Omówienie
Wykres kolumnowy to pionowy wykres słupkowy renderowany w przeglądarce za pomocą SVG lub VML, zależnie od przeglądarki użytkownika. Podobnie jak w przypadku innych wykresów Google, po najechaniu kursorem na dane na wykresach kolumnowych zobaczysz podpowiedzi. Poziomą wersję tego wykresu znajdziesz na wykresie słupkowym.
Przykłady
Kolorowanie kolumn
Wykresy gęstości 4 metali szlachetnych:
Wszystkie pozostałe kolory są domyślnie niebieskie. To wszystko dlatego, że wszystkie są częścią tej samej serii. Gdyby była druga seria, zostałaby pokolorowana na czerwono. Te kolory możemy dostosować za pomocą roli stylu:
Kolory można wybrać na 3 sposoby. W naszej tabeli danych znajdziesz wszystkie kolory: wartości RGB, angielskie nazwy kolorów i deklarację CSS.
var data = google.visualization.arrayToDataTable([ ['Element', 'Density', { role: 'style' }], ['Copper', 8.94, '#b87333'], // RGB value ['Silver', 10.49, 'silver'], // English color name ['Gold', 19.30, 'gold'], ['Platinum', 21.45, 'color: #e5e4e2' ], // CSS-style declaration ]);
Style kolumn
Rola stylu umożliwia kontrolowanie kilku aspektów wyglądu kolumny za pomocą deklaracji podobnych do CSS:
color
opacity
fill-color
fill-opacity
stroke-color
stroke-opacity
stroke-width
Nie zalecamy mieszania stylów zbyt głęboko w wykresie – wybierz styl i trzymaj się go. Jednak aby zademonstrować wszystkie atrybuty stylu, możesz skorzystać z tego przykładu:
Pierwsze 2 kolumny mają określone color
(pierwsza z nazwą w języku angielskim, druga z wartością RGB). Nie wybrano opacity
, więc stosowana jest wartość domyślna 1.0 (w pełni nieprzejrzysta), dlatego druga kolumna zasłania siatkę. W trzeciej kolumnie używana jest wartość opacity
równa 0, 2, przez co widoczna jest siatka. Czwarty atrybut zawiera 3 atrybuty: stroke-color
i stroke-width
, a fill-color
, aby wskazać kolor prostokąta. Poza tym kolumna po prawej stronie dodatkowo korzysta z stroke-opacity
i fill-opacity
, aby wybrać przezroczystość obramowania i wypełnienia:
function drawChart() { var data = google.visualization.arrayToDataTable([ ['Year', 'Visitations', { role: 'style' } ], ['2010', 10, 'color: gray'], ['2020', 14, 'color: #76A7FA'], ['2030', 16, 'opacity: 0.2'], ['2040', 22, 'stroke-color: #703593; stroke-width: 4; fill-color: #C5A5CF'], ['2050', 28, 'stroke-color: #871B47; stroke-opacity: 0.6; stroke-width: 8; fill-color: #BC5679; fill-opacity: 0.2'] ]);
Oznaczanie kolumn etykietami
Wykresy mają kilka rodzajów etykiet, np. etykiety potwierdzenia, etykiety legend i etykiety w etykietkach. W tej sekcji zobaczysz, jak umieścić etykiety w kolumnach (lub obok nich) na wykresie.
Załóżmy, że chcemy dodać do każdej kolumny adnotacje z odpowiednim symbolem chemicznym. W tym celu możesz użyć roli adnotacji:
W tabeli danych zdefiniowaliśmy nową kolumnę z atrybutem { role:
'annotation' }
, który pomieści etykiety kolumn:
var data = google.visualization.arrayToDataTable([ ['Element', 'Density', { role: 'style' }, { role: 'annotation' } ], ['Copper', 8.94, '#b87333', 'Cu' ], ['Silver', 10.49, 'silver', 'Ag' ], ['Gold', 19.30, 'gold', 'Au' ], ['Platinum', 21.45, 'color: #e5e4e2', 'Pt' ] ]);
Użytkownicy mogą najeżdżać kursorem na kolumny, aby wyświetlać wartości danych, ale możesz uwzględnić je w samej kolumnie:
Jest to nieco bardziej skomplikowane, ponieważ tworzymy właściwość DataView
, która określa adnotację w każdej kolumnie.
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load("current", {packages:['corechart']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ["Element", "Density", { role: "style" } ], ["Copper", 8.94, "#b87333"], ["Silver", 10.49, "silver"], ["Gold", 19.30, "gold"], ["Platinum", 21.45, "color: #e5e4e2"] ]); var view = new google.visualization.DataView(data); view.setColumns([0, 1, { calc: "stringify", sourceColumn: 1, type: "string", role: "annotation" }, 2]); var options = { title: "Density of Precious Metals, in g/cm^3", width: 600, height: 400, bar: {groupWidth: "95%"}, legend: { position: "none" }, }; var chart = new google.visualization.ColumnChart(document.getElementById("columnchart_values")); chart.draw(view, options); } </script> <div id="columnchart_values" style="width: 900px; height: 300px;"></div>
Jeśli chcesz sformatować wartość inaczej, możesz zdefiniować formater i skompresować go w ten sposób:
function getValueAt(column, dataTable, row) { return dataTable.getFormattedValue(row, column); }
Następnie możemy nazwać ją calc: getValueAt.bind(undefined, 1)
.
Jeśli etykieta jest zbyt duża, aby zmieścić się w kolumnie, wyświetla się na zewnątrz:
Skumulowane wykresy kolumnowe
Stos kolumn – wykres kolumnowy, w którym ułożone są powiązane wartości. Jeśli występują jakieś wartości ujemne, są one ułożone w odwrotnej kolejności pod elementem bazowym wykresu. Zwykle używa się wtedy, gdy kategoria naturalnie dzieli się na komponenty. Weźmy na przykład hipotetyczną sprzedaż książek podzieloną według gatunku i porównaną z czasem:
Skumulowany wykres kolumnowy tworzysz, ustawiając opcję isStacked
na true
:
var data = google.visualization.arrayToDataTable([ ['Genre', 'Fantasy & Sci Fi', 'Romance', 'Mystery/Crime', 'General', 'Western', 'Literature', { role: 'annotation' } ], ['2010', 10, 24, 20, 32, 18, 5, ''], ['2020', 16, 22, 23, 30, 16, 9, ''], ['2030', 28, 19, 29, 30, 12, 13, ''] ]); var options = { width: 600, height: 400, legend: { position: 'top', maxLines: 3 }, bar: { groupWidth: '75%' }, isStacked: true, };
Skumulowane wykresy kolumnowe obsługują też skumulowane 100%, gdzie stosy elementów w każdej wartości domeny są przeskalowane, aby sumować je do 100%. Dostępne opcje to isStacked: 'percent'
, który formatuje każdą wartość jako procent 100%, oraz isStacked: 'relative'
, który formatuje ułamek 1. Dostępna jest też opcja isStacked: 'absolute'
, która odpowiada funkcjonalnie funkcji isStacked: true
.
Zwróć uwagę, że na wykresie skumulowanym 100% po prawej wartości sygnatury są oparte na względnej skali od 0 do 1 jako ułamki 1, ale wartości osi są wyświetlane jako wartości procentowe. Dzieje się tak, ponieważ znaczniki osi procentowej są wynikiem zastosowania formatu „#,##%” do względnych wartości skali od 0 do 1. Gdy używasz isStacked: 'percent'
, pamiętaj, aby określić wartości i znaczniki na osi względnej w skali od 0 do 1.
var options_stacked = { isStacked: true, height: 300, legend: {position: 'top', maxLines: 3}, vAxis: {minValue: 0} };
var options_fullStacked = { isStacked: 'percent', height: 300, legend: {position: 'top', maxLines: 3}, vAxis: { minValue: 0, ticks: [0, .3, .6, .9, 1] } };
Tworzenie wykresów kolumnowych materiałów
W 2014 roku ogłosiliśmy wytyczne dotyczące wspólnego wyglądu i stylu obsługi wszystkich naszych usług i aplikacji (np. aplikacji na Androida), które działają na platformach Google. Nazywamy to Material Design. Będziemy udostępniać wersje „Material” wszystkich najważniejszych wykresów. Możesz ich używać, jeśli podoba Ci się.
Tworzenie wykresu kolumnowego przypomina materiał, który teraz będziemy nazywać klasycznym wykresem kolumnowym. Wczytujesz interfejs Google Migration API (chociaż korzystasz z pakietu 'bar'
zamiast pakietu 'corechart'
), definiujesz tabelę danych, a następnie tworzysz obiekt (ale klasę google.charts.Bar
zamiast google.visualization.ColumnChart
).
Wykresy słupkowe i kolumnowe są zasadniczo identyczne, ale dla orientacji nazywamy oba wykresy Material Bar, niezależnie od tego, czy są one pionowe (klasycznie, kolumnowe), czy poziome (wykres słupkowy). Jedyną różnicą jest opcja Material
bars
. Gdy zasada ma wartość 'horizontal'
, orientacja jest zbliżona do tradycyjnego klasycznego wykresu słupkowego. W przeciwnym razie słupki będą pionowe.
Uwaga: Wykresy materiałowe nie działają w starszych wersjach Internet Explorera. (IE8 i starsze wersje nie obsługują SVG, co jest wymagane na wykresach materiałowych).
W porównaniu z klasycznymi wykresami kolumnowe wykresy kolumnowe zawierają wiele drobniejszych ulepszeń, takich jak udoskonalona paleta kolorów, zaokrąglone narożniki, wyraźniejsze formatowanie etykiet, mniejsze odstępy między wierszami serii, miększe linie siatki i tytuły (oraz dodane napisy).
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('current', {'packages':['bar']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Year', 'Sales', 'Expenses', 'Profit'], ['2014', 1000, 400, 200], ['2015', 1170, 460, 250], ['2016', 660, 1120, 300], ['2017', 1030, 540, 350] ]); var options = { chart: { title: 'Company Performance', subtitle: 'Sales, Expenses, and Profit: 2014-2017', } }; var chart = new google.charts.Bar(document.getElementById('columnchart_material')); chart.draw(data, google.charts.Bar.convertOptions(options)); } </script> </head> <body> <div id="columnchart_material" style="width: 800px; height: 500px;"></div> </body> </html>
Wykresy materiałowe są w wersji beta. Wygląd i opcje interakcji są w większości ostateczne, ale wiele opcji dostępnych na wykresach klasycznych nie jest jeszcze w nich dostępnych. Listę opcji, które nie są jeszcze obsługiwane, znajdziesz w tym artykule.
Ponadto deklarowane opcje nie zostały sfinalizowane, jeśli korzystasz z wersji klasycznej, musisz przekonwertować je na opcje materiału, zastępując ten wiersz:
chart.draw(data, options);
...na przykład:
chart.draw(data, google.charts.Bar.convertOptions(options));
Używanie google.charts.Bar.convertOptions()
pozwala korzystać z niektórych funkcji, takich jak gotowe ustawienia hAxis/vAxis.format
.
Wykresy z podwójną osią Y
Czasami na wykresie kolumnowym chcesz wyświetlić 2 serie z 2 niezależnymi osiami Y: oś lewa dla jednej serii, prawa o drugiej:
Pamiętaj, że nasze 2 osie Y są nie tylko oznaczone inaczej („parsecs” niż „pozorna siła”), ale też mają osobne
skali i linie siatki. Jeśli chcesz dostosować to działanie, użyj opcji vAxis.gridlines
.
W poniższym kodzie opcje axes
i series
określają wygląd wykresu podwójnie. Opcja series
określa, która oś zostanie użyta ('distance'
i 'brightness'
– nie ma związku z nazwami kolumn w tabeli danych). Opcja axes
sprawia, że wykres jest podwójny i zawiera oś 'distance'
po lewej (oznaczoną etykietą „parsecs”) i oś 'brightness'
po prawej (oznaczoną etykietą).
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('current', {'packages':['corechart', 'bar']}); google.charts.setOnLoadCallback(drawStuff); function drawStuff() { var button = document.getElementById('change-chart'); var chartDiv = document.getElementById('chart_div'); var data = google.visualization.arrayToDataTable([ ['Galaxy', 'Distance', 'Brightness'], ['Canis Major Dwarf', 8000, 23.3], ['Sagittarius Dwarf', 24000, 4.5], ['Ursa Major II Dwarf', 30000, 14.3], ['Lg. Magellanic Cloud', 50000, 0.9], ['Bootes I', 60000, 13.1] ]); var materialOptions = { width: 900, chart: { title: 'Nearby galaxies', subtitle: 'distance on the left, brightness on the right' }, series: { 0: { axis: 'distance' }, // Bind series 0 to an axis named 'distance'. 1: { axis: 'brightness' } // Bind series 1 to an axis named 'brightness'. }, axes: { y: { distance: {label: 'parsecs'}, // Left y-axis. brightness: {side: 'right', label: 'apparent magnitude'} // Right y-axis. } } }; var classicOptions = { width: 900, series: { 0: {targetAxisIndex: 0}, 1: {targetAxisIndex: 1} }, title: 'Nearby galaxies - distance on the left, brightness on the right', vAxes: { // Adds titles to each axis. 0: {title: 'parsecs'}, 1: {title: 'apparent magnitude'} } }; function drawMaterialChart() { var materialChart = new google.charts.Bar(chartDiv); materialChart.draw(data, google.charts.Bar.convertOptions(materialOptions)); button.innerText = 'Change to Classic'; button.onclick = drawClassicChart; } function drawClassicChart() { var classicChart = new google.visualization.ColumnChart(chartDiv); classicChart.draw(data, classicOptions); button.innerText = 'Change to Material'; button.onclick = drawMaterialChart; } drawMaterialChart(); }; </script> </head> <body> <button id="change-chart">Change to Classic</button> <br><br> <div id="chart_div" style="width: 800px; height: 500px;"></div> </body> </html>
Top-X top
Uwaga: osie X X są dostępne tylko w przypadku wykresów materiałowych (czyli tych z pakietem bar
).
Jeśli chcesz umieścić etykiety i tytuły osi X u góry wykresu, a nie na dole, w opcjach Material (opcja axes.x
) możesz to zrobić:
<html> <head> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('current', {'packages':['bar']}); google.charts.setOnLoadCallback(drawStuff); function drawStuff() { var data = new google.visualization.arrayToDataTable([ ['Move', 'Percentage'], ["King's pawn (e4)", 44], ["Queen's pawn (d4)", 31], ["Knight to King 3 (Nf3)", 12], ["Queen's bishop pawn (c4)", 10], ['Other', 3] ]); var options = { width: 800, legend: { position: 'none' }, chart: { title: 'Chess opening moves', subtitle: 'popularity by percentage' }, axes: { x: { 0: { side: 'top', label: 'White to move'} // Top x-axis. } }, bar: { groupWidth: "90%" } }; var chart = new google.charts.Bar(document.getElementById('top_x_div')); // Convert the Classic options to Material options. chart.draw(data, google.charts.Bar.convertOptions(options)); }; </script> </head> <body> <div id="top_x_div" style="width: 800px; height: 600px;"></div> </body> </html>
Wczytuję
Nazwa pakietu google.charts.load
to "corechart"
.
Nazwa klasy wizualizacji to google.visualization.ColumnChart
.
google.charts.load("current", {packages: ["corechart"]});
var visualization = new google.visualization.ColumnChart(container);
W przypadku wykresów kolumnowych materiałem o nazwie google.charts.load
jest "bar"
. (To nie literówka: wykres słupkowy Material Design obsługuje obie orientacje).
Nazwa klasy wizualizacji to google.charts.Bar
. (nie literówka: wykres słupkowy Material Design obsługuje obie orientacje).
google.charts.load("current", {packages: ["bar"]});
var chart = new google.charts.Bar(container);
Format danych
Każdy wiersz tabeli odpowiada grupie przyległych pasków.
Wiersze: każdy wiersz w tabeli odpowiada grupie słupków.
Kolumny:
Kolumna 0 | Kolumna 1 | … | Kolumna N | |
---|---|---|---|---|
Cel: | Wartości słupka 1 w tej grupie | … | Wartości słupka N w tej grupie | |
Typ danych: | liczba | … | liczba | |
Rola: | domena | dane | … | dane |
Opcjonalne role kolumn: | … |
Opcje konfiguracji
Nazwa | |
---|---|
animacja.czas trwania |
Czas trwania animacji w milisekundach. Szczegółowe informacje znajdziesz w dokumentacji animacji. Typ: liczba
Wartość domyślna: 0
|
animacja.wygładzanie |
Funkcja wygładzania zastosowana w animacji. Dostępne są te opcje:
Typ: ciąg znaków
Domyślnie: „linear”
|
animacje.startup, |
Określa, czy wykres będzie animowany podczas pierwszego rysowania. Jeśli Typ: wartość logiczna
Default (Fałsz) – wartość domyślna
|
adnotację.alwayOutside |
Na wykresach słupkowych i kolumnowych, jeśli jest ustawiona wartość Typ: wartość logiczna
Wartość domyślna: false
|
adnotację.boxStyle |
W przypadku wykresów, które obsługują adnotacje, obiekt var options = { annotations: { boxStyle: { // Color of the box outline. stroke: '#888', // Thickness of the box outline. strokeWidth: 1, // x-radius of the corner curvature. rx: 10, // y-radius of the corner curvature. ry: 10, // Attributes for linear gradient fill. gradient: { // Start color for gradient. color1: '#fbf6a7', // Finish color for gradient. color2: '#33b679', // Where on the boundary to start and // end the color1/color2 gradient, // relative to the upper left corner // of the boundary. x1: '0%', y1: '0%', x2: '100%', y2: '100%', // If true, the boundary for x1, // y1, x2, and y2 is the box. If // false, it's the entire chart. useObjectBoundingBoxUnits: true } } } }; Ta opcja jest obecnie obsługiwana w przypadku wykresów warstwowych, słupkowych, kolumnowych, mieszanych, liniowych i punktowych. Nie jest on obsługiwany na wykresie adnotacji. Typ: obiekt
Domyślne: null
|
adnotacje.datum |
W przypadku wykresów, które obsługują adnotacje, obiekt
annotations.datum pozwala zastąpić wybór wykresu Google w przypadku adnotacji poszczególnych elementów danych (np. wartości wyświetlanych na każdym słupku na wykresie słupkowym). Możesz zarządzać kolorem za pomocą annotations.datum.stem.color , długości łodygi za pomocą annotations.datum.stem.length i stylu w annotations.datum.style .
Typ: obiekt
Domyślny:kolor to „czarny”, długość to 12, a styl to „punkt”.
|
adnotacje.domena |
W przypadku wykresów, które obsługują adnotacje, obiekt
annotations.domain umożliwia zastąpienie wyboru wykresu Google w przypadku adnotacji udostępnionych dla domeny (główna oś wykresu, na przykład oś X na typowym wykresie liniowym). Możesz zarządzać kolorem za pomocą annotations.domain.stem.color , długości łodygi za pomocą annotations.domain.stem.length i stylu w annotations.domain.style .
Typ: obiekt
Domyślny: kolor to „czarny”; długość to 5; styl to „punkt”.
|
adnotacje.wysoki kontrast. |
W przypadku wykresów, które obsługują adnotacje, wartość logiczna
annotations.highContrast pozwala zastąpić kolor adnotacji wybrany przez Wykresy Google. Domyślnie annotations.highContrast ma wartość Prawda, co powoduje, że wykresy wybierają kolor adnotacji z dobrym kontrastem: jasne kolory na ciemnym tle i ciemny na jasnym tle. Jeśli ustawisz wartość annotations.highContrast na wartość fałsz i nie określisz własnego koloru adnotacji, w Grafie Google zostanie użyty domyślny kolor serii dla tej adnotacji:
Typ: wartość logiczna
Wartość domyślna: true
|
adnotacje.stem |
W przypadku wykresów, które obsługują adnotacje, obiekt
annotations.stem umożliwia zastąpienie wyboru Wykresów Google jako stylu rdzeni. Możesz zarządzać kolorem
za pomocą annotations.stem.color i łodygi
za pomocą annotations.stem.length . Pamiętaj, że opcja długości rdzeń macierzy nie wpływa na adnotacje ze stylem 'line' : w przypadku adnotacji 'line' z punktem odniesienia długość łodygi jest zawsze taka sama jak tekst, a w przypadku adnotacji domeny 'line' jej przedłużenie jest widoczne na całym wykresie.
Typ: obiekt
Domyślny: kolor to „czarny”, długość adnotacji to 5, a adnotacji adnotacji to 12.
|
adnotacje.style |
W przypadku wykresów, które obsługują adnotacje, opcja
annotations.style pozwala zastąpić typ adnotacji wybrany przez wykres Google. Może to być 'line' lub 'point' .
Typ: ciąg znaków
Domyślny: „point”
|
adnotacje.tekstStyl |
Na wykresach, które obsługują adnotacje, obiekt
annotations.textStyle kontroluje wygląd tekstu adnotacji:
var options = { annotations: { textStyle: { fontName: 'Times-Roman', fontSize: 18, bold: true, italic: true, // The color of the text. color: '#871b47', // The color of the text outline. auraColor: '#d799ae', // The transparency of the text. opacity: 0.8 } } }; Ta opcja jest obecnie obsługiwana w przypadku wykresów warstwowych, słupkowych, kolumnowych, mieszanych, liniowych i punktowych. Nie jest on obsługiwany na wykresie adnotacji. Typ: obiekt
Domyślne: null
|
Położenietytułu osi |
Położenie tytułów osi w porównaniu z miejscami na wykresie. Obsługiwane wartości:
Typ: ciąg znaków
Domyślny: „out”
|
backgroundColor, |
Kolor tła głównego obszaru wykresu. Może to być prosty ciąg kolorów HTML, taki jak Typ: ciąg znaków lub obiekt
Domyślny: „biały”.
|
backgroundColor.type |
Kolor obramowania wykresu w postaci ciągu kolorów HTML. Typ: ciąg znaków
Domyślne: „#666”
|
backgroundColor.rayWidth |
Szerokość obramowania w pikselach. Typ: liczba
Wartość domyślna: 0
|
backgroundColor.fill |
Kolor wypełnienia wykresu w postaci koloru HTML. Typ: ciąg znaków
Domyślny: „biały”.
|
bar.grupaSzerokość |
Szerokość grupy pasków określona w jednym z tych formatów:
Typ: liczba lub ciąg
Domyślny: złoty współczynnik, ok. „61,8%”.
|
bary |
Określa, czy słupki materiału wykresu słupkowego są pionowe czy poziome. Ta opcja nie ma wpływu na klasyczne wykresy słupkowe ani klasyczne wykresy kolumnowe. Typ: „poziome” lub „pionowe”
Wartość domyślna: „vertical”
|
obszarGraficzny |
Obiekt z użytkownikami do konfigurowania położenia i rozmiaru obszaru wykresu (tam, gdzie rysowany jest sam wykres, z wyłączeniem osi i legend). Obsługiwane są 2 formaty: liczba lub liczba, po której następuje %. Prosta liczba to wartość w pikselach. Liczba, po której następuje %, to wartość procentowa. Przykład: Typ: obiekt
Domyślne:null
|
chartArea.backgroundColor. |
Kolor tła wykresu. Ciąg może być ciągiem szesnastkowym (np. „#fdc”) lub angielskiej nazwy koloru. Podczas korzystania z tych obiektów możesz podać te właściwości:
Typ: ciąg znaków lub obiekt
Domyślny: „biały”.
|
wykresArea.left |
Odległość, jaka ma być używana do rysowania wykresu od lewej krawędzi. Typ: liczba lub ciąg
Ustawienie domyślne: automatyczne
|
wykresArea.top |
Odległość, w jakiej znajduje się wykres od górnej krawędzi. Typ: liczba lub ciąg
Ustawienie domyślne: automatyczne
|
chartArea.width |
Szerokość obszaru wykresu. Typ: liczba lub ciąg
Ustawienie domyślne: automatyczne
|
wykresArea.height |
Wysokość obszaru wykresu. Typ: liczba lub ciąg
Ustawienie domyślne: automatyczne
|
wykres.podtytuł |
W przypadku wykresów Material ta opcja określa podtytuł. Tylko Material Charts obsługują napisy. Typ: ciąg znaków
Domyślne: null
|
chart.title |
W przypadku wykresów Material ta opcja określa tytuł. Typ: ciąg znaków
Domyślne:null
|
kolory |
Kolory elementów wykresu. Tablica ciągów znaków, w których każdy jest ciągiem koloru HTML, np. Typ: Tablica ciągów znaków
Domyślny: kolory domyślne.
|
ochroność danych |
Przezroczystość punktów danych – 1,0 jest całkowicie nieprzejrzysty, a 0,0 – całkowicie przezroczysty. Na wykresach punktowych, histogramach, słupkach i kolumnach dotyczy to widocznych danych: kropek na wykresie rozproszonym i prostokątów w innych. W przypadku wykresów, na których wybór danych tworzy kropkę, np. wykres liniowy lub warstwowy, dotyczy to okręgów, które pojawiają się po najechaniu kursorem lub zaznaczeniem. Wykres mieszany pokazuje oba rodzaje zachowań i ta opcja nie ma wpływu na inne wykresy. Aby zmienić przezroczystość linii trendu, zobacz przezroczystość linii trendu. Typ: liczba
Domyślna: 1.0
|
włącz interfejs interaktywny |
Określa, czy wykres generuje zdarzenia oparte na użytkownikach lub reaguje na ich interakcje. Jeśli ma wartość false (fałsz), wykres nie zwróci zdarzenia wyboru ani innych zdarzeń związanych z interakcją (ale będzie zwracać zdarzenia lub błędy) ani nie będzie zawierać tekstu wyświetlanego po najechaniu kursorem ani innego działania w zależności od danych wejściowych użytkownika. Typ: wartość logiczna
Wartość domyślna: true
|
explorer |
Opcja Ta funkcja jest eksperymentalna i w przyszłych wersjach może ulec zmianie. Uwaga: eksplorator obsługuje tylko osie ciągłe (np. liczby lub daty). Typ: obiekt
Domyślne:null
|
explorer.actions, |
Eksplorator wykresów Google obsługuje 3 działania:
Typ: Tablica ciągów znaków
Domyślne: ['dragToPan', 'rightClickToReset']
|
explorer.osie |
Domyślnie, gdy używana jest opcja Typ: ciąg znaków
Domyślne: przesuwanie w poziomie i w pionie
|
explorer.keepInBounds, |
Domyślnie użytkownicy mogą przesuwać widok bez względu na to, gdzie znajdują się dane. Aby użytkownicy nie mogli przesuwać treści poza oryginalny wykres, użyj funkcji Typ: wartość logiczna
Wartość domyślna: false
|
odkrywca.maxZoomIn |
Maksymalna wartość, którą może wyświetlić eksplorator. Domyślnie użytkownicy mogą powiększyć widok tak, aby zobaczyć tylko 25% oryginalnego widoku. Ustawienie Typ: liczba
Wartość domyślna: 0,25
|
odkrywca.maxZoomOut |
Maksymalna wartość, którą eksplorator może pomniejszyć. Domyślnie użytkownicy będą mogli pomniejszyć obraz tak bardzo, że wykres zajmie tylko 1/4 dostępnego miejsca. Jeśli zasada jest ustawiona na Typ: liczba
Wartość domyślna: 4
|
odkrywca.zoomdelta |
Gdy użytkownicy powiększają lub pomniejszają obraz, Typ: liczba
Wartość domyślna: 1,5
|
cel główny |
Typ jednostki, która otrzymuje kursor myszy. Ma też wpływ na to, który element jest wybierany przez kliknięcie myszą, a który element tabeli danych jest powiązany ze zdarzeniami. Może to być:
W polu „target” (grupa docelowa) etykietka zawiera wszystkie wartości kategorii. Może to być przydatne do porównywania wartości różnych serii. Typ: ciąg znaków
Domyślny: „datum”
|
rozmiar czcionki |
Domyślny rozmiar czcionki całego tekstu na wykresie (w pikselach). Możesz zastąpić tę opcję, używając właściwości określonych elementów wykresu. Typ: liczba
Domyślna: automatycznie.
|
Czcionka |
Domyślny krój czcionki całego tekstu na wykresie. Możesz zastąpić tę opcję, używając właściwości określonych elementów wykresu. Typ: ciąg znaków
Domyślny: „solarmora”
|
forceIFrame |
Rysuje wykres wewnątrz wbudowanej ramki. (Pamiętaj, że ta opcja jest ignorowana w IE8 – wszystkie wykresy IE8 są ujęte w ramki iFrame). Typ: wartość logiczna
Wartość domyślna: false
|
Oś h |
Obiekt z członkami, który służy do konfigurowania różnych elementów osi poziomej. Aby określić właściwości tego obiektu, możesz użyć notacji literału obiektu w sposób przedstawiony poniżej: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Typ: obiekt
Domyślne:null
|
Numer hAxis.baseline |
Punkt odniesienia dla osi poziomej. Ta opcja jest obsługiwana tylko w przypadku osi Typ: liczba
Domyślna: automatycznie.
|
xAxis.baselineColor |
Kolor punktu odniesienia dla osi poziomej. Może to być dowolny ciąg kolorów HTML, np. Ta opcja jest obsługiwana tylko w przypadku osi Typ: liczba
Domyślny: „czarny”.
|
hAxis.direction, |
Kierunek, w którym rosną wartości na osi poziomej. Określ Typ: 1 lub -1
Wartość domyślna: 1
|
xAxis.format |
Ciąg tekstowy dla etykiet liczbowych lub osi osi.
W przypadku etykiet osi numerycznych jest to podzbiór formatowania dziesiętnego zestawu wzorców ICU. Na przykład w polu
W przypadku etykiet osi daty jest to podzbiór formatowania daty zestawu wzorców ICU. Na przykład Rzeczywiste formatowanie zastosowane do etykiety pochodzi z języka, w którym został załadowany interfejs API. Więcej informacji znajdziesz w artykule na temat ładowania wykresów z określonego regionu.
W obliczeniu wartości znaczników linii siatki i kilku linii siatki uwzględnianych jest kilka alternatywnych kombinacji wszystkich odpowiednich opcji linii. Alternatywne wersje zostaną odrzucone, jeśli sformatowane etykiety znaczników będą zduplikowane lub nakładają się.
Możesz więc określić
Ta opcja jest obsługiwana tylko w przypadku osi Typ: ciąg znaków
Ustawienie domyślne: automatyczne
|
Linia hAxis.gridline |
Obiekt z właściwościami służącymi do konfigurowania linii siatki na osi poziomej. Pamiętaj, że linie siatki na osi poziomej są rysowane pionowo. Aby określić właściwości tego obiektu, możesz użyć notacji literału obiektu w sposób przedstawiony poniżej: {color: '#333', minSpacing: 20}
Ta opcja jest obsługiwana tylko w przypadku osi Typ: obiekt
Domyślne:null
|
Oś hA.grid.color |
Kolor poziomych linii siatki w obszarze wykresu. Podaj prawidłowy ciąg kolorów HTML. Typ: ciąg znaków
Domyślny: „#CCC”
|
gAxis.gridlines.count |
Przybliżona liczba poziomych linii siatki w obszarze wykresu.
Jeśli podasz liczbę dodatnią dla formuły Typ: liczba
Wartość domyślna: -1
|
xAxis.gridlines.interval |
Tablica rozmiarów (jako wartości danych, a nie piksele) między sąsiednimi siatkami. W tej chwili ta opcja dotyczy tylko osi numerycznych, ale jest to odpowiednik opcji Typ: liczba od 1 do 10 (z wyłączeniem 10).
Wartość domyślna: obliczona
|
xAxis.gridlines.minSpacing, |
Minimalny odstęp ekranu (w pikselach) między głównymi liniami hAxis.
Domyślnym ustawieniem głównych linii siatki jest Typ: liczba
Wartość domyślna: obliczona
|
xAxis.gridlines.multiple |
Wszystkie wartości siatki i znaczników muszą być wielokrotnością wartości tej opcji. Pamiętaj, że w przeciwieństwie do interwałów, moc 10-krotność wielokrotności nie jest brana pod uwagę.
Aby wymusić znaczniki wyboru jako liczby całkowite, podaj Typ: liczba
Wartość domyślna: 1
|
xAxis.gridlines.units |
Zastępuje domyślny format różnych typów danych typu data/data/godzina, gdy są używane na podstawie obliczonych linii siatki. Umożliwia formatowanie lat, miesięcy, dni, godzin, minut, sekund i milisekund. Ogólny format to: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Dodatkowe informacje znajdziesz w artykule Daty i godziny. Typ: obiekt
Domyślne:null
|
Linie siatki xAxis.minorGridline |
Obiekt z użytkownikami do konfigurowania mniejszych linii siatki na osi poziomej, podobnie jak w przypadku opcji hAxis.gridlines.
Ta opcja jest obsługiwana tylko w przypadku osi Typ: obiekt
Domyślne:null
|
xAxis.minorGridlines.color |
Kolor poziomych linii siatki w obszarze wykresu. Podaj prawidłowy ciąg kolorów HTML. Typ: ciąg znaków
Domyślne: połączenie kolorów siatki i tła.
|
hAxis.minorGridlines.count, |
Opcja Typ: liczba
Wartość domyślna: 1
|
hAxis.minorGridlines.interval |
Opcja majorGridlines.interval jest podobna do opcji odstępów głównych linii siatki, ale wybrany przedział jest zawsze równym dzielnikiem głównych linii siatki.
Domyślny przedział na wagach liniowych to Typ: liczba
Wartość domyślna: 1
|
hAxis.minorGridlines.minSpacing, |
Minimalny wymagany odstęp (w pikselach) między sąsiednimi mniejszymi liniami siatki oraz między siatką a dużą siatką. Wartość domyślna to 1/2 minSpacing mainline of line lines for skale linearne i 1/5 minSpacing for log scales. Typ: liczba
Wartość domyślna: obliczona
|
hAxis.minorGridlines.multiple |
To samo co w przypadku wersji głównej Typ: liczba
Wartość domyślna: 1
|
xAxis.minorGridlines.units |
Zastępuje domyślny format różnych typów danych typu data/data/godzina, gdy są używane na podstawie obliczonych linii podrzędnych siatki. Umożliwia formatowanie lat, miesięcy, dni, godzin, minut, sekund i milisekund. Ogólny format to: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Dodatkowe informacje znajdziesz w artykule Daty i godziny. Typ: obiekt
Domyślne: null
|
hAxis.logScale |
Właściwość Ta opcja jest obsługiwana tylko w przypadku osi Typ: wartość logiczna
Wartość domyślna: false
|
TypHaxis.scaleType |
Właściwość
Ta opcja jest obsługiwana tylko w przypadku osi Typ: ciąg znaków
Wartość domyślna: null
|
Oś hAxis.text |
Położenie tekstu na osi poziomej względem obszaru wykresu. Obsługiwane wartości: „out”, „in”, „none”. Typ: ciąg znaków
Domyślny: „out”
|
xAxis.textStyle |
Obiekt określający styl tekstu na osi poziomej. Obiekt ma taki format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Typ: obiekt
Domyślnie:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
xAxis.ticks |
Zastępuje automatycznie generowane znaczniki osi X określoną tablicą. Każdy element tablicy powinien być prawidłową wartością znacznika (np. liczbą, datą, datą lub godziną) lub obiektem. Jeśli jest to obiekt, powinien mieć właściwość
Wartość ViewWindow zostanie automatycznie rozwinięta, tak by obejmowała wartości minimalne i maksymalne, chyba że określisz Przykłady:
Ta opcja jest obsługiwana tylko w przypadku osi Typ: tablica elementów
Ustawienie domyślne: automatyczne
|
xAxis.title, |
Właściwość Typ: ciąg znaków
Domyślne: null
|
xAxis.titleTextStyle |
Obiekt określający styl tekstu tytułu na osi poziomej. Obiekt ma taki format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Typ: obiekt
Domyślnie:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
Licencja hAxis.allowContainerBoundaryTextcut |
Jeśli ma wartość Fałsz, zewnętrzne etykiety są ukrywane, a nie przycinane przez kontener wykresu. Jeśli ustawisz wartość prawda, przycinanie etykiet będzie możliwe. Ta opcja jest obsługiwana tylko w przypadku osi Typ: wartość logiczna
Wartość domyślna: false
|
xAxis.slantedText |
Jeśli wartość to prawda, narysuj tekst osi poziomej pod kątem. W ten sposób możesz zmieścić na osi więcej tekstu, a w przeciwnym razie narysuj tekst osi pionowej. Domyślnym zachowaniem jest nieprzychylny tekst, jeśli po najechaniu na całość nie mieści się on w całości. Pamiętaj, że ta opcja jest dostępna tylko wtedy, gdy Typ: wartość logiczna
Domyślna:automatycznie.
|
Obiekty hAxis.slantedTextAngle |
Kąt tekstu na osi poziomej (jeśli jest skośny). Ignorowana, jeśli element Typ: liczba -90–90
Wartość domyślna: 30
|
xAxis.maxAlternation |
Maksymalna liczba poziomów tekstu na osi poziomej. Jeśli etykiety tekstu na osi staną się zbyt zatłoczone, serwer może przesunąć sąsiadujące etykiety w górę lub w dół, aby zmieścić je bliżej. Ta wartość określa największą liczbę poziomów do wykorzystania. Jeśli etykiety pasują do siebie bez nakładania się, serwer może stosować ich mniej. W przypadku dat i godzin domyślna wartość wynosi 1. Typ: liczba
Wartość domyślna: 2
|
xAxis.maxTextLine |
Maksymalna dozwolona liczba wierszy w etykietach tekstowych. Etykiety mogą obejmować wiele wierszy, jeśli są zbyt długie, a liczba wierszy jest domyślnie ograniczona przez wysokość dostępnego miejsca. Typ: liczba
Ustawienie domyślne: automatyczne
|
xAxis.minTextSpacing, |
Minimalne odstępy w poziomie (w pikselach) między 2 przylegającymi etykietami tekstu. Jeśli etykiety są zbyt gęsto rozmieszczone lub są zbyt długie, odstępy te mogą spaść poniżej tego progu i w tym przypadku zostanie zastosowane jedno z rozwiązań umożliwiających rozmycie etykiet (np.obcięcie etykiet lub usunięcie ich niektórych). Typ: liczba
Wartość domyślna: wartość
hAxis.textStyle.fontSize |
hAxis.showTextCo |
Liczba etykiet osi poziomej (1 oznacza każdą etykietę, 2 oznacza każdą inną etykietę itd.). Domyślnie wyświetlane są jak najwięcej etykiet bez nakładania się. Typ: liczba
Domyślna: automatycznie.
|
xAxis.maxValue |
Przenosi maksymalną wartość osi poziomej do określonej wartości. W przypadku większości wykresów będzie to prawo. Ignorowane, jeśli ta wartość jest ustawiona na wartość mniejszą niż maksymalna wartość x danych.
Ta opcja jest obsługiwana tylko w przypadku osi Typ: liczba
Domyślna:automatycznie.
|
xAxis.minValue |
Przenosi minimalną wartość osi poziomej do określonej wartości. W przypadku większości wykresów jest to lewo. Ignorowane, jeśli ustawiona wartość jest większa niż minimalna wartość X danych.
Ta opcja jest obsługiwana tylko w przypadku osi Typ: liczba
Domyślna: automatycznie.
|
Tryb xAxis.viewWindow |
Określa, jak skaluje oś poziomą, aby renderować wartości na obszarze wykresu. Obsługiwane są te wartości ciągów:
Ta opcja jest obsługiwana tylko w przypadku osi Typ: ciąg znaków
Domyślny: odpowiednik „ładne”, ale jeśli mają one pierwszeństwo,
haxis.viewWindow.min i haxis.viewWindow.max mają pierwszeństwo.
|
Widok xA.is |
Określa zakres przycięcia osi poziomej. Typ: obiekt
Domyślne: null
|
Oś hx.viewWindow.max |
Ignorowany, gdy Typ: liczba
Ustawienie domyślne: automatyczne
|
xAxis.viewWindow.min |
Ignorowany, gdy Typ: liczba
Ustawienie domyślne: automatyczne
|
wysokość |
Wysokość wykresu w pikselach. Typ: liczba
Domyślna: wysokość elementu, który go zawiera.
|
Jest skumulowany |
Jeśli ma wartość Prawda, łączy elementy wszystkich serii w każdej wartości domeny. Uwaga: na wykresach Kolumna, Obszar i Etap krokowy Wykresy Google odwracają kolejność legend, aby lepiej pasowały do stosu elementów serii (np. seria 0 jest najniższym elementem legendy). Nie dotyczy to wykresów barowych.
Opcja Opcje dla
W przypadku nakładania 100% obliczona wartość każdego elementu jest widoczna w etykietce po rzeczywistej wartości.
Oś docelowa domyślnie ustawia wartości zależne od skali 0–1 jako ułamki 1 w przypadku
skumulowane 100% obsługuje tylko wartości danych typu Typ: wartość logiczna / ciąg znaków
Wartość domyślna: false
|
legenda |
Obiekt z użytkownikami do konfigurowania różnych aspektów legendy. Aby określić właściwości tego obiektu, możesz użyć zapisu dosłownego obiektu, jak pokazano tutaj: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Typ: obiekt
Domyślne: null
|
legend.pageIndex |
Początkowo wybrany indeks oparty na zerowej stronie legendy. Typ: liczba
Wartość domyślna: 0
|
legend.position, |
Pozycja legendy. Użyj jednego z tych rodzajów wartości:
Typ: ciąg znaków
Domyślny: „right”
|
legend.alignment, |
Wyrównanie legendy. Użyj jednego z tych rodzajów wartości:
Początek, środek i koniec są zależne od stylu legendy (pionowa lub pozioma). Na przykład w legendzie „prawa” odpowiednio „start” i „koniec” znajdują się odpowiednio u góry i u dołu. W przypadku legendy „górny”, „start” i „koniec” znajdziesz odpowiednio po lewej i prawej stronie obszaru. Wartość domyślna zależy od pozycji legendy. W przypadku legend „bottom” domyślną wartością jest „center”, a w innych legendach – „start”. Typ: ciąg znaków
Domyślna: automatycznie.
|
legend.textStyle, |
Obiekt określający styl tekstu legendy. Obiekt ma taki format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Typ: obiekt
Domyślnie:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
orientacja |
Orientacja wykresu. Jeśli ustawisz wartość Typ: ciąg znaków
Wartość domyślna: „pozioma”
|
odwrócone kategorie |
Jeśli zasada ma wartość Prawda, seria jest rysowana od prawej do lewej. Domyślne ustawienie to rysowanie od lewej do prawej.
Ta opcja jest obsługiwana tylko w przypadku osi Typ: wartość logiczna
Wartość domyślna: false
|
seriale |
Tablica obiektów, z których każdy opisuje format odpowiedniej serii na wykresie Aby użyć wartości domyślnych dla serii, podaj pusty obiekt {}. Jeśli seria lub wartość nie jest określona, zostanie użyta wartość globalna. Każdy obiekt obsługuje te właściwości:
Możesz podać tablicę obiektów, z których każdy dotyczy serii, w określonej kolejności, lub obiekt, w którym każdy element podrzędny ma klucz numeryczny, który wskazuje serię. Na przykład te 2 deklaracje są identyczne, deklarując pierwszą serię jako czarną i nieobecną w legendie, a czwartą jako czerwoną i nieobecną w legendie: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } Typ: tablica obiektów lub obiektów z zagnieżdżonymi obiektami
Domyślnie: {}
|
motyw |
Motyw to zestaw wstępnie zdefiniowanych wartości opcji, które współdziałają ze sobą, aby osiągnąć określone zachowanie wykresu lub efektu wizualnego. Obecnie dostępny jest tylko jeden motyw:
Typ: ciąg znaków
Domyślne: null
|
tytuł |
Tekst do wyświetlenia nad wykresem. Typ: ciąg znaków
Domyślnie: bez tytułu.
|
Stanowisko |
Porównanie tytułu wykresu z obszarem obszaru wykresu. Obsługiwane wartości:
Typ: ciąg znaków
Domyślny: „out”
|
stylTextTextStyle |
Obiekt określający styl tekstu tytułu. Obiekt ma taki format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Typ: obiekt
Domyślnie:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
etykietka |
Obiekt z członkami, który służy do konfigurowania różnych elementów etykietek. Aby określić właściwości tego obiektu, możesz użyć notacji literału obiektu w sposób przedstawiony poniżej: {textStyle: {color: '#FF0000'}, showColorCode: true} Typ: obiekt
Domyślne: null
|
tooltip.ignoreBounds |
Jeśli ustawiona jest wartość Uwaga: dotyczy to tylko etykietek HTML. Jeśli ta opcja jest włączona w przypadku etykietek SVG, wszystkie nadmiary wykraczające poza granice wykresu zostaną przycięte. Więcej informacji znajdziesz w artykule Dostosowywanie zawartości etykietki. Typ: wartość logiczna
Wartość domyślna: false
|
tooltip.isHtml |
Jeśli ma wartość Prawda, używaj etykiet z renderowaniem HTML (a nie z elementami renderowanymi w formacie SVG). Więcej informacji znajdziesz w artykule Dostosowywanie zawartości etykietki. Uwaga: wizualizacja wykresu bąbelkowego nie obsługuje dostosowywania zawartości etykietki HTML za pomocą roli danych kolumny etykietki. Typ: wartość logiczna
Wartość domyślna: false
|
tooltip.showColorCode |
Jeśli ma wartość true (prawda), obok informacji o serii w etykietce pokazuj kolorowe kwadraty. Wartość domyślna to „true”, gdy Typ: wartość logiczna
Domyślna:automatycznie.
|
tooltip.textStyle |
Obiekt określający styl tekstu etykietki. Obiekt ma taki format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Typ: obiekt
Domyślnie:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
tooltip.trigger |
Interakcja użytkownika, która powoduje wyświetlenie etykietki:
Typ: ciąg znaków
Domyślny: „focus”
|
linie trendu |
Pokazuje linie trendów na wykresach, które je obsługują. Domyślnie używane są liniowe linie trendu, ale można to zmienić za pomocą opcji
Linie trendu są określane dla poszczególnych serii, więc większość opcji będzie wyglądać tak: var options = { trendlines: { 0: { type: 'linear', color: 'green', lineWidth: 3, opacity: 0.3, showR2: true, visibleInLegend: true } } } Typ: obiekt
Domyślne: null
|
linielinii.n.kolor |
Kolor linii trendu wyrażony jako nazwa koloru angielskiego lub ciąg szesnastkowy. Typ: ciąg znaków
Domyślny:domyślny kolor serii
|
linielinii.n.stopień |
W przypadku linii trendu równych Typ: liczba
Wartość domyślna: 3
|
trends.n.labelInLegend |
Po ustawieniu linia trendu pojawi się w legendzie w postaci tego ciągu znaków. Typ: ciąg znaków
Domyślne:null
|
linielinii.szerokość.linii |
Szerokość linii linii trendu (w pikselach). Typ: liczba
Wartość domyślna: 2
|
linielinii.n.opacity |
Przezroczystość linii trendu od 0,0 (przezroczysta) do 1,0 (nieprzejrzysta). Typ: liczba
Domyślna: 1.0
|
trends.n.pointSize |
Linie trendu składają się ze fragmentu kropką na wykresie. Ta rzadko używana opcja pozwala dostosować rozmiar kropek. Opcja Typ: liczba
Wartość domyślna: 1
|
trends.n.pointsVisible |
Linie trendu składają się z wielu kropek na wykresie. Opcja Typ: wartość logiczna
Wartość domyślna: true
|
linielinii.n.showR2 |
Określa, czy wyświetlać współczynnik determinacji w podpowiedziach legendy czy linii trendu. Typ: wartość logiczna
Wartość domyślna: false
|
linielinii.n.typ |
Określa, czy linie trendu mają wartość Typ: ciąg znaków
Domyślne:liniowe
|
linielinii.n.visibleInLegend |
Określa, czy równanie linii trendu pojawia się w legendzie. Pojawi się on w etykietce linii trendu. Typ: wartość logiczna
Wartość domyślna: false
|
vAxes, |
Określa właściwości poszczególnych osi pionowych, jeśli wykres ma kilka osi.
Każdy obiekt podrzędny to obiekt
Aby określić wykres z wieloma osiami pionowymi, najpierw zdefiniuj nową oś za pomocą { series: { 2: { targetAxisIndex:1 } }, vAxes: { 1: { title:'Losses', textStyle: {color: 'red'} } } }
Ta właściwość może być obiektem lub tablicą: jest to zbiór obiektów każdy z etykietą liczbową określającą oś – jest to format przedstawiony powyżej; tablica to tablica obiektów, po jednym na osi. Na przykład ta notacja w stylu tablicy jest identyczna jak obiekt vAxes: [ {}, // Nothing specified for axis 0 { title:'Losses', textStyle: {color: 'red'} // Axis 1 } ] Typ: tablica obiektów lub obiektów podrzędnych
Domyślne: null
|
Oś vs |
Obiekt z członkami, który służy do konfigurowania różnych elementów osi pionowej. Aby określić właściwości tego obiektu, możesz użyć zapisu dosłownego obiektu, jak pokazano tutaj: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} Typ: obiekt
Domyślne:null
|
Wartość vAxis.baseline |
Właściwość Typ: liczba
Domyślna: automatycznie.
|
KolorAxis.baseline |
Określa kolor punktu odniesienia dla osi pionowej. Może to być dowolny ciąg kolorów HTML, np. Typ: liczba
Domyślny: „czarny”.
|
OśAvis.direction |
Kierunek, w którym rosną wartości na osi pionowej. Domyślnie niskie wartości znajdują się u dołu wykresu. Określ Typ: 1 lub -1
Wartość domyślna: 1
|
PlikAVIS.format |
Formatujący ciąg etykiet liczbowych. Jest to podzbiór wzorca ICU.
Na przykład w polu
Rzeczywiste formatowanie zastosowane do etykiety pochodzi z języka, w którym został załadowany interfejs API. Więcej informacji znajdziesz w artykule na temat ładowania wykresów z określonego regionu.
W obliczeniu wartości znaczników linii siatki i kilku linii siatki uwzględnianych jest kilka alternatywnych kombinacji wszystkich odpowiednich opcji linii. Alternatywne wersje zostaną odrzucone, jeśli sformatowane etykiety znaczników będą zduplikowane lub nakładają się.
Możesz więc określić Typ: ciąg znaków
Ustawienie domyślne: automatyczne
|
Linie siatki vAxis.grid |
Obiekt z członkami, który służy do konfigurowania linii siatki na osi pionowej. Pamiętaj, że linie siatki osi pionowej są rysowane w poziomie. Aby określić właściwości tego obiektu, możesz użyć notacji literału obiektu w sposób przedstawiony poniżej: {color: '#333', minSpacing: 20} Typ: obiekt
Domyślne:null
|
OśA.vsiat.grid.color |
Kolor pionowych linii siatki wewnątrz obszaru wykresu. Określ prawidłowy ciąg kolorów HTML. Typ: ciąg znaków
Domyślny: „#CCC”
|
OśAvis.grid.count |
Przybliżona liczba poziomych linii siatki w obszarze wykresu.
Jeśli podasz liczbę dodatnią dla formuły Typ: liczba
Wartość domyślna: -1
|
OśAvis.grid.interval |
Tablica rozmiarów (jako wartości danych, a nie piksele) między sąsiednimi siatkami. W tej chwili ta opcja dotyczy tylko osi numerycznych, ale jest to odpowiednik opcji Typ: liczba od 1 do 10 (z wyłączeniem 10).
Wartość domyślna: obliczona
|
Oś vAxis.gridlines.minSpacing |
Minimalny odstęp ekranu (w pikselach) między głównymi liniami hAxis.
Domyślnym ustawieniem głównych linii siatki jest Typ: liczba
Wartość domyślna: obliczona
|
OśAvs.grid.multiple |
Wszystkie wartości siatki i znaczników muszą być wielokrotnością wartości tej opcji. Pamiętaj, że w przeciwieństwie do interwałów, moc 10-krotność wielokrotności nie jest brana pod uwagę.
Aby wymusić znaczniki wyboru jako liczby całkowite, podaj Typ: liczba
Wartość domyślna: 1
|
Oś vas.grid.units |
Zastępuje domyślny format różnych typów danych typu data/data/godzina, gdy są używane na podstawie obliczonych linii siatki. Umożliwia formatowanie lat, miesięcy, dni, godzin, minut, sekund i milisekund. Ogólny format to: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]}, hours: {format: [/*format strings here*/]}, minutes: {format: [/*format strings here*/]}, seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]} } } Dodatkowe informacje znajdziesz w artykule Daty i godziny. Typ: obiekt
Domyślne:null
|
Linie siatki vAxis.minorGrids |
Obiekt z użytkownikami do konfigurowania mniejszych linii siatki na osi pionowej, podobnie jak w przypadku opcji vAxis.gridlines. Typ: obiekt
Domyślne: null
|
Oś v.is.minor.net.kolor |
Kolor pionowych linii siatki wewnątrz obszaru wykresu. Podaj prawidłowy ciąg kolorów HTML. Typ: ciąg znaków
Domyślne:połączenie kolorów siatki i tła.
|
vAxis.minorGridlines.count, |
Opcja generalGridlines.count jest w większości wycofana. Wyjątkiem jest wyłączenie podrzędnych linii siatki przez ustawienie licznika na 0. Liczba mniejszych linii siatki zależy od przedziału między głównymi liniami siatki (patrz vAxis.gridlines.interval) i minimalnej wymaganej przestrzeni (patrz vAxis.minorGridlines.minSpacing). Typ: liczba
Wartość domyślna: 1
|
vAxis.minorGridlines.interval, |
Opcja majorGridlines.interval jest podobna do opcji odstępów głównych linii siatki, ale wybrany przedział jest zawsze równym dzielnikiem głównych linii siatki.
Domyślny przedział na wagach liniowych to Typ: liczba
Wartość domyślna: 1
|
xAxis.minorGridlines.minSpacing, |
Minimalny wymagany odstęp (w pikselach) między sąsiednimi mniejszymi liniami siatki oraz między siatką a dużą siatką. Wartość domyślna to 1/2 minSpacing mainline of line lines for skale linearne i 1/5 minSpacing for log scales. Typ: liczba
Wartość domyślna: obliczona
|
Oś vAxis.minorGridline.multiple |
To samo co w przypadku wersji głównej Typ: liczba
Wartość domyślna: 1
|
xAxis.minorGridlines.units |
Zastępuje domyślny format różnych typów danych typu data/data/godzina, gdy są używane na podstawie obliczonych linii podrzędnych siatki. Umożliwia formatowanie lat, miesięcy, dni, godzin, minut, sekund i milisekund. Ogólny format to: gridlines: { units: { years: {format: [/*format strings here*/]}, months: {format: [/*format strings here*/]}, days: {format: [/*format strings here*/]} hours: {format: [/*format strings here*/]} minutes: {format: [/*format strings here*/]} seconds: {format: [/*format strings here*/]}, milliseconds: {format: [/*format strings here*/]}, } } Dodatkowe informacje znajdziesz w artykule Daty i godziny. Typ: obiekt
Domyślne: null
|
vAxis.logScale |
Jeśli ma wartość true (prawda), oś pionowa jest skalą logarytmiczną. Uwaga: wszystkie wartości muszą być dodatnie. Typ: wartość logiczna
Wartość domyślna: false
|
TypAxis.scale |
Właściwość
Ta opcja jest obsługiwana tylko w przypadku osi Typ: ciąg znaków
Domyślne: null
|
Oś vAxis.text |
Położenie tekstu na osi pionowej względem obszaru wykresu. Obsługiwane wartości: „out”, „in”, „none”. Typ: ciąg znaków
Domyślny: „out”
|
StylAxis.text |
Obiekt określający styl tekstu na osi pionowej. Obiekt ma taki format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Typ: obiekt
Domyślnie:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
PlikAxis.ticks |
Zastępuje automatycznie generowane znaczniki osi Y określoną tablicą. Każdy element tablicy powinien być prawidłową wartością znacznika (np. liczbą, datą, datą lub godziną) lub obiektem. Jeśli jest to obiekt, powinien mieć właściwość
Wartość ViewWindow zostanie automatycznie rozwinięta, tak by obejmowała wartości minimalne i maksymalne, chyba że określisz Przykłady:
Typ: tablica elementów
Ustawienie domyślne: automatyczne
|
OśAvis.title |
Właściwość Typ: ciąg znaków
Domyślnie: bez tytułu.
|
StylAxis.titleTextText |
Obiekt określający styl tekstu tytułu osi pionowej. Obiekt ma taki format: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
Typ: obiekt
Domyślnie:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
Wartość xAxis.max |
Przenosi maksymalną wartość osi pionowej do określonej wartości. W przypadku większości wykresów będzie ona większa. Ignorowane, jeśli ta wartość jest ustawiona na wartość mniejszą niż maksymalna wartość y danych.
Typ: liczba
Domyślna: automatycznie.
|
WartośćAxis.minValue |
Przenosi minimalną wartość osi pionowej do określonej wartości – w przypadku większości wykresów będzie ona niższa. Ignorowane, jeśli ta wartość jest ustawiona na wartość większą niż minimalna wartość y.
Typ: liczba
Domyślne: null
|
TrybAvis.viewWindow |
Określa, jak skaluje oś pionową, aby renderować wartości w obszarze wykresu. Obsługiwane są te wartości ciągów:
Typ: ciąg znaków
Domyślny: odpowiednik „ładne”, ale jeśli mają one pierwszeństwo,
vaxis.viewWindow.min i vaxis.viewWindow.max mają pierwszeństwo.
|
Oś-v.is.is |
Określa zakres przycięcia osi pionowej. Typ: obiekt
Domyślne:null
|
Oś v.axis.max |
Maksymalna wartość pionowych danych. Ignorowany, gdy Typ: liczba
Ustawienie domyślne: automatyczne
|
Axis.viewWindow.min |
Minimalna wartość danych pionowych do renderowania. Ignorowany, gdy Typ: liczba
Ustawienie domyślne: automatyczne
|
szerokość |
Szerokość wykresu w pikselach. Typ: liczba
Domyślna – szerokość elementu, który zawiera.
|
Metody
Metoda | |
---|---|
draw(data, options) |
Rysuje wykres. Wykres akceptuje dalsze wywołania metody dopiero po wywołaniu zdarzenia Typ zwrotu: brak
|
getAction(actionID) |
Zwraca obiekt działania etykietki z wymaganym parametrem Typ zwrotu: obiekt
|
getBoundingBox(id) |
Zwraca obiekt zawierający lewą, górną, szerokość i wysokość elementu wykresu
Wartości odnoszą się do kontenera wykresu. Wywołuj je po narysowaniu wykresu. Typ zwrotu: obiekt
|
getChartAreaBoundingBox() |
Zwraca obiekt zawierający lewą, górną, szerokość i wysokość zawartości wykresu (tzn. z wyłączeniem etykiet i legend):
Wartości odnoszą się do kontenera wykresu. Wywołuj je po narysowaniu wykresu. Typ zwrotu: obiekt
|
getChartLayoutInterface() |
Zwraca obiekt zawierający informacje o umieszczonym na ekranie miejscu na wykresie i jego elementach. W zwróconym obiekcie można wywołać te metody:
Wywołuj je po narysowaniu wykresu. Typ zwrotu: obiekt
|
getHAxisValue(xPosition, optional_axis_index) |
Zwraca poziomą wartość danych w miejscu Przykład: Wywołuj je po narysowaniu wykresu. Typ zwrotu: numer
|
getImageURI() |
Zwraca wykres zserializowany jako identyfikator URI obrazu. Wywołuj je po narysowaniu wykresu. Patrz Drukowanie wykresów PNG. Typ zwrotu: ciąg znaków
|
getSelection() |
Zwraca tablicę wybranych elementów wykresu.
Elementy, które można wybrać, to paski, legendy i kategorie.
Pasek odnosi się do komórki tabeli danych, wpisu legendy do kolumny (indeks wiersza ma wartość null) i kategorii do wiersza (indeks kolumny ma wartość null).
Na tym wykresie w danym momencie możesz wybrać tylko 1 element.
Typ zwrotu: tablica elementów wyboru.
|
getVAxisValue(yPosition, optional_axis_index) |
Zwraca pionową wartość danych w miejscu Przykład: Wywołuj je po narysowaniu wykresu. Typ zwrotu: numer
|
getXLocation(dataValue, optional_axis_index) |
Zwraca współrzędną x piksela Przykład: Wywołuj je po narysowaniu wykresu. Typ zwrotu: numer
|
getYLocation(dataValue, optional_axis_index) |
Zwraca współrzędną Y piksela Przykład: Wywołuj je po narysowaniu wykresu. Typ zwrotu: numer
|
removeAction(actionID) |
Usuwa z wykresu etykietkę z żądaniem Typ zwrotu:
none |
setAction(action) |
Ustawia działanie etykietki do wykonania, gdy użytkownik kliknie tekst działania.
Metoda
Przed wywołaniem metody Typ zwrotu:
none |
setSelection() |
Zaznacza określone elementy wykresu. Anuluje poprzedni wybór.
Elementy, które można wybrać, to paski, legendy i kategorie.
Pasek odnosi się do komórki tabeli danych, wpisu legendy do kolumny (indeks wiersza ma wartość null) i kategorii do wiersza (indeks kolumny ma wartość null).
Na tym wykresie możesz wybrać tylko jeden element naraz.
Typ zwrotu: brak
|
clearChart() |
Czyści wykres i usuwa wszystkie przydzielone zasoby. Typ zwrotu: brak
|
Zdarzenia
Więcej informacji o korzystaniu z tych zdarzeń znajdziesz w artykułach Podstawowe funkcje interaktywne, Obsługa zdarzeń i Uruchamianie zdarzeń.
Nazwa | |
---|---|
animationfinish |
Uruchamiane po zakończeniu animacji przejścia. Właściwości: brak
|
click |
Uruchamiane, gdy użytkownik kliknie wykres. Można jej użyć do określenia, kiedy kliknięty jest tytuł, elementy danych, wpisy legendy, osie, linie siatki lub etykiety. Właściwości: targetID
|
error |
Uruchamiane, gdy podczas próby renderowania wykresu wystąpi błąd. Właściwości: id, message
|
legendpagination |
Uruchamiane, gdy użytkownik kliknie legendę podziału na strony. Przekazuje aktualny indeks stron oparty na zerowej legendzie i łączną liczbę stron. Właściwości: currentPageIndex, totalPages
|
onmouseover |
Uruchamiane, gdy użytkownik najedzie kursorem na jednostkę wizualną. Zwraca indeksy wierszy i kolumn odpowiedniego elementu tabeli danych. Właściwości: wiersz, kolumna.
|
onmouseout |
Uruchamiane, gdy użytkownik odsunie kursor od jednostki wizualnej. Zwraca indeksy wierszy i kolumn odpowiedniego elementu tabeli danych. Właściwości: wiersz, kolumna.
|
ready |
Wykres jest gotowy do wywołań metod zewnętrznych. Jeśli chcesz korzystać z wykresu i metod wywoływania po narysowaniu, musisz skonfigurować odbiornik tego zdarzenia przed wywołaniem metody Właściwości: brak
|
select |
Uruchamiane, gdy użytkownik kliknie element wizualny. Aby dowiedzieć się, co zostało wybrane, zadzwoń pod numer
Właściwości: brak
|
Zasady dotyczące danych
Cały kod i dane są przetwarzane i renderowane w przeglądarce. Żadne dane nie są wysyłane do żadnego serwera.