Retorna dados comparativos de um widget de índice, como valor, período e variação.

sc_widget_data('dataName')

A macro sc_widget_data() retorna dados de um widget do tipo Índice, permitindo acessar os valores comparativos e estatísticos definidos na configuração do widget.

Ela pode ser usada para personalizar o conteúdo e a aparência do widget com base nos dados calculados em tempo de execução, como variação percentual ou diferença entre períodos.

Parâmetro

A macro recebe um único parâmetro, que deve ser o nome do dado que se deseja recuperar.

Exemplo de uso:

sc_widget_data('value')

Parâmetros disponíveis

Parâmetro	Descrição
`value`	Valor principal do período atual.
`period`	Período atual configurado no widget (ex: mês atual, semana, etc).
`last_value`	Valor do período anterior ao atual.
`last_period`	Período anterior ao configurado (ex: mês anterior, semana passada, etc).
`difference`	Diferença entre os valores dos dois períodos (`value - last_value`).
`variation`	Variação percentual entre os períodos (comparação entre `value` e `last_value`).

Exemplo

$dif = sc_widget_data('difference');

if ($dif < 0) {
  sc_widget_config([
    'background-color' => '#ffdddd',
    'border-color' => '#cc0000',
    'legend' => 'Desempenho inferior ao período anterior',
  ]);
} else {
  sc_widget_config([
    'background-color' => '#ddffdd',
    'border-color' => '#00cc00',
    'legend' => 'Melhoria em relação ao período anterior',
  ]);
}

No exemplo acima, a macro sc_widget_data() recupera a diferença entre os períodos. Com base nesse valor, a aparência do widget é adaptada dinamicamente.