Visão geral
Um gráfico de colunas é um gráfico de barras verticais renderizado no navegador usando SVG ou VML, o que for apropriado para o navegador do usuário. Como todos os gráficos do Google, os gráficos de colunas exibem dicas quando o usuário passa o cursor sobre os dados. Para uma versão horizontal desse gráfico, consulte o gráfico de barras.
Exemplos
Colorir colunas
Vamos fazer um gráfico com as densidades de quatro metais preciosos:
Acima, todas as cores são o azul padrão. Isso ocorre porque todos eles fazem parte da mesma série. Se houvesse uma segunda série, isso seria colorido em vermelho. Podemos personalizar essas cores com a função de estilo:
Há três maneiras diferentes de escolher as cores, e nossa tabela de dados mostra todas elas: valores RGB, nomes de cores em inglês e uma declaração semelhante a 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 ]);
Estilos de coluna
O papel de estilo permite controlar vários aspectos da aparência da coluna com declarações semelhantes a CSS:
color
opacity
fill-color
fill-opacity
stroke-color
stroke-opacity
stroke-width
Não recomendamos misturar estilos muito livremente em um gráfico. Escolha um estilo e mantenha-o. Mas, para demonstrar todos os atributos de estilo, veja uma amostra:
As duas primeiras colunas usam uma color
específica (a
primeira com um nome em inglês, a segunda com um valor
RGB). Nenhum opacity
foi escolhido, portanto, o padrão 1.0
(totalmente opaco) é usado. É por isso que a segunda coluna oculta a
linha de grade atrás dela. Na terceira coluna, é usado um opacity
de 0,2, que revela a linha de grade. No quarto, três atributos de estilo são usados: stroke-color
e stroke-width
para desenhar a borda e fill-color
para especificar a cor do retângulo dentro dele. A coluna mais à direita também
usa stroke-opacity
e fill-opacity
para
escolher as opacidades da borda e do preenchimento:
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'] ]);
Como rotular colunas
Os gráficos têm vários tipos de rótulos, como rótulos de marcação, de legenda e rótulos nas dicas. Nesta seção, veremos como colocar rótulos dentro (ou perto) das colunas em um gráfico de colunas.
Vamos supor que você queira anotar cada coluna com o símbolo químico apropriado. Podemos fazer isso com o papel annotation:
Na tabela de dados, definimos uma nova coluna com { role:
'annotation' }
para armazenar os rótulos das colunas:
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' ] ]);
Os usuários podem passar o cursor sobre as colunas para ver os valores dos dados, mas também é possível incluí-las nas próprias colunas:
Isso é um pouco mais complicado do que deveria ser, porque
criamos um DataView
para especificar a anotação para cada
coluna.
<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>
Se quiséssemos formatar o valor de maneira diferente, poderíamos definir um formatador e uni-lo em uma função como esta:
function getValueAt(column, dataTable, row) { return dataTable.getFormattedValue(row, column); }
Depois, podemos chamá-lo com calc: getValueAt.bind(undefined, 1)
.
Se o rótulo for muito grande para caber completamente na coluna, ele será exibido fora:
Gráficos de colunas empilhadas
Gráfico de colunas empilhadas é um gráfico de colunas que posiciona valores relacionados entre si. Se houver valores negativos, eles serão empilhados em ordem inversa abaixo da linha de base do gráfico. Geralmente, ele é usado quando uma categoria se divide naturalmente em componentes. Por exemplo, veja algumas vendas hipotéticas de livros, divididas por gênero e comparadas ao longo do tempo:
Crie um gráfico de colunas empilhadas definindo a opção isStacked
como 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, };
Os gráficos de colunas empilhadas também são compatíveis com o empilhamento de 100%, em que as pilhas dos elementos em cada
valor de domínio são redimensionadas para que totalizem 100%. As opções para isso são isStacked: 'percent'
, que formata cada valor como uma porcentagem de 100%, e isStacked: 'relative'
, que formata cada valor como uma fração de 1. Há também uma opção isStacked: 'absolute'
, que é funcionalmente equivalente a isStacked: true
.
No gráfico empilhado 100% à direita, os valores de marcação são baseados na escala relativa de 0 a 1 como frações de 1, mas os valores do eixo são exibidos como porcentagens. Isso ocorre porque
as marcações do eixo de porcentagem são o resultado da aplicação de um formato de "#.##%" aos valores de escala relativos de 0 a 1. Ao usar isStacked: 'percent'
, especifique valores de escalas/eixo
usando a escala relativa de 0 a 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] } };
Como criar gráficos de colunas do Material Design
Em 2014, anunciamos diretrizes destinadas a oferecer suporte a uma aparência comum nas propriedades e apps (como apps Android) executados em plataformas do Google. Chamamos isso de Material Design. Forneceremos versões de "Material" de todos os nossos gráficos principais. Fique à vontade para usá-los se quiser.
A criação de um gráfico de colunas do Material Design é semelhante à criação do que
chamaremos de gráfico "clássico". Carregue a API de visualização
do Google (embora com o pacote 'bar'
em vez
do pacote 'corechart'
), defina sua tabela de dados e
crie um objeto (mas da classe google.charts.Bar
em vez
de google.visualization.ColumnChart
).
Como os gráficos de barras e de colunas são basicamente idênticos, mas
para orientação, chamamos os dois gráficos de barras do Material Design, independentemente
de as barras serem verticais (clássicas, de coluna) ou
horizontais (um gráfico de barras). No Material Design, a única diferença é a
opção bars
. Quando definida como 'horizontal'
, a orientação será semelhante ao gráfico de barras clássico tradicional. Caso contrário, as barras serão verticais.
Observação: os gráficos do Material Design não funcionam em versões antigas do Internet Explorer. O IE8 e versões anteriores não são compatíveis com SVG, o que é exigido pelos gráficos do Material Design.
Os gráficos de colunas do Material Design têm muitas pequenas melhorias em relação aos gráficos de colunas clássicos, incluindo uma paleta de cores aprimorada, cantos arredondados, formatação de rótulo mais clara, espaçamento padrão mais restrito entre séries, linhas de grade mais baixas e títulos (e a adição de legendas).
<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>
Os gráficos do Material Design estão na versão Beta. A aparência e a interatividade são finais, mas muitas das opções disponíveis nos gráficos clássicos ainda não estão disponíveis nelas. Veja uma lista de opções que ainda não têm suporte
neste problema.
Além disso, a forma como as opções são declaradas não está finalizada, portanto, se você estiver usando uma das
opções clássicas, converta-a em opções substitutas substituindo essa linha:
chart.draw(data, options);
...por:
chart.draw(data, google.charts.Bar.convertOptions(options));
O uso de google.charts.Bar.convertOptions()
permite que você aproveite determinados recursos, como as opções predefinidas de hAxis/vAxis.format
.
Gráficos Y duplo
Às vezes, você vai querer mostrar duas séries em um gráfico de colunas, com dois eixos Y independentes: um eixo esquerdo para uma série e outro para a direita:
Observe que nossos dois eixos y não estão apenas rotulados de maneira diferente ("analisados" vs. "magnitude aparente"), mas cada um tem as próprias escalas e linhas de grade independentes. Se você quiser personalizar esse
comportamento, use as opções vAxis.gridlines
.
No código abaixo, as opções axes
e series
especificam a aparência dupla em Y do gráfico. A opção series
especifica qual eixo usar para cada um ('distance'
e 'brightness'
. Eles não precisam ter nenhuma relação com os nomes das colunas na tabela de dados). A opção axes
torna esse gráfico um gráfico Y, colocando o eixo 'distance'
à esquerda (rotulado como "parsecs") e o eixo 'brightness'
à direita, denominado "magnitude aparente".
<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>
Gráficos X
Observação: os eixos Top-X estão disponíveis apenas para
gráficos do Material Design (ou seja, aqueles com o pacote bar
).
Se você quiser colocar as etiquetas e o título do eixo X na parte de cima do
gráfico, não na parte de baixo, faça isso nos gráficos do Material Design com
a opção axes.x
:
<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>
Carregando
O nome do pacote google.charts.load
é "corechart"
.
O nome da classe do layout é google.visualization.ColumnChart
.
google.charts.load("current", {packages: ["corechart"]});
var visualization = new google.visualization.ColumnChart(container);
Para gráficos de colunas do Material Design, o nome do pacote
google.charts.load
é "bar"
. Não é um erro de digitação: o gráfico de barras
do Material Design processa as duas orientações.
O nome da classe da visualização é google.charts.Bar
. Não é um erro de digitação: o gráfico de barras do Material Design
processa as duas orientações.
google.charts.load("current", {packages: ["bar"]});
var chart = new google.charts.Bar(container);
Formato de dados
Cada linha da tabela representa um grupo de barras adjacentes.
Linhas:cada linha da tabela representa um grupo de barras.
Columns:
Coluna 0 | Coluna 1 | … | Coluna N | |
---|---|---|---|---|
Finalidade: | Valores da barra 1 neste grupo | … | Barra N valores neste grupo | |
Tipo de dado: | number | … | number | |
Papel: | domínio | dados | … | dados |
Papéis de coluna opcionais: | … |
Opções de configuração
Nome | |
---|---|
animação.duração |
É a duração da animação em milissegundos. Para mais detalhes, consulte a documentação de animação. Tipo: número
Padrão: 0
|
animação.easing |
A função de easing aplicada à animação. As seguintes opções estão disponíveis:
Tipo: string
Padrão: "linear"
|
animação.startup |
Determina se o gráfico vai ser animado no desenho inicial. Se Tipo: booleano
Falso padrão
|
anotações.AlwaysOutside |
Nos gráficos de
barras e
colunas, se definidos como Tipo: booleano
Padrão:falso
|
anotações.boxStyle |
Para gráficos compatíveis com
anotações,
o objeto 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 } } } }; No momento, essa opção é compatível com gráficos de área, barra, coluna, combinação, linha e dispersão. Ela não é compatível com o gráfico de anotações. Tipo: objeto
Padrão:nulo
|
anotações.datum |
Para gráficos com suporte a
anotações,
o objeto
annotations.datum permite substituir a
escolha dos gráficos do Google para anotações fornecidas para elementos de dados
individuais (como valores exibidos com cada barra em um gráfico de
barras). Você pode controlar a cor
com annotations.datum.stem.color , o comprimento do tronco
com annotations.datum.stem.length e o estilo com annotations.datum.style .
Tipo: objeto
Padrão: a cor é "preta", o comprimento é 12 e o estilo é "ponto".
|
anotações.domínio |
Para gráficos compatíveis com anotações, o objeto
annotations.domain permite substituir a escolha de gráficos do Google para anotações fornecidas para um domínio (o maior eixo do gráfico, como o eixo X em um gráfico de linhas típico). Você pode controlar a cor
com annotations.domain.stem.color , o comprimento do tronco
com annotations.domain.stem.length e o estilo com annotations.domain.style .
Tipo: objeto
Padrão:a cor é "preta", o comprimento é 5, e o estilo é "ponto".
|
anotações.highContrast |
Para gráficos compatíveis com
anotações,
o booleano
annotations.highContrast permite modificar a escolha dos
gráficos do Google na cor da anotação. Por padrão, annotations.highContrast é verdadeiro, o que faz com que
os gráficos selecionem uma cor de anotação com bom contraste: cores claras em planos de fundo escuros e
escuro na luz. Se você definir annotations.highContrast como falso e não especificar a cor da sua própria anotação, os gráficos do Google usarão a cor padrão da série para a anotação:
Tipo: booleano
Padrão: verdadeiro
|
anotações.stem |
Para gráficos compatíveis com
anotações,
o objeto
annotations.stem permite substituir
a escolha dos gráficos do Google pelo estilo da raiz. Você pode controlar a cor
com annotations.stem.color e o comprimento do tronco
com annotations.stem.length . Observe que a opção de
comprimento da base não tem efeito nas anotações com
o estilo 'line' : para anotações de datum
'line' , o comprimento da raiz é sempre o mesmo que o texto.
Para as anotações de domínio 'line' , a derivação se estende
por todo o gráfico.
Tipo: objeto
Padrão: a cor é "preta", e o comprimento é 5 para anotações do domínio e 12 para anotações de datum.
|
anotações.style |
Para gráficos com suporte a
anotações,
a opção
annotations.style permite substituir
a escolha do tipo de anotação nos Gráficos Google. Pode ser
'line' ou 'point' .
Tipo: string
Padrão: "point"
|
anotações.textStyle |
Para gráficos compatíveis com
anotações,
o objeto
annotations.textStyle controla a aparência do texto da
anotação:
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 } } }; No momento, essa opção é compatível com gráficos de área, barra, coluna, combinação, linha e dispersão. Ela não é compatível com o gráfico de anotações . Tipo: objeto
Padrão: nulo
|
TitleTitleSPosition |
Onde colocar os títulos dos eixos em comparação com a área do gráfico Os valores suportados são:
Tipo: string
Padrão: "out"
|
backgroundColor |
A cor do plano de fundo da área principal do gráfico. Pode ser uma string de cor HTML simples,
por exemplo: Tipo: string ou objeto
Padrão: "branco"
|
backgroundColor.stroke |
A cor da borda do gráfico, como uma string de cor HTML. Tipo: string
Padrão: "#666"
|
backgroundColor.strokeWidth |
A largura da borda em pixels. Tipo:número
Padrão: 0
|
backgroundColor.fill |
A cor de preenchimento do gráfico, como uma string de cor HTML. Tipo: string
Padrão: "branco"
|
Largura do grupo |
A largura de um grupo de barras, especificada em um destes formatos:
Tipo: número ou string
Padrão:
a proporção dourada,
aproximadamente 66,8%.
|
bares |
Indica se as barras em um gráfico de barras do Material são verticais ou horizontais. Essa opção não afeta os gráficos de barras clássicos nem os de colunas clássicas. Tipo: "horizontal" ou "vertical"
Padrão: "vertical"
|
Área do gráfico |
Um objeto com membros para configurar a posição e o tamanho da área do gráfico (em que o próprio gráfico é desenhado, excluindo eixo e legendas). Dois formatos são compatíveis: um número ou um número seguido por %. Um número simples é um valor em pixels. Um número seguido por % é uma porcentagem. Exemplo: Tipo: objeto
Padrão: nulo
|
chartArea.backgroundColor |
Cor de fundo da área do gráfico. Quando usada, uma string pode ser hexadecimal (por exemplo, "#fdc") ou o nome da cor em inglês. Quando um objeto é usado, é possível
fornecer as seguintes propriedades:
Tipo: string ou objeto
Padrão: "branco"
|
gráficoArea.left |
Até onde desenhar o gráfico da borda esquerda. Tipo:número ou string
Padrão: automático
|
gráficoArea.top |
Até onde desenhar o gráfico da borda superior. Tipo:número ou string
Padrão:automático
|
gráficoArea.largura |
Largura da área do gráfico. Tipo:número ou string
Padrão:automático
|
gráficoArea.height |
Altura da área do gráfico. Tipo:número ou string
Padrão:automático
|
Chart.subtitle |
Em Gráficos do Material, essa opção especifica o subtítulo. Somente os gráficos do Material Design oferecem suporte para legendas. Tipo: string
Padrão: nulo
|
gráfico.título |
Em Gráficos do Material, essa opção especifica o título. Tipo: string
Padrão:nulo
|
Cores |
As cores a serem usadas nos elementos do gráfico. Uma matriz de strings, em que cada elemento é uma string de cor HTML, por exemplo: Tipo:matriz de strings
Padrão: cores padrão
|
Opacidade dos dados |
A transparência dos pontos de dados, com 1.0 sendo completamente opaco e 0.0 totalmente transparente. Nos gráficos de dispersão, histograma, barra e coluna, isso se refere aos dados visíveis: pontos no gráfico de dispersão e retângulos nos outros. Nos gráficos em que a seleção de dados cria um ponto, como os gráficos de linhas e áreas, isso se refere aos círculos que aparecem ao passar o cursor ou selecionar. O gráfico de combinação exibe os dois comportamentos, e essa opção não afeta outros gráficos. Para mudar a opacidade de uma linha de tendência, consulte opacidade da linha de tendência . Tipo: número
Padrão: 1.0
|
enableInteractivity |
Se o gráfico gera eventos com base no usuário ou reage à interação do usuário. Se for falso, o gráfico não gerará "select" ou outros eventos baseados em interação (mas fará eventos prontos ou de erro) e não exibirá texto passando ou mudará de acordo com a entrada do usuário. Tipo: booleano
Padrão:verdadeiro
|
explorer |
A opção Esse recurso é experimental e pode mudar em versões futuras. Observação:o explorador só funciona com eixos contínuos (como números ou datas). Tipo: objeto
Padrão:nulo
|
explorer.ações |
O explorador de gráficos do Google é compatível com três ações:
Tipo: matriz de strings
Padrão: ['dragToPan', 'rightClickToReset']
|
explorador.eixo |
Por padrão, os usuários podem movimentar horizontal e verticalmente quando a opção Tipo: string
Padrão:deslocamento horizontal e vertical
|
explorer.keepInBounds |
Por padrão, os usuários podem movimentar tudo, independentemente da localização dos dados. Para garantir que não sejam deslocados além do gráfico original, use Tipo: booleano
Padrão: falso
|
explorer.maxZoomIn |
O máximo que o explorador pode aumentar o zoom. Por padrão, os usuários poderão aumentar o zoom o suficiente
para ver apenas 25% da visualização original. A definição de Tipo:número
Padrão: 0,25
|
explorer.maxZoomOut |
O máximo que o explorador pode diminuir o zoom. Por padrão, os usuários podem diminuir o zoom o suficiente para que o gráfico ocupe apenas 1/4 do espaço disponível. Definir
Tipo:número
Padrão:4
|
explorador.zoomDelta |
Quando os usuários aumentam ou diminuem o zoom, o Tipo:número
Padrão:1,5
|
Meta de foco |
É o tipo da entidade que recebe o foco ao passar o cursor. Também afeta qual entidade é selecionada pelo clique do mouse e qual elemento da tabela de dados está associado aos eventos. Será um dos seguintes valores:
Na função "target" "category", a dica mostra todos os valores de categoria. Isso pode ser útil para comparar valores de séries diferentes. Tipo: string
Padrão: "datum"
|
fontSize |
O tamanho de fonte padrão, em pixels, de todo o texto do gráfico. É possível modificar isso usando propriedades para elementos específicos do gráfico. Tipo:número
Padrão: automático
|
Nome da fonte |
A fonte padrão para todo o texto no gráfico. É possível modificar isso usando propriedades para elementos específicos do gráfico. Tipo: string
Padrão: "Arial"
|
FrameIForce |
Desenha o gráfico dentro de um frame inline. No IE8, essa opção é ignorada. Todos os gráficos do IE8 são desenhados em i-frames. Tipo: booleano
Padrão: falso
|
híbrido |
Um objeto com membros para configurar vários elementos de eixo horizontal. Para especificar propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui: { title: 'Hello', titleTextStyle: { color: '#FF0000' } } Tipo: objeto
Padrão: nulo
|
hAxis.baseline |
A linha de base do eixo horizontal. Essa opção só é compatível com um eixo Tipo: número
Padrão: automático
|
hAxis.baselineColor |
A cor do valor de referência do eixo horizontal. Pode ser qualquer string de cor HTML, por exemplo:
Essa opção só é compatível com um eixo Tipo:número
Padrão: "preto"
|
haxis.direction |
A direção em que os valores ao longo do eixo horizontal crescem. Especifique Tipo:1 ou -1
Padrão: 1
|
hAxis.format |
Uma string de formato para rótulos numéricos ou de eixo de data.
No caso dos rótulos de eixo, esse é um subconjunto do conjunto de padrões de ICU (em inglês). Por exemplo,
Para os rótulos de eixo de data, é um subconjunto do
conjunto de padrões de ICU
da formatação de data. Por exemplo, A formatação real aplicada ao rótulo é derivada da localidade com que a API foi carregada. Para mais detalhes, consulte Como carregar gráficos com uma localidade específica.
Ao calcular valores de marcação e linhas de grade, várias combinações
alternativas de todas as opções relevantes
serão consideradas, e as alternativas serão rejeitadas se os
rótulos de marcação formatados forem duplicados ou se sobrepuserem.
Portanto, especifique
Essa opção é aceita apenas para um eixo
Tipo: string
Padrão:automático
|
hAxis.gridlines |
Um objeto com propriedades para configurar as linhas de grade no eixo horizontal. As linhas de grade do eixo horizontal são desenhadas verticalmente. Para especificar propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui: {color: '#333', minSpacing: 20}
Essa opção é aceita apenas para um eixo
Tipo: objeto
Padrão:nulo
|
hAxis.gridlines.color |
A cor das linhas de grade horizontais dentro da área do gráfico. Especifique uma string de cor HTML válida. Tipo: string
Padrão: "#CCC"
|
hAxis.gridlines.count |
O número aproximado de linhas de grade horizontais na área do gráfico.
Se você especificar um número positivo para a Tipo:número
Padrão: -1
|
hAxis.gridlines.interval |
Uma matriz de tamanhos (como valores de dados, não pixels) entre as linhas de grade adjacentes. No momento, essa opção é só para eixos numéricos, mas é análoga às opções Tipo: número entre 1 e 10, sem incluir 10.
Padrão: calculado
|
hAxis.gridlines.minSpacing |
O espaço mínimo da tela, em pixels, entre as principais linhas de grade do Hadoop.
O padrão para as principais linhas de grade é Tipo: número
Padrão:calculado
|
haxis.gridlines.multiple |
Todos os valores de grade e marcação precisam ser múltiplos do
valor dessa opção. Observe que, ao contrário dos intervalos, potências de 10 vezes os múltiplos não são consideradas.
Portanto, é possível forçar as marcações como números inteiros especificando
Tipo: número
Padrão:1
|
hAxis.gridlines.units |
Substitui o formato padrão para vários aspectos dos tipos de dados de data/hora/hora do dia quando usado com linhas de grade calculadas de acordo com o gráfico. Permite a formatação de anos, meses, dias, horas, minutos, segundos e milissegundos. O formato geral é: 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*/]}, } } Mais informações podem ser encontradas em Datas e horas. Tipo: objeto
Padrão:nulo
|
hAxis.minorGridlines |
Um objeto com membros para configurar as linhas de grade secundárias no eixo horizontal, semelhante à opção hAxis.gridlines.
Essa opção é aceita apenas para um eixo
Tipo: objeto
Padrão:nulo
|
hAxis.minorGridlines.color |
A cor das linhas de grade secundárias horizontais dentro da área do gráfico. Especifique uma string de cor HTML válida. Tipo: string
Padrão: uma combinação da linha de grade e das cores do plano de fundo
|
hAxis.minorGridlines.count |
A opção Tipo:número
Padrão: 1
|
hAxis.minorGridlines.intervalo |
A opção minorGridlines.interval é como a opção do intervalo das linhas de grade principais, mas o intervalo escolhido será sempre um divisor uniforme do intervalo da linha de grade principal.
O intervalo padrão para escalas lineares é Tipo:número
Padrão: 1
|
hAxis.minorGridlines.minSpacing |
O espaço mínimo necessário, em pixels, entre as linhas de grade secundárias e as linhas de grade menores e maiores. O valor padrão é 1/2 do minSpacing das principais linhas de grade para escalas lineares e 1/5 o minSpacing para escalas de registro. Tipo: número
Padrão:calculado
|
hAxis.minorGridlines.multiple |
O mesmo que ocorre no Tipo:número
Padrão: 1
|
hAxis.minorGridlines.units |
Substitui o formato padrão para vários aspectos de tipos de dados de data/hora/hora do dia quando usado com gráfico de grade calculado. Permite a formatação de anos, meses, dias, horas, minutos, segundos e milissegundos. O formato geral é: 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*/]}, } } Mais informações podem ser encontradas em Datas e horas. Tipo: objeto
Padrão:nulo
|
hAxis.logScale |
Propriedade Essa opção só é compatível com um eixo Tipo: booleano
Padrão: falso
|
hAxis.scaleType |
Propriedade
Essa opção só é compatível com um eixo Tipo: string
Padrão: nulo
|
hAxis.textPosition |
Posição do texto do eixo horizontal em relação à área do gráfico. Valores compatíveis: "out", "in", "none". Tipo: string
Padrão: "out"
|
hAxis.textStyle |
Um objeto que especifica o estilo de texto do eixo horizontal. O objeto tem este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
O Tipo: objeto
Padrão:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
Marcações de relógio. |
Substitui as marcações do eixo X geradas automaticamente pela matriz especificada. Cada elemento da
matriz precisa ser um valor de marcação válido (como um número, data, data/hora ou
hora do dia) ou um objeto. Se for um objeto, ele precisa ter uma propriedade
A viewWindow será expandida automaticamente para incluir as marcações mínima e máxima, a menos que você especifique um Exemplos:
Essa opção é aceita apenas para um eixo
Tipo: matriz de elementos
Padrão: automático
|
hAxis.title |
Propriedade Tipo: string
Padrão: nulo
|
hAxis.titleTextStyle |
Um objeto que especifica o estilo do texto do título do eixo horizontal. O objeto tem este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
O Tipo: objeto
Padrão:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
hAxis.allowContainerBoundaryTextCutoff |
Se for falso, os rótulos externos ficarão ocultos, em vez de permitir que sejam cortados pelo contêiner do gráfico. Se verdadeiro, permitirá o corte de rótulo. Essa opção só é compatível com um eixo Tipo: booleano
Padrão:falso
|
Texto do texto do relógio (hAxis.slantedText) |
Se for verdadeiro, desenhe o texto do eixo horizontal em um ângulo para ajudar a ajustar mais texto ao longo do eixo. Se
for falso, desenhe o texto do eixo horizontal na vertical. O comportamento padrão é inclinar o texto se ele não couber
quando for desenhado para cima. Essa opção está disponível apenas quando o
Tipo: booleano
Padrão:automático
|
hAxis.slantedTextAngle |
É o ângulo do texto do eixo horizontal, se for inclinado. Ignorado se
Tipo:número, -90–90
Padrão:30
|
hAxis.maxAlternation |
Número máximo de níveis de texto no eixo horizontal. Se os rótulos de texto dos eixos ficarem sobrecarregados, o servidor poderá deslocar os rótulos vizinhos para cima ou para baixo e, assim, ajustar os rótulos mais próximos. Esse valor especifica o maior número de níveis a ser usado. O servidor poderá usar menos níveis se os rótulos puderem ser ajustados sem sobreposição. Para datas e horas, o padrão é 1. Tipo: número
Padrão:2
|
hAxis.maxTextLines |
Número máximo de linhas permitido para os rótulos de texto. Os rótulos podem abranger várias linhas se forem muito longos, e o número de linhas for, por padrão, limitado pela altura do espaço disponível. Tipo: número
Padrão: automático
|
hAxis.minTextSpacing |
Espaçamento mínimo (em pixels) permitido entre dois rótulos de texto adjacentes. Se os rótulos forem muito espaçados ou muito longos, o espaçamento poderá cair abaixo desse limite e, nesse caso, uma das medidas de organização será aplicada (por exemplo, truncando os rótulos ou soltando alguns deles). Tipo: número
Padrão:o valor de
hAxis.textStyle.fontSize |
hAxis.showTextEvery |
Quantos rótulos de eixo horizontal serão mostrados, em que 1 significa para mostrar todos os rótulos, 2 para mostrar todos os outros rótulos e assim por diante. O padrão é tentar mostrar o máximo possível de rótulos sem sobreposição. Tipo: número
Padrão:automático
|
hAxis.maxValue |
Move o valor máximo do eixo horizontal para o valor especificado; ele será direcionado para a direita na maioria dos gráficos. Será ignorado se esse valor for menor que o valor máximo de x dos dados.
Essa opção é aceita apenas para um eixo
Tipo: número
Padrão: automático
|
hAxis.minValue |
Move o valor mínimo do eixo horizontal para o valor especificado. Esse valor será deixado para a esquerda na maioria dos gráficos. Será ignorado se esse valor for maior que o valor x mínimo dos dados.
Essa opção é aceita apenas para um eixo
Tipo: número
Padrão: automático
|
hAxis.viewWindowMode |
Especifica como dimensionar o eixo horizontal para renderizar os valores na área do gráfico. Os seguintes valores de string são compatíveis:
Essa opção é aceita apenas para um eixo
Tipo: string
Padrão:equivalente a "pretinho", mas
haxis.viewWindow.min e
haxis.viewWindow.max têm precedência, se usados.
|
hAxis.viewWindow |
Especifica o intervalo de corte do eixo horizontal. Tipo: objeto
Padrão:nulo
|
hAxis.viewWindow.max |
Ignorado quando Tipo: número
Padrão: automático
|
hAxis.viewWindow.min |
Ignorado quando Tipo: número
Padrão: automático
|
altura |
Altura do gráfico, em pixels. Tipo: número
Padrão:altura do elemento em questão
|
empilhado |
Se definido como verdadeiro, empilha os elementos para todas as séries em cada valor de domínio. Observação:nos gráficos Column, Area e SteppedArea, o Google Graph inverte a ordem dos itens de legenda para corresponder melhor ao empilhamento dos elementos da série (por exemplo, a série 0 será o item de legenda mais abaixo). Isso não se aplica a gráficos de barras.
A opção As opções para
Para 100% de empilhamento, o valor calculado de cada elemento aparecerá na dica depois do valor real.
Por padrão, o eixo desejado vai usar valores de escala com base na escala relativa de 0 a 1, como frações de 1 a
O empilhamento de 100% é compatível apenas com valores de dados do tipo Tipo:booleano/string
Padrão:falso
|
lenda |
Um objeto com membros para configurar vários aspectos da legenda. Para especificar as propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui: {position: 'top', textStyle: {color: 'blue', fontSize: 16}} Tipo: objeto
Padrão:nulo
|
legenda.pagina |
Índice inicial selecionado da página com base em zero da legenda. Tipo: número
Padrão:0
|
legenda.posição |
Posição da legenda. Será um dos seguintes valores:
Tipo: string
Padrão: "right"
|
legenda.alinhamento |
Alinhamento da legenda. Será um dos seguintes valores:
O início, o centro e o fim são relativos ao estilo (vertical ou horizontal) da legenda. Por exemplo, em uma legenda "direita", "início" e "fim" estão na parte superior e inferior, respectivamente. Para uma legenda "superior", "início" e "fim" estariam à esquerda e à direita da área, respectivamente. O valor padrão depende da posição da legenda. Para legendas "inferior", o padrão é "center", outras legendas padrão são "start". Tipo: string
Padrão:automático
|
legenda.Estilodetexto |
Um objeto que especifica o estilo do texto da legenda. O objeto tem este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
O Tipo: objeto
Padrão:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
orientação |
A orientação do gráfico. Quando definido como Tipo: string
Padrão: "horizontal"
|
categorias inversas |
Se definida como verdadeira, a série será desenhada da direita para a esquerda. O padrão é desenhar da esquerda para a direita.
Essa opção é compatível apenas com um eixo
Tipo: booleano
Padrão: falso
|
Série |
Uma matriz de objetos, cada um descrevendo o formato da série correspondente no gráfico. Para usar valores padrão para uma série, especifique um objeto vazio {}. Se uma série ou um valor não for especificado, o valor global será usado. Cada objeto oferece suporte às seguintes propriedades:
É possível especificar uma matriz de objetos, sendo que cada uma delas se aplica à série na ordem fornecida, ou especificar um objeto em que cada filho tem uma chave numérica indicando a qual série ela se aplica. Por exemplo, as duas declarações a seguir são idênticas e declaram a primeira série como preta e ausente da legenda, e a quarta como vermelha e ausente da legenda: series: [ {color: 'black', visibleInLegend: false}, {}, {}, {color: 'red', visibleInLegend: false} ] series: { 0:{color: 'black', visibleInLegend: false}, 3:{color: 'red', visibleInLegend: false} } Tipo: matriz de objetos ou objetos com objetos aninhados
Padrão: {}
|
tema |
Um tema é um conjunto de valores de opção predefinidos que funcionam juntos para alcançar um comportamento ou efeito visual específico. Atualmente, apenas um tema está disponível:
Tipo: string
Padrão:nulo
|
title |
Texto a ser exibido acima do gráfico. Tipo: string
Padrão:sem título
|
Posição do título |
Onde colocar o título do gráfico, em comparação com a área do gráfico. Os valores suportados são:
Tipo: string
Padrão: "out"
|
TítulodoEstiloEstilo |
Um objeto que especifica o estilo do texto do título. O objeto tem este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
O Tipo: objeto
Padrão:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
dica |
Um objeto com membros para configurar vários elementos de dica. Para especificar as propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui: {textStyle: {color: '#FF0000'}, showColorCode: true} Tipo: objeto
Padrão:nulo
|
tooltip.ignoreBounds |
Se definido como Observação: isso se aplica somente a dicas de HTML. Se ele estiver ativado com dicas de ferramentas SVG, qualquer estouro fora dos limites do gráfico será cortado. Consulte Como personalizar o conteúdo de dicas para mais detalhes. Tipo: booleano
Padrão: falso
|
tooltip.isHTML |
Se definida como verdadeira, use dicas renderizadas por HTML (em vez de renderizadas por SVG). Consulte Como personalizar o conteúdo de dicas para mais detalhes. Observação: a personalização do conteúdo da dica de HTML por meio do papel de dados da coluna de dica de ferramenta não é aceita pela visualização Gráfico de bolhas. Tipo: booleano
Padrão: falso
|
tooltip.showColorCode |
Se verdadeiro, mostra quadrados coloridos ao lado das informações da série na dica. O padrão é
verdadeiro quando Tipo: booleano
Padrão: automático
|
tooltip.textStyle |
Um objeto que especifica o estilo do texto da dica. O objeto tem este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
O Tipo: objeto
Padrão:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
tooltip.trigger |
A interação do usuário que faz com que a dica seja exibida:
Tipo: string
Padrão: "focus"
|
linhas de tendência |
Exibe
linhas de tendência
nos gráficos compatíveis. Por padrão, as linhas de tendência lineares são
usadas, mas isso pode ser personalizado com a opção
As linhas de tendência são especificadas por série, portanto, na maioria das vezes, suas opções terão esta aparência: var options = { trendlines: { 0: { type: 'linear', color: 'green', lineWidth: 3, opacity: 0.3, showR2: true, visibleInLegend: true } } } Tipo: objeto
Padrão: nulo
|
linelines.n.color |
A cor da linha de tendência , expressa como um nome de cor em inglês ou uma string hexadecimal. Tipo: string
Padrão: cor padrão da série
|
linhas de tendência.n |
Para
linhas de tendência
de Tipo:número
Padrão:3
|
linelines.n.labelInLegend |
Se definida, a linha de tendência vai aparecer na legenda como essa string. Tipo: string
Padrão:nulo
|
tendêncialines.n.lineWidth |
A largura da linha de tendência em pixels. Tipo: número
Padrão:2
|
linelines.n.opacity |
É a transparência da linha de tendência , de 0,0 (transparente) a 1,0 (opaca). Tipo:número
Padrão:1.0
|
linelines.n.pointSize |
As
linhas de tendência
são marcadas com a inclusão de vários pontos no gráfico. Com essa opção raramente necessária, é possível
personalizar o tamanho dos pontos. A opção Tipo: número
Padrão: 1
|
linelines.n.pointsVisible |
As linhas de tendência são incluídas com a marcação de vários pontos no gráfico. A opção Tipo: booleano
Padrão: verdadeiro
|
Linhas de tendência.n.showR2 |
Mostra o coeficiente de determinação na dica de legenda ou linha de tendência. Tipo: booleano
Padrão:falso
|
linelines.n.type |
Define se as
linhas de tendência
são Tipo: string
Padrão: linear
|
Linhas de tendência.n.visibleInLegend |
Se a equação da linha de tendência aparece na legenda. Ela vai aparecer na dica da linha de tendência. Tipo: booleano
Padrão: falso
|
Axx |
Especifica propriedades para eixos verticais individuais, se o gráfico tiver vários eixos verticais.
Cada objeto filho é um objeto
Para especificar um gráfico com vários eixos verticais, primeiro defina um novo eixo usando { series: { 2: { targetAxisIndex:1 } }, vAxes: { 1: { title:'Losses', textStyle: {color: 'red'} } } }
Essa propriedade pode ser um objeto ou uma matriz: o objeto é uma coleção de objetos,
cada uma com um rótulo numérico que especifica o eixo que define. Esse é o formato mostrado
acima. A matriz é uma matriz de objetos, um por eixo. Por exemplo, a seguinte notação de estilo de matriz é idêntica ao objeto vAxes: [ {}, // Nothing specified for axis 0 { title:'Losses', textStyle: {color: 'red'} // Axis 1 } ] Tipo: matriz de objeto ou objeto com objetos filhos
Padrão: nulo
|
Eixo |
Um objeto com membros para configurar vários elementos de eixo vertical. Para especificar as propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui: {title: 'Hello', titleTextStyle: {color: '#FF0000'}} Tipo: objeto
Padrão:nulo
|
vAxis.baseline |
Propriedade Tipo: número
Padrão: automático
|
vAxis.baselineColor |
Especifica a cor do valor de referência do eixo vertical. Pode ser qualquer string de cor HTML, por exemplo, Tipo: número
Padrão: "preto"
|
vAxis.direction |
A direção em que os valores ao longo do eixo vertical crescem. Por padrão, os valores mais baixos ficam na parte inferior do gráfico. Especifique Tipo:1 ou -1
Padrão:1
|
vAxis.format |
Uma string de formato para rótulos de eixo numérico. Esse é um subconjunto do
conjunto de padrões de ICU
.
Por exemplo,
A formatação real aplicada ao rótulo é derivada da localidade com que a API foi carregada. Para mais detalhes, consulte Como carregar gráficos com uma localidade específica.
Ao calcular valores de marcação e linhas de grade, várias combinações
alternativas de todas as opções relevantes
serão consideradas, e as alternativas serão rejeitadas se os
rótulos de marcação formatados forem duplicados ou se sobrepuserem.
Portanto, especifique Tipo: string
Padrão: automático
|
vAxis.gridlines |
Um objeto com membros para configurar as linhas de grade no eixo vertical. As linhas de grade do eixo vertical são desenhadas horizontalmente. Para especificar propriedades desse objeto, use a notação literal de objeto, conforme mostrado aqui: {color: '#333', minSpacing: 20} Tipo: objeto
Padrão: nulo
|
vAxis.gridlines.color |
A cor das linhas de grade verticais dentro da área do gráfico. Especifique uma string de cor HTML válida. Tipo: string
Padrão: "#CCC"
|
vAxis.gridlines.count |
O número aproximado de linhas de grade horizontais na área do gráfico.
Se você especificar um número positivo para a Tipo: número
Padrão: -1
|
vAxis.gridlines.interval |
Uma matriz de tamanhos (como valores de dados, não pixels) entre as linhas de grade adjacentes. No momento, essa opção é só para eixos numéricos, mas é análoga às opções Tipo:número entre 1 e 10, sem incluir 10.
Padrão:calculado
|
vAxis.gridlines.minSpacing |
O espaço mínimo da tela, em pixels, entre as principais linhas de grade do Hadoop.
O padrão para as principais linhas de grade é Tipo:número
Padrão: calculado
|
vAxis.gridlines.multiple |
Todos os valores de grade e marcação precisam ser múltiplos do
valor dessa opção. Observe que, ao contrário dos intervalos, potências de 10 vezes os múltiplos não são consideradas.
Portanto, é possível forçar as marcações como números inteiros especificando
Tipo:número
Padrão:1
|
vAxis.gridlines.units |
Substitui o formato padrão para vários aspectos dos tipos de dados de data/hora/hora do dia quando usado com linhas de grade calculadas de acordo com o gráfico. Permite a formatação de anos, meses, dias, horas, minutos, segundos e milissegundos. O formato geral é: 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*/]} } } Mais informações podem ser encontradas em Datas e horas. Tipo: objeto
Padrão: nulo
|
vAxis.minorGridlines |
Um objeto com membros para configurar as linhas de grade secundárias no eixo vertical, semelhante à opção vAxis.gridlines. Tipo: objeto
Padrão:nulo
|
vAxis.minorGridlines.color |
A cor das pequenas linhas de grade verticais dentro da área do gráfico. Especifique uma string de cor HTML válida. Tipo: string
Padrão: uma combinação da linha de grade e das cores do plano de fundo
|
vAxis.minorGridlines.count |
O uso da opção minorGridlines.count foi descontinuado, exceto pela desativação de linhas de grade menores, definindo a contagem como 0. O número de linhas de grade secundárias depende do intervalo entre as linhas de grade principais (consulte vAxis.gridlines.interval) e o espaço mínimo necessário (consulte vAxis.minorGridlines.minSpacing). Tipo:número
Padrão: 1
|
vAxis.minorGridlines.intervalo |
A opção minorGridlines.interval é como a opção do intervalo das linhas de grade principais, mas o intervalo escolhido será sempre um divisor uniforme do intervalo da linha de grade principal.
O intervalo padrão para escalas lineares é Tipo: número
Padrão: 1
|
vAxis.minorGridlines.minSpacing |
O espaço mínimo necessário, em pixels, entre as linhas de grade secundárias e as linhas de grade menores e maiores. O valor padrão é 1/2 do minSpacing das principais linhas de grade para escalas lineares e 1/5 o minSpacing para escalas de registro. Tipo:número
Padrão:calculado
|
vAxis.minorGridlines.multiple |
O mesmo que ocorre no Tipo: número
Padrão:1
|
vAxis.minorGridlines.units |
Substitui o formato padrão para vários aspectos de tipos de dados de data/hora/hora do dia quando usado com gráfico de grade calculado. Permite a formatação de anos, meses, dias, horas, minutos, segundos e milissegundos. O formato geral é: 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*/]}, } } Mais informações podem ser encontradas em Datas e horas. Tipo: objeto
Padrão:nulo
|
vAxis.logScale |
Se for verdadeiro, torna o eixo vertical uma escala logarítmica. Observação: todos os valores precisam ser positivos. Tipo: booleano
Padrão: falso
|
vAxis.scaleType |
Propriedade
Essa opção só é compatível com um eixo Tipo: string
Padrão:nulo
|
vAxis.textPosition |
Posição do texto do eixo vertical em relação à área do gráfico. Valores compatíveis: "out", "in", "none". Tipo: string
Padrão: "out"
|
vAxis.textStyle |
Um objeto que especifica o estilo de texto do eixo vertical. O objeto tem este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
O Tipo: objeto
Padrão:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
Marcas de vídeo. |
Substitui as marcações do eixo Y geradas automaticamente pela matriz especificada. Cada elemento da
matriz precisa ser um valor de marcação válido (como um número, data, data/hora ou
hora do dia) ou um objeto. Se for um objeto, ele precisará ter uma propriedade
A viewWindow será expandida automaticamente para incluir as marcações mínima e máxima, a menos que você especifique um Exemplos:
Tipo:matriz de elementos
Padrão:automático
|
vAxis.title |
Propriedade Tipo: string
Padrão:sem título
|
vAxis.titleTextStyle |
Um objeto que especifica o estilo do texto do título do eixo vertical. O objeto tem este formato: { color: <string>, fontName: <string>, fontSize: <number>, bold: <boolean>, italic: <boolean> }
O Tipo: objeto
Padrão:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
vAxis.maxValue |
Move o valor máximo do eixo vertical para o valor especificado; isso será crescente na maioria dos gráficos. Será ignorado se esse valor for definido como um valor menor que o valor y máximo dos dados.
Tipo: número
Padrão:automático
|
vAxis.minValue |
Move o valor mínimo do eixo vertical para o valor especificado. Esse valor será decrescente na maioria dos gráficos. Será ignorado se esse valor for maior que o valor y mínimo dos dados.
Tipo: número
Padrão:nulo
|
vAxis.viewWindowMode |
Especifica como dimensionar o eixo vertical para renderizar os valores na área do gráfico. Os seguintes valores de string são compatíveis:
Tipo: string
Padrão:equivalente a "pretinho", mas
vaxis.viewWindow.min e
vaxis.viewWindow.max têm precedência, se usados.
|
vAxis.viewWindow |
Especifica o intervalo de corte do eixo vertical. Tipo: objeto
Padrão: nulo
|
vAxis.viewWindow.max |
O valor máximo de dados verticais para renderização. Ignorado quando Tipo:número
Padrão: automático
|
vAxis.viewWindow.min |
O valor mínimo de dados verticais para renderização. Ignorado quando Tipo:número
Padrão:automático
|
largura |
Largura do gráfico, em pixels. Tipo: número
Padrão: largura do elemento contido
|
Métodos
Método | |
---|---|
draw(data, options) |
Desenha o gráfico. O gráfico aceita mais chamadas de método somente após o evento Tipo de retorno:nenhum
|
getAction(actionID) |
Retorna o objeto de ação da dica com a Return Type: objeto
|
getBoundingBox(id) |
Retorna um objeto que contém os elementos esquerdo, superior, largura e altura do elemento do gráfico
Os valores são relativos ao contêiner do gráfico. Chame essa função após o gráfico ser desenhado. Return Type: objeto
|
getChartAreaBoundingBox() |
Retorna um objeto que contém o lado esquerdo, o topo, a largura e a altura do conteúdo do gráfico (ou seja, excluir rótulos e legendas):
Os valores são relativos ao contêiner do gráfico. Chame essa função após o gráfico ser desenhado. Return Type: objeto
|
getChartLayoutInterface() |
Retorna um objeto que contém informações sobre o posicionamento na tela do gráfico e os elementos dele. Os seguintes métodos podem ser chamados no objeto retornado:
Chame essa função após o gráfico ser desenhado. Return Type: objeto
|
getHAxisValue(xPosition, optional_axis_index) |
Retorna o valor de dados horizontal em Exemplo: Chame essa função após o gráfico ser desenhado. Tipo de retorno: número
|
getImageURI() |
Retorna o gráfico serializado como um URI de imagem. Chame essa função após o gráfico ser desenhado. Consulte Como imprimir gráficos PNG. Tipo de retorno: string
|
getSelection() |
Retorna uma matriz das entidades do gráfico selecionadas.
Entidades selecionáveis são barras, entradas de legenda e categorias.
Uma barra corresponde a uma célula da tabela de dados, uma entrada de legenda a uma coluna (o índice da linha é nulo) e uma categoria a uma linha (o índice da coluna é nulo).
Nesse gráfico, apenas uma entidade pode ser selecionada por vez.
Tipo de retorno:matriz de elementos de seleção
|
getVAxisValue(yPosition, optional_axis_index) |
Retorna o valor de dados verticais em Exemplo: Chame essa função após o gráfico ser desenhado. Tipo de retorno: número
|
getXLocation(dataValue, optional_axis_index) |
Retorna a coordenada X de pixel de Exemplo: Chame essa função após o gráfico ser desenhado. Tipo de retorno: número
|
getYLocation(dataValue, optional_axis_index) |
Retorna a coordenada y de pixel de Exemplo: Chame essa função após o gráfico ser desenhado. Tipo de retorno:número
|
removeAction(actionID) |
Remove a ação de dica com a Tipo de retorno:
none |
setAction(action) |
Define uma ação de dica a ser executada quando o usuário clica no texto de ação.
O método
Toda e qualquer ação de dica precisa ser definida antes de chamar o método Tipo de retorno:
none |
setSelection() |
Seleciona as entidades do gráfico especificadas. Cancela qualquer seleção anterior.
Entidades selecionáveis são barras, entradas de legenda e categorias.
Uma barra corresponde a uma célula da tabela de dados, uma entrada de legenda a uma coluna (o índice da linha é nulo) e uma categoria a uma linha (o índice da coluna é nulo).
Somente uma entidade pode ser selecionada por vez para este gráfico.
Tipo de retorno: nenhum
|
clearChart() |
Limpa o gráfico e libera todos os recursos alocados. Tipo de retorno:nenhum
|
Eventos
Para mais informações sobre como usar esses eventos, consulte Interatividade básica, Como lidar com eventos e Eventos de disparo.
Nome | |
---|---|
animationfinish |
Disparado quando a animação de transição é concluída. Propriedades:nenhuma
|
click |
Disparado quando o usuário clica dentro do gráfico. Pode ser usado para identificar quando o título, os elementos de dados, as entradas de legendas, os eixos, as linhas de grade ou os rótulos são clicados. Propriedades: targetID.
|
error |
Disparado quando ocorre um erro ao tentar renderizar o gráfico. Propriedades:ID e mensagem
|
legendpagination |
Disparado quando o usuário clica nas setas de paginação de legenda. Retorna o índice de páginas atual com base em zero e o número total de páginas. Propriedades:currentPageIndex, totalPages
|
onmouseover |
Disparado quando o usuário passa o mouse sobre uma entidade visual. Transmite os índices de linha e coluna do elemento da tabela de dados correspondente. Propriedades: linha, coluna
|
onmouseout |
Disparado quando o usuário passa o mouse sobre uma entidade visual. Retorna os índices de linha e coluna do elemento da tabela de dados correspondente. Propriedades: linha, coluna
|
ready |
O gráfico está pronto para chamadas de método externo. Se você quiser interagir com o gráfico e chamar métodos depois de desenhá-lo, configure um listener para esse evento antes de chamar o método Propriedades: nenhuma
|
select |
Disparado quando o usuário clica em uma entidade visual. Para saber o que foi selecionado, chame
Propriedades: nenhuma
|
Política de dados
Todos os códigos e dados são processados e renderizados no navegador. Nenhum dado é enviado para nenhum servidor.