Um criador para gráficos de pizza. Para mais detalhes, consulte a documentação do Gráficos Google.
Aqui está um exemplo que mostra como criar um gráfico de pizza. 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=A1%3AB8' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1'; var chartBuilder = Charts.newPieChart() .setTitle('World Population by Continent') .setDimensions(600, 500) .set3D() .setDataSourceUrl(dataSourceUrl); var chart = chartBuilder.build();
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Chart | Cria o gráfico. |
reverseCategories() | PieChartBuilder | Inverte o desenho das séries no eixo de domínio. |
set3D() | PieChartBuilder | Define o gráfico como tridimensional. |
setBackgroundColor(cssValue) | PieChartBuilder | Define a cor do plano de fundo do gráfico. |
setColors(cssValues) | PieChartBuilder | Define as cores das linhas no gráfico. |
setDataSourceUrl(url) | PieChartBuilder | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como o Planilhas Google. |
setDataTable(tableBuilder) | PieChartBuilder | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
setDataTable(table) | PieChartBuilder | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
setDataViewDefinition(dataViewDefinition) | PieChartBuilder | Define a definição de visualização de dados a ser usada no gráfico. |
setDimensions(width, height) | PieChartBuilder | Define as dimensões do gráfico. |
setLegendPosition(position) | PieChartBuilder | Define a posição da legenda em relação ao gráfico. |
setLegendTextStyle(textStyle) | PieChartBuilder | Define o estilo de texto da legenda do gráfico. |
setOption(option, value) | PieChartBuilder | Define opções avançadas para este gráfico. |
setTitle(chartTitle) | PieChartBuilder | Define o título do gráfico. |
setTitleTextStyle(textStyle) | PieChartBuilder | Define o estilo de texto do título do gráfico. |
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
PieChartBuilder
: builder, útil para encadeamento.
set3D()
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
Nome | Tipo | Descrição |
---|---|---|
cssValue | String | O valor de CSS para a cor (como "blue" ou "#00f" ). |
Retorno
PieChartBuilder
: 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
Nome | Tipo | Descrição |
---|---|---|
cssValues | String[] | 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
PieChartBuilder
: 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
Nome | Tipo | Descrição |
---|---|---|
url | String | O URL da origem de dados, incluindo todos os parâmetros de consulta. |
Retorno
PieChartBuilder
: 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
Nome | Tipo | Descrição |
---|---|---|
tableBuilder | DataTableBuilder | Um 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
PieChartBuilder
: 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
Nome | Tipo | Descrição |
---|---|---|
table | DataTableSource | A tabela de dados a ser usada no gráfico. |
Retorno
PieChartBuilder
: builder, útil para encadeamento.
setDataViewDefinition(dataViewDefinition)
Define a definição de visualização de dados a ser usada no gráfico.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
dataViewDefinition | DataViewDefinition | Um 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
PieChartBuilder
: builder, útil para encadeamento.
setDimensions(width, height)
Define as dimensões do gráfico.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
width | Integer | A largura do gráfico, em pixels. |
height | Integer | A altura do gráfico, em pixels. |
Retorno
PieChartBuilder
: 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
Nome | Tipo | Descrição |
---|---|---|
position | Position | A posição da legenda. |
Retorno
PieChartBuilder
: 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
Nome | Tipo | Descrição |
---|---|---|
textStyle | TextStyle | O estilo de texto a ser usado na legenda do gráfico. |
Retorno
PieChartBuilder
: 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 pie chart with a pretty legend. var builder = Charts.newPieChart(); builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}}); var chart = builder.build();
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
option | String | A opção a ser definida. |
value | Object | O valor que será definido. |
Retorno
PieChartBuilder
: 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
Nome | Tipo | Descrição |
---|---|---|
chartTitle | String | no título do gráfico. |
Retorno
PieChartBuilder
: 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
Nome | Tipo | Descrição |
---|---|---|
textStyle | TextStyle | O estilo de texto a ser usado no título do gráfico. É possível criar um objeto TextStyleBuilder chamando Charts.newTextStyle() . |
Retorno
PieChartBuilder
: builder, útil para encadeamento.