דף זה תורגם על ידי Cloud Translation API.

Class BarChartBuilder

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

הנה דוגמה שממחישה איך ליצור תרשים עמודות. הנתונים מיובאים מגיליון אלקטרוני של Google.

 // Get sample data from a spreadsheet.
 var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=B1%3AC11' +
     '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=0&headers=-1';

 var chartBuilder = Charts.newBarChart()
     .setTitle('Top Grossing Films in US and Canada')
     .setXAxisTitle('USD')
     .setYAxisTitle('Film')
     .setDimensions(600, 500)
     .setLegendPosition(Charts.Position.BOTTOM)
     .setDataSourceUrl(dataSourceUrl);

 var chart = chartBuilder.build();

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`build()`	`Chart`	בונה את התרשים.
`reverseCategories()`	`BarChartBuilder`	הופכת את ציור הסדרות בציר הדומיין.
`reverseDirection()`	`BarChartBuilder`	הופכת את הכיוון שבו העמודות גדלות לאורך הציר האופקי.
`setBackgroundColor(cssValue)`	`BarChartBuilder`	הגדרת צבע הרקע של התרשים.
`setColors(cssValues)`	`BarChartBuilder`	הגדרת צבעי הקווים בתרשים.
`setDataSourceUrl(url)`	`BarChartBuilder`	מגדירה את כתובת ה-URL של מקור הנתונים לצורך שליפת נתונים ממקור חיצוני, כמו Google Sheets.
`setDataTable(tableBuilder)`	`BarChartBuilder`	מגדיר את טבלת הנתונים לשימוש בתרשים באמצעות DataTableBuilder.
`setDataTable(table)`	`BarChartBuilder`	מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים ואת התוויות של ציר ה-X.
`setDataViewDefinition(dataViewDefinition)`	`BarChartBuilder`	מגדיר את ההגדרה של תצוגת הנתונים לשימוש בתרשים.
`setDimensions(width, height)`	`BarChartBuilder`	מגדיר את מידות התרשים.
`setLegendPosition(position)`	`BarChartBuilder`	הגדרת המיקום של המקרא ביחס לתרשים.
`setLegendTextStyle(textStyle)`	`BarChartBuilder`	הגדרת סגנון הטקסט במקרא של התרשים.
`setOption(option, value)`	`BarChartBuilder`	מגדיר אפשרויות מתקדמות לתרשים הזה.
`setRange(start, end)`	`BarChartBuilder`	הגדרת הטווח של התרשים.
`setStacked()`	`BarChartBuilder`	הפונקציה משתמשת בקווים מוערם, כלומר שערכי הקו והעמודות מוערם (נצברים).
`setTitle(chartTitle)`	`BarChartBuilder`	הגדרת כותרת התרשים.
`setTitleTextStyle(textStyle)`	`BarChartBuilder`	הגדרת סגנון הטקסט של כותרת התרשים.
`setXAxisTextStyle(textStyle)`	`BarChartBuilder`	מגדיר את סגנון הטקסט של הציר האופקי.
`setXAxisTitle(title)`	`BarChartBuilder`	הוספת כותרת לציר האופקי.
`setXAxisTitleTextStyle(textStyle)`	`BarChartBuilder`	מגדיר את סגנון הטקסט של הכותרת בציר האופקי.
`setYAxisTextStyle(textStyle)`	`BarChartBuilder`	מגדיר את סגנון הטקסט של הציר האנכי.
`setYAxisTitle(title)`	`BarChartBuilder`	הוספת כותרת לציר האנכי.
`setYAxisTitleTextStyle(textStyle)`	`BarChartBuilder`	מגדיר את סגנון הטקסט של הכותרת בציר האנכי.
`useLogScale()`	`BarChartBuilder`	הופכת את ציר הטווח לקנה מידה לוגריתמי (מחייב שכל הערכים יהיו חיוביים).

תיעוד מפורט

`build()`

בונה את התרשים.

החזרות

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

`reverseCategories()`

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

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`reverseDirection()`

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

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setBackgroundColor(cssValue)`

הגדרת צבע הרקע של התרשים.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

פרמטרים

שם	תיאור	התיאור
`cssValue`	`String`	ערך ה-CSS של הצבע (למשל `"blue"` או `"#00f"`).

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setColors(cssValues)`

הגדרת צבעי הקווים בתרשים.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

פרמטרים

שם	תיאור	התיאור
`cssValues`	`String[]`	מערך של ערכי CSS של צבע, כמו `["red", "#acf"]`. רכיב ה-n במערך מייצג את הצבע של קו ה-n בתרשים.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setDataSourceUrl(url)`

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

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

פרמטרים

שם	תיאור	התיאור
`url`	`String`	כתובת ה-URL של מקור הנתונים, כולל הפרמטרים של השאילתה.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setDataTable(tableBuilder)`

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

פרמטרים

