Devuelve datos comparativos de un widget de índice, como valor, período y variación.

sc_widget_data('dataName')

La macro sc_widget_data() devuelve datos de un widget de tipo Índice, permitiendo acceder a los valores comparativos y estadísticos definidos en la configuración del widget.

Puede utilizarse para personalizar el contenido y la apariencia del widget según los datos calculados en tiempo de ejecución, como la variación porcentual o la diferencia entre períodos.

Parámetro

La macro recibe un único parámetro, que debe ser el nombre del dato que se desea recuperar.

Ejemplo de uso:

sc_widget_data('value')

Parámetros disponibles

Parámetro	Descripción
`value`	Valor principal del período actual.
`period`	Período actual configurado en el widget (por ejemplo: mes actual, semana, etc.).
`last_value`	Valor correspondiente al período anterior.
`last_period`	Etiqueta del período anterior (por ejemplo: mes anterior, semana pasada, etc.).
`difference`	Diferencia entre los valores de ambos períodos (`value - last_value`).
`variation`	Variación porcentual entre los períodos (comparación entre `value` y `last_value`).

Ejemplo

$dif = sc_widget_data('difference');

if ($dif < 0) {
  sc_widget_config([
    'background-color' => '#ffdddd',
    'border-color' => '#cc0000',
    'legend' => 'Rendimiento inferior al período anterior',
  ]);
} else {
  sc_widget_config([
    'background-color' => '#ddffdd',
    'border-color' => '#00cc00',
    'legend' => 'Mejora en relación al período anterior',
  ]);
}

En el ejemplo anterior, la macro sc_widget_data() recupera la diferencia entre los períodos. Según ese valor, la apariencia del widget se adapta dinámicamente.