כלי ליצירת אובייקטים של DataTable. כדי ליצור טבלת נתונים, צריך קודם לציין את העמודות שלה ואז להוסיף את השורות, אחת בכל פעם. דוגמה:
const data = Charts.newDataTable() .addColumn(Charts.ColumnType.STRING, 'Month') .addColumn(Charts.ColumnType.NUMBER, 'In Store') .addColumn(Charts.ColumnType.NUMBER, 'Online') .addRow(['January', 10, 1]) .addRow(['February', 12, 1]) .addRow(['March', 20, 2]) .addRow(['April', 25, 3]) .addRow(['May', 30, 4]) .build();
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
add | Data | הוספת עמודה לטבלת הנתונים. |
add | Data | הוספת שורה לטבלת הנתונים. |
build() | Data | יוצרת טבלת נתונים ומחזירה אותה. |
set | Data | מגדיר ערך ספציפי בטבלה. |
תיעוד מפורט
addColumn(type, label)
הוספת עמודה לטבלת הנתונים. העמודות יתווספו מ-0 עד n.
העמודה הראשונה משמשת לעיתים קרובות בתרשימים לתוויות (לדוגמה, תוויות של ציר ה-X בתרשימי קו או תוויות של פלחים בתרשימי עוגה). לרוב משתמשים בעמודות האחרות לנתונים, ולכן לרוב צריך להזין בהן ערכים מספריים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
type | Column | סוג הנתונים בעמודה (מספר, מחרוזת או תאריך) |
label | String | התווית של העמודה (היא משמשת למקרא של התרשים). |
חזרה
DataTableBuilder – ה-builder הזה, לשרשור.
addRow(values)
הוספת שורה לטבלת הנתונים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
values | Object[] | הערכים של השורה, שצוינו באותו סדר שבו הוזנו העמודות. |
חזרה
DataTableBuilder – ה-builder הזה, לשרשור.
build()
setValue(row, column, value)
מגדיר ערך ספציפי בטבלה.
אפשר להגדיר ערך לפני שמוסיפים את העמודה לטבלת הנתונים. עם זאת, אם לא תוסיפו את העמודה בשלב כלשהו, המערכת תתעלם מהערך.
לא צריך למלא את כל הערכים בעמודות. התמונות החסרות ייחשבו null.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
row | Integer | אינדקס השורה (השורה הראשונה היא אינדקס 0) |
column | Integer | אינדקס העמודה (העמודה הראשונה היא אינדקס 0) |
value | Object | הערך של התא בטבלה (צריך להיות מהסוג הנכון לעמודה). |
חזרה
DataTableBuilder – ה-builder הזה, לשרשור