Class BarChartBuilder

BarChartBuilder

Builder de gráficos de barras. Para mais detalhes, consulte a documentação do Gráficos Google.

Aqui está um exemplo que mostra como criar um gráfico de barras. Os dados são importados de uma planilha do Google.

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

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

 var chart = chartBuilder.build();

Métodos

MétodoTipo de retornoBreve descrição
build()ChartCria o gráfico.
reverseCategories()BarChartBuilderInverte o desenho das séries no eixo de domínio.
reverseDirection()BarChartBuilderInverte a direção em que as barras crescem ao longo do eixo horizontal.
setBackgroundColor(cssValue)BarChartBuilderDefine a cor do plano de fundo do gráfico.
setColors(cssValues)BarChartBuilderDefine as cores das linhas no gráfico.
setDataSourceUrl(url)BarChartBuilderDefine o URL da fonte de dados usado para extrair dados de uma fonte externa, como o Planilhas Google.
setDataTable(tableBuilder)BarChartBuilderDefine a tabela de dados a ser usada no gráfico usando um DataTableBuilder.
setDataTable(table)BarChartBuilderDefine a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X.
setDataViewDefinition(dataViewDefinition)BarChartBuilderDefine a definição de visualização de dados a ser usada no gráfico.
setDimensions(width, height)BarChartBuilderDefine as dimensões do gráfico.
setLegendPosition(position)BarChartBuilderDefine a posição da legenda em relação ao gráfico.
setLegendTextStyle(textStyle)BarChartBuilderDefine o estilo de texto da legenda do gráfico.
setOption(option, value)BarChartBuilderDefine opções avançadas para este gráfico.
setRange(start, end)BarChartBuilderDefine o intervalo do gráfico.
setStacked()BarChartBuilderUsa linhas empilhadas, o que significa que os valores de linha e barra são empilhados (acumulados).
setTitle(chartTitle)BarChartBuilderDefine o título do gráfico.
setTitleTextStyle(textStyle)BarChartBuilderDefine o estilo de texto do título do gráfico.
setXAxisTextStyle(textStyle)BarChartBuilderDefine o estilo de texto do eixo horizontal.
setXAxisTitle(title)BarChartBuilderAdiciona um título ao eixo horizontal.
setXAxisTitleTextStyle(textStyle)BarChartBuilderDefine o estilo do texto do título do eixo horizontal.
setYAxisTextStyle(textStyle)BarChartBuilderDefine o estilo de texto do eixo vertical.
setYAxisTitle(title)BarChartBuilderAdiciona um título ao eixo vertical.
setYAxisTitleTextStyle(textStyle)BarChartBuilderDefine o estilo do texto do título do eixo vertical.
useLogScale()BarChartBuilderTransforma o eixo do intervalo em uma escala logarítmica (requer que todos os valores sejam positivos).

Documentação detalhada

build()

Cria o gráfico.

Retorno

Chart: um objeto de gráfico que pode ser incorporado a documentos, elementos da interface ou usado como imagem estática.


reverseCategories()

Inverte o desenho das séries no eixo de domínio. Para gráficos de intervalo vertical (como gráficos de linhas, área ou colunas), isso significa que o eixo horizontal é desenhado da direita para a esquerda. Para gráficos de intervalo horizontal (como gráficos de barras), isso significa que o eixo vertical é desenhado de cima para baixo. Para gráficos de pizza, isso significa que as fatias são desenhadas no sentido anti-horário.

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

Retorno

BarChartBuilder: builder, útil para encadeamento.


reverseDirection()

Inverte a direção em que as barras crescem ao longo do eixo horizontal. Por padrão, os valores aumentam da esquerda para a direita. Chamar esse método faz com que eles cresçam da direita para a esquerda.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setBackgroundColor(cssValue)

Define a cor do plano de fundo do gráfico.

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

Parâmetros

NomeTipoDescrição
cssValueStringO valor de CSS para a cor (como "blue" ou "#00f").

Retorno

BarChartBuilder: builder, útil para encadeamento.


setColors(cssValues)

Define as cores das linhas no gráfico.

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

Parâmetros

NomeTipoDescrição
cssValuesString[]Uma matriz de valores CSS de cor, como ["red", "#acf"]. O enésimo elemento na matriz representa a cor da linha enésima no gráfico.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setDataSourceUrl(url)

Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como o Planilhas Google. Se um URL da fonte de dados e uma tabela de dados forem informados, o URL da fonte será ignorado.

Para mais informações sobre como consultar fontes de dados, confira a documentação do Gráficos Google.

