Gráficos de velas

• 'category': agrupa os dados selecionados por valor x.
• 'series': agrupa os dados selecionados por série.
• 'auto': agrupa os dados selecionados por valor x se todas as seleções tiverem o mesmo valor. Caso contrário, por série.
• 'none': mostra apenas uma dica por seleção.

var options = {
  // Allow multiple
  // simultaneous selections.
  selectionMode: 'multiple',
  // Trigger tooltips
  // on selections.
  tooltip: {trigger: 'selection'},
  // Group selections
  // by x-value.
  aggregationTarget: 'category',
};
    

É a duração da animação, em milissegundos. Para ver mais detalhes, consulte a documentação de animação.

A função de easing aplicada à animação. As seguintes opções estão disponíveis:

• 'linear' - velocidade constante.
• "In" (aceleração) - Inicie devagar e acelere.
• "out" (abrandamento): inicie rápido e desacelere.
• "inAndOut" - Acelerar e desacelerar - Inicie devagar, acelere e depois desacelere.

Determina se o gráfico será animado no desenho inicial. Se definido como true, o gráfico começará no valor de referência e será animado para o estado final.

Onde posicionar os títulos dos eixos em comparação com a área do gráfico. Valores compatíveis:

• in - desenha os títulos dos eixos dentro da área do gráfico.
• out - desenha os títulos dos eixos fora da área do gráfico.
• nenhum: omite os títulos dos eixos.

A cor de plano de fundo da área principal do gráfico. Pode ser uma string de cor HTML simples, por exemplo: 'red' ou '#00cc00', ou um objeto com as propriedades a seguir.

A cor da borda do gráfico, como uma string de cor HTML.

A largura da borda, em pixels.

A cor de preenchimento do gráfico, como uma string de cor HTML.

• Pixels (por exemplo, 50).
• Porcentagem da largura disponível para cada grupo (por exemplo, "20%"), em que "100%" significa que os grupos não têm espaço entre eles.

Se verdadeiro, as velas em ascensão vão parecer vazias, e as velas caindo, sólidas, caso contrário, o oposto.

A cor de preenchimento de velas em queda, como uma string de cor HTML.

A cor do traço das velas em queda, como uma string de cor HTML.

A largura do traço das velas em queda, como uma string de cor HTML.

A cor de preenchimento de velas em ascensão, como uma string de cor HTML.

A cor do traço das velas em ascensão, como uma string de cor HTML.

A largura do traço das velas em ascensão, como uma string de cor HTML.

