Class TableChartBuilder

TableChartBuilder

כלי לבניית תרשימי טבלה. מידע נוסף זמין במסמכי התיעוד של 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.

פרמטרים

שםסוגתיאור
enablePagingBooleantrue אם צריך להפעיל את החלוקה לדפים, 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);

פרמטרים

שםסוגתיאור
pageSizeIntegerמספר השורות בכל דף בטבלה.

חזרה

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);

פרמטרים

שםסוגתיאור
pageSizeIntegerמספר השורות בכל דף בטבלה.
startPageIntegerדף הטבלה הראשון להצגה (מספרי הדפים מבוססים על אפס).

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


enableRtlTable(rtlEnabled)

מוסיף תמיכה בסיסית בשפות הנכתבות מימין לשמאל (כגון ערבית או עברית) על ידי היפוך סדר העמודות בטבלה, כך שעמודה אפס היא העמודה הימנית ביותר והעמודה האחרונה בעמודה השמאלית ביותר.

אין לכך השפעה על אינדקס העמודות בנתוני הבסיס, אלא רק על סדר התצוגה. אפילו אין תמיכה בתצוגה דו-כיוונית מלאה של התצוגה החזותית של הטבלה באפשרות הזאת. המערכת תתעלם מהאפשרות הזו אם תפעילו את החלוקה לדפים (באמצעות אפשרות הדף), או אם הטבלה כוללת סרגלי גלילה מכיוון שציינת אפשרויות גובה ורוחב קטנות יותר גודל הטבלה הנדרש. התנהגות ברירת המחדל היא שתמיכה ב-RTL מושבתת.

פרמטרים

שםסוגתיאור
rtlEnabledBooleantrue אם צריך להפעיל תמיכה מימין לשמאל, false אחרת.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


enableSorting(enableSorting)

קובעת אם למיין עמודות כשהמשתמש לוחץ על כותרת עמודה.

אם המיון מופעל, כשמשתמשים לוחצים על כותרת העמודה, השורות מוצגות באופן אוטומטי. מוינה. כברירת מחדל, המיון מופעל.

פרמטרים

שםסוגתיאור
enableSortingBooleantrue כדי לאפשר מיון על ידי לחיצה על כותרות העמודות, false אחרת.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


setDataSourceUrl(url)

מגדיר את כתובת ה-URL של מקור הנתונים שמשמש לשליפת נתונים ממקור חיצוני, כמו Google גיליונות אם סופקו כתובת URL של מקור נתונים ו-DataTable, המערכת מתעלמת מכתובת ה-URL של מקור הנתונים.

מידע נוסף על שליחת שאילתות למקורות נתונים זמין במסמכי התיעוד של Google Charts.

פרמטרים

שםסוגתיאור
urlStringכתובת ה-URL של מקור הנתונים, כולל הפרמטרים של השאילתה.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


setDataTable(tableBuilder)

מגדירה את טבלת הנתונים שתשמש את התרשים באמצעות DataTableBuilder. זוהי שיטה נוחה להגדרת טבלת הנתונים בלי שתצטרכו לקרוא ל-build().

פרמטרים

שםסוגתיאור
tableBuilderDataTableBuilderכלי לבניית טבלאות נתונים טבלת נתונים חדשה נוצרת באופן מיידי כחלק כך שעדכונים נוספים ב-builder לא יבואו לידי ביטוי בתרשים.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


setDataTable(table)

מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים, ואת התוויות של ציר ה-X. העמודה הראשונה צריכה להיות מחרוזת ולהכיל את התוויות של הציר האופקי. כל מספר של עמודות יכולים לעקוב, וכולם חייבים להיות מספריים. כל עמודה מוצגת כשורה נפרדת.

פרמטרים

שםסוגתיאור
tableDataTableSourceטבלת הנתונים שבה ייעשה שימוש עבור התרשים.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


setDataViewDefinition(dataViewDefinition)

מגדיר את ההגדרה של תצוגת הנתונים שתשמש את התרשים.

פרמטרים

שםסוגתיאור
dataViewDefinitionDataViewDefinitionאובייקט של הגדרה של תצוגת נתונים שמגדיר את התצוגה שאמורה להיות נגזר ממקור הנתונים הנתון של שרטוט התרשים.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


setDimensions(width, height)

מגדיר את המימדים של התרשים.

פרמטרים

שםסוגתיאור
widthIntegerרוחב התרשים, בפיקסלים.
heightIntegerגובה התרשים, בפיקסלים.

חזרה

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);

פרמטרים

שםסוגתיאור
numberIntegerמספר השורה של השורה הראשונה בטבלת הנתונים.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


setInitialSortingAscending(column)

מגדיר את האינדקס של העמודה לפיו צריך למיין את הטבלה בהתחלה (בסדר עולה).

העמודה 'מערכת ההפעלה' ממוינת בסדר עולה ומסומנת בחץ קטן שמציין זאת.

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

פרמטרים

שםסוגתיאור
columnIntegerמספר העמודה שלפיה צריך למיין את הטבלה בהתחלה.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


setInitialSortingDescending(column)

מגדיר את האינדקס של העמודה לפיו צריך למיין את הטבלה בהתחלה (בסדר יורד).

העמודה 'מערכת ההפעלה' ממוינת בסדר יורד ומסומנת בחץ קטן שמציין זאת.

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

פרמטרים

שםסוגתיאור
columnIntegerמספר העמודה שלפיה צריך למיין את הטבלה בהתחלה.

חזרה

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();

פרמטרים

שםסוגתיאור
optionStringהאפשרות להגדיר.
valueObjectהערך שיש להגדיר.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


showRowNumberColumn(showRowNumber)

ההגדרה קובעת אם להציג את מספר השורה כעמודה הראשונה בטבלה.

התנהגות ברירת המחדל לא מציגה מספרי שורות.

פרמטרים

שםסוגתיאור
showRowNumberBooleantrue אם בעמודה הראשונה של הטבלה צריך להופיע מספר השורה, אחרת, false.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.


useAlternatingRowStyle(alternate)

ההגדרה קובעת אם סגנון הצבעים המתחלפים מוקצה לשורות אי-זוגיות וזוגיות בתרשים טבלה.

התנהגות ברירת המחדל היא שהשורות עם סגנון של צבעים מתחלפים.

פרמטרים

שםסוגתיאור
alternateBooleantrue אם סגנונות הצבעים צריכים להיות מתחלפים, false אחרת.

חזרה

TableChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.