Narzędzie do tworzenia wykresów liniowych. Więcej informacji znajdziesz w dokumentacji Wykresów Google.
Oto przykład, który pokazuje, jak utworzyć wykres liniowy. Dane są zaimportowane z arkusza kalkulacyjnego Google.
// Get sample data from a spreadsheet. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AG5' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=2&headers=-1'; var chartBuilder = Charts.newLineChart() .setTitle('Yearly Rainfall') .setXAxisTitle('Month') .setYAxisTitle('Rainfall (in)') .setDimensions(600, 500) .setCurveStyle(Charts.CurveStyle.SMOOTH) .setPointStyle(Charts.PointStyle.MEDIUM) .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | Chart | Tworzy wykres. |
reverseCategories() | LineChartBuilder | Odwraca rysowanie serii na osi domeny. |
setBackgroundColor(cssValue) | LineChartBuilder | Ustawia kolor tła wykresu. |
setColors(cssValues) | LineChartBuilder | Ustawia kolory linii na wykresie. |
setCurveStyle(style) | LineChartBuilder | Określa styl, który będzie używany w przypadku krzywych na wykresie. |
setDataSourceUrl(url) | LineChartBuilder | Ustawia adres URL źródła danych, które jest używane do pobierania danych ze źródła zewnętrznego, np. Google Arkusze. |
setDataTable(tableBuilder) | LineChartBuilder | Konfiguruje tabelę danych, która ma być używana na potrzeby wykresu, za pomocą DataTableBuilder. |
setDataTable(table) | LineChartBuilder | Ustawia tabelę danych, która zawiera linie wykresu, a także etykiety osi X. |
setDataViewDefinition(dataViewDefinition) | LineChartBuilder | Określa definicję widoku danych, która będzie używana na wykresie. |
setDimensions(width, height) | LineChartBuilder | Ustawia wymiary wykresu. |
setLegendPosition(position) | LineChartBuilder | Określa pozycję legendy względem wykresu. |
setLegendTextStyle(textStyle) | LineChartBuilder | Określa styl tekstu legendy wykresu. |
setOption(option, value) | LineChartBuilder | Określa zaawansowane opcje tego wykresu. |
setPointStyle(style) | LineChartBuilder | Określa styl punktów na linii. |
setRange(start, end) | LineChartBuilder | Określa zakres wykresu. |
setTitle(chartTitle) | LineChartBuilder | Określa tytuł wykresu. |
setTitleTextStyle(textStyle) | LineChartBuilder | Określa styl tekstu tytułu wykresu. |
setXAxisTextStyle(textStyle) | LineChartBuilder | Określa styl tekstu osi poziomej. |
setXAxisTitle(title) | LineChartBuilder | Dodaje tytuł do osi poziomej. |
setXAxisTitleTextStyle(textStyle) | LineChartBuilder | Określa styl tekstu tytułu na osi poziomej. |
setYAxisTextStyle(textStyle) | LineChartBuilder | Określa styl tekstu osi pionowej. |
setYAxisTitle(title) | LineChartBuilder | Dodaje tytuł do osi pionowej. |
setYAxisTitleTextStyle(textStyle) | LineChartBuilder | Określa styl tekstu tytułu osi pionowej. |
useLogScale() | LineChartBuilder | Przekształca oś zakresu w skalę logarytmiczną (wszystkie wartości muszą być dodatnie). |
Szczegółowa dokumentacja
build()
Tworzy wykres.
Powrót
Chart
– obiekt Chart, który można umieszczać w dokumentach i elementach interfejsu albo używać jako statyczny
.
reverseCategories()
Odwraca rysowanie serii na osi domeny. Na wykresach pionowych (np. liniowych, wykresów warstwowych lub kolumnowych), oznacza to, że oś pozioma jest rysowana od prawej do lewej. Dla: na wykresach poziomych (np. słupkowych) oznacza to, że oś pionowa jest rysowana od góry do dołu. w dół. W przypadku wykresów kołowych wycinki są rysowane w lewo.
// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner. var builder = Charts.newPieChart(); builder.reverseCategories();
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setBackgroundColor(cssValue)
Ustawia kolor tła wykresu.
// Creates a line chart builder and sets the background color to gray var builder = Charts.newLineChart(); builder.setBackgroundColor("gray");
Parametry
Nazwa | Typ | Opis |
---|---|---|
cssValue | String | Wartość CSS koloru (np. "blue" lub "#00f" ). |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setColors(cssValues)
Ustawia kolory linii na wykresie.
// 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"]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
cssValues | String[] | Tablica wartości CSS koloru, np. ["red", "#acf"] . N-ty element
wskazuje kolor n-tej linii na wykresie. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setCurveStyle(style)
Określa styl, który będzie używany w przypadku krzywych na wykresie. Informacje o dozwolonej krzywej znajdziesz tutaj: CurveStyle
stylów.
// Creates a line chart builder and curves the lines in the chart. var builder = Charts.newLineChart(); builder.setCurveStyle(Charts.CurveStyle.SMOOTH)
Parametry
Nazwa | Typ | Opis |
---|---|---|
style | CurveStyle | Styl krzywych na wykresie. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
Zobacz też
setDataSourceUrl(url)
Ustawia adres URL źródła danych, które jest używane do pobierania danych ze źródła zewnętrznego, np. Google Arkusze. Jeśli podany jest URL źródła danych i tabela DataTable, adres URL źródła danych jest ignorowany.
Więcej informacji o wysyłaniu zapytań dotyczących źródeł danych znajdziesz w dokumentacji Wykresów Google.
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL źródła danych wraz ze wszystkimi parametrami zapytania. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setDataTable(tableBuilder)
Konfiguruje tabelę danych, która ma być używana na potrzeby wykresu, za pomocą DataTableBuilder. Jest to wygodna metoda
do ustawienia tabeli danych bez konieczności wywoływania funkcji build()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
tableBuilder | DataTableBuilder | Kreator tabel danych. W ramach tego parametru natychmiast jest tworzona nowa tabela danych , więc dalsze aktualizacje narzędzia nie zostaną odzwierciedlone na wykresie. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setDataTable(table)
Ustawia tabelę danych, która zawiera linie wykresu, a także etykiety osi X. pierwsza kolumna powinna być ciągiem znaków i zawierać etykiety osi poziomej. Dowolna liczba kolumn po których może następować, wszystkie muszą mieć wartości liczbowe. Każda kolumna jest wyświetlana jako osobna linia.
Parametry
Nazwa | Typ | Opis |
---|---|---|
table | DataTableSource | Tabela danych, która ma być używana na wykresie. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setDataViewDefinition(dataViewDefinition)
Określa definicję widoku danych, która będzie używana na wykresie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
dataViewDefinition | DataViewDefinition | Obiekt definicji widoku danych, który określa widok, który powinien być na podstawie podanego źródła danych na potrzeby rysunku. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setDimensions(width, height)
Ustawia wymiary wykresu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
width | Integer | Szerokość wykresu w pikselach. |
height | Integer | Wysokość wykresu w pikselach. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setLegendPosition(position)
Określa pozycję legendy względem wykresu. Domyślnie nie ma legendy.
// Creates a line chart builder and sets the legend position to right. var builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
Parametry
Nazwa | Typ | Opis |
---|---|---|
position | Position | Pozycja legendy. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setLegendTextStyle(textStyle)
Określa styl tekstu legendy wykresu.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
textStyle | TextStyle | Styl tekstu, który będzie używany w legendzie wykresu. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setOption(option, value)
Określa zaawansowane opcje tego wykresu. Zobacz dostępne opcje ten wykres. Ta metoda nie działa, jeśli dana opcja jest nieprawidłowa.
// Build a line chart with a 1-second animation duration. var builder = Charts.newLineChart(); builder.setOption('animation.duration', 1000); var chart = builder.build();
Parametry
Nazwa | Typ | Opis |
---|---|---|
option | String | Opcja do ustawienia. |
value | Object | Wartość do ustawienia. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setPointStyle(style)
Określa styl punktów na linii. Domyślnie punkty nie mają określonych stylów i tylko że linia jest widoczna.
// Creates a line chart builder and sets large point style. var builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
Parametry
Nazwa | Typ | Opis |
---|---|---|
style | PointStyle | Styl, który ma być używany w przypadku punktów na linii. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
Zobacz też
setRange(start, end)
Określa zakres wykresu.
Jeśli jakieś punkty danych wykraczają poza zakres, zakres się powiększa, aby uwzględnić te dane. pkt.
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Number | Wartość najniższej linii siatki na osi zakresu. |
end | Number | Wartość najwyższej linii siatki na osi zakresu. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setTitle(chartTitle)
Określa tytuł wykresu. Tytuł jest wyświetlany na środku nad wykresem.
// Creates a line chart builder and title to 'My Line Chart'. var builder = Charts.newLineChart(); builder.setTitle('My Line Chart')
Parametry
Nazwa | Typ | Opis |
---|---|---|
chartTitle | String | tytuł wykresu. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setTitleTextStyle(textStyle)
Określa styl tekstu tytułu wykresu.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
textStyle | TextStyle | Styl tekstu, który będzie używany jako tytuł wykresu. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setXAxisTextStyle(textStyle)
Określa styl tekstu osi poziomej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
textStyle | TextStyle | Styl tekstu, który będzie używany jako tytuł osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setXAxisTitle(title)
Dodaje tytuł do osi poziomej. Tytuł jest wyśrodkowany i wyświetla się pod wartością osi. etykiety.
// Creates a line chart builder and sets the X-axis title. var builder = Charts.newLineChart(); builder.setTitle('X-axis Title')
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Tytuł osi X. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setXAxisTitleTextStyle(textStyle)
Określa styl tekstu tytułu na osi poziomej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
textStyle | TextStyle | Styl tekstu, który będzie używany jako tytuł osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setYAxisTextStyle(textStyle)
Określa styl tekstu osi pionowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
textStyle | TextStyle | Styl tekstu, który będzie używany jako tytuł osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setYAxisTitle(title)
Dodaje tytuł do osi pionowej. Tytuł jest wyśrodkowany i wyświetla się po lewej stronie wartości. etykiety.
// Creates a line chart builder and sets the Y-axis title. var builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title')
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | Tytuł osi Y. |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
setYAxisTitleTextStyle(textStyle)
Określa styl tekstu tytułu osi pionowej.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
textStyle | TextStyle | Styl tekstu, który będzie używany jako tytuł osi poziomej. Obiekt TextStyleBuilder możesz utworzyć, wywołując funkcję Charts.newTextStyle() . |
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.
useLogScale()
Przekształca oś zakresu w skalę logarytmiczną (wszystkie wartości muszą być dodatnie). Zakres są osią pionową dla wykresów pionowych (np. liniowe, warstwowe lub kolumnowe). oś pozioma w przypadku wykresów poziomych (np. słupkowych).
Powrót
LineChartBuilder
– to kreator przydatny w przypadku łańcuchów.