Um objeto com membros para configurar o posicionamento e o tamanho da área do gráfico (onde 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, enquanto um número seguido por % é uma porcentagem. Exemplo: chartArea:{left:20,top:0,width:'50%',height:'75%'}

• stroke: a cor, fornecida como uma string hexadecimal ou nome da cor em inglês.
• strokeWidth: se fornecido, desenha uma borda ao redor da área do gráfico com a largura especificada (e com a cor stroke).

A distância da borda esquerda a desenhar o gráfico.

Indica a distância entre a borda superior e o gráfico a partir da borda superior.

Largura da área do gráfico.

Altura da área do gráfico.

As cores a serem usadas para os elementos do gráfico. Uma matriz de strings, em que cada elemento é uma string de cor HTML, por exemplo: colors:['red','#004411'].

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 vai gerar "select" ou outros eventos baseados em interação (mas vai gerar eventos prontos ou de erro) e não vai mostrar texto de passar o cursor nem mudar de acordo com a entrada do usuário.

O tipo de 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. Pode ser uma das seguintes opções:

• "datum" - concentra-se em um único ponto de dados. Correlaciona-se a uma célula na tabela de dados.
• "categoria" - concentra-se em um agrupamento de todos os pontos de dados ao longo do eixo principal. Corresponde a uma linha na tabela de dados.

Em FocusTarget 'category', a dica de ferramenta mostra todos os valores da categoria. Isso pode ser útil para comparar valores de séries diferentes.

O tamanho da fonte padrão, em pixels, de todo o texto no gráfico. É possível modificar isso usando propriedades de elementos específicos do gráfico.

O tipo de fonte padrão para todo o texto no gráfico. É possível modificar isso usando propriedades de elementos específicos do gráfico.

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.

Um objeto com membros para configurar vários elementos do eixo horizontal. Para especificar as propriedades desse objeto, use a notação literal de objeto, como mostrado aqui:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    

A linha de base do eixo horizontal.

Essa opção só é compatível com um eixo continuous.

A cor da linha de base do eixo horizontal. Pode ser qualquer string de cor HTML, por exemplo: 'red' ou '#00cc00'.

Essa opção só é compatível com um eixo continuous.

A direção em que os valores ao longo do eixo horizontal crescem. Especifique -1 para inverter a ordem dos valores.

Uma string de formato para rótulos numéricos ou de data do eixo.

Para rótulos de eixo numérico, esse é um subconjunto do conjunto de padrões de ICU de formatação decimal. Por exemplo, {format:'#,###%'} exibirá os valores "1.000%", "750%" e "50%" para os valores 10, 7,5 e 0,5. Também é possível fornecer qualquer um dos seguintes:

• {format: 'none'}: mostra números sem formatação (por exemplo, 8.000.000)
• {format: 'decimal'}: exibe números com separadores de milhares (por exemplo, 8.000.000)
• {format: 'scientific'}: mostra números em notação científica (por exemplo, 8e6)
• {format: 'currency'}: exibe os números na moeda local (por exemplo, USD 8.000.000,00)
• {format: 'percent'}: mostra números como porcentagens (por exemplo, 800.000.000%)
• {format: 'short'}: mostra números abreviados (por exemplo, 8 mi)
• {format: 'long'}: exibe números como palavras inteiras (por exemplo, 8 milhões)

Para rótulos de eixo de data, esse é um subconjunto do conjunto de padrões de ICU de formatação de datas. Por exemplo, {format:'MMM d, y'} exibirá o valor "1o de julho de 2011" para a primeira data de julho de 2011.

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 .

No cálculo de valores de marcação e linhas de grade, várias combinações alternativas de todas as opções de linha de grade relevantes serão consideradas, e alternativas serão rejeitadas se os rótulos de marcação formatados forem duplicados ou sobrepostos. Portanto, você pode especificar format:"#" se quiser mostrar apenas valores de marcação inteiros, mas saiba que, se nenhuma alternativa satisfizer essa condição, nenhuma linha de grade ou marcação será mostrada.

Essa opção só é compatível com um eixo continuous.

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 as propriedades desse objeto, use a notação literal de objeto, como mostrado aqui:

{color: '#333', minSpacing: 20}

Essa opção só é compatível com um eixo continuous.

A cor das linhas de grade horizontais dentro da área do gráfico. Especifique uma string de cor HTML válida.

O número aproximado de linhas de grade horizontais dentro da área do gráfico. Se você especificar um número positivo para gridlines.count, ele será usado para calcular minSpacing entre as linhas de grade. Você pode especificar um valor de 1 para desenhar apenas uma linha de grade ou 0 para não desenhar linhas de grade. Especifique -1, que é o padrão, para calcular automaticamente o número de linhas de grade com base em outras opções.

Uma matriz de tamanhos (como valores de dados, e não pixels) entre linhas de grade adjacentes. No momento, essa opção é apenas para eixos numéricos, mas é análoga às opções gridlines.units.<unit>.interval, que são usadas apenas para datas e horas. Para escalas lineares, o padrão é [1, 2, 2.5, 5], o que significa que os valores das linhas de grade podem estar em todas as unidades (1), em unidades pares (2) ou em múltiplos de 2,5 ou 5. Qualquer potência de 10 vezes esses valores também é considerada (por exemplo, [10, 20, 25, 50] e [0,1, 0,2, 0,25, 0,5]). Para escalas de registro, o padrão é [1, 2, 5].

O espaço mínimo na tela, em pixels, entre as principais linhas de grade do eixo h. O padrão para as principais linhas de grade é 40 para escalas lineares e 20 para escalas de registro. Se você especificar o count e não o minSpacing, o minSpacing será calculado com base na contagem. Por outro lado, se você especificar o minSpacing e não o count, a contagem será calculada com base no minSpacing. Se você especificar ambos, o minSpacing vai substituir.

Todos os valores de linhas de grade e escalas precisam ser múltiplos do valor desta opção. Observe que, ao contrário dos intervalos, potências de 10 vezes o múltiplo não são consideradas. Portanto, você pode forçar as marcações a serem números inteiros especificando gridlines.multiple = 1 ou forçar elas a serem múltiplas de 1.000 especificando gridlines.multiple = 1000.

Modifica o formato padrão para vários aspectos dos tipos de dados de data/hora/hora/hora quando usados com linhas de grade calculadas em gráficos. Permite a formatação para 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*/]},
  }
}
    

Para mais informações, consulte Datas e horas.

Um objeto com membros para configurar as linhas de grade secundárias no eixo horizontal, semelhante à opção hAxis.gridlines.

Essa opção só é compatível com um eixo continuous.

A cor das linhas de grade menores horizontais dentro da área do gráfico. Especifique uma string de cor HTML válida.

A opção smallGridlines.interval é como a opção de intervalo das linhas de grade principais, mas o intervalo escolhido sempre será um divisor par do intervalo da linha de grade principal. O intervalo padrão para escalas lineares é [1, 1.5, 2, 2.5, 5] e para escalas de registro é [1, 2, 5].

