במסמך הזה נסביר איך ליצור דיאגרמות ון באמצעות Chart API.
תוכן העניינים
תכונות שספציפיות לתרשים
|
תכונות רגילות
|
הקדמה
דיאגרמות ון הן תרשימים עם מעגלים חופפים שמציינים את המשותף לכמה קבוצות שונות. התרשימים תומכים בדיאגרמות ון עם שניים או שלושה מעגלים. עליך לציין את הגדלים היחסיים של המעגלים ואת מידת החפיפה ביניהם.
סוגי תרשימים (cht
)
כדי לציין דיאגרמת ון באמצעות התחביר הבא:
תחביר
cht=v
מחרוזת הנתונים היא קבוצה של עד שבעה רכיבים, שמופרדים באמצעות התו המפריד שמתאים לפורמט הנתונים שלכם, כפי שמתואר כאן:
- שלושת הערכים הראשונים מציינים את הגדלים של שלושה מעגלים: A, B ו-C. בתרשים עם שני מעגלים בלבד, מציינים אפס עבור הערך השלישי.
- הערך הרביעי מציין את גודל ההצטלבות של A ו-B.
- הערך החמישי מציין את גודל ההצטלבות של A ו-C. לתרשים עם שני מעגלים בלבד, אין לציין כאן ערך.
- הערך השישי מציין את גודל ההצטלבות של B ו-C. לתרשים עם שני מעגלים בלבד, אין לציין כאן ערך.
- הערך השביעי מציין את גודל החיתוך המשותף של A, B ו-C. לתרשים עם שני מעגלים בלבד, אין לציין כאן ערך.
שימו לב שבתרשימים של דיאגרמות ון (Venn) כל הערכים הם יחסיים ולא מוחלטים. כלומר, תרשים עם הערכים 10,20,30 ייראה זהה לתרשים עם הערכים 100,200,300 (אם סוג הקידוד שלכם מקבל את הערכים האלה).
תיאור | דוגמה |
---|---|
תרשים ון שמורכב משלושה מעגלים. |
|
כדי ליצור תרשים עם שני מעגלים, צריך לציין אפס עבור מעגל C ואסור לציין ערכים חופפים שכוללים את C. | cht=v |
צבעי הסדרה chco
אפשר לציין את הצבעים של כל הסדרות, כל סדרה או סדרות מסוימות באמצעות הפרמטר chco
.
תחביר
chco=<color_1>,...,<color_n>
- <color>
- צבע הסדרה, בפורמט הקסדצימלי של RRGGBB. כדי לציין צבעים שונים לסדרות שונות, מוסיפים ערכי צבעים המופרדים בפסיקים. אם יש פחות צבעים מסדרה, הצבע האחרון חוזר על עצמו, אבל בתרשימי ון, צבעים זהים עלולים להקשות על הקריאה בתרשים.
תיאור | דוגמה |
---|---|
צבע שונה לכל עיגול. | chco=FF6342,ADDE63,63C6DE |
אם יש פחות צבעים מאשר עיגולים, הצבע האחרון שצוין חוזר. עם זאת, הדבר מקשה על קריאת התרשים. |
|
תכונות רגילות
שאר התכונות בדף הזה הן תכונות רגילות של תרשים.
צריך לציין צבעים באמצעות מחרוזת בת 6 תווים של ערכים הקסדצימליים, בתוספת שני ערכי שקיפות אופציונליים, בפורמט RRGGBB[AA]
.
לדוגמה:
FF0000
= אדום00FF00
= ירוק0000FF
= כחול000000
= שחורFFFFFF
= לבן
AA
הוא ערך שקיפות אופציונלי, שבו הערך 00
הוא שקיפות מלאה ו-FF
אטום לחלוטין. לדוגמה:
0000FFFF
= כחול מלא0000FF66
= כחול שקוף
כותרת התרשים chtt
, chts
[כל
התרשימים]
אפשר לבחור את טקסט הכותרת, הצבע וגודל הגופן של התרשים.
תחביר
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
– מציין את כותרת התרשים.
- <chart_title>
- כותרת להצגה לתרשים. לא ניתן לציין איפה יופיע השם, אבל אפשר לציין את גודל הגופן והצבע. כדי לציין רווחים, צריך להשתמש בסימן + ובקו ניצב (
|
) כדי לציין מעברי שורה.
chts
[אופציונלי] – צבעים וגודל גופן
לפרמטר chtt
.
- <color>
- צבע הכותרת, בפורמט הקסדצימלי של RRGGBB. צבע ברירת המחדל הוא שחור.
- <font_size>
- גודל הגופן של הכותרת, בנקודות.
- <opt_alignment>
- [אופציונלי] יישור הכותרת. בוחרים אחד מערכי המחרוזת הבאים תלויי אותיות רישיות: "l" (שמאל), "c" (במרכז) "r" (ימין). ברירת המחדל היא "c".
דוגמאות
תיאור | דוגמה |
---|---|
תרשים עם כותרת, עם צבע וגודל גופן שמוגדרים כברירת מחדל. צריך לציין רווח עם סימן חיבור ( כדי לאלץ מעבר שורה, צריך להשתמש בתו קו אנכי (
|
chtt=Site+visitors+by+month| |
תרשים עם כותרת כחולה ביישור לימין של 20 נקודות. |
chtt=Site+visitors |
טקסט וסגנון של מקרא התרשים chdl
, chdlp
, chdls
[כל
התרשימים]
המקרא הוא קטע צדדי בתרשים, שמספק תיאור קצר של כל סדרה. אפשר לציין את הטקסט שמשויך לכל סדרה במקרא הזה ולציין איפה הוא יופיע בתרשים.
למידע נוסף על הגדרת השוליים סביב המקרא, אפשר לעיין גם בchma
.
הערה לגבי ערכי מחרוזת: מותר להשתמש רק בתווים שמתאימים לכתובת URL במחרוזות תוויות. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z
.
אפשר למצוא מקודד של כתובות URL במסמכי התיעוד של Google החזותית.
תחביר
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
– הטקסט של כל סדרה, שיוצג במקרא.
- <data_series_label>
- הטקסט של הפריטים מהמקרא. כל תווית חלה על הסדרה המתאימה במערך
chd
. הוספת סימן חיבור (+) למרחב משותף. אם לא מציינים את הפרמטר הזה, התרשים לא יקבל מקרא. אין אפשרות לציין מעבר שורה בתווית. המקרא בדרך כלל יורחב כדי להציג את הטקסט של המקרא, ואזור התרשים יצטמצם כדי להתאים למקרא.
chdlp
– [אופציונלי] המיקום של המקרא והסדר של שמות הפריטים במקרא. אפשר לציין <position>
ו/או <label_order>. אם מציינים את שניהם, צריך להפריד ביניהם באמצעות תו בר. אפשר להוסיף 's' לכל ערך אם רוצים לדלג על רשומות ריקות במקרא
chdl
במקרא. דוגמאות: chdlp=bv
, chdlp=r
, chdlp=bv|r
, chdlp=bvs|r
- <opt_position>
- [אופציונלי] מציין את המיקום של המקרא בתרשים. כדי להוסיף מרווח פנימי נוסף בין המקרא לאזור התרשים או לגבולות התמונה, אפשר להשתמש בפרמטר
chma
. בוחרים אחד מהערכים הבאים:b
- מקרא בתחתית התרשים, רשומות מקרא בשורה אופקית.bv
- מקרא בתחתית התרשים, רשומות מקרא בעמודה אנכית.t
- מקרא בראש התרשים, רשומות מקרא בשורה אופקית.tv
- מקרא בראש התרשים, ערכים מהמקרא בעמודה אנכית.r
- [ברירת מחדל] מקרא מימין לתרשים, הערכים של המקרא בעמודה אנכית.l
- מקרא משמאל לתרשים, ערכים מהמקרא בעמודה אנכית.
- <opt_label_order>
- [אופציונלי]
הסדר שבו התוויות מוצגות במקרא.
בוחרים אחד מהערכים הבאים:
l
- [ברירת המחדל של מקרא אנכי] הצגת התוויות לפי הסדר שנקבע ל-chdl
.r
- הצגת התוויות בסדר ההפוך כפי שניתן ל-chdl
. האפשרות הזו שימושית בתרשימי עמודות אופקיים מוערם כדי להציג את המקרא
באותו סדר שבו מופיעות העמודות.a
- [ברירת המחדל של מקרא אופקי] סידור אוטומטי: כלומר, מיון לפי אורך, הקצר ביותר תחילה, כפי שנמדד בבלוקים של 10 פיקסלים. כששני רכיבים הם באורך זהה (חלוקה ל-10 בלוקים של פיקסלים), הרכיב הראשון שמופיע ראשון מופיע ראשון.0,1,2...
- סדר של תוויות מותאמות אישית. זוהי רשימה של אינדקסים מבוססי-אפס של תוויות מ-chdl
, מופרדים בפסיקים.
chdls
– [אופציונלי] קביעת הצבע וגודל הגופן של הטקסט במקרא.
- <color>
- צבע הטקסט במקרא, בפורמט הקסדצימלי של RRGGBB.
- <size>
- גודל הנקודות בטקסט המקרא.
דוגמאות
תיאור | דוגמה |
---|---|
שתי דוגמאות של אגדות. ציון הטקסט במקרא באותו סדר כמו סדרת הנתונים. |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
בתרשים הראשון מוצגים פריטים מהמקרא האופקי ( |
|
בדוגמה הזו אפשר לראות את שינוי גודל הגופן. |
|
שולי התרשים chma
[כל
התרשימים]
אפשר לציין את גודל השוליים של התרשים, בפיקסלים. השוליים מחושבים פנימה מהגודל שצוין בתרשים (chs
). הגדלה של השוליים לא מגדילה את הגודל הכולל של התרשים, אלא רק מכווצת את שטח התרשים, במקרה הצורך.
כברירת מחדל, השוליים הם כל מה שנותר אחרי חישוב גודל התרשים. ערך ברירת המחדל משתנה לפי סוג התרשים. השוליים שציינתם הם ערך מינימלי. אם אזור התרשים מותיר מקום לשוליים, גודל השוליים יהיה כל מה שנשאר. לא ניתן לכווץ את השוליים שקטנים ממה שנדרש למקרא ולתוויות. זהו תרשים שמציג את החלקים הבסיסיים של התרשים:
שולי התרשים כוללים את תוויות הצירים ואת אזור המקרא. גודל האזור של המקרא משתנה באופן אוטומטי כך שיתאים בדיוק לטקסט, אלא אם מציינים רוחב גדול יותר באמצעות טיפ: בתרשים עמודות, אם לעמודות יש גודל קבוע (ברירת המחדל), לא ניתן להקטין את רוחב האזור בתרשים. צריך לציין פס קטן יותר או עמודה שניתן לשנות את הגודל שלה באמצעות |
תחביר
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- <left_margin>, <left_margin>, <left_margin>, <left_margin>
- גודל השוליים המינימלי מסביב לאזור התרשים, בפיקסלים. יש להגדיל את הערך כדי להוסיף מרווח פנימי מסוים כדי למנוע חפיפה בין תוויות הצירים לבין גבולות התרשים.
- <opt_legend_width>, <opt_legend_height>
- [אופציונלי] רוחב השוליים סביב המקרא, בפיקסלים. ניתן להשתמש באפשרות הזו כדי שהמקרא לא יקפוץ באזור התרשים או בקצוות התמונה.
דוגמאות
תיאור | דוגמה |
---|---|
בדוגמה הזו, בתרשים יש שוליים מינימליים של 30 פיקסלים בכל צד. המקרא של התרשים הוא ברוחב של יותר מ-30 פיקסלים, ולכן השוליים שבצד שמאל מוגדרים לרוחב של מקרא התרשים, והם שונים מהשוליים האחרים. תוויות הצירים נמצאות מחוץ לאזור התרשים, ולכן הן משורטטות בתוך שטח השוליים. |
|
כדי להוסיף שוליים סביב המקרא, מגדירים ערך לפרמטרים בדוגמה הזו, המקרא הוא ברוחב של כ-60 פיקסלים. אם תגדירו את |
|
מילוי ברקע chf
[כל
התרשימים]
אפשר לציין צבעים וסגנונות מילוי לאזור הנתונים של התרשים ו/או לכל הרקע של התרשים. סוגי המילוי כוללים מילויים מלאים, מילויים מפוספסים והדרגה.
אפשר לציין מילויים שונים לאזורים שונים (לדוגמה, לכל אזור התרשים או רק לאזור הנתונים). מילוי השטח של התרשים
יחליף את המילוי ברקע. כל המילויים מצוינים באמצעות הפרמטר chf
,
וניתן לשלב סוגי מילוי שונים (מלאים, פסים, צבעים הדרגתיים) באותו תרשים,
על ידי הפרדה בין ערכים באמצעות קו אנכי ( | ). מילוי אזור התרשים מחליף את מילויי הרקע של התרשים.
מילוי מלא chf
[כל
התרשימים]
אפשר לציין מילוי מלא לרקע ו/או לאזור התרשים, או להקצות
ערך שקיפות לכל התרשים. אפשר לציין מספר מילויים באמצעות התו בצינורות (|
). (מפות: רקע בלבד).
תחביר
chf=<fill_type>,s,<color>|...
- <fill_type>
- החלק בתרשים שממלא. אפשר לציין את אחד מהערכים הבאים:
bg
- מילוי רקעc
– מילוי אזור התרשים. האפשרות הזו לא נתמכת בתרשימי מפה.a
- הגדרת כל התרשים (כולל רקעים) שקופים. המערכת מתעלמת משש הספרות הראשונות של<color>
, ורק שתי הספרות האחרונות (ערך השקיפות) חלות על התרשים כולו ועל כל המילוי.b<index>
- מילויים מלאים בעמודות (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בצבע אחיד. האפקט דומה לציון הערךchco
בתרשים עמודות. מידע נוסף מופיע בקטע צבעי סדרת העמודות.
- שנ'
- מציין מילוי מלא או שקיפות.
- <color>
- צבע המילוי, בפורמט הקסדצימלי של RRGGBB. במקרה של שקפים, המערכת מתעלמת משש הספרות הראשונות, אבל בכל זאת צריך לכלול אותן.
דוגמאות
תיאור | דוגמה |
---|---|
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר ( |
|
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר ( |
|
בדוגמה הזו ניתן להחיל שקיפות של 50% על כל התרשים (80 בהקסדצימליים הם 128, או כ-50% שקיפות). שמים לב לרקע של התא בטבלה שמוצג דרך התרשים. |
|
מילוי הדרגתי chf
[Line,
Bar, Google-o-meter, רדאר, פיזור,וון]
ניתן להחיל מילוי אחד או יותר של צבעים הדרגתיים על אזורים או רקעים בתרשים. מילויים הדרגתיים משתנים בהדרגה מצבע אחד לצבע אחר. (עוגה, תרשימי Google-o-Meter: רקע בלבד).
כל מילוי הדרגתי מציין זווית, ולאחר מכן שני צבעים או יותר שמוצמדים למיקום שצוין. הצבע משתנה ברגע שהוא עובר מעוגן אחד לאחר. חייבים להיות לפחות שני צבעים עם ערכים שונים של <color_centerpoint>, כדי שאחד מהם יוכל להפוך לשקוף בהדרגה. כל מדורג נוסף מצוין באמצעות זוג <color>,<color_centerpoint>.
תחביר
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <fill_type>
- אזור התרשים שיש למלא. אחד מהפרטים הבאים:
bg
- מילוי רקעc
– מילוי אזור התרשים.b<index>
– מילויים הדרגתיים של עמודות (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בהדרגתיות. מידע נוסף מופיע בקטע צבעי סדרת העמודות.
- lg
- מציין מילוי הדרגתי.
- <angle>
- מספר שמציין את הזווית של ההדרגתיות מ-0 (אופקי) עד 90 (אנכי).
- <color>
- צבע המילוי, בפורמט הקסדצימלי של RRGGBB.
- <color_centerpoint>
- קביעת נקודת העוגן של הצבע. הצבע יתחיל להתעמעם מהנקודה הזו כשהוא יתקרב לעוגן אחר. טווח הערכים הוא בין 0.0 (קצה תחתון או שמאלי) ל-1.0 (קצה עליון או ימני), בהטיה בזווית שצוינה באמצעות <angle>.
דוגמאות
תיאור | דוגמה |
---|---|
באזור התרשים יש שיפוע לינארי אופקי, שצוין בזווית של אפס מעלות ( הצבעים הם אפרסק ( רקע התרשים משורטט בצבע אפור ( |
|
באזור התרשים יש שיפוע לינארי באלכסון (משמאל למעלה מימין)
לינארי, שמצוין בזווית של ארבעים וחמש מעלות ( אפרסק ( כחול ( רקע התרשים משורטט בצבע אפור ( |
|
באזור התרשים יש שיפוע לינארי אנכי (מלמעלה למטה)
שצוין בזווית של תשעים מעלות ( כחול ( אפרסק ( רקע התרשים משורטט בצבע אפור ( |
|
מילויים מפסים chf
[קו,
בר, Google-o-meter, מכ"ם, פיזור, Venn]
אפשר לבחור מילוי של רקע מפוספס לאזור התרשים, או לכל התרשים. (עוגה, תרשימי Google-o-Meter: רקע בלבד.)
תחביר
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <fill_type>
- אזור התרשים שיש למלא. אחד מהפרטים הבאים:
bg
- מילוי רקעc
– מילוי אזור התרשיםb<index>
– מילויים בפסים (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בפסים. אפשר לעיין בדוגמאות, בקטע צבעי סדרה של תרשים עמודות.
- ls
- קביעת מילוי של פס לינארי.
- <angle>
- הזווית של כל הפסים, ביחס לציר ה-Y. צריך להשתמש במאפיין
0
לפסים אנכיים או במאפיין90
לפסים אופקיים. - <color>
- הצבע של הפס הזה, בפורמט הקסדצימלי של RRGGBB. חוזרים על <color> ועל <width> לכל פס נוסף. צריך שיהיו לך שני פסים לפחות. הפסים מתחלפים עד שהתרשים מתמלא.
- <width>
- רוחב הפס הזה, מ-
0
עד1
, כאשר1
הוא לכל רוחב התרשים. הפסים חוזרים על עצמם עד שהתרשים מתמלא. חוזרים על התגים <color> ו-<width> לכל פס נוסף. צריך שיהיו לך שני פסים לפחות. הפסים מתחלפים עד שהתרשים מתמלא.
דוגמאות
תיאור | דוגמה |
---|---|
|
chf= |
|
chf= |