Parâmetros

NomeTipoDescrição
urlStringO URL da origem de dados, incluindo todos os parâmetros de consulta.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setDataTable(tableBuilder)

Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. Esse é um método conveniente para definir a tabela de dados sem precisar chamar build().

Parâmetros

NomeTipoDescrição
tableBuilderDataTableBuilderUm criador de tabelas de dados. Uma nova tabela de dados é criada instantaneamente como parte dessa chamada, então qualquer atualização posterior no builder não será refletida no gráfico.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setDataTable(table)

Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. A primeira coluna precisa ser uma string e conter os rótulos do eixo horizontal. Qualquer número de colunas pode ser incluído, e todas precisam ser numéricas. Cada coluna é exibida como uma linha separada.

Parâmetros

NomeTipoDescrição
tableDataTableSourceA tabela de dados a ser usada no gráfico.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setDataViewDefinition(dataViewDefinition)

Define a definição de visualização de dados a ser usada no gráfico.

Parâmetros

NomeTipoDescrição
dataViewDefinitionDataViewDefinitionUm objeto de definição de visualização de dados que define a visualização que precisa ser derivada da fonte de dados especificada para o desenho do gráfico.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setDimensions(width, height)

Define as dimensões do gráfico.

Parâmetros

NomeTipoDescrição
widthIntegerA largura do gráfico, em pixels.
heightIntegerA altura do gráfico, em pixels.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setLegendPosition(position)

Define a posição da legenda em relação ao gráfico. Por padrão, não há legenda.

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

Parâmetros

NomeTipoDescrição
positionPositionA posição da legenda.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setLegendTextStyle(textStyle)

Define o estilo de texto da legenda do gráfico.

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado na legenda do gráfico.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setOption(option, value)

Define opções avançadas para este gráfico. Veja as opções disponíveis para esse gráfico. Esse método não terá efeito se a opção fornecida for inválida.

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

Parâmetros

NomeTipoDescrição
optionStringA opção a ser definida.
valueObjectO valor que será definido.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setRange(start, end)

Define o intervalo do gráfico.

Se algum ponto de dados estiver fora do intervalo, o intervalo será expandido para incluir esses pontos.

Parâmetros

NomeTipoDescrição
startNumberO valor da linha de grade mais baixa no eixo do intervalo.
endNumberO valor da linha de grade mais alta no eixo do intervalo.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setStacked()

Usa linhas empilhadas, o que significa que os valores de linha e barra são empilhados (acumulados). Por padrão, não há empilhamento.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setTitle(chartTitle)

Define o título do gráfico. O título é exibido centralizado acima do gráfico.

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

Parâmetros

NomeTipoDescrição
chartTitleStringno título do gráfico.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setTitleTextStyle(textStyle)

Define o estilo de texto do título do gráfico.

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do gráfico. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retorno

BarChartBuilder: builder, útil para encadeamento.


setXAxisTextStyle(textStyle)

Define o estilo de texto do eixo horizontal.

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retorno

BarChartBuilder: builder, útil para encadeamento.


setXAxisTitle(title)

Adiciona um título ao eixo horizontal. O título é centralizado e aparece abaixo dos rótulos de valor do eixo.

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

Parâmetros

NomeTipoDescrição
titleStringO título do eixo X.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setXAxisTitleTextStyle(textStyle)

Define o estilo do texto do título do eixo horizontal.

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retorno

BarChartBuilder: builder, útil para encadeamento.


setYAxisTextStyle(textStyle)

Define o estilo de texto do eixo vertical.

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retorno

BarChartBuilder: builder, útil para encadeamento.


setYAxisTitle(title)

Adiciona um título ao eixo vertical. O título é centralizado e aparece à esquerda dos rótulos de valor.

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

Parâmetros

NomeTipoDescrição
titleStringO título do eixo Y.

Retorno

BarChartBuilder: builder, útil para encadeamento.


setYAxisTitleTextStyle(textStyle)

Define o estilo do texto do título do eixo vertical.

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

Parâmetros

NomeTipoDescrição
textStyleTextStyleO estilo de texto a ser usado no título do eixo horizontal. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle().

Retorno

BarChartBuilder: builder, útil para encadeamento.


useLogScale()

Transforma o eixo do intervalo em uma escala logarítmica (requer que todos os valores sejam positivos). O eixo do intervalo é o vertical para gráficos verticais (como linha, área ou coluna) e o eixo horizontal para gráficos horizontais (como barras).

Retorno

BarChartBuilder: builder, útil para encadeamento.