O espaço mínimo necessário, em pixels, entre linhas de grade secundárias adjacentes e entre linhas de grade secundárias e principais. O valor padrão é 1/2 do minSpacing das principais linhas de grade para escalas lineares e 1/5 do minSpacing para escalas de registro.

Igual à gridlines.multiple principal.

A opção minorGridlines.count foi descontinuada na maioria das vezes, exceto para desativar linhas de grade secundárias definindo a contagem como 0. O número de linhas de grade secundárias agora depende totalmente do intervalo entre as principais linhas de grade (consulte hAxis.gridlines.interval) e o espaço mínimo necessário (consulte hAxis.minorGridlines.minSpacing).

Substitui o formato padrão de vários aspectos dos tipos de dados date/datetime/timeofday quando usados com smallGridlines calculadas em gráfico. Permite a formatação para 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*/]},
  }
}
    

Para mais informações, consulte Datas e horas.

Propriedade hAxis que torna o eixo horizontal uma escala logarítmica (exige que todos os valores sejam positivos). Defina como verdadeiro para sim.

Essa opção só é compatível com um eixo continuous.

A propriedade hAxis que transforma o eixo horizontal em uma escala logarítmica. Será um dos seguintes valores:

• nulo: nenhum dimensionamento logarítmico é executado.
• "log" - dimensionamento logarítmico. Valores negativos e zero não são representados no gráfico. Essa opção é igual à configuração de hAxis: { logscale: true }.
• "mirrorLog": escala logarítmica em que valores negativos e zero são representados no gráfico. O valor plotado de um número negativo é o negativo do log do valor absoluto. Valores próximos a 0 são representados em uma escala linear.

Essa opção só é compatível com um eixo continuous.

Posição do texto do eixo horizontal em relação à área do gráfico. Valores aceitos: 'out', 'in', 'none'.

Um objeto que especifica o estilo do texto do eixo horizontal. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

O color pode ser qualquer string de cor HTML, como 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Substitui as marcas do eixo X geradas automaticamente pela matriz especificada. Cada elemento da matriz deve ser um valor de marcação válido (como um número, data, data e hora ou timeofday) ou um objeto. Se for um objeto, ele precisará ter uma propriedade v para o valor da marcação e uma propriedade f opcional contendo a string literal a ser exibida como o rótulo.

A viewWindow será expandida automaticamente para incluir as marcações mínima e máxima, a menos que você especifique um viewWindow.min ou viewWindow.max para substituir.

Por exemplo:

• hAxis: { ticks: [5,10,15,20] }
• hAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• hAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• hAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

Essa opção só é compatível com um eixo continuous.

A propriedade hAxis que especifica o título do eixo horizontal.

Um objeto que especifica o estilo de texto do título do eixo horizontal. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

O color pode ser qualquer string de cor HTML, como 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Se for falso, ocultará os rótulos mais externos em vez de permitir que eles sejam cortados pelo contêiner do gráfico. Se verdadeiro, permitirá o corte de rótulos.

Essa opção só é compatível com um eixo discrete.

Se verdadeiro, desenhe o texto do eixo horizontal em um ângulo para ajudar a encaixar mais texto ao longo do eixo. Se falso, desenhe o texto do eixo horizontal na vertical. O comportamento padrão é inclinar o texto se ele não encaixar na posição vertical. Essa opção está disponível apenas quando hAxis.textPosition está definido como "out" (que é o padrão). O padrão é false para datas e horas.

É o ângulo do texto do eixo horizontal, se ele tiver sido desenhado inclinado. Ignorado se hAxis.slantedText for false ou estiver no modo automático e o gráfico decidir desenhar o texto horizontalmente. Se o ângulo for positivo, a rotação será no sentido anti-horário e, se negativo, será no sentido horário.

Número máximo de níveis de texto do eixo horizontal. Se os rótulos de texto do eixo ficarem muito poluídos, o servidor poderá deslocar os rótulos vizinhos para cima ou para baixo a fim de aproximá-los. Esse valor especifica o maior número de níveis a ser usado. O servidor pode usar menos níveis, se os rótulos couberem sem se sobrepor. Para datas e horas, o padrão é 1.

Número máximo de linhas permitidas para os rótulos de texto. Os rótulos podem abranger várias linhas se forem muito longos, e o número de linhas é, por padrão, limitado pela altura do espaço disponível.

Espaçamento horizontal mínimo, em pixels, permitido entre dois rótulos de texto adjacentes. Se os rótulos forem muito densos ou muito longos, o espaçamento poderá ficar abaixo desse limite e, nesse caso, uma das medidas de organização de rótulos será aplicada (por exemplo, truncando os rótulos ou descartando alguns deles).

Quantos rótulos de eixo horizontal serão exibidos, em que 1 significa mostrar todos os rótulos, 2 significa mostrar todos os outros rótulos e assim por diante. O padrão é tentar mostrar o maior número possível de rótulos sem sobreposição.

