Compilador para gráficos de columnas. Para obtener más detalles, consulta la documentación de Google Charts.
En este ejemplo, se muestra cómo crear un gráfico de columnas con datos de una tabla de datos.
const sampleData = Charts.newDataTable() .addColumn(Charts.ColumnType.STRING, 'Year') .addColumn(Charts.ColumnType.NUMBER, 'Sales') .addColumn(Charts.ColumnType.NUMBER, 'Expenses') .addRow(['2004', 1000, 400]) .addRow(['2005', 1170, 460]) .addRow(['2006', 660, 1120]) .addRow(['2007', 1030, 540]) .addRow(['2008', 800, 600]) .addRow(['2009', 943, 678]) .addRow(['2010', 1020, 550]) .addRow(['2011', 910, 700]) .addRow(['2012', 1230, 840]) .build(); const chart = Charts.newColumnChart() .setTitle('Sales & Expenses') .setXAxisTitle('Year') .setYAxisTitle('Amount (USD)') .setDimensions(600, 500) .setDataTable(sampleData) .build();
Métodos
| Método | Tipo de datos que se devuelve | Descripción breve |
|---|---|---|
build() | Chart | Compila el gráfico. |
reverse | Column | Invierte el dibujo de las series en el eje del dominio. |
set | Column | Establece el color de fondo del gráfico. |
set | Column | Establece los colores de las líneas del gráfico. |
set | Column | Establece la URL de la fuente de datos que se usa para extraer datos de una fuente externa, como Hojas de cálculo de Google. |
set | Column | Establece la tabla de datos que se usará para el gráfico con un DataTableBuilder. |
set | Column | Establece la tabla de datos que contiene las líneas del gráfico, así como las etiquetas del eje X. |
set | Column | Establece la definición de la vista de datos que se usará para el gráfico. |
set | Column | Establece las dimensiones del gráfico. |
set | Column | Establece la posición de la leyenda con respecto al gráfico. |
set | Column | Establece el estilo de texto de la leyenda del gráfico. |
set | Column | Establece opciones avanzadas para este gráfico. |
set | Column | Establece el rango del gráfico. |
set | Column | Usa líneas apiladas, lo que significa que los valores de líneas y barras se apilan (acumulan). |
set | Column | Establece el título del gráfico. |
set | Column | Establece el estilo de texto del título del gráfico. |
set | Column | Establece el estilo del texto del eje horizontal. |
set | Column | Agrega un título al eje horizontal. |
set | Column | Establece el estilo de texto del título del eje horizontal. |
set | Column | Establece el estilo del texto del eje vertical. |
set | Column | Agrega un título al eje vertical. |
set | Column | Establece el estilo de texto del título del eje vertical. |
use | Column | Convierte el eje de rango en una escala logarítmica (requiere que todos los valores sean positivos). |
Documentación detallada
build()
Compila el gráfico.
Volver
Chart: Es un objeto Chart que se puede incorporar en documentos o elementos de la IU, o bien usarse como una imagen estática.
reverseCategories()
Invierte el dibujo de las series en el eje del dominio. En el caso de los gráficos de rango vertical (como los de líneas, áreas o columnas), esto significa que el eje horizontal se dibuja de derecha a izquierda. En el caso de los gráficos de rango horizontal (como los gráficos de barras), esto significa que el eje vertical se dibuja de arriba hacia abajo. En el caso de los gráficos circulares, esto significa que las porciones se dibujan en sentido antihorario.
// Creates a pie chart builder and sets drawing of the slices in a // counter-clockwise manner. const builder = Charts.newPieChart(); builder.reverseCategories();
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setBackgroundColor(cssValue)
Establece el color de fondo del gráfico.
// Creates a line chart builder and sets the background color to gray const builder = Charts.newLineChart(); builder.setBackgroundColor('gray');
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
css | String | Es el valor CSS del color (por ejemplo, "blue" o "#00f"). |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setColors(cssValues)
Establece los colores de las líneas del gráfico.
// Creates a line chart builder and sets the first two lines to be drawn in // green and red, respectively. const builder = Charts.newLineChart(); builder.setColors(['green', 'red']);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
css | String[] | Es un array de valores CSS de color, como ["red", "#acf"]. El n-ésimo elemento del array representa el color de la n-ésima línea del gráfico. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setDataSourceUrl(url)
Establece la URL de la fuente de datos que se usa para extraer datos de una fuente externa, como Hojas de cálculo de Google. Si se proporcionan una URL de fuente de datos y un objeto DataTable, se ignora la URL de fuente de datos.
Para obtener más información sobre cómo consultar fuentes de datos, consulta la documentación de Google Charts.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
url | String | Es la URL de la fuente de datos, incluidos los parámetros de consulta. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setDataTable(tableBuilder)
Establece la tabla de datos que se usará para el gráfico con un DataTableBuilder. Este es un método conveniente para configurar la tabla de datos sin necesidad de llamar a build().
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
table | Data | Es un compilador de tablas de datos. Se crea una nueva tabla de datos de forma instantánea como parte de esta llamada, por lo que las actualizaciones posteriores del compilador no se reflejarán en el gráfico. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setDataTable(table)
Establece la tabla de datos que contiene las líneas del gráfico, así como las etiquetas del eje X. La primera columna debe ser una cadena y contener las etiquetas del eje horizontal. Pueden seguir cualquier cantidad de columnas, todas deben ser numéricas. Cada columna se muestra como una línea separada.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
table | Data | Es la tabla de datos que se usará para el gráfico. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setDataViewDefinition(dataViewDefinition)
Establece la definición de la vista de datos que se usará para el gráfico.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
data | Data | Es un objeto de definición de vista de datos que define la vista que se debe derivar de la fuente de datos proporcionada para el dibujo del gráfico. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setDimensions(width, height)
Establece las dimensiones del gráfico.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
width | Integer | Ancho del gráfico en píxeles. |
height | Integer | Altura del gráfico en píxeles. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setLegendPosition(position)
Establece la posición de la leyenda con respecto al gráfico. De forma predeterminada, no hay leyenda.
// Creates a line chart builder and sets the legend position to right. const builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
position | Position | Posición de la leyenda. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setLegendTextStyle(textStyle)
Establece el estilo de texto de la leyenda del gráfico.
// Creates a line chart builder and sets it up for a blue, 26-point legend. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setLegendTextStyle(style);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
text | Text | Es el estilo de texto que se usará para la leyenda del gráfico. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setOption(option, value)
Establece opciones avanzadas para este gráfico. Consulta las opciones disponibles para este gráfico. Este método no tiene efecto si la opción proporcionada no es válida.
// Build a column chart with a 1-second animation duration. const builder = Charts.newColumnChart(); builder.setOption('animation.duration', 1000); const chart = builder.build();
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
option | String | Opción que se configurará. |
value | Object | Es el valor que se establecerá. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setRange(start, end)
Establece el rango del gráfico.
Si algún punto de datos queda fuera del rango, este se expande para incluir esos puntos.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
start | Number | Es el valor de la línea de cuadrícula más baja del eje de rango. |
end | Number | Es el valor de la línea de cuadrícula más alta del eje de rango. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setStacked()
Usa líneas apiladas, lo que significa que los valores de líneas y barras se apilan (acumulan). De forma predeterminada, no se apilan.
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setTitle(chartTitle)
Establece el título del gráfico. El título se muestra centrado sobre el gráfico.
// Creates a line chart builder and title to 'My Line Chart'. const builder = Charts.newLineChart(); builder.setTitle('My Line Chart');
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
chart | String | El título del gráfico |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setTitleTextStyle(textStyle)
Establece el estilo de texto del título del gráfico.
// Creates a line chart builder and sets it up for a blue, 26-point title. const textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26); const style = textStyleBuilder.build(); const builder = Charts.newLineChart(); builder.setTitleTextStyle(style);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
text | Text | Es el estilo de texto que se usará para el título del gráfico. Puedes crear un objeto Text llamando a Charts.newTextStyle(). |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setXAxisTextStyle(textStyle)
Establece el estilo del texto del eje horizontal.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTextStyle(textStyle);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
text | Text | Es el estilo de texto que se usará para el título del eje horizontal. Puedes crear un objeto Text llamando a Charts.newTextStyle(). |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setXAxisTitle(title)
Agrega un título al eje horizontal. El título está centrado y aparece debajo de las etiquetas de los valores del eje.
// Creates a line chart builder and sets the X-axis title. const builder = Charts.newLineChart(); builder.setTitle('X-axis Title');
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
title | String | Es el título del eje X. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setXAxisTitleTextStyle(textStyle)
Establece el estilo de texto del título del eje horizontal.
// Creates a line chart builder and sets the X-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setXAxisTitleTextStyle(textStyle);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
text | Text | Es el estilo de texto que se usará para el título del eje horizontal. Puedes crear un objeto Text llamando a Charts.newTextStyle(). |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setYAxisTextStyle(textStyle)
Establece el estilo del texto del eje vertical.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point // font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTextStyle(textStyle);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
text | Text | Es el estilo de texto que se usará para el título del eje horizontal. Puedes crear un objeto Text llamando a Charts.newTextStyle(). |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setYAxisTitle(title)
Agrega un título al eje vertical. El título está centrado y aparece a la izquierda de las etiquetas de valores.
// Creates a line chart builder and sets the Y-axis title. const builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title');
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
title | String | Es el título del eje Y. |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
setYAxisTitleTextStyle(textStyle)
Establece el estilo de texto del título del eje vertical.
// Creates a line chart builder and sets the Y-axis title text style to blue, // 18-point font. const textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build(); const builder = Charts.newLineChart(); builder.setYAxisTitleTextStyle(textStyle);
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
text | Text | Es el estilo de texto que se usará para el título del eje horizontal. Puedes crear un objeto Text llamando a Charts.newTextStyle(). |
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.
useLogScale()
Convierte el eje de rango en una escala logarítmica (requiere que todos los valores sean positivos). El eje de rango es el eje vertical para los gráficos verticales (como los de líneas, áreas o columnas) y el eje horizontal para los gráficos horizontales (como los de barras).
Volver
ColumnChartBuilder: Este compilador, útil para el encadenamiento.