| 1 |
/** |
| 2 |
* KPI card renderer — pure DOM fill, no fetch. |
| 3 |
* |
| 4 |
* Payload shape comes from PeriodHelper::kpi_payload() on the server: |
| 5 |
* { value, prev_value, change_pct } plus optional client extras |
| 6 |
* { formatted, subline }. change_pct null → delta hidden (no wrong deltas). |
| 7 |
* |
| 8 |
* @since 4.4.2 |
| 9 |
* @version 1.0.0 |
| 10 |
*/ |
| 11 |
|
| 12 |
/** |
| 13 |
* @param {Element} elCard The .lp-kpi-card root. |
| 14 |
* @param {Object} payload KPI payload. |
| 15 |
*/ |
| 16 |
export const renderKpi = ( elCard, payload = {} ) => { |
| 17 |
if ( ! elCard ) { |
| 18 |
return; |
| 19 |
} |
| 20 |
|
| 21 |
const elValue = elCard.querySelector( '.lp-kpi-value' ); |
| 22 |
const elDelta = elCard.querySelector( '.lp-kpi-delta' ); |
| 23 |
const elSubline = elCard.querySelector( '.lp-kpi-subline' ); |
| 24 |
|
| 25 |
if ( elValue ) { |
| 26 |
const value = payload.formatted ?? payload.value; |
| 27 |
elValue.textContent = null == value || '' === value ? '–' : String( value ); |
| 28 |
} |
| 29 |
|
| 30 |
if ( elDelta ) { |
| 31 |
elDelta.classList.remove( 'is-up', 'is-down' ); |
| 32 |
|
| 33 |
if ( 'number' === typeof payload.change_pct ) { |
| 34 |
const isUp = payload.change_pct >= 0; |
| 35 |
elDelta.classList.add( isUp ? 'is-up' : 'is-down' ); |
| 36 |
elDelta.textContent = `${ isUp ? '▲' : '▼' } ${ Math.abs( |
| 37 |
payload.change_pct |
| 38 |
) }%`; |
| 39 |
} else { |
| 40 |
elDelta.textContent = ''; |
| 41 |
} |
| 42 |
} |
| 43 |
|
| 44 |
if ( elSubline ) { |
| 45 |
elSubline.textContent = payload.subline ?? ''; |
| 46 |
} |
| 47 |
}; |
| 48 |
|