Move o valor máximo do eixo horizontal para o valor especificado. Ele ocorre para a direita na maioria dos gráficos. Ignorado se for definido como um valor menor que o valor x máximo dos dados. hAxis.viewWindow.max substitui essa propriedade.

Essa opção só é compatível com um eixo continuous.

Move o valor mínimo do eixo horizontal até o valor especificado. Ele fica para a esquerda na maioria dos gráficos. Ignorado se for definido como um valor maior que o valor x mínimo dos dados. hAxis.viewWindow.min substitui essa propriedade.

Essa opção só é compatível com um eixo continuous.

Especifica como dimensionar o eixo horizontal para renderizar os valores dentro da área do gráfico. Aceitamos os seguintes valores de string:

• "pretty": dimensiona os valores horizontais para que os valores de dados máximo e mínimo sejam renderizados um pouco dentro da esquerda e da direita da área do gráfico. A viewWindow é expandida para a linha de grade principal mais próxima para números ou a linha de grade menor mais próxima para datas e horas.
• "maximized": dimensiona os valores horizontais para que os valores de dados máximo e mínimo toquem à esquerda e à direita da área do gráfico. Isso fará com que haxis.viewWindow.min e haxis.viewWindow.max sejam ignorados.
• "explicit": uma opção descontinuada para especificar os valores de escala esquerdo e direito da área do gráfico. Esse recurso foi descontinuado por ser redundante com haxis.viewWindow.min e haxis.viewWindow.max. Os valores de dados fora desses valores serão cortados. Especifique um objeto hAxis.viewWindow descrevendo os valores máximo e mínimo a serem mostrados.

Essa opção só é compatível com um eixo continuous.

Especifica o intervalo de corte do eixo horizontal.

• Para um eixo continuous :

  O valor máximo de dados horizontais a serem renderizados.

• Para um eixo discrete:

  O índice de linha baseado em zero em que a janela de corte termina. Os pontos de dados neste índice e em valores superiores serão cortados. Em conjunto com vAxis.viewWindowMode.min, ele define um intervalo meio aberto [min, max) que indica os índices de elementos a serem exibidos. Em outras palavras, todos os índices de modo que min <= index < max sejam exibidos.

Ignorado quando hAxis.viewWindowMode é "bonito" ou "maximizado".

• Para um eixo continuous:

  O valor mínimo de dados horizontais a serem renderizados.

• Para um eixo discrete:

  O índice de linha baseado em zero em que a janela de corte começa. Os pontos de dados em índices inferiores a esse serão cortados. Em conjunto com vAxis.viewWindowMode.max, ele define um intervalo meio aberto [min, max) que indica os índices de elementos a serem exibidos. Em outras palavras, todos os índices de forma que min <= index < max sejam exibidos.

Ignorado quando hAxis.viewWindowMode é "bonito" ou "maximizado".

Altura do gráfico, em pixels.

Um objeto com membros para configurar vários aspectos da legenda. Para especificar as propriedades desse objeto, use a notação literal de objeto, como mostrado aqui:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}

Alinhamento da legenda. Será um dos seguintes valores:

• "start": alinhado ao início da área alocada para a legenda.
• "center": centralizado na área alocada para a legenda.
• "end" - alinhado ao fim da área alocada para a legenda.

Início, centro e fim são relativos ao estilo (vertical ou horizontal) da legenda. Por exemplo, em uma legenda de "direita", "início" e "fim" estão na parte de cima e de baixo, respectivamente. Para uma legenda de "topo", "início" e "fim" estariam à esquerda e à direita da área, respectivamente.

O valor padrão depende da posição da legenda. Para legendas "bottom", o padrão é "center". Outras legendas têm como padrão "start".

Número máximo de linhas na legenda. Defina como um número maior que um para adicionar linhas à legenda. Observação: a lógica exata usada para determinar o número real de linhas renderizadas ainda está em fluxo.

No momento, essa opção funciona apenas quando caption.position é "topo".

Índice de página inicial selecionado da legenda.

Posição da legenda. Será um dos seguintes valores:

• "bottom" - abaixo do gráfico.
• 'esquerdo' - à esquerda do gráfico, desde que o eixo esquerdo não tenha séries associadas. Portanto, se você quiser a legenda à esquerda, use a opção targetAxisIndex: 1.
• "in" - dentro do gráfico, pelo canto superior esquerdo.
• "none": nenhuma legenda é exibida.
• “right” - à direita do gráfico. Incompatível com a opção vAxes.
• "top" - acima do gráfico.

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 color pode ser qualquer string de cor HTML, como 'red' ou '#00cc00'. Consulte também fontName e fontSize.

A orientação do gráfico. Quando definida como 'vertical', gira os eixos do gráfico para que, por exemplo, um gráfico de colunas se torne um gráfico de barras e um gráfico de área cresça para a direita em vez de para cima:

Se definida como verdadeira, desenhará séries da direita para a esquerda. O padrão é desenhar da esquerda para a direita.

Essa opção só é compatível com um eixo discrete major.

Quando selectionMode for 'multiple', os usuários poderão selecionar vários pontos de dados.

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 suporta as seguintes propriedades:

• color: a cor a ser usada na série. Especifique uma string de cor HTML válida.
• fallingColor.fill: substitui o valor candlestick.fallingColor.fill global desta série.
• fallingColor.stroke: substitui o valor candlestick.fallingColor.stroke global desta série.
• fallingColor.strokeWidth: substitui o valor candlestick.fallingColor.strokeWidth global desta série.
• labelInLegend: a descrição da série que será exibida na legenda do gráfico.
• risingColor.fill: substitui o valor candlestick.risingColor.fill global desta série.
• risingColor.stroke: substitui o valor candlestick.risingColor.stroke global desta série.
• risingColor.strokeWidth: substitui o valor candlestick.risingColor.strokeWidth global desta série.
• targetAxisIndex: a qual eixo atribuir essa série, em que 0 é o eixo padrão e 1 é o eixo oposto. O valor padrão é 0. Defina como 1 para definir um gráfico em que séries diferentes são renderizadas em relação a eixos diferentes. Pelo menos uma série deve ser alocada ao eixo padrão. Você pode definir uma escala diferente para eixos diferentes.
• visibleInLegend: um valor booleano, em que "true" significa que a série precisa ter uma entrada de legenda, e "false" significa que ela não precisa. O padrão é verdadeiro.

É possível especificar uma matriz de objetos, cada um aplicável à série na ordem determinada, ou especificar um objeto em que cada filho tenha uma chave numérica que indica a qual série ele 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}
}
    

Um tema é um conjunto de valores de opções predefinidos que trabalham juntos para atingir um comportamento ou efeito visual específico de gráfico. No momento, apenas um tema está disponível:

• "maximized": maximiza a área do gráfico e desenha a legenda e todos os rótulos dentro da área do gráfico. Define as seguintes opções:

  chartArea: {width: '100%', height: '100%'},
  legend: {position: 'in'},
  titlePosition: 'in', axisTitlesPosition: 'in',
  hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
          

Texto a ser exibido acima do gráfico.

Onde colocar o título do gráfico em comparação com a área do gráfico. Valores compatíveis:

• in - desenha o título dentro da área do gráfico.
• out - desenha o título fora da área do gráfico.
• nenhum: omite o título.

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 color pode ser qualquer string de cor HTML, como 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Um objeto com membros para configurar vários elementos de dica. Para especificar as propriedades desse objeto, use a notação literal de objeto, como mostrado aqui:

{textStyle: {color: '#FF0000'}, showColorCode: true}

Se definido como true, permite que o desenho de dicas flua fora dos limites do gráfico em todos os lados.

Observação:isso se aplica apenas a dicas de HTML. Se essa opção for ativada com dicas de SVG, qualquer estouro fora dos limites do gráfico será cortado. Consulte Como personalizar o conteúdo da dica para mais detalhes.

Se definida como verdadeira, use dicas renderizadas em HTML (em vez de renderizadas em SVG). Consulte Como personalizar o conteúdo da dica para mais detalhes.

Observação:a personalização do conteúdo da dica HTML pelo papel de dados da coluna de dicas não é compatível com a visualização do gráfico de bolhas.

Se verdadeiro, mostra quadrados coloridos ao lado das informações da série na dica. O padrão é verdadeiro quando focusTarget é definido como "categoria". Caso contrário, o padrão é "falso".

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 color pode ser qualquer string de cor HTML, como 'red' ou '#00cc00'. Consulte também fontName e fontSize.

A interação do usuário que faz com que a dica seja exibida:

• "focus": a dica é mostrada quando o usuário passa o cursor sobre o elemento.
• "nenhum" - a dica de ferramenta não será exibida.

Especifica propriedades para eixos verticais individuais, se o gráfico tiver vários eixos verticais. Cada objeto filho é um objeto vAxis e pode conter todas as propriedades compatíveis com vAxis. Esses valores de propriedade substituem todas as configurações globais da mesma propriedade.

Para especificar um gráfico com vários eixos verticais, primeiro defina um novo eixo usando series.targetAxisIndex. Depois, configure o eixo usando vAxes. O exemplo a seguir atribui a série 2 ao eixo direito e especifica um título e um estilo de texto personalizados para ela:

{
  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 um com um rótulo numérico que especifica o eixo definido. Este é 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 vAxis mostrado acima:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    

Um objeto com membros para configurar vários elementos do eixo vertical. Para especificar as propriedades desse objeto, use a notação literal de objeto, como mostrado aqui:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}

