כלי ליצירת תרשימים מסוג טבלה. פרטים נוספים זמינים במסמכי העזרה של Gviz.
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
add | Embedded | הוספת טווח לתרשים שהכלי הזה משנה. |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-AreaChart ומחזירה Embedded . |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-BarChart ומחזירה Embedded . |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-ColumnChart ומחזירה Embedded . |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-ComboChart ומחזירה Embedded . |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-HistogramChart ומחזירה Embedded . |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-LineChart ומחזירה Embedded . |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-PieChart ומחזירה Embedded . |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-ScatterChart ומחזירה Embedded . |
as | Embedded | הפונקציה מגדירה את סוג התרשים כ-TableChart ומחזירה Embedded . |
build() | Embedded | יצירת התרשים כך שישקף את כל השינויים שבוצעו בו. |
clear | Embedded | הסרת כל הטווחים מהתרשים שה-builder הזה משנה. |
enable | Embedded | ההגדרה קובעת אם להפעיל דפדוף בנתונים. |
enable | Embedded | הפעלת דפים והגדרת מספר השורות בכל דף. |
enable | Embedded | הפונקציה מפעילה דפדוף, מגדירה את מספר השורות בכל דף ואת דף הטבלה הראשון שיוצג (מספרי הדפים מתחילים באפס). |
enable | Embedded | הוספת תמיכה בסיסית בשפות שמנוקדות מימין לשמאל (כמו ערבית או עברית) על ידי היפוך סדר העמודות בטבלה, כך שעמודה אפס היא העמודה הכי ימנית והעמודה האחרונה היא העמודה הכי שמאלית. |
enable | Embedded | קובע אם למיין את העמודות כשהמשתמש לוחץ על כותרת עמודה. |
get | Chart | הפונקציה מחזירה את סוג התרשים הנוכחי. |
get | Container | החזרת התרשים Container , שמכיל את המיקום שבו התרשים מופיע בגיליון. |
get | Range[] | הפונקציה מחזירה עותק של רשימת הטווחים שמספקים נתונים לתרשים הזה כרגע. |
remove | Embedded | הסרת הטווח שצוין מהתרשים שה-builder הזה משנה. |
set | Embedded | שינוי סוג התרשים. |
set | Embedded | הגדרת מספר השורה של השורה הראשונה בטבלת הנתונים. |
set | Embedded | הגדרת האסטרטגיה לשימוש בשורות ובעמודות מוסתרות. |
set | Embedded | הגדרת האינדקס של העמודה לפיה צריך למיין את הטבלה בשלב הראשון (במצב עולה). |
set | Embedded | הגדרת האינדקס של העמודה לפיה הטבלה צריכה להיות ממוינת בהתחלה (יורד). |
set | Embedded | הגדרת שיטת המיזוג שישמש כשיש יותר מרצועה אחת. |
set | Embedded | הגדרת מספר השורות או העמודות בטווח שצריך להתייחס אליהן ככותרות. |
set | Embedded | הגדרת אפשרויות מתקדמות לתרשים הזה. |
set | Embedded | מגדיר את המיקום של התרשים בגיליון. |
set | Embedded | קובע אם השורות והעמודות של התרשים יבוצעו טרנספוזיציה. |
show | Embedded | מגדיר אם להציג את מספר השורה כעמודה הראשונה בטבלה. |
use | Embedded | קובע אם סגנון של צבעים מתחלפים יוקצה לשורות האי-זוגיות והזוגיות של תרשים טבלה. |
מסמכים מפורטים
add Range(range)
הוספת טווח לתרשים שהכלי הזה משנה. הטווח לא יתווסף אם הוא כבר נוסף לתרשים.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
פרמטרים
שם | סוג | תיאור |
---|---|---|
range | Range | הטווח שרוצים להוסיף. |
חזרה
Embedded
– ה-builder הזה, לשרשור
as Area Chart()
הפונקציה מגדירה את סוג התרשים כ-AreaChart ומחזירה Embedded
.
חזרה
Embedded
— יצירת תרשים שטח
as Bar Chart()
הפונקציה מגדירה את סוג התרשים כ-BarChart ומחזירה Embedded
.
חזרה
Embedded
— יצירת תרשים עמודות
as Column Chart()
הפונקציה מגדירה את סוג התרשים כ-ColumnChart ומחזירה Embedded
.
חזרה
Embedded
— יצירת תרשים עמודות אנכי
as Combo Chart()
הפונקציה מגדירה את סוג התרשים כ-ComboChart ומחזירה Embedded
.
חזרה
Embedded
— יצירת תרשים משולב
as Histogram Chart()
הפונקציה מגדירה את סוג התרשים כ-HistogramChart ומחזירה Embedded
.
חזרה
Embedded
— יצירת תרשים היסטוגרמה
as Line Chart()
הפונקציה מגדירה את סוג התרשים כ-LineChart ומחזירה Embedded
.
חזרה
Embedded
— כלי ליצירת תרשים קו
as Pie Chart()
הפונקציה מגדירה את סוג התרשים כ-PieChart ומחזירה Embedded
.
חזרה
Embedded
— יצירת תרשים עוגה
as Scatter Chart()
הפונקציה מגדירה את סוג התרשים כ-ScatterChart ומחזירה Embedded
.
חזרה
Embedded
— כלי ליצירת תרשים פיזור
as Table Chart()
הפונקציה מגדירה את סוג התרשים כ-TableChart ומחזירה Embedded
.
חזרה
Embedded
– יצירת תרשים טבלה
build()
יצירת התרשים כך שישקף את כל השינויים שבוצעו בו.
השיטה הזו לא גורמת לציור אוטומטי של התרשים מעל הגיליון האלקטרוני. כדי להוסיף תרשים חדש צריך להשתמש ב-sheet.insertChart(chart)
, ולעדכן תרשים קיים באמצעות sheet.updateChart(chart)
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
חזרה
Embedded
– התרשים שנוצר, שעדיין צריך להוסיף לגיליון האלקטרוני
clear Ranges()
הסרת כל הטווחים מהתרשים שה-builder הזה משנה.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This code updates the chart to use only the new ranges while preserving the // existing formatting of the chart. const chart = sheet.getCharts()[0]; const newChart = chart.modify() .clearRanges() .addRange(sheet.getRange('A1:A5')) .addRange(sheet.getRange('B1:B5')) .build(); sheet.updateChart(newChart);
חזרה
Embedded
– ה-builder הזה, לשרשור
enable Paging(enablePaging)
ההגדרה קובעת אם להפעיל דפדוף בנתונים.
ברירת המחדל היא שהדפדוף מושבת. אם הדפדוף מופעל, גודל הדף שמוגדר כברירת מחדל הוא 10.
פרמטרים
שם | סוג | תיאור |
---|---|---|
enable | Boolean | true אם צריך להפעיל את דפדוף הדפים, false אחרת. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
enable Paging(pageSize)
הפעלת דפים והגדרת מספר השורות בכל דף.
גודל הדף שמוגדר כברירת מחדל הוא 10.
// Creates a table chart builder and enables paging with page size of 5. const builder = Charts.newTableChart(); builder.enablePaging(5);
פרמטרים
שם | סוג | תיאור |
---|---|---|
page | Integer | מספר השורות בכל דף בטבלה. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
enable Paging(pageSize, startPage)
הפונקציה מפעילה דפדוף, מגדירה את מספר השורות בכל דף ואת דף הטבלה הראשון שיוצג (מספרי הדפים מתחילים באפס).
גודל הדף שמוגדר כברירת מחדל הוא 10, ודף הפתיחה שמוגדר כברירת מחדל הוא 0.
// Creates a table chart builder and enables paging with page size of 5 and // displays page 2 first. const builder = Charts.newTableChart(); builder.enablePaging(5, 2);
פרמטרים
שם | סוג | תיאור |
---|---|---|
page | Integer | מספר השורות בכל דף בטבלה. |
start | Integer | דף הטבלה הראשון שיוצג (מספרי הדפים מתחילים באפס). |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
enable Rtl Table(rtlEnabled)
הוספת תמיכה בסיסית בשפות שמנוקדות מימין לשמאל (כמו ערבית או עברית) על ידי היפוך סדר העמודות בטבלה, כך שעמודה אפס היא העמודה הכי ימנית והעמודה האחרונה היא העמודה הכי שמאלית.
הפעולה הזו לא משפיעה על אינדקס העמודה בנתונים הבסיסיים, אלא רק על סדר התצוגה. גם עם האפשרות הזו, התצוגה החזותית של הטבלה לא תומכת בתצוגה מלאה של שפות דו-כיווניות (BiDi). המערכת תתעלם מהאפשרות הזו אם תפעילו דפים (באמצעות האפשרות 'דף'), או אם לטבלה יש סרגל גלילה כי ציינת אפשרויות גובה ורוחב קטנות יותר מגודל הטבלה הנדרש. ברירת המחדל היא שהתמיכה ב-RTL מושבתת.
פרמטרים
שם | סוג | תיאור |
---|---|---|
rtl | Boolean | true אם צריך להפעיל תמיכה בקריאה מימין לשמאל, false
אחרת. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
enable Sorting(enableSorting)
קובע אם למיין את העמודות כשהמשתמש לוחץ על כותרת עמודה.
אם מפעילים את המיון, כשמשתמשים לוחצים על כותרת העמודה, השורות ממוינות באופן אוטומטי. ברירת המחדל היא שהמיון מופעל.
פרמטרים
שם | סוג | תיאור |
---|---|---|
enable | Boolean | true כדי להפעיל מיון בלחיצה על כותרות העמודות, false אחרת. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
get Chart Type()
get Container()
החזרת התרשים Container
, שמכיל את המיקום שבו התרשים מופיע בגיליון.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0); // This method returns the exact same data as Chart#getContainerInfo() const containerInfo = chartBuilder.getContainer(); // Logs the values used in setPosition() Logger.log( 'Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s', containerInfo.getAnchorColumn(), containerInfo.getAnchorRow(), containerInfo.getOffsetX(), containerInfo.getOffsetY(), );
חזרה
Container
– אובייקט שמכיל את המיקום של מאגר התרשימים
get Ranges()
הפונקציה מחזירה עותק של רשימת הטווחים שמספקים נתונים לתרשים הזה כרגע. משתמשים ב-add
וב-remove
כדי לשנות את הרשימה הזו.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B8')) .setPosition(5, 5, 0, 0); const ranges = chartBuilder.getRanges(); // There's only one range as a data source for this chart, // so this logs "A1:B8" for (const i in ranges) { const range = ranges[i]; Logger.log(range.getA1Notation()); }
חזרה
Range[]
– מערך של טווחים שמשמש כמקור הנתונים של התרשים שייבנה
remove Range(range)
הסרת הטווח שצוין מהתרשים שה-builder הזה משנה. לא תקפיץ הודעת שגיאה אם הטווח לא מופיע בתרשים הזה.
הטווח שהוסרו צריך להתאים לטווח שנוסף באמצעות add
. אחרת, לא יבוצע שינוי בתרשים. אי אפשר להשתמש בשיטה הזו כדי להסיר ערכים באופן חלקי מטווח.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const firstRange = sheet.getRange('A1:B5'); const secondRange = sheet.getRange('A6:B8'); const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(firstRange) // This range will render in a different color .addRange(secondRange) .setPosition(5, 5, 0, 0); // Note that you can use either of these two formats, but the range // MUST match up with a range that was added via addRange(), or it // will not be removed, and will not throw an exception chartBuilder.removeRange(firstRange); chartBuilder.removeRange(sheet.getRange('A6:B8')); const chart = chartBuilder.build(); sheet.insertChart(chart);
פרמטרים
שם | סוג | תיאור |
---|---|---|
range | Range | הטווח להסרה. |
חזרה
Embedded
– ה-builder הזה, לשרשור
set Chart Type(type)
שינוי סוג התרשים. בשלב זה, אין תמיכה בכל סוגי התרשימים המוטמעים. Chart
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
פרמטרים
שם | סוג | תיאור |
---|---|---|
type | Chart | הסוג שאליו רוצים לשנות את התרשים. |
חזרה
Embedded
– ה-builder הזה, לשרשור
set First Row Number(number)
הגדרת מספר השורה של השורה הראשונה בטבלת הנתונים.
מספר השורה שמוגדר כברירת מחדל לשורה הראשונה הוא 1.
// Creates a table chart builder and sets the first row to be 2. const builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
פרמטרים
שם | סוג | תיאור |
---|---|---|
number | Integer | מספר השורה של השורה הראשונה בטבלת הנתונים. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set Hidden Dimension Strategy(strategy)
הגדרת האסטרטגיה לשימוש בשורות ובעמודות מוסתרות. ברירת המחדל היא IGNORE_ROWS
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setHiddenDimensionStrategy( Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS, ) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
פרמטרים
שם | סוג | תיאור |
---|---|---|
strategy | Chart | האסטרטגיה לשימוש בשורות ובעמודות מוסתרות. |
חזרה
Embedded
– ה-builder הזה, לשרשור
set Initial Sorting Ascending(column)
הגדרת האינדקס של העמודה לפיה צריך למיין את הטבלה בשלב הראשון (במצב עולה).
העמודה ממוינת בסדר עולה ומסומנת בחץ קטן שמציין זאת.
// Creates a table chart builder and sorts it by the second column (ascending). const builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
פרמטרים
שם | סוג | תיאור |
---|---|---|
column | Integer | מספר העמודה לפיה צריך למיין את הטבלה בשלב הראשון. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set Initial Sorting Descending(column)
הגדרת האינדקס של העמודה לפיה הטבלה צריכה להיות ממוינת בהתחלה (יורד).
העמודה ממוינת בסדר יורד ומסומנת בחץ קטן שמציין זאת.
// Creates a table chart builder and sorts it by the second column (descending). const builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
פרמטרים
שם | סוג | תיאור |
---|---|---|
column | Integer | מספר העמודה לפיה צריך למיין את הטבלה בשלב הראשון. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set Merge Strategy(mergeStrategy)
הגדרת שיטת המיזוג שישמש כשיש יותר מרצועה אחת. אם הערך הוא MERGE_ROWS
, מתבצע מיזוג של שורות. אם הערך הוא MERGE_COLUMNS
, מתבצע מיזוג של עמודות. ברירת המחדל היא MERGE_COLUMNS
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B10'); const range2 = sheet.getRange('C:C10'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
פרמטרים
שם | סוג | תיאור |
---|---|---|
merge | Chart | שיטת המיזוג שבה רוצים להשתמש. |
חזרה
Embedded
– ה-builder הזה, לשרשור
set Num Headers(headers)
הגדרת מספר השורות או העמודות בטווח שצריך להתייחס אליהן ככותרות.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setNumHeaders(1) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
פרמטרים
שם | סוג | תיאור |
---|---|---|
headers | Integer | מספר השורות או העמודות שיש להתייחס אליהן ככותרות. ערכים שליליים יגרמו לזיהוי אוטומטי של כותרות. |
חזרה
Embedded
– ה-builder הזה, לשרשור
set Option(option, value)
הגדרת אפשרויות מתקדמות לתרשים הזה. רשימת האפשרויות הזמינות מפורטת במאמר אפשרויות הגדרה של תרשימים.
השיטה הזו לא מאמתת שהאפשרות שציינתם תקפה לסוג התרשים הזה, או שהערך בפורמט או במבנה הנכון.
בדוגמה הזו מוסבר איך לשנות את הכותרת ולהגדיר כותרת משנה.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const sheet = spreadsheet.getSheets()[0]; const chart = sheet.newChart() .setOption('title', 'Earnings projections') .setOption('legend', { position: 'top', textStyle: { color: 'blue', fontSize: 16 }, }).build();
פרמטרים
שם | סוג | תיאור |
---|---|---|
option | String | שם האפשרות. |
value | Object | הערך של האפשרות. |
חזרה
Embedded
– ה-builder הזה, לשרשור.
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
מגדיר את המיקום של התרשים בגיליון. הערכים anchor
ו-anchor
מתחילים ב-1.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
פרמטרים
שם | סוג | תיאור |
---|---|---|
anchor | Integer | הצד העליון של התרשים מוצמדת לשורה הזו. |
anchor | Integer | הצד השמאלי של התרשים מקובע בעמודה הזו. |
offsetX | Integer | הפינה השמאלית העליונה של התרשים מוסטת באותו מספר פיקסלים. |
offsetY | Integer | הפינה הימנית התחתונה של התרשים מוסטת באותו מספר פיקסלים. |
חזרה
Embedded
– ה-builder הזה, לשרשור
set Transpose Rows And Columns(transpose)
קובע אם השורות והעמודות של התרשים יבוצעו טרנספוזיציה. אם הערך מוגדר ל-true
, השורות והעמודות מוחלפות. ברירת המחדל היא false
.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B5'); const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build(); sheet.insertChart(chart);
פרמטרים
שם | סוג | תיאור |
---|---|---|
transpose | Boolean | אם הערך של true הוא 1, השורות והעמודות שמשמשות ליצירת התרשים מועברות למבנה 'אלכסוני'. |
חזרה
Embedded
– ה-builder הזה, לשרשור
show Row Number Column(showRowNumber)
מגדיר אם להציג את מספר השורה כעמודה הראשונה בטבלה.
ברירת המחדל היא לא להציג את מספרי השורות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
show | Boolean | true אם מספר השורה צריך להופיע בעמודה הראשונה של הטבלה,
false אחרת. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
use Alternating Row Style(alternate)
קובע אם סגנון של צבעים מתחלפים יוקצה לשורות האי-זוגיות והזוגיות של תרשים טבלה.
ברירת המחדל היא שהשורות יהיו בסגנון צבע לסירוגין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
alternate | Boolean | true אם סגנונות הצבעים צריכים להיות לסירוגין, false אחרת. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.