כלי לבניית תרשימי טבלאות. מידע נוסף זמין במשאבי העזרה של Google Tables.
הנה דוגמה שממחישה איך ליצור תרשים טבלה. הנתונים מיובאים מגיליון אלקטרוני של Google.
// Get sample data from a spreadsheet. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; var chartBuilder = Charts.newTableChart() .setDimensions(600, 500) .enablePaging(20) .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
build() | Chart | בונה את התרשים. |
enablePaging(enablePaging) | TableChartBuilder | מגדירה אם להפעיל דפדוף בנתונים. |
enablePaging(pageSize) | TableChartBuilder | מאפשר דפדוף ומגדיר את מספר השורות בכל דף. |
enablePaging(pageSize, startPage) | TableChartBuilder | הפעלת החלוקה לדפים, הגדרת מספר השורות בכל דף והצגה של דף הטבלה הראשון (מספרי הדפים מבוססים על אפס). |
enableRtlTable(rtlEnabled) | TableChartBuilder | מוסיף תמיכה בסיסית בשפות הנכתבות מימין לשמאל (כמו ערבית או עברית) על ידי היפוך סדר העמודות בטבלה, כך שעמודה אפס היא העמודה הימנית ביותר והעמודה האחרונה היא העמודה השמאלית ביותר. |
enableSorting(enableSorting) | TableChartBuilder | מגדירה אם העמודות ממוינות כשהמשתמש לוחץ על כותרת של עמודה. |
setDataSourceUrl(url) | TableChartBuilder | מגדירה את כתובת ה-URL של מקור הנתונים לצורך שליפת נתונים ממקור חיצוני, כמו Google Sheets. |
setDataTable(tableBuilder) | TableChartBuilder | מגדיר את טבלת הנתונים לשימוש בתרשים באמצעות DataTableBuilder. |
setDataTable(table) | TableChartBuilder | מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים ואת התוויות של ציר ה-X. |
setDataViewDefinition(dataViewDefinition) | TableChartBuilder | מגדיר את ההגדרה של תצוגת הנתונים לשימוש בתרשים. |
setDimensions(width, height) | TableChartBuilder | מגדיר את מידות התרשים. |
setFirstRowNumber(number) | TableChartBuilder | מגדיר את מספר השורה של השורה הראשונה בטבלת הנתונים. |
setInitialSortingAscending(column) | TableChartBuilder | המדיניות מגדירה את האינדקס של העמודה שלפיה הטבלה צריכה להיות ממוינת בהתחלה (בסדר עולה). |
setInitialSortingDescending(column) | TableChartBuilder | קובעת את האינדקס של העמודה לפיו יש למיין את הטבלה (בסדר יורד). |
setOption(option, value) | TableChartBuilder | מגדיר אפשרויות מתקדמות לתרשים הזה. |
showRowNumberColumn(showRowNumber) | TableChartBuilder | מגדירה אם להציג את מספר השורה כעמודה הראשונה של הטבלה. |
useAlternatingRowStyle(alternate) | TableChartBuilder | קובעת אם סגנון צבעים מתחלף מוקצה לשורות אי-זוגיות וזוגיות בתרשים טבלה. |
תיעוד מפורט
build()
בונה את התרשים.
החזרות
Chart
- אובייקט תרשים, שאפשר להטמיעו במסמכים וברכיבי ממשק משתמש ולהשתמש בו כתמונה סטטית.
enablePaging(enablePaging)
מגדירה אם להפעיל דפדוף בנתונים.
כברירת מחדל, הדפדוף מושבת. אם הדפדוף מופעל, ברירת המחדל של גודל הדף היא 10.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enablePaging | Boolean | true אם החלוקה צריכה להיות מופעלת, false אחרת. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
enablePaging(pageSize)
מאפשר דפדוף ומגדיר את מספר השורות בכל דף.
גודל הדף שמוגדר כברירת מחדל הוא 10.
// Creates a table chart builder and enables paging with page size of 5. var builder = Charts.newTableChart(); builder.enablePaging(5);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
pageSize | Integer | מספר השורות בכל דף בטבלה. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
enablePaging(pageSize, startPage)
הפעלת החלוקה לדפים, הגדרת מספר השורות בכל דף והצגה של דף הטבלה הראשון (מספרי הדפים מבוססים על אפס).
גודל הדף שמוגדר כברירת מחדל הוא 10, וברירת המחדל של דף הפתיחה היא 0.
// Creates a table chart builder and enables paging with page size of 5 and displays page 2 // first. var builder = Charts.newTableChart(); builder.enablePaging(5, 2);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
pageSize | Integer | מספר השורות בכל דף בטבלה. |
startPage | Integer | דף הטבלה הראשון להצגה (מספרי הדפים מבוססים על אפס). |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
enableRtlTable(rtlEnabled)
מוסיף תמיכה בסיסית בשפות הנכתבות מימין לשמאל (כמו ערבית או עברית) על ידי היפוך סדר העמודות בטבלה, כך שעמודה אפס היא העמודה הימנית ביותר והעמודה האחרונה היא העמודה השמאלית ביותר.
השינוי הזה לא משפיע על אינדקס העמודות בנתונים הבסיסיים, אלא רק על סדר התצוגה. התצוגה החזותית של הטבלה לא נתמכת בתצוגה דו-כיוונית (BiDi) מלאה, גם כשבוחרים באפשרות הזו. המערכת מתעלמת מהאפשרות הזו אם מפעילים דפדוף (באמצעות אפשרות הדף), או אם בטבלה יש פסי גלילה כי ציינתם אפשרויות גובה ורוחב שהן קטנות מהגודל הנדרש לטבלה. התנהגות ברירת המחדל היא התמיכה מימין לשמאל.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
rtlEnabled | Boolean | true אם התמיכה מימין לשמאל צריכה להיות מופעלת, false
אחרת. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
enableSorting(enableSorting)
מגדירה אם העמודות ממוינות כשהמשתמש לוחץ על כותרת של עמודה.
אם המיון מופעל, כשהמשתמשים לוחצים על כותרת העמודה השורות ממוינות באופן אוטומטי. המיון מופעל כברירת מחדל.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enableSorting | Boolean | true כדי להפעיל מיון על ידי לחיצה על כותרות העמודות. אחרת, false . |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setDataSourceUrl(url)
מגדירה את כתובת ה-URL של מקור הנתונים לצורך שליפת נתונים ממקור חיצוני, כמו Google Sheets. אם תספקו כתובת URL של מקור נתונים ו-DataTable, המערכת תתעלם מכתובת ה-URL של מקור הנתונים.
מידע נוסף על שאילתות לגבי מקורות נתונים זמין במסמכי התיעוד של Google Graph.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
url | String | כתובת ה-URL של מקור הנתונים, כולל הפרמטרים של השאילתה. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setDataTable(tableBuilder)
מגדיר את טבלת הנתונים לשימוש בתרשים באמצעות DataTableBuilder. זוהי שיטה נוחה להגדרת טבלת הנתונים בלי להתקשר אל build()
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
tableBuilder | DataTableBuilder | כלי לבניית טבלאות נתונים. טבלת נתונים חדשה נוצרת באופן מיידי כחלק מהקריאה הזו, כך שעדכונים נוספים בכלי לא יופיעו בתרשים. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setDataTable(table)
מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים ואת התוויות של ציר ה-X. העמודה הראשונה צריכה להיות מחרוזת ולהכיל את התוויות של הציר האופקי. אחרי מספר העמודות יכולות להופיע כל העמודות, וכולן צריכות להכיל ערכים מספריים. כל עמודה מוצגת בשורה נפרדת.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
table | DataTableSource | טבלת הנתונים לשימוש בתרשים. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setDataViewDefinition(dataViewDefinition)
מגדיר את ההגדרה של תצוגת הנתונים לשימוש בתרשים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
dataViewDefinition | DataViewDefinition | אובייקט של הגדרה של תצוגת נתונים, שמגדיר את התצוגה שאמורה להיות נגזרת ממקור הנתונים הנתון לשרטוט התרשים. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setDimensions(width, height)
מגדיר את מידות התרשים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
width | Integer | רוחב התרשים, בפיקסלים. |
height | Integer | גובה התרשים, בפיקסלים. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setFirstRowNumber(number)
מגדיר את מספר השורה של השורה הראשונה בטבלת הנתונים.
מספר ברירת המחדל של השורה הראשונה הוא 1.
// Creates a table chart builder and sets the first row to be 2. var builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
number | Integer | מספר השורה של השורה הראשונה בטבלת הנתונים. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setInitialSortingAscending(column)
המדיניות מגדירה את האינדקס של העמודה שלפיה הטבלה צריכה להיות ממוינת בהתחלה (בסדר עולה).
העמודה ממוינת בסדר עולה ומסומנת באמצעות חץ קטן שמציין זאת.
// Creates a table chart builder and sorts it by the second column (ascending). var builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
column | Integer | מספר העמודה שלפיה צריך למיין את הטבלה בהתחלה. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setInitialSortingDescending(column)
קובעת את האינדקס של העמודה לפיו יש למיין את הטבלה (בסדר יורד).
העמודה ממוינת בסדר יורד ומסומנת באמצעות חץ קטן שמציין זאת.
// Creates a table chart builder and sorts it by the second column (descending). var builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
column | Integer | מספר העמודה שלפיה צריך למיין את הטבלה בהתחלה. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
setOption(option, value)
מגדיר אפשרויות מתקדמות לתרשים הזה. כדאי לעיין באפשרויות הזמינות בתרשים הזה. לשיטה הזו אין השפעה אם האפשרות הנתונה אינה חוקית.
// Build a table chart which renders HTML. var builder = Charts.newTableChart(); builder.setOption('allowHtml', {@code true}); var chart = builder.build();
פרמטרים
שם | תיאור | התיאור |
---|---|---|
option | String | אפשרות ההגדרה. |
value | Object | הערך שיש להגדיר. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
showRowNumberColumn(showRowNumber)
מגדירה אם להציג את מספר השורה כעמודה הראשונה של הטבלה.
התנהגות ברירת המחדל לא מציגה מספרי שורות.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
showRowNumber | Boolean | true אם העמודה הראשונה בטבלה צריכה להציג את מספר השורה,
false אחרת. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.
useAlternatingRowStyle(alternate)
קובעת אם סגנון צבעים מתחלף מוקצה לשורות אי-זוגיות וזוגיות בתרשים טבלה.
התנהגות ברירת המחדל היא השורות עם סגנון צבעים מתחלף.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
alternate | Boolean | true אם סגנונות הצבעים צריכים להיות מתחלפים, false אחרת. |
החזרות
TableChartBuilder
– הכלי הזה – שימושי ליצירת שרשורים.