look |
Table and list presentations by kind: diverging, paired_heat, ranked_list, drivers, verbatims, tree_flat, topic_buttons (panel_matrix) and sentiment_donut (ring_compare). Each accepts aside, the right-hand unit words |
{"look":{"kind":"ranked_list","rank":"rank","text":"title","chipSeparator":"|"}} |
look.rowStyle: "plain" |
On topic_buttons: borderless rows, the picked one filled, both counts ("p / n") kept. Absent = bordered buttons |
{"look":{"kind":"topic_buttons","positive":"pos","negative":"neg","rowStyle":"plain"}} |
look.moreStyle: "box" |
On ranked_list with rowsCollapsed: the reveal is a bordered full-width disclosure row with a caret. Absent = a text link |
{"look":{"kind":"ranked_list","rowsCollapsed":5,"moreStyle":"box"}} |
look.kind: "topic_sides" |
One topic's sides (1 or 2): each sides[] names tone, heading, the drivers text column and an optional verbatims text column; a row joins the side whose tone its text carries. Drivers print as paragraphs (emptyText when none), the first verbatim is boxed with quoteLead · <row sublabel>, the rest open behind "View N more" |
{"look":{"kind":"topic_sides","sides":[{"tone":"positive","heading":{"vi":"Được khen"},"drivers":"drv","verbatims":"vb"}]}} |
pivotForm |
Chart form of an aligned pivot by kind: ranked_bars, split_bars, pool_share_bars, period_columns, cohort_columns, combo. Drawn only on a card with no click, except combo |
{"pivotForm":{"kind":"ranked_bars","share":true}} |
pivotForm.layout: "ranked", pivotForm.countText |
On pool_share_bars: each pool is a block headed by its name and N (countText places it, {n} buzz), one bar per series, largest first, with its share |
{"pivotForm":{"kind":"pool_share_bars","countSeries":"n","layout":"ranked","countText":{"vi":"{n} buzz"}}} |
bandLayout |
"strip": one line per row, figures inked by column polarity. "tiles": one card per top-level column (label, figure, compare, notes, change) |
{"bandLayout":"tiles","cardChrome":"none","titleHidden":true,"tileFit":"content"} |
tileNotes[], tileContext |
A muted note under a tile's figure by column key; a suffix on every change line's context |
{"tileNotes":[{"key":"outcomes","vi":"Bài gốc"}],"tileContext":{"vi":"7 ngày trọn"}} |
tileCompares: "end" |
Tiles: the compare line and tileNotes sit under the change line ("▲ +152.9% · vs Oct 16-22", then "Baseline: 18,255"). Absent = above it |
{"bandLayout":"tiles","tileCompares":"end"} |
notePlacement: "top", noteLead |
The panel note sits above the body (an instruction rather than a footnote); noteLead: true sets its first sentence in the accent ink |
{"note":{"vi":"Bấm một ngày để xem bài đăng. ..."},"notePlacement":"top","noteLead":true} |
tileGrid |
"balanced": one line when every tile fits, else balanced rows that fill the width (3+2, then 2+2+1) |
{"tileGrid":"balanced"} |
tileUnreported, tileChangeUnavailable |
"hide": a tile with a blank figure is not drawn and the rest close up; tiles print no "change unavailable" line |
{"tileUnreported":"hide","tileChangeUnavailable":"hide"} |
compareToggle |
The named change columns (each subOf a figure column) stay off until a card-header switch turns them on; the switch shows only when every row's change resolves |
{"compareToggle":{"columns":["chg"]}} |
collapsed |
The card opens closed behind one disclosure line; the body mounts and fetches only when opened. Pair with titleHidden |
{"titleHidden":true,"collapsed":{"summary":{"vi":"Ghi chú đo lường"}}} |
collapsed.surface: "card" |
The closed card is drawn on the glossary's card with the same 48px title row, so every collapsed row on a page has one height and one surface. Needs cardChrome: "none" (refused otherwise) |
{"titleHidden":true,"cardChrome":"none","collapsed":{"summary":{"vi":"Xem chỉ số khác"},"surface":"card"}} |
collapsed.summary tokens |
The disclosure line fills page tokens ({label:<dimKey>}, {dimKey}); an unfilled token drops out with its separator |
{"collapsed":{"summary":{"vi":"Xem {label:attribute} qua các kỳ"}}} |
cardGroup |
Widgets that share cardGroup.id draw inside ONE bordered card (read mode; the editor ignores it). Shape { id, title?: {vi,en?}, subtitle?: {vi,en?}, collapsible?: true }; only the first widget needs the header fields, later ones repeat id. collapsible adds a toggle (open by default). Also accepted on audience cards and static blocks. A group is skipped when another card sits inside its rectangle. |
|
emptyCell |
A blank figure prints this word alone; the reason stays in the tooltip |
{"emptyCell":{"vi":"—"}} |
cellNote |
A muted line under the named columns' cells while a page dim holds one of the values |
{"cellNote":{"columns":["share"],"when":{"dim":"node","values":["other"]},"vi":"Phạm vi khác"}} |
visibleWhen |
The card is not drawn, and not fetched, unless a page dim holds one of the values |
{"visibleWhen":{"dim":"node","values":["total"]}} |
hideWhenEmpty |
An answered card with nothing to draw is not drawn and its tile closes up: a matrix without rows, a chart without points or values, a chart or ring whose scope has no x point or category. A refusal or an error keeps its line |
{"hideWhenEmpty":true} |
cardTitle, cardSubtitle |
Card heading and a muted line under it. Tokens: {period_id}, {label:<dimKey>} and the frame tokens. cardSubtitle alone prints under the widget's own title |
{"cardTitle":{"vi":"{label:node} · mỗi ngày"}} |
cardTitleStyle: "heading" |
cardTitle prints as the card's own heading (sentence case) with cardSubtitle at the end of its row |
{"cardTitle":{"vi":"{label:attribute}"},"cardTitleStyle":"heading"} |
cardSubtitleStyle: "badge" |
With cardSubtitlePlacement: "header": the subtitle reads as a warning-toned pill (a scope caveat) |
{"cardSubtitle":{"vi":"Gồm minigame"},"cardSubtitlePlacement":"header","cardSubtitleStyle":"badge"} |
section.scopeVi, section.scopeEn |
A scope strip with a dot under the section title; same tokens as cardTitle. section.style: "intro" draws eyebrow, headline, lead and corner badge |
{"section":{"titleVi":"Tổng quan","scopeVi":"{period_id}"}} |
section.scopeLead: "pill" |
With scopeStyle: "band": the strip's first · segment reads as a filled pill ("Tracking snapshot"), the dot goes |
{"section":{"scopeVi":"Ảnh chụp theo dõi · 23-29/10/2026","scopeStyle":"band","scopeLead":"pill"}} |
section.subtitlePlacement: "after_scope" |
The section subtitle prints under the scope strip as a small caveat. Absent = under the title |
{"section":{"subtitleVi":"Không phải kết quả thử nghiệm.","subtitlePlacement":"after_scope"}} |
section.style: "sub" |
A sub-heading under the page's opening block: an h3 in the section ink at the intro headline size (20px), as written (no upper case), the subtitle as a lead under it. Eyebrow and badge are not drawn. Use it for a second heading on a page that already has an intro |
{"section":{"titleVi":"{label:channel}","subtitleVi":"…","style":"sub"}} |
column.bar: "share_pair", sharePairRoles |
A two-tone 100% bar plus a bold percent on a share cell; sharePairRoles names the theme seriesRoles.value keys for the two halves |
{"sharePairRoles":{"value":"brand-a","rest":"brand-b"}} |
click.alwaysOne |
On click.kind: "filter", a second click keeps the pick instead of clearing it |
{"click":{"kind":"filter","dim":"attr","alwaysOne":true}} |
click.clears |
On a filter click: page dims (up to 6) whose pick is cleared whenever the click changes the selection, even where their control stays visible |
{"click":{"kind":"filter","dim":"channel","alwaysOne":true,"clears":["activity"]}} |
click.pointSummary |
On click.kind: "detail" of a chart: the dialog states the day's figures (each series, then its role badge), opened from the chart or from a narrative section's detail link to that chart |
{"click":{"kind":"detail","dim":"$sub","datasetKey":"threads","binding":{...},"pointSummary":true}} |
headerAction |
A link to another pack page in the card header's right slot, labelled by cta (required). A card with a hidden title draws it right-aligned above the body. Same target, carry, pin, anchor, back as navigate |
{"headerAction":{"kind":"navigate","target":{"page":"feedback"},"carry":[],"cta":{"vi":"Khám phá phản hồi","en":"Explore feedback"}}} |
hostedControlsPlacement |
With hostsTabControls: "section" = the hosted controls (and a frame tab strip) under the card's heading; "below" = after the body; "card" = the section place drawn as one bordered controls card, each label above its control. Absent = the card's control row |
{"hostsTabControls":true,"hostedControlsPlacement":"card"} |
hostsPageControls |
The card draws the page controls marked placement: "card" in its section heading's right slot (needs section); same page state and visibleWhen as the top row |
{"hostsPageControls":true,"section":{"titleVi":"Social Outreach"}} |
csvOnly, csvLayout |
Keys kept off the card but written to its CSV; "rows_per_x" writes one row per x point |
{"csvOnly":["per_day"],"csvLayout":"rows_per_x"} |
defaults.<dim>.scope: "dataset" |
A cells default picks among the values of the whole dataset, not the card's pinned scope |
{"defaults":{"node":{"pick":"first","among":["total"],"scope":"dataset"}}} |
| Field |
Meaning |
Example |
| ------------------------------------------------------------------------------- |
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
--------------------------------------------------------------------------------------------------------------------------------------- |
section.titleVi, widget title |
Page tokens {period_id}, {label:<dimKey>} fill a section title and suffix, and a panel card's own title in read mode. Unresolved: no section heading; a card title drops the token and its separator |
{"section":{"titleVi":"{label:channel}"}}; card title {label:channel} · Buzz mỗi ngày |
section.scopeStyle: "band" |
The scope strip as a tinted band (surface.accent ground, section-ink dot). Per card, so no other card or org changes. Needs section.scopeVi (refused otherwise) |
{"section":{"titleVi":"Kênh","scopeVi":"{period_id}","scopeStyle":"band"}} |
section.scopePlacement: "after_controls" |
The scope strip sits under the card's hosted controls (the controls card first, then the scope). Needs section.scopeVi and hostsTabControls (refused otherwise); takes effect with hostedControlsPlacement "section" or "card" |
{"hostsTabControls":true,"hostedControlsPlacement":"card","section":{"titleVi":"Tổng quan","scopeVi":"{period_id}","scopePlacement":"after_controls"}} |
section.stats |
On a style: "intro" section: up to four figure + label pairs at the heading's right edge, the figure in the section ink (value up to 12 chars, labelVi up to 40, optional labelEn). Typed by the pack, never computed; a stat on any other style is dropped. Absent, the heading is as before |
{"section":{"titleVi":"Tổng quan","style":"intro","stats":[{"value":"4","labelVi":"phân khúc","labelEn":"segments"},{"value":"9","labelVi":"dòng sản phẩm"}]}} |
section.statsLayout: "inline" |
Each intro stat reads figure then label on one line. Absent = the label under the figure |
{"section":{"style":"intro","stats":[{"value":"4","labelVi":"phân khúc"}],"statsLayout":"inline"}} |
bulletStyle: "lead" |
A bullets frame prints each row as a lead paragraph: no list marker, body size, section ink. Absent = the bulleted list |
{"bulletStyle":"lead","rowTemplates":[{"row":"recap","vi":"..."}]} |
cardSubtitlePlacement: "header" |
cardSubtitle in the card header's right slot, wrapping under the title when narrow; a hidden-title card keeps its line. Needs cardSubtitle (refused otherwise) |
{"cardSubtitle":{"vi":"Loại minigame"},"cardSubtitlePlacement":"header"} |
| Field |
Meaning |
Example |
| -------------------------------------------------------------------------------------------------- |
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
--------------------------------------------------------------------------------------------------------------------------------------- |
section.index under deckCardTitleCase: "as_written" |
Not a pack field: when the org's skin heads cards as written, a numbered section heads in sentence case at 20px in the section ink, and its subtitle takes its own line under the title. Other skins keep the upper-case label |
{"section":{"index":1,"titleVi":"Người dùng thảo luận điều gì"}} |