Propriedade vAxis que especifica a linha de base do eixo vertical. Se a linha de base for maior que a linha de grade mais alta ou menor que a linha de grade mais baixa, ela será arredondada para a linha de grade mais próxima.

Especifica a cor da linha de base para o eixo vertical. Pode ser qualquer string de cor HTML, por exemplo: 'red' ou '#00cc00'.

A direção em que os valores ao longo do eixo vertical crescem. Por padrão, os valores baixos ficam na parte inferior do gráfico. Especifique -1 para inverter a ordem dos valores.

Uma string de formato para os rótulos dos eixos numéricos. Esse é um subconjunto do conjunto de padrões de ICU . Por exemplo, {format:'#,###%'} exibirá os valores "1.000%", "750%" e "50%" para os valores 10, 7,5 e 0,5. Também é possível fornecer qualquer um dos seguintes:

• {format: 'none'}: mostra números sem formatação (por exemplo, 8.000.000)
• {format: 'decimal'}: exibe números com separadores de milhares (por exemplo, 8.000.000)
• {format: 'scientific'}: mostra números em notação científica (por exemplo, 8e6)
• {format: 'currency'}: exibe os números na moeda local (por exemplo, USD 8.000.000,00)
• {format: 'percent'}: mostra números como porcentagens (por exemplo, 800.000.000%)
• {format: 'short'}: mostra números abreviados (por exemplo, 8 mi)
• {format: 'long'}: exibe números como palavras inteiras (por exemplo, 8 milhões)

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 .

No cálculo de valores de marcação e linhas de grade, várias combinações alternativas de todas as opções de linha de grade relevantes serão consideradas, e alternativas serão rejeitadas se os rótulos de marcação formatados forem duplicados ou sobrepostos. Portanto, você pode especificar format:"#" se quiser mostrar apenas valores de marcação inteiros, mas saiba que, se nenhuma alternativa satisfizer essa condição, nenhuma linha de grade ou marcação será mostrada.

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 as propriedades desse objeto, use a notação literal de objeto, como mostrado aqui:

{color: '#333', minSpacing: 20}

A cor das linhas de grade verticais dentro da área do gráfico. Especifique uma string de cor HTML válida.

O número aproximado de linhas de grade horizontais dentro da área do gráfico. Se você especificar um número positivo para gridlines.count, ele será usado para calcular minSpacing entre as linhas de grade. Você pode especificar um valor de 1 para desenhar apenas uma linha de grade ou 0 para não desenhar linhas de grade. Especifique -1, que é o padrão, para calcular automaticamente o número de linhas de grade com base em outras opções.

Uma matriz de tamanhos (como valores de dados, e não pixels) entre linhas de grade adjacentes. No momento, essa opção é apenas para eixos numéricos, mas é análoga às opções gridlines.units.<unit>.interval, que são usadas apenas para datas e horas. Para escalas lineares, o padrão é [1, 2, 2.5, 5], o que significa que os valores das linhas de grade podem estar em todas as unidades (1), em unidades pares (2) ou em múltiplos de 2,5 ou 5. Qualquer potência de 10 vezes esses valores também é considerada (por exemplo, [10, 20, 25, 50] e [0,1, 0,2, 0,25, 0,5]). Para escalas de registro, o padrão é [1, 2, 5].

O espaço mínimo na tela, em pixels, entre as principais linhas de grade do eixo h. O padrão para as principais linhas de grade é 40 para escalas lineares e 20 para escalas de registro. Se você especificar o count e não o minSpacing, o minSpacing será calculado com base na contagem. Por outro lado, se você especificar o minSpacing e não o count, a contagem será calculada com base no minSpacing. Se você especificar ambos, o minSpacing vai substituir.

Todos os valores de linhas de grade e escalas precisam ser múltiplos do valor desta opção. Observe que, ao contrário dos intervalos, potências de 10 vezes o múltiplo não são consideradas. Portanto, você pode forçar as marcações a serem números inteiros especificando gridlines.multiple = 1 ou forçar elas a serem múltiplas de 1.000 especificando gridlines.multiple = 1000.

Modifica o formato padrão para vários aspectos dos tipos de dados de data/hora/hora/hora quando usados com linhas de grade calculadas em gráficos. Permite a formatação para 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*/]}
  }
}
    

Para mais informações, consulte Datas e horas.

Um objeto com membros para configurar as linhas de grade secundárias no eixo vertical, semelhante à opção vAxis.gridlines.

A cor das linhas de grade verticais menores dentro da área do gráfico. Especifique uma string de cor HTML válida.

A opção menosGridlines.count está obsoleta, exceto para desativar linhas de grade secundárias ao definir a contagem como 0. O número de linhas de grade secundárias depende do intervalo entre as principais linhas de grade (consulte vAxis.gridlines.interval) e o espaço mínimo necessário (consulte vAxis.minorGridlines.minSpacing).