שם	תיאור	התיאור
`tableBuilder`	`DataTableBuilder`	כלי לבניית טבלאות נתונים. טבלת נתונים חדשה נוצרת באופן מיידי כחלק מהקריאה הזו, כך שעדכונים נוספים בכלי לא יופיעו בתרשים.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setDataTable(table)`

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

פרמטרים

שם	תיאור	התיאור
`table`	`DataTableSource`	טבלת הנתונים לשימוש בתרשים.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setDataViewDefinition(dataViewDefinition)`

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

פרמטרים

שם	תיאור	התיאור
`dataViewDefinition`	`DataViewDefinition`	אובייקט של הגדרה של תצוגת נתונים, שמגדיר את התצוגה שאמורה להיות נגזרת ממקור הנתונים הנתון לשרטוט התרשים.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setDimensions(width, height)`

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

פרמטרים

שם	תיאור	התיאור
`width`	`Integer`	רוחב התרשים, בפיקסלים.
`height`	`Integer`	גובה התרשים, בפיקסלים.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setLegendPosition(position)`

הגדרת המיקום של המקרא ביחס לתרשים. כברירת מחדל, אין מקרא.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

פרמטרים

שם	תיאור	התיאור
`position`	`Position`	המיקום של המקרא.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setLegendTextStyle(textStyle)`

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

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

פרמטרים

שם	תיאור	התיאור
`textStyle`	`TextStyle`	סגנון הטקסט לשימוש במקרא של התרשים.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setOption(option, value)`

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

// Build a bar chart with a 1-second animation duration.
var builder = Charts.newBarChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

פרמטרים

שם	תיאור	התיאור
`option`	`String`	אפשרות ההגדרה.
`value`	`Object`	הערך שיש להגדיר.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setRange(start, end)`

הגדרת הטווח של התרשים.

אם נקודות נתונים כלשהן נמצאות מחוץ לטווח, הטווח מורחב כך שיכלול את הנקודות האלה.

פרמטרים

שם	תיאור	התיאור
`start`	`Number`	הערך של קו הרשת הנמוך ביותר של ציר הטווח.
`end`	`Number`	הערך של קו הרשת הגבוה ביותר בציר הטווח.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setStacked()`

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

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setTitle(chartTitle)`

הגדרת כותרת התרשים. הכותרת מוצגת במרכז התרשים.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

פרמטרים

שם	תיאור	התיאור
`chartTitle`	`String`	את כותרת התרשים.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setTitleTextStyle(textStyle)`

הגדרת סגנון הטקסט של כותרת התרשים.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

פרמטרים

שם	תיאור	התיאור
`textStyle`	`TextStyle`	סגנון הטקסט שישמש לכותרת התרשים. ניתן ליצור אובייקט `TextStyleBuilder` על ידי קריאה ל-`Charts.newTextStyle()`.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setXAxisTextStyle(textStyle)`

מגדיר את סגנון הטקסט של הציר האופקי.

// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

פרמטרים

שם	תיאור	התיאור
`textStyle`	`TextStyle`	סגנון הטקסט לשימוש בכותרת של הציר האופקי. ניתן ליצור אובייקט `TextStyleBuilder` על ידי קריאה ל-`Charts.newTextStyle()`.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setXAxisTitle(title)`

הוספת כותרת לציר האופקי. הכותרת ממורכזת ומופיעה מתחת לתוויות הערך של הציר.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

פרמטרים

שם	תיאור	התיאור
`title`	`String`	הכותרת של ציר ה-X.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setXAxisTitleTextStyle(textStyle)`

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

// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

פרמטרים

שם	תיאור	התיאור
`textStyle`	`TextStyle`	סגנון הטקסט לשימוש בכותרת של הציר האופקי. ניתן ליצור אובייקט `TextStyleBuilder` על ידי קריאה ל-`Charts.newTextStyle()`.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setYAxisTextStyle(textStyle)`

מגדיר את סגנון הטקסט של הציר האנכי.

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

פרמטרים

שם	תיאור	התיאור
`textStyle`	`TextStyle`	סגנון הטקסט לשימוש בכותרת של הציר האופקי. ניתן ליצור אובייקט `TextStyleBuilder` על ידי קריאה ל-`Charts.newTextStyle()`.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setYAxisTitle(title)`

הוספת כותרת לציר האנכי. הכותרת ממורכזת ומופיעה מימין לתוויות הערכים.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

פרמטרים

שם	תיאור	התיאור
`title`	`String`	הכותרת של ציר ה-Y.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`setYAxisTitleTextStyle(textStyle)`

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

// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

פרמטרים

שם	תיאור	התיאור
`textStyle`	`TextStyle`	סגנון הטקסט לשימוש בכותרת של הציר האופקי. ניתן ליצור אובייקט `TextStyleBuilder` על ידי קריאה ל-`Charts.newTextStyle()`.

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.

`useLogScale()`

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

החזרות

BarChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.