כלי לבניית תרשימי טבלה. מידע נוסף זמין במסמכי התיעוד של Google Charts.
הדוגמה הבאה ממחישה איך ליצור תרשים טבלה. הנתונים מיובאים מגיליון אלקטרוני של 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 גיליונות |
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
– ה-builder הזה, שימושי ליצירת שרשורים.
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
– ה-builder הזה, שימושי ליצירת שרשורים.
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
– ה-builder הזה, שימושי ליצירת שרשורים.
enableRtlTable(rtlEnabled)
מוסיף תמיכה בסיסית בשפות הנכתבות מימין לשמאל (כגון ערבית או עברית) על ידי היפוך סדר העמודות בטבלה, כך שעמודה אפס היא העמודה הימנית ביותר והעמודה האחרונה בעמודה השמאלית ביותר.
אין לכך השפעה על אינדקס העמודות בנתוני הבסיס, אלא רק על סדר התצוגה. אפילו אין תמיכה בתצוגה דו-כיוונית מלאה של התצוגה החזותית של הטבלה באפשרות הזאת. המערכת תתעלם מהאפשרות הזו אם תפעילו את החלוקה לדפים (באמצעות אפשרות הדף), או אם הטבלה כוללת סרגלי גלילה מכיוון שציינת אפשרויות גובה ורוחב קטנות יותר גודל הטבלה הנדרש. התנהגות ברירת המחדל היא שתמיכה ב-RTL מושבתת.
פרמטרים
שם | סוג | תיאור |
---|---|---|
rtlEnabled | Boolean | true אם צריך להפעיל תמיכה מימין לשמאל, false
אחרת. |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.
enableSorting(enableSorting)
קובעת אם למיין עמודות כשהמשתמש לוחץ על כותרת עמודה.
אם המיון מופעל, כשמשתמשים לוחצים על כותרת העמודה, השורות מוצגות באופן אוטומטי. מוינה. כברירת מחדל, המיון מופעל.
פרמטרים
שם | סוג | תיאור |
---|---|---|
enableSorting | Boolean | true כדי לאפשר מיון על ידי לחיצה על כותרות העמודות, false אחרת. |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.
setDataSourceUrl(url)
מגדיר את כתובת ה-URL של מקור הנתונים שמשמש לשליפת נתונים ממקור חיצוני, כמו Google גיליונות אם סופקו כתובת URL של מקור נתונים ו-DataTable, המערכת מתעלמת מכתובת ה-URL של מקור הנתונים.
מידע נוסף על שליחת שאילתות למקורות נתונים זמין במסמכי התיעוד של Google Charts.
פרמטרים
שם | סוג | תיאור |
---|---|---|
url | String | כתובת ה-URL של מקור הנתונים, כולל הפרמטרים של השאילתה. |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.
setDataTable(tableBuilder)
מגדירה את טבלת הנתונים שתשמש את התרשים באמצעות DataTableBuilder. זוהי שיטה נוחה
להגדרת טבלת הנתונים בלי שתצטרכו לקרוא ל-build()
.
פרמטרים
שם | סוג | תיאור |
---|---|---|
tableBuilder | DataTableBuilder | כלי לבניית טבלאות נתונים טבלת נתונים חדשה נוצרת באופן מיידי כחלק כך שעדכונים נוספים ב-builder לא יבואו לידי ביטוי בתרשים. |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.
setDataTable(table)
מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים, ואת התוויות של ציר ה-X. העמודה הראשונה צריכה להיות מחרוזת ולהכיל את התוויות של הציר האופקי. כל מספר של עמודות יכולים לעקוב, וכולם חייבים להיות מספריים. כל עמודה מוצגת כשורה נפרדת.
פרמטרים
שם | סוג | תיאור |
---|---|---|
table | DataTableSource | טבלת הנתונים שבה ייעשה שימוש עבור התרשים. |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.
setDataViewDefinition(dataViewDefinition)
מגדיר את ההגדרה של תצוגת הנתונים שתשמש את התרשים.
פרמטרים
שם | סוג | תיאור |
---|---|---|
dataViewDefinition | DataViewDefinition | אובייקט של הגדרה של תצוגת נתונים שמגדיר את התצוגה שאמורה להיות נגזר ממקור הנתונים הנתון של שרטוט התרשים. |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.
setDimensions(width, height)
מגדיר את המימדים של התרשים.
פרמטרים
שם | סוג | תיאור |
---|---|---|
width | Integer | רוחב התרשים, בפיקסלים. |
height | Integer | גובה התרשים, בפיקסלים. |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.
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
– ה-builder הזה, שימושי ליצירת שרשורים.
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
– ה-builder הזה, שימושי ליצירת שרשורים.
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
– ה-builder הזה, שימושי ליצירת שרשורים.
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
– ה-builder הזה, שימושי ליצירת שרשורים.
showRowNumberColumn(showRowNumber)
ההגדרה קובעת אם להציג את מספר השורה כעמודה הראשונה בטבלה.
התנהגות ברירת המחדל לא מציגה מספרי שורות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
showRowNumber | Boolean | true אם בעמודה הראשונה של הטבלה צריך להופיע מספר השורה,
אחרת, false . |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.
useAlternatingRowStyle(alternate)
ההגדרה קובעת אם סגנון הצבעים המתחלפים מוקצה לשורות אי-זוגיות וזוגיות בתרשים טבלה.
התנהגות ברירת המחדל היא שהשורות עם סגנון של צבעים מתחלפים.
פרמטרים
שם | סוג | תיאור |
---|---|---|
alternate | Boolean | true אם סגנונות הצבעים צריכים להיות מתחלפים, false אחרת. |
חזרה
TableChartBuilder
– ה-builder הזה, שימושי ליצירת שרשורים.