A opção smallGridlines.interval é como a opção de intervalo das linhas de grade principais, mas o intervalo escolhido sempre será um divisor par do intervalo da linha de grade principal. O intervalo padrão para escalas lineares é [1, 1.5, 2, 2.5, 5] e para escalas de registro é [1, 2, 5].

O espaço mínimo necessário, em pixels, entre linhas de grade secundárias adjacentes e entre linhas de grade secundárias e principais. O valor padrão é 1/2 do minSpacing das principais linhas de grade para escalas lineares e 1/5 do minSpacing para escalas de registro.

Igual à gridlines.multiple principal.

Substitui o formato padrão de vários aspectos dos tipos de dados date/datetime/timeofday quando usados com smallGridlines calculadas em gráfico. Permite a formatação para 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*/]},
  }
}
    

Para mais informações, consulte Datas e horas.

Se verdadeiro, transforma o eixo vertical em uma escala logarítmica. Observação: todos os valores precisam ser positivos.

A propriedade vAxis que transforma o eixo vertical em uma escala logarítmica. Será um dos seguintes valores:

• nulo: nenhum dimensionamento logarítmico é executado.
• "log" - dimensionamento logarítmico. Valores negativos e zero não são representados no gráfico. Essa opção é igual à configuração de vAxis: { logscale: true }.
• "mirrorLog": escala logarítmica em que valores negativos e zero são representados no gráfico. O valor plotado de um número negativo é o negativo do log do valor absoluto. Valores próximos a 0 são representados em uma escala linear.

Essa opção só é compatível com um eixo continuous.

Posição do texto do eixo vertical em relação à área do gráfico. Valores aceitos: 'out', 'in', 'none'.

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 color pode ser qualquer string de cor HTML, como 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Substitui as marcas do eixo Y geradas automaticamente pela matriz especificada. Cada elemento da matriz deve ser um valor de marcação válido (como um número, data, data e hora ou timeofday) ou um objeto. Se for um objeto, ele precisará ter uma propriedade v para o valor da marcação e uma propriedade f opcional contendo a string literal a ser exibida como o rótulo.

A viewWindow será expandida automaticamente para incluir as marcações mínima e máxima, a menos que você especifique um viewWindow.min ou viewWindow.max para substituir.

Por exemplo:

• vAxis: { ticks: [5,10,15,20] }
• vAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• vAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• vAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

Propriedade vAxis que especifica um título para o eixo vertical.

Um objeto que especifica o estilo de texto do título do eixo vertical. O objeto tem este formato:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

O color pode ser qualquer string de cor HTML, como 'red' ou '#00cc00'. Consulte também fontName e fontSize.

Move o valor máximo do eixo vertical até o valor especificado. Na maioria dos gráficos, esse valor é crescente. Ignorado se estiver definido como um valor menor que o valor y máximo dos dados. vAxis.viewWindow.max substitui essa propriedade.

Move o valor mínimo do eixo vertical até o valor especificado. Na maioria dos gráficos, esse valor é baixo. Ignorado se estiver definido como um valor maior que o valor y mínimo dos dados. vAxis.viewWindow.min substitui essa propriedade.

Especifica como dimensionar o eixo vertical para renderizar os valores dentro da área do gráfico. Aceitamos os seguintes valores de string:

• "pretty" - dimensiona os valores verticais para que os valores de dados máximo e mínimo sejam renderizados um pouco dentro da parte inferior e superior da área do gráfico. A viewWindow é expandida para a linha de grade principal mais próxima para números ou a linha de grade menor mais próxima para datas e horas.
• "maximized": dimensiona os valores verticais de modo que os valores máximo e mínimo dos dados toquem nas partes superior e inferior da área do gráfico. Isso fará com que vaxis.viewWindow.min e vaxis.viewWindow.max sejam ignorados.
• "explicit": uma opção descontinuada para especificar os valores de escala superior e inferior da área do gráfico. (descontinuado porque é redundante com vaxis.viewWindow.min e vaxis.viewWindow.max. Os valores de dados fora deles serão cortados. É necessário especificar um objeto vAxis.viewWindow descrevendo os valores máximo e mínimo a serem mostrados.

Especifica o intervalo de corte do eixo vertical.

O valor máximo dos dados verticais a serem renderizados.

Ignorado quando vAxis.viewWindowMode é "bonito" ou "maximizado".

O valor mínimo de dados verticais a ser renderizado.

Ignorado quando vAxis.viewWindowMode é "bonito" ou "maximizado".

Largura do gráfico, em pixels.

Desenha o gráfico. O gráfico aceita outras chamadas de método somente depois que o evento ready é disparado. Extended description.

Retorna o objeto de ação da dica com o actionID solicitado.

Retorna um objeto que contém as informações de esquerda, parte superior, largura e altura do elemento id do gráfico. O formato de id ainda não está documentado (eles são os valores de retorno dos manipuladores de eventos), mas estes são alguns exemplos:

var cli = chart.getChartLayoutInterface();

Altura da área do gráfico

cli.getBoundingBox('chartarea').height

Largura da terceira barra na primeira série de um gráfico de barras ou colunas

cli.getBoundingBox('bar#0#2').width

Caixa delimitadora do quinto encaixe de um gráfico de pizza

cli.getBoundingBox('slice#4')

Caixa delimitadora dos dados de um gráfico vertical (por exemplo, coluna):

cli.getBoundingBox('vAxis#0#gridline')

Caixa delimitadora dos dados de um gráfico horizontal (por exemplo, de barras):

cli.getBoundingBox('hAxis#0#gridline')

Os valores são relativos ao contêiner do gráfico. Chame essa função depois que o gráfico for desenhado.

Retorna um objeto que contém as informações de esquerda, parte superior, largura e altura do conteúdo do gráfico (ou seja, excluindo rótulos e legendas):

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left

cli.getChartAreaBoundingBox().top

cli.getChartAreaBoundingBox().height

cli.getChartAreaBoundingBox().width

Os valores são relativos ao contêiner do gráfico. Chame essa função depois que o gráfico for desenhado.

Retorna um objeto que contém informações sobre o posicionamento na tela do gráfico e seus elementos.

Os seguintes métodos podem ser chamados no objeto retornado:

• getBoundingBox
• getChartAreaBoundingBox
• getHAxisValue
• getVAxisValue
• getXLocation
• getYLocation

Chame essa função depois que o gráfico for desenhado.

Retorna o valor de dados horizontal em xPosition, que é um deslocamento de pixel da borda esquerda do contêiner do gráfico. Pode ser negativo.

Exemplo: chart.getChartLayoutInterface().getHAxisValue(400).

Chame essa função depois que o gráfico for desenhado.

Retorna o gráfico serializado como um URI de imagem.

Chame essa função depois que o gráfico for desenhado.

Consulte Como imprimir gráficos PNG.

Retorna uma matriz das entidades de gráfico selecionadas. As entidades selecionáveis são velas, entradas de legenda e categorias. Neste gráfico, apenas uma entidade pode ser selecionada por vez. Extended description .

Retorna o valor de dados vertical em yPosition, que é um deslocamento de pixel para baixo em relação à borda superior do contêiner do gráfico. Pode ser negativo.

Exemplo: chart.getChartLayoutInterface().getVAxisValue(300).

Chame essa função depois que o gráfico for desenhado.

Retorna a coordenada x do pixel de dataValue em relação à borda esquerda do contêiner do gráfico.

Exemplo: chart.getChartLayoutInterface().getXLocation(400).

Chame essa função depois que o gráfico for desenhado.

Retorna a coordenada y do pixel de dataValue em relação à borda superior do contêiner do gráfico.

Exemplo: chart.getChartLayoutInterface().getYLocation(300).

Chame essa função depois que o gráfico for desenhado.

Remove a ação da dica com o actionID solicitado do gráfico.

Define uma ação de dica a ser executada quando o usuário clica no texto de ação.

O método setAction usa um objeto como parâmetro de ação. Esse objeto precisa especificar três propriedades: id, o ID da ação definida, text, o texto que aparecerá na dica da ação, e action, a função que será executada quando um usuário clicar no texto da ação.

Todas as ações de dica precisam ser definidas antes de chamar o método draw() do gráfico. Descrição estendida.

Seleciona as entidades de gráfico especificadas. Cancela qualquer seleção anterior. As entidades selecionáveis são velas, entradas de legenda e categorias. Neste gráfico, apenas uma entidade pode ser selecionada por vez. Extended description .

Limpa o gráfico e libera todos os recursos alocados.

Disparado quando a animação de transição é concluída.

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 legenda, os eixos, as linhas de grade ou os rótulos são clicados.

Disparado quando ocorre um erro ao tentar renderizar o gráfico.

Disparado quando o usuário clica nas setas de paginação de legendas. Transmite o índice de página baseado em zero atual e o número total de páginas.

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. Um candlestick se correlaciona com uma célula da tabela de dados, uma entrada de legenda em uma coluna (o índice de linha é nulo) e uma categoria com uma linha (o índice de coluna é nulo).

Disparado quando o usuário afasta o mouse de uma entidade visual. Transmite os índices de linha e coluna do elemento da tabela de dados correspondente. Um candlestick se correlaciona com uma célula da tabela de dados, uma entrada de legenda em uma coluna (o índice de linha é nulo) e uma categoria com uma linha (o índice de coluna é nulo).

O gráfico está pronto para chamadas de métodos externos. 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 draw e chame-o somente depois que o evento for disparado.

Disparado quando o usuário clica em uma entidade visual. Para saber o que foi selecionado, chame getSelection().