HTML Element & Component Reference
This specification defines the complete set of built-in XML/HTML tags and components supported by the RTXUI template parser, including their classification, attribute interfaces, slot projections, event contracts, and default user-agent stylesheets.
1. Architectural Model
1.1 Unified Component Architecture
Every built-in tag—from <div> to <dialog>—is a component registered in the global component registry and built over rtxui::Element. Simpler tags like <div> or <span> use trivial templates (e.g. <slot></slot> with a default stylesheet), while richer widgets like <input> or <select> encapsulate internal HTML templates, reactive state bindings, slot projections, and scoped CSS rules. The difference is in complexity, not in kind.
1.2 Parser Contract
- Well-Formed XML/HTML: All tags must be balanced or explicitly self-closed (e.g.
<hr />,<br />,<input />). Unclosed tags generate parser errors with line and column diagnostics. - Case Sensitivity: Tag names and attribute names are case-sensitive, as in XML. Built-in tags and attributes are lower-case (
<DIV>is an unknown tag, andCLASSis notclass), and a component's tag is written as it was imported (<Card/>). - Quoting: Attribute values must be enclosed in double (
"...") or single ('...') quotes.
1.3 Binding Syntax
| Syntax | Target | Example | Semantic Contract |
|---|---|---|---|
{member} | Text / Attribute | <span id="{node_id}">{title}</span> | Interpolates C++ member snapshot; updates DOM on change. |
on<event>="Handler" | Event Callback | <button onclick="Submit">OK</button> | Dispatches to registered C++ method or lambda. oncontextmenu takes the right click. |
onkey:<key>="Handler" | Keyboard Shortcut | <div onkey:j="Down" onkey:ctrl+d="Jump(10)"> | Runs when the key is pressed with the focus on this element or inside it. onkey="Handler" runs for every key. See Keyboard Shortcuts. |
2. Global Attributes & Directives
The following attributes apply to all elements and components:
| Attribute | Type | Default | Description |
|---|---|---|---|
id | string | "" | Unique element identifier; targets #id CSS rules and for associations. |
class | string | "" | Space-delimited token list for .class CSS selector matching. |
style | string | "" | Inline CSS declarations. Overrides stylesheet rules with higher specificity. |
tabindex | integer | -1 | Sequential keyboard focus order. Values >= 0 participate in Tab navigation; -1 excludes the element. |
focusable | boolean | false | Shorthand; focusable="true" is equivalent to tabindex="0". |
disabled | boolean | false | Disables user interaction, removes focus, and applies the :disabled CSS pseudo-class. |
if | expression | — | Conditional rendering directive. If the expression evaluates to false, the element and its subtree are pruned from the DOM. |
part | string | "" | Names an element part for ::part() CSS selector targeting from ancestor components. |
onanimationend | handler | — | Runs when one of the element's keyframe animations finishes. Not for an infinite one, nor one removed before its end. |
3. Structural Containers & Layout
<div>
- Classification: Block Component
- Layout Model:
display: block - Semantics: Standard block-level container for flow, flex, or grid layouts.
<span>
- Classification: Inline Component
- Layout Model:
display: inline - Semantics: Inline-level formatting wrapper for styled text segments.
Semantic Elements (<header>, <footer>, <main>, <nav>, <aside>, <section>, <article>)
- Classification: Block Components
- Layout Model:
display: block - Semantics: Structural containers functionally identical to
<div>, providing semantic document organization.
<table>, <thead>, <tbody>, <tfoot>, <tr>, <th>, <td>
- Classification: Table Components
- Layout Model: Table formatting context with automatic column and row sizing.
- Section Containers:
<thead>,<tbody>, and<tfoot>group rows logically. The layout engine traverses them transparently when assembling grid rows and computing cell geometry.
<th> / <td> Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
colspan | integer | 1 | One-way | Number of columns the cell should span. |
rowspan | integer | 1 | One-way | Number of rows the cell should span. |
Table Sizing Algorithm:
Columns: Evaluates the maximum preferred cell width across each column. Extra horizontal space from fixed container
widthormin-widthis distributed proportionally.Rows: Row height conforms to the tallest cell in the row. Shorter cells stretch vertically to maintain unbroken borders and backgrounds;
vertical-align: middle | bottomon a cell moves its content down within it.Cell borders: by default each cell draws its whole border, next to its neighbours'.
border-spacingputs space between them.border-collapse: collapseon the table draws each line once and joins them at the crossings:csstable { border: solid; border-collapse: collapse; } td, th { border: solid; padding: 0 1; }┌──────────┬────────┐ │ Service │ Status │ ├──────────┼────────┤ │ Database │ Active │ └──────────┴────────┘
<table>
<thead>
<tr>
<th>Service</th>
<th>Status</th>
</tr>
</thead>
<tbody>
<tr>
<td>Database</td>
<td>Active</td>
</tr>
</tbody>
</table>
<style>
table {
border: solid;
border-color: #3b82f6;
}
th {
font-weight: bold;
border-bottom: solid;
border-color: #334155;
}
td, th {
padding-left: 1;
padding-right: 1;
}
</style>4. Form Controls & Interactive Widgets
<button>
- Classification: Inline Component (
rtxui::button) - Focusable: Yes (
tabindex="0")
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
disabled | boolean | false | One-way | Suppresses activation events and sets :disabled pseudo-class. |
onclick | handler | — | — | Callback invoked on mouse click or Enter/Space keyboard activation. |
Slots
| Slot | Target Element | Description |
|---|---|---|
(default) | Inline container | Button text or child element content. |
Default Stylesheet
self {
display: inline-block;
padding-left: 1;
padding-right: 1;
cursor: pointer;
background-color: lighten(10%);
opacity: 0.85;
transition: background-color 0.1s linear, opacity 0.1s linear, color 0.1s linear;
}
self:hover {
background-color: rgb(59, 130, 246);
color: white;
opacity: 0.95;
}
self:focus {
background-color: rgb(37, 99, 235);
color: white;
opacity: 1.0;
}
self:active {
background-color: rgb(29, 78, 216);
color: white;
opacity: 1.0;
}
self:disabled {
cursor: default;
opacity: 0.4;
}<input>
- Classification: Inline Component (
rtxui::input) - Focusable: Yes (
tabindex="0")
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
value | string | "" | Two-way | Text content. Automatically synchronized during typing. |
type | string | "text" | One-way | Input format. "text" renders characters; "password" masks characters with *. |
placeholder | string | "" | One-way | Ghost text displayed when value is empty. |
disabled | boolean | false | One-way | Disables input and focus; applies :disabled pseudo-class. |
readonly | boolean | false | One-way | Prevents text modification while allowing focus and text selection. |
select_on_focus | boolean | false | One-way | Automatically selects all text content when focused. |
maxlength | integer | -1 | One-way | Maximum character length constraint (-1 indicates unconstrained). |
onchange | handler | — | — | Runs when the user commits an edit: on Enter, or when focus leaves the input after its value changed. Accepts void() or void(std::string), which receives the value. |
Styleable Parts (::part())
placeholder: The span element rendering placeholder text.cursor,cursor-focused: The active cursor indicator.selection: Highlighted text selection regions.
Default Stylesheet
self {
display: inline-flex;
flex-direction: row;
width: 20;
padding-left: 1;
padding-right: 1;
overflow-x: scroll;
scrollbar-width: none;
white-space: nowrap;
background-color: rgb(40, 40, 40);
opacity: 0.8;
}
self:focus {
opacity: 1.0;
}
self:disabled {
opacity: 0.4;
cursor: default;
}<textarea>
- Classification: Block Component (
rtxui::textarea) - Focusable: Yes (
tabindex="0")
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
value | string | "" | Two-way | Multi-line text content. |
placeholder | string | "" | One-way | Ghost text rendered when content is empty. |
disabled | boolean | false | One-way | Disables editing and interaction. |
readonly | boolean | false | One-way | Prevents text edits while maintaining scroll and selection capabilities. |
select_on_focus | boolean | false | One-way | Automatically selects all text content when focused. |
maxlength | integer | -1 | One-way | Maximum character capacity limit. |
linenumbers | string | "" | One-way | Displays line number gutter. Values: "" (off), "true" / "absolute" (absolute), "relative" (relative). |
line_start | integer | 1 | One-way | The displayed number of the first logical line. |
line_end | integer | -1 | One-way | The last displayed number to show a gutter entry for; -1 means unbounded. |
line_wrap | string | "" | One-way | Soft line wrapping at viewport boundary. Values: "", "ignore", "subline". |
highlight_current_line | boolean | false | One-way | Emphasizes the row hosting the active cursor. |
<checkbox>
- Classification: Inline-Flex Component (
rtxui::checkbox) - Focusable: Yes (
tabindex="0")
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
checked | boolean | false | Two-way | State toggle. Toggles between ☑ and ☐. Synchronizes :checked pseudo-class. |
disabled | boolean | false | One-way | Suppresses toggle interaction and sets :disabled pseudo-class. |
onchange | handler | — | — | Fired on state change. Accepts void() or void(bool). |
Styleable Parts (::part())
checkmark: Span element containing the checkmark glyph (☑or☐).
Default Stylesheet
self {
display: inline-flex;
flex-direction: row;
white-space: nowrap;
cursor: pointer;
padding-left: 1;
padding-right: 1;
transition: background-color 0.1s linear;
}
self:hover {
background-color: lighten(10%);
}
self:focus {
background-color: lighten(25%);
}
self:active {
background-color: lighten(35%);
}
self:disabled {
cursor: default;
opacity: 0.4;
}
.checkmark {
margin-right: 1;
}<radio>
- Classification: Inline-Flex Component (
rtxui::radio) - Focusable: Yes (
tabindex="0")
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
name | string | "" | One-way | Radio group identifier. Only one radio sharing a name can be checked simultaneously. |
checked | boolean | false | Two-way | Selection state. Toggles between ◉ and ○. Synchronizes :checked pseudo-class. |
disabled | boolean | false | One-way | Suppresses activation and applies :disabled pseudo-class. |
onchange | handler | — | — | Fired when the radio is selected. |
Styleable Parts (::part())
radio-mark: Span element containing the radio glyph (◉or○).
<radio name="theme" checked="{dark_mode}">Dark</radio>
<radio name="theme" checked="{light_mode}">Light</radio><select> and <option>
- Classification: Component (
rtxui::select,rtxui::option) - Focusable: Yes (
tabindex="0")
<select> Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
value | string | "" | Two-way | Active selected option value. |
disabled | boolean | false | One-way | Disables dropdown expansion. |
onchange | handler | — | — | Fired on option change. Accepts void() or void(std::string). |
<option> Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
value | string | "" | One-way | Distinct value payload passed to <select>. |
disabled | boolean | false | One-way | Prevents selection of this specific option. |
Styleable Parts (::part())
select-btn: Main clickable trigger container.select-label: Active selected text label.select-arrow: Dropdown expand/collapse arrow glyph.dropdown-list: Floating options list container.
<slider>
- Classification: Inline Component (
rtxui::slider) - Focusable: Yes (
tabindex="0")
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
value | integer | 0 | Two-way | Current slider value. Clamped between min and max. |
min | integer | 0 | One-way | Lower bound of the range. |
max | integer | 100 | One-way | Upper bound of the range. |
step | integer | 1 | One-way | Discrete increment step on keyboard navigation or dragging. |
width | integer | 20 | One-way | Visual cell track width. |
direction | string | "horizontal" | One-way | Track orientation ("horizontal" or "vertical"). |
disabled | boolean | false | One-way | Disables slider manipulation. |
onchange | handler | — | — | Fired on value updates. Accepts void() or void(int). |
Styleable Parts (::part())
slider-container: Wrapper element.track-left: Filled track portion preceding the thumb.thumb: Visual thumb handle glyph (●).track-right: Unfilled track portion following the thumb.
<progress>
- Classification: Inline Component (
rtxui::progress) - Focusable: No
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
value | float | 0.0 | One-way | Current progress amount. |
max | float | 100.0 | One-way | Maximum range value. |
width | integer | 20 | One-way | Physical cell width of the bar. |
Styleable Parts (::part())
filled: Active progress section (rendered using█).empty: Inactive remainder section.
<canvas>
- Classification: Inline-Block Component (
rtxui::canvas), replaced: it has no children - Focusable: No (add
tabindex="0"; keys then reach the owner'sOnEvent)
The application draws the cells. RTXUI calls ondraw once the frame is laid out, with an rtxui::Canvas the size of the element's content box, cleared first. It calls it again only when the content box changes size or the bound state of the component holding ondraw changes, and keeps the drawing otherwise. To animate, advance a bound member from a PostDelayedTask.
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
width | integer | 30 | One-way | Width in cells when CSS sets none, as an image's. |
height | integer | 8 | One-way | Height in cells when CSS sets none. |
ondraw | handler | — | — | Draws the cells. A bound void(rtxui::Canvas&). Required. |
onpointer | handler | — | — | Mouse events over the canvas, in its coordinates. A bound void(const rtxui::PointerEvent&). |
width and height CSS set the box as for any element, so width: 100% fills the parent. Padding and borders surround the drawing. A cell the draw function leaves alone shows the element's CSS background through; a color it leaves out is the element's CSS color, :hover and transitions included.
Drawing (rtxui::Canvas)
| Member | Description |
|---|---|
width(), height() | The size, in cells. |
color() | The element's CSS color. |
Set(x, y, grapheme[, color]) | One grapheme; a wide one takes two cells. |
Text(x, y, text[, color]) | A line of text, not wrapped. |
SetBackground(x, y, color), Fill(color) | A cell's background, or every cell's. |
SetPixels(mode) | The dots of Point and Line: Braille (2×4 a cell, the default), Quadrant (2×2), HalfBlock (1×2, a color each). |
pixel_width(), pixel_height() | The size, in dots. |
Point(x, y[, color]), Line(x0, y0, x1, y1[, color]) | Dots. |
Anything outside the surface is clipped.
Pointer (rtxui::PointerEvent)
x, y are the cell from the content box's top left; pixel_x, pixel_y the dot in the current pixel mode (precise when the terminal reports pixels, else the cell's middle); mouse is the Event::Mouse (button, motion, modifiers). Hover moves arrive while the pointer is over the canvas. A press captures the pointer until its release, so a drag keeps reporting past the edges, with coordinates outside the canvas.
class Sketch : public rtxui::Component<Sketch> {
public:
int count = 0;
int last_x = 0, last_y = 0;
std::vector<std::array<int, 4>> lines;
std::string_view view = R"(
<canvas class="pad" ondraw="Draw" onpointer="OnPointer"/>
<style>
.pad { width: 100%; height: 10; color: rgb(88, 166, 255); }
</style>
)";
Sketch() {
Bind(count);
Bind(Draw);
Bind(OnPointer);
}
void Draw(rtxui::Canvas& c) {
for (const auto& [x0, y0, x1, y1] : lines) {
c.Line(x0, y0, x1, y1);
}
}
void OnPointer(const rtxui::PointerEvent& e) {
if (e.mouse.button() != rtxui::Event::Mouse::Left) {
return;
}
if (e.mouse.motion() == rtxui::Event::Mouse::Pressed) {
last_x = e.pixel_x;
last_y = e.pixel_y;
}
lines.push_back({last_x, last_y, e.pixel_x, e.pixel_y});
last_x = e.pixel_x;
last_y = e.pixel_y;
count = static_cast<int>(lines.size()); // Bound: draws again.
}
};<label>
- Classification: Inline-Flex Component (
rtxui::label) - Focusable: No (
cursor: pointer)
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
for | string | "" | One-way | ID of target interactive element. |
Event Delegation Semantics:
Clicking a <label> delegates focus and activation to the target:
- Explicit Target: Element whose
idmatches theforattribute. - Implicit Target: The first focusable descendant nested within
<label></label>.
5. Disclosure, Navigation & Overlays
<details> and <summary>
- Classification: Block Component (
rtxui::details,rtxui::summary)
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
open | boolean | false | Two-way | Expansion state. Toggled by clicking <summary> or pressing Enter/Space. |
Slots
| Slot | Target Element | Description |
|---|---|---|
summary | <summary> | Clickable disclosure header row. If omitted, defaults to "Details". |
(default) | Block container | Collapsible body content displayed when open="true". |
<fieldset> and <legend>
- Classification: Block Component (
rtxui::fieldset,rtxui::legend)
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
disabled | boolean | false | One-way | Disables the fieldset and all enclosed form controls. |
Slots
| Slot | Target Element | Description |
|---|---|---|
legend | <legend> | Header caption nested into the top border frame. |
(default) | Block container | Enclosed form controls and content. |
<tabs> and <tab-pane>
- Classification: Component (
rtxui::tabs,rtxui::tab_pane)
<tabs> Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
value | string | "" | Two-way | Active pane identifier matching <tab-pane name="...">. |
onchange | handler | — | — | Fired when active tab changes. |
<tab-pane> Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
name | string | "" | One-way | Unique tab identifier. |
label | string | "" | One-way | Header text displayed on the tab button. |
<dialog>
- Classification: Modal Overlay (
rtxui::dialog) - Layer: Top-layer modal (
z-index: 100)
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
open | boolean | false | Two-way | Visibility toggle. When true, presents centered overlay with translucent backdrop. |
title | string | "Dialog" | One-way | Title text displayed in the header frame. |
Keyboard Invariants:
Pressing the Escape key automatically dismisses an open dialog and updates the bound open property to false.
Styleable Parts (::part())
dialog-overlay: The backdrop over the whole screen, which centers the box.dialog-box: The framed box. It is as wide as its content, betweenmin-width: 30andmax-width: 60; set awidthhere for another one, e.g.dialog::part(dialog-box) { width: 56; }.dialog-header,dialog-title: The header frame and its title text.dialog-body: What holds the dialog's content.
<toast>
- Classification: Notification Overlay (
rtxui::toast) - Layer: Top-layer popup (
z-index: 200)
A short notification in a corner of the screen, over everything else. It closes itself after duration milliseconds, or when clicked.
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
open | boolean | false | Two-way | Shows the toast. It returns to false when the toast closes, by its timer or a click. Each opening starts the timer again. |
duration | integer | 3000 | One-way | Milliseconds before it closes itself; 0 keeps it until clicked or closed by the application. |
placement | string | "bottom-right" | One-way | Corner: bottom-right, bottom-left, top-right or top-left. Anything else is reported as a diagnostic. |
Parts
toast (the box). It has a tall border by default; restyle it like any element, e.g. .error::part(toast) { border-color: red; } or toast::part(toast) { border: round; }. While it closes, the box is also part closing.
Animation
A toast slides in horizontally from its side of the screen, and slides back out when it closes: a terminal has more columns than rows, so a sideways move looks smoother than a vertical one. It stays on screen until its closing animation ends. Replace either animation with your own @keyframes, declared in your component:
@keyframes fade-in {
from {
opacity: 0;
}
}
@keyframes fade-out {
to {
opacity: 0;
}
}
toast::part(toast) {
animation: fade-in 200ms;
}
toast::part(closing) {
animation: fade-out 200ms forwards;
}Write the closing rule after the toast one: the closing box is both parts. toast::part(toast) { animation: none; } turns both animations off, and a toast with no closing animation, or an infinite one, hides at once.
Several toasts open at once in the same corner overlap. To stack them, give each a different placement, or render them from a <for> inside a fixed container of your own and set toast::part(toast) { position: static; }.
<tree-item>
- Classification: Interactive Tree Node (
rtxui::tree_item) - Focus: Its row is focusable.
One node of a tree: a row showing label, and the <tree-item>s nested inside it, shown indented below while it is open. A node with no <tree-item> (or other element) inside is a leaf.
<tree-item label="src" open="{src_open}">
<tree-item label="main.cpp" onclick="Open(main.cpp)"/>
<tree-item label="ui">
<tree-item label="app.cpp" onclick="Open(ui/app.cpp)"/>
</tree-item>
</tree-item>Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
label | string | "" | One-way | Text of the row. |
open | boolean | false | Two-way | Whether the children show. Ignored on a leaf. |
onclick | callback | — | — | Runs when the row is clicked or activated with Enter. A branch without one toggles instead. |
Interaction
- Clicking the arrow toggles a branch. Clicking the row, or pressing Enter on it, runs its
onclick; a branch without one toggles. - Right opens and Left closes the focused branch; with nothing to open or close, the arrows move focus as usual.
Parts
row, arrow (▸, ▾, or blank for a leaf), label, children.
<tooltip>
- Classification: Hover Overlay (
rtxui::tooltip) - Layer: Top-layer popup (
z-index: 1000)
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
content | string | "" | One-way | Text rendered inside the floating popup. |
placement | string | "top" | One-way | Positioning anchor: "top", "bottom", "left", "right", "top-start", "top-end", "bottom-start", "bottom-end". |
6. Typography & Formatting Elements
| Tag | Classification | Default Style | Semantic Invariant |
|---|---|---|---|
<h1>, <h2>, <h3>, <h4>, <h5>, <h6> | Block | display: block; font-weight: bold; | Hierarchical headings with stepped margins and sizes. |
<p> | Block | display: block; margin: 1 0; | Paragraph block with vertical separation. |
<a> | Inline | color: rgb(59, 130, 246); text-decoration: underline; | Hyperlink. href="#id" scrolls the element with that id into view, when clicked or when focused and activated with Enter. With an href, it is in the Tab order, as in a browser. An href that is a URL with a scheme (https://…, mailto:…, file://…) makes the text a terminal hyperlink (OSC 8): kitty, WezTerm, iTerm2, foot, GNOME Terminal and Windows Terminal open it the way each does for links (usually Ctrl- or Cmd-click, plus Shift in some while the app reads the mouse), and other terminals show the text as usual (example). |
<b>, <strong> | Inline | font-weight: bold; | Emphasized text with bold weight attribute. |
<i>, <em> | Inline | font-style: italic; | Slanted text with italic terminal attribute. |
<u> | Inline | text-decoration: underline; | Underlined text. |
<s>, <strike>, <del> | Inline | text-decoration: line-through; | Strikethrough text. |
<code> | Inline | background-color: rgb(40, 40, 40); | Monospaced inline code snippet. |
<kbd> | Inline | display: inline; font-weight: bold; | Keyboard shortcut token. |
<pre> | Block | white-space: pre; | Preformatted text preserving line breaks and spaces. |
<blockquote> | Block | display: block; padding-left: 2; border-left: solid; | Indented quotation block with left accent line. |
<hr /> | Block | height: 1; border-top: solid; | Full-width horizontal divider line. |
<br /> | Inline | — | Forces hard line break in inline flow algorithms. |
<markdown>
- Classification: Block Component (
rtxui::markdown)
Attributes
| Attribute | Type | Default | Reactive | Description |
|---|---|---|---|---|
content | string | "" | Two-way | Raw Markdown text to parse and render. |
stylesheet | string | "" | One-way | Custom CSS applied to the rendered DOM tree. |
7. Lists (<ul>, <ol>, <li>)
Unordered Lists (<ul>)
Unordered lists render alternating glyph markers based on structural nesting depth:
- Level 1: Disc (
•) - Level 2: Circle (
○) - Level 3+: Square (
■)
Ordered Lists (<ol>)
Ordered lists format numbered decimal prefixes (1. , 2. ):
start(integer, default1): Initial counter value.reversed(boolean, defaultfalse): Counts down rather than up.
List Items (<li>)
value(integer): Explicit sequence override within ordered lists.
8. Template Control Flow
<if>, <elif>, <else>
Conditional evaluation nodes. Direct children of <if> branches are mounted or unmounted dynamically:
<if condition="{has_error}">
<span class="error">{error_message}</span>
</if>
<elif condition="{is_loading}">
<span>Loading...</span>
</elif>
<else>
<span>Ready.</span>
</else><for>
Repeats template structures across bound collections. Syntax: <for each="{collection}" as="item">. The loop index is available as {$index} (zero-based).
each: Bound collection expression.as: Variable alias for collection element.key: (Optional) Unique identifier field on struct item. Preserves element state and cursor position across sort and filter operations.virtual: (Optional) Inside a scroll container, renders only the items around what it shows. See Long lists.item-height: (Optional, withvirtual) Rows each item takes;1by default.
<slot> and <template> (Content Projection)
Enables reusable components to project child content passed by their caller:
- Default Slot:
<slot></slot>inside a component definition renders all unassigned child elements. - Named Slots:
<slot name="header"></slot>defines a named projection target. - Content Injection: Callers project an element into a named slot with
slot="header"on it, or several nodes at once with<template slot="header">. Content naming the same slot fills it in document order. - Fallback Content: Markup placed inside
<slot>Fallback</slot>is rendered if the caller provides no projecting children.
<!-- Component Definition (e.g. Card) -->
<div class="card">
<div class="card-header"><slot name="header">Default Header</slot></div>
<div class="card-body"><slot></slot></div>
</div>
<!-- Caller Usage -->
<Card>
<span slot="header">Custom Title</span>
<p>Body projected into default slot.</p>
</Card>
