כלי ליצירת תרשימי עמודות. פרטים נוספים זמינים ב מסמכי העזרה של Gviz.
Methods
מסמכים מפורטים
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 הזה, לשרשור
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 הזה, לשרשור
reverse Categories()
היפוך כיוון הציור של הסדרות בציר הדומיין. בתרשימים עם טווח אנכי (כמו תרשימי קו, תרשימי שטח או תרשימי עמודות), המשמעות היא שהציר האנכי מצויר מימין לשמאל. בתרשימים עם טווח אופקי (כמו תרשימי עמודות), המשמעות היא שהציר האנכי מצויר מלמעלה למטה. בתרשים עוגה, המשמעות היא שהפלחים מצוירים נגד כיוון השעון.
// Creates a pie chart builder and sets drawing of the slices in a // counter-clockwise manner. const builder = Charts.newPieChart(); builder.reverseCategories();
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set Background Color(cssValue)
הגדרת צבע הרקע של התרשים.
// Creates a line chart builder and sets the background color to gray const builder = Charts.newLineChart(); builder.setBackgroundColor('gray');
פרמטרים
שם | סוג | תיאור |
---|---|---|
css | String | ערך ה-CSS של הצבע (למשל "blue" או "#00f" ). |
חזרה
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 Colors(cssValues)
הגדרת הצבעים של השורות בתרשים.
// Creates a line chart builder and sets the first two lines to be drawn in // green and red, respectively. const builder = Charts.newLineChart(); builder.setColors(['green', 'red']);
פרמטרים
שם | סוג | תיאור |
---|---|---|
css | String[] | מערך של ערכי CSS של צבעים, כמו ["red", "#acf"] . האלמנט ה-n במערך מייצג את הצבע של הקו ה-n בתרשים. |
חזרה
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 Legend Position(position)
הגדרת המיקום של המקרא ביחס לתרשים. כברירת מחדל, אין שם תרשים.
// Creates a line chart builder and sets the legend position to right. const builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
פרמטרים
שם | סוג | תיאור |
---|---|---|
position | Position | המיקום של המקרא. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set Legend Text Style(textStyle)
הגדרת סגנון הטקסט של המיתוג של התרשים.
// Creates a line chart builder and sets it up for a blue, 26-point legend. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setLegendTextStyle(style);
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | Text | סגנון הטקסט שישמש את כותרת התרשים. |
חזרה
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 Range(start, end)
הגדרת הטווח של התרשים.
אם נקודות נתונים מסוימות יוצאות מהטווח, הטווח יתרחב כך שיכלול את נקודות הנתונים האלה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
start | Number | הערך של קו התא של הציר 'טווח' הנמוך ביותר. |
end | Number | הערך של קו התאמה הכי גבוה בציר הטווח. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set Stacked()
נעשה שימוש בקווים מוערמים, כלומר ערכי הקווים והעמודות מוערמים (מקובצים). כברירת מחדל, אין צבירה.
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set Title(chartTitle)
הגדרת כותרת התרשים. הכותרת מוצגת במרכז מעל התרשים.
// Creates a line chart builder and title to 'My Line Chart'. const builder = Charts.newLineChart(); builder.setTitle('My Line Chart');
פרמטרים
שם | סוג | תיאור |
---|---|---|
chart | String | כותרת התרשים. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set TitleTextStyle(textStyle)
הגדרת סגנון הטקסט של שם התרשים.
// Creates a line chart builder and sets it up for a blue, 26-point title. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setTitleTextStyle(style);
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | Text | סגנון הטקסט לשימוש בכותרת התרשים. אפשר ליצור אובייקט Text באמצעות קריאה ל-Charts.newTextStyle() . |
חזרה
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 הזה, לשרשור
set XAxis Text Style(textStyle)
הגדרת סגנון הטקסט של הציר האופקי.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTextStyle(textStyle);
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | Text | סגנון הטקסט שישמש לכותרת של הציר האופקי. אפשר ליצור אובייקט Text באמצעות קריאה ל-Charts.newTextStyle() . |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set XAxis Title(title)
הוספת כותרת לציר האופקי. הכותרת ממוקמת במרכז ומופיעה מתחת לתוויות של ערכי הצירים.
// Creates a line chart builder and sets the X-axis title. const builder = Charts.newLineChart(); builder.setTitle('X-axis Title');
פרמטרים
שם | סוג | תיאור |
---|---|---|
title | String | הכותרת של ציר ה-X. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set XAxis TitleTextStyle(textStyle)
הגדרת סגנון הטקסט של הכותרת של הציר האופקי.
// Creates a line chart builder and sets the X-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTitleTextStyle(textStyle);
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | Text | סגנון הטקסט שישמש לכותרת של הציר האופקי. אפשר ליצור אובייקט Text באמצעות קריאה ל-Charts.newTextStyle() . |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set YAxis Text Style(textStyle)
הגדרת סגנון הטקסט של הציר האנכי.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTextStyle(textStyle);
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | Text | סגנון הטקסט שישמש לכותרת של הציר האופקי. אפשר ליצור אובייקט Text באמצעות קריאה ל-Charts.newTextStyle() . |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set YAxis Title(title)
הוספת כותרת לציר האנכי. הכותרת ממוקמת במרכז ומופיעה מימין לתוויות הערכים.
// Creates a line chart builder and sets the Y-axis title. const builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title');
פרמטרים
שם | סוג | תיאור |
---|---|---|
title | String | הכותרת של ציר ה-Y. |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
set YAxis TitleTextStyle(textStyle)
הגדרת סגנון הטקסט של הכותרת של הציר האנכי.
// Creates a line chart builder and sets the Y-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTitleTextStyle(textStyle);
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | Text | סגנון הטקסט שישמש לכותרת של הציר האופקי. אפשר ליצור אובייקט Text באמצעות קריאה ל-Charts.newTextStyle() . |
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.
use Log Scale()
הופכת את ציר הטווח לסולם לוגריתמי (כל הערכים צריכים להיות חיוביים). ציר הטווח הוא הציר האנכי בתרשימים אנכיים (כמו תרשים קו, תרשים שטח או תרשים עמודות) והציר האופקית בתרשימים אופקיים (כמו תרשים עמודות).
חזרה
Embedded
— ה-builder הזה שימושי לשרשור.