Como personalizar visualizações usando o Editor de configuração de gráficos

Use o Chart Config Editor para personalizar opções de formatação nas visualizações do Looker que usam a API HighCharts. Isso inclui a maioria dos gráficos cartesianos, como gráficos de colunas, de barras e de linhas, entre outros.

Pré-requisitos

Para acessar o Editor de configuração de gráficos, você precisa ter a permissão can_override_vis_config.

Como personalizar uma visualização

Para personalizar uma visualização com o Editor de configuração de gráficos, siga estas etapas:

  1. Acesse uma visualização em um Explore ou edite uma visualização em um Look ou dashboard.
  2. Abra o menu Editar na visualização.

  3. Clique no botão Edit Chart Config na guia Plot. O Looker mostra a caixa de diálogo Edit Chart Config.

    • O painel Configuração do gráfico (origem) contém o JSON original da sua visualização e não pode ser editado.

    • O painel Configuração do gráfico (Substituir) contém o JSON que deve substituir o JSON de origem. Quando você abre a caixa de diálogo Edit Chart Config pela primeira vez, o Looker preenche o painel com um JSON padrão. Você pode começar com esse JSON ou excluí-lo e inserir qualquer JSON do HighCharts válido.

  4. Selecione a seção Configuração do gráfico (Substituir) e insira algum JSON HighCharts válido. Os novos valores substituirão os valores na seção Configuração do gráfico (origem).

    • Consulte a seção Exemplos deste artigo para ver exemplos de JSON do HighCharts válido.
    • O Looker aceita todos os valores JSON válidos. O Looker não aceita funções, datas ou valores indefinidos.

  5. Clique em <> (Formatar código) para permitir que o Looker formate corretamente o JSON.

  6. Clique em Visualizar para testar as mudanças.

  7. Clique em Aplicar para aplicar as mudanças. A visualização será exibida usando os valores JSON personalizados.

Depois de personalizar sua visualização, você pode salvá-la. Se você acessou a visualização em um Explore, salve-o. Se você editou um Look ou painel, clique em Salvar.

Se quiser editar as opções de visualização padrão, primeiro remova todas as alterações feitas no Editor de configuração de gráfico e, em seguida, substitua-as mais tarde. Especificamente, siga estas etapas:

  1. Clique no botão Edit Chart Config na guia Plot. O Looker mostra a caixa de diálogo Edit Chart Config.
  2. Copie o texto no painel Configuração do gráfico (Substituir).
  3. Clique no botão Clear Chart Overrides para excluir todas as mudanças.
  4. Clique em Aplicar.
  5. Edite sua visualização usando as opções padrão.
  6. Clique no botão Edit Chart Config na guia Plot. O Looker mostra a caixa de diálogo Edit Chart Config.
  7. Insira um JSON HighCharts válido no painel Configuração do gráfico (Override). Você pode usar o texto copiado na etapa 2 como um modelo, mas não deixe de testar as alterações usando o botão Visualizar para garantir que não haja conflitos.
  8. Clique em Aplicar.

Formatação condicional com series formatters

O Editor de configuração do gráfico aceita a maioria dos JSON HighCharts válidos. Ela também aceita o atributo series formatters, que existe apenas no Looker. Cada série pode ter vários formatadores para combinar regras de estilo diferentes.

O atributo series formatters aceita dois atributos: select e style.

  • Insira uma expressão lógica no atributo select para indicar quais valores de dados serão formatados.
  • Insira um JSON no atributo style para indicar como formatar os valores de dados.

Por exemplo, o JSON a seguir vai colorir cada valor de dados de laranja se ele for maior ou igual a 380:

{
  series: [{
    formatters: [{
      select: 'value >= 380',
      style: {
        color: 'orange'
      }
    }]
  }]
}

As seções a seguir descrevem em mais detalhes os possíveis valores dos atributos select e style.

O atributo select

É possível usar os seguintes valores em uma expressão select:

  • value: essa variável retorna o valor da série. Por exemplo, é possível usar select: value > 0 para segmentar todos os valores positivos ou value = 100 para corresponder apenas às séries com um valor de 100.
  • max: use select: max para segmentar o valor da série que tem o valor máximo.
  • min: use select: min para segmentar o valor da série que tem o valor mínimo.
  • percent_rank: esta variável segmenta o valor da série com um percentil especificado. Por exemplo, é possível usar select: percent_rank >= 0.9 para segmentar valores de série no 90o percentil.
  • name: essa variável retorna o valor da dimensão da série. Por exemplo, se você tiver um relatório mostrando pedidos Vendidos, Cancelados e Devolvidos, será possível usar select: name = Sold para segmentar a série em que o valor da dimensão é "Vendido".
  • AND/OR Use AND e OR para combinar várias expressões lógicas.

Para ver essas expressões implementadas no Editor de configuração de gráfico, consulte o exemplo Colorir os valores máximo, mínimo e percentil.

O atributo style

O atributo style pode ser usado para aplicar estilos compatíveis com o HighCharts. Por exemplo, é possível definir valores de séries de cores usando style.color, bordas de séries de cores usando style.borderColor e definir a largura da borda da série com style.borderWidth. Para uma lista mais completa de opções de estilo, consulte as Opções de Highcharts para series.column.data.

Para visualizações de linha, use style.marker.fillColor e style.marker.lineColor em vez de style.color. Para uma lista mais completa de opções de estilo de linha, consulte as Opções do Highchart para series.line.data.marker.

Para ver a formatação de cores implementada no Editor de configuração de gráfico, consulte o exemplo Colorir os valores máximo, mínimo e percentil.

Examples

As seções a seguir fornecem exemplos de alguns casos de uso comuns do Editor de configuração de gráficos. Para uma lista completa dos atributos que você pode editar, consulte a documentação da API HighCharts.

Mudar a cor do plano de fundo e do texto do eixo

Para mudar a cor de fundo de uma visualização, use o atributo chart.backgroundColor.

Da mesma forma, para alterar a cor do texto dos eixos em uma visualização, use os seguintes atributos:

O JSON HighCharts a seguir muda a cor de fundo da visualização para roxo e o texto dos títulos e rótulos dos eixos para branco.

{
  chart: {
    backgroundColor: "purple"
  },

  xAxis: {
    labels: {
      style: {
        color: "white"
      }
    },
    title: {
      style: {
        color: "white"
      }
    }
  },

  yAxis: {
    labels: {
      style: {
        color: "white"
      }
    },
    title: {
      style: {
        color: "white"
      }
    }
  }
}

Personalizar a cor da dica

Para personalizar a cor da dica, use os seguintes atributos:

O JSON HighCharts a seguir muda a cor do plano de fundo da dica para ciano e muda a cor do texto da dica para preto.

{
  tooltip: {
    backgroundColor: "cyan",
    style: {
      color: "black"
    }
  }
}

Personalizar estilos e conteúdo de dicas

Para personalizar o conteúdo da dica, use os seguintes atributos:

O JSON do HighCharts a seguir altera o formato da dica de modo que o valor do eixo x apareça no topo da dica em fonte maior, seguido por uma lista de todos os valores da série naquele ponto.

Este exemplo usa as seguintes funções e variáveis do HighCharts:

  • {key} é uma variável que retorna o valor do eixo x do ponto selecionado. (neste exemplo, o mês e o ano).
  • {#each points}{/each} é uma função que repete o código incluído para cada série no gráfico.
  • {series.name} é uma variável que retorna o nome da série.
  • {y:.2f} é uma variável que retorna o valor do eixo y do ponto selecionado, arredondado para duas casas decimais.
    • {y} é uma variável que retorna o valor do eixo y do ponto selecionado.
    • {variable:.2f} arredonda variable para duas casas decimais. Consulte a documentação de modelos de Highcharts para mais exemplos de formatação de valores.
{
  tooltip: {
    format: '<span style="font-size: 1.8em">{key}</span><br/>{#each points}<span style="color:{color}; font-weight: bold;">\u25CF {series.name}: </span>{y:.2f}<br/>{/each}',
    shared: true
  },
}

Adicionar legendas e anotações ao gráfico

Para adicionar uma anotação, use o atributo annotations. Para adicionar uma legenda ao gráfico, use o atributo caption.

Para ver as coordenadas de um ponto, clique em Inspect Point Metadata na parte superior da caixa de diálogo Edit Chart Config. Em seguida, mantenha o ponteiro do mouse sobre o ponto de dados que você gostaria de anotar. O Looker exibe um ID de ponto, que pode ser usado no atributo annotations.labels.point.

O JSON do HighCharts a seguir adiciona duas anotações ao gráfico para explicar uma redução nos itens do inventário após determinados períodos. Ela também adiciona uma legenda à parte inferior do gráfico para explicar as anotações com mais detalhes.

{
  caption: {
    text: 'Items go on clearance after 60 days, and are thrown away after 80 days. Thus we see large drops in inventory after these events.'
  },
  annotations: [{
    labels: [{
        point: "inventory_items.count-60-79",
        text: "Clearance sale"
      },
      {
        point: "inventory_items.count-80+",
        text: "Thrown away"
      },
    ]
  }]
}

Adicionar intervalos de referência verticais

Para adicionar uma faixa de referência vertical, use o atributo xAxis.plotBands.

O JSON do HighCharts a seguir adiciona uma faixa de referência vertical entre 24 e 29 de novembro de 2022 para indicar um período de promoção. Ela também adiciona uma legenda na parte inferior do gráfico para explicar a importância da banda.

Os atributos to e from de xAxis.plotBands precisam corresponder aos valores de dados no gráfico. Neste exemplo, como os dados são baseados no horário, os atributos aceitam valores de carimbo de data/hora Unix (1669680000000 para 29 de novembro de 2022 e 1669248000000 para 24 de novembro de 2022). Formatos de data baseados em string, como MM/DD/AAAA e DD-MM-AA, não são compatíveis com os atributos HighCharts to e from.

{
  caption: {
    text: 'This chart uses the HighCharts plotBands attribute to display a band around the Black Friday Cyber Monday sale period.'
  },
  xAxis: {
    plotBands: [{
      to: 1669680000000,
      from: 1669248000000,
      label: {
        text: 'BFCM Sale Period'
      }
    }]
  },
}

Colorir os valores máximo, mínimo e percentual

Consulte a página Como aproveitar ao máximo as visualizações do Looker: personalização de formatação condicional em gráficos cartesianos para conferir um exemplo detalhado sobre como colorir os valores máximo, mínimo e percentil de uma visualização cartesiana.

Criação de novos tipos de visualização

É possível usar o Editor de configuração de gráficos para criar tipos de visualização que não estão incluídos nos tipos de visualização padrão do Looker. Os artigos a seguir fornecem exemplos de algumas das visualizações que você pode projetar com o Editor de configuração de gráficos: