Table
Present related values with themed headings, rows and cells.
use blinc_cn as cn;
use blinc_layout::prelude::*;
pub fn table_demo() -> Div {
div().class("demo-wide").child(
cn::table()
.child(
cn::table_header().child(
cn::table_row()
.child(cn::table_head("Project"))
.child(cn::table_head("Status")),
),
)
.child(
cn::table_body()
.child(
cn::table_row()
.child(cn::table_cell().child(text("Website")))
.child(cn::table_cell().child(text("Published"))),
)
.child(
cn::table_row()
.child(cn::table_cell().child(text("Mobile app")))
.child(cn::table_cell().child(text("In review"))),
)
.child(
cn::table_row()
.child(cn::table_cell().child(text("Design system")))
.child(cn::table_cell().child(text("Draft"))),
),
),
)
}
@layer components {
.cn-table {
color: var(--text-primary);
border: 1px solid var(--cn-table-border, var(--border));
border-radius: var(--cn-table-radius, var(--radius-md));
font-size: var(--text-sm);
}
.cn-table-header {
background: var(--surface-overlay);
}
.cn-table-footer {
font-weight: 500;
background: var(--surface-overlay);
border-top: 1px solid var(--cn-table-border, var(--border));
}
.cn-table-row {
border-bottom: 1px solid var(--cn-table-border, var(--border));
transition: background var(--duration-fast) var(--ease-state);
}
.cn-table-body .cn-table-row:last-child {
border-bottom: none;
}
.cn-table-body > .cn-table-row:hover {
background: var(--cn-table-row-hover, color-mix(in srgb, var(--text-primary) 4%, transparent));
}
.cn-table-row[data-state="selected"],
.cn-table-row[data-state="selected"]:hover {
background: var(--cn-table-row-selected, var(--selection)) !important;
}
.cn-table-head {
color: var(--text-secondary);
font-weight: 500;
font-size: var(--text-sm);
}
.cn-table-caption {
color: var(--text-secondary);
font-size: var(--text-sm);
}
}
Usage and properties
Present related values with themed headings, rows and cells. Apply CSS after the component layer to restyle the documented parts.
Use the installation guide to add blinc_cn and its component stylesheet. Create the fixture bindings once, and return the demo from your UI builder. Values marked Bound accept Signal/Computed sources where the API supports them; structural options configure the component at construction.
| Property | Type | Update model | This example |
|---|---|---|---|
header / body / row / cell | table builders | Construction | Project / Status with three rows |
Keyboard and interaction
Informational content; no activation or Tab stop is required.
Customizing it
Add application CSS after the default component layer. These selectors are the restyling surface for this component:
.cn-table.cn-table-header.cn-table-body.cn-table-footer.cn-table-row.cn-table-head.cn-table-cell.cn-table-caption
Theme and component variables: --primary, --text-primary, --text-secondary, --surface, --border, --radius-default, --duration-fast, --ease-state.
Built-in themes
The Live theme control installs Blinc's own theme bundles, including their colours, focus rings, corner shapes and motion tokens.
pub fn theme_bundle_for(name: &str) -> blinc_theme::ThemeBundle {
match name {
"restrained" => blinc_theme::RestrainedTheme::bundle(),
"expressive" => blinc_theme::ExpressiveTheme::bundle(),
_ => blinc_theme::HybridTheme::bundle(),
}
.with_css(blinc_cn::cn_styles::CN_STYLES)
}Download the default widget and component stylesheets. Sample assets and licenses are available in the asset guide.
Documentation
From the canonical component guide.
Rows of cells under a header, with an optional footer and caption:
let chosen = ctx.use_signal(false);
table()
.w_full()
.child(table_header().child(
table_row().child(table_head("Invoice")).child(table_head("Amount")),
))
.child(table_body()
.child(table_row()
.child(table_cell().child(text("INV001")))
.child(table_cell().child(text("$250.00"))))
.child(table_row()
.selected(chosen)
.child(table_cell().child(text("INV002")))
.child(table_cell().child(text("$1,200.00")))))
.child(table_caption("Recent invoices"))
.selected(..) takes a bool, Signal or Computed and follows it in place.
Styling
The look is the .cn-table* rules. .cn-table sets the text colour every
cell inherits, the border and the radius; .cn-table-header and
.cn-table-footer sit on --surface-overlay; .cn-table-head and
.cn-table-caption text is muted. Body rows highlight on hover, and a
selected row carries data-state="selected". The variables
--cn-table-border, --cn-table-radius, --cn-table-row-hover and
--cn-table-row-selected adjust them:
.cn-table-row[data-state="selected"] { background: color-mix(in srgb, var(--primary) 20%, transparent); }
Platforms and version
The component API is available in Blinc 0.6.0. The Live example runs in a dedicated worker and requires a compatible GPU surface. Preview and Code remain available when Live cannot start. The canvas has a descriptive label; a full screen-reader DOM mirror is not provided. The gallery integration is based on revision e2e55c24e078.
Recordings and live demos use the default Hybrid theme with bundled Noto Sans. The recording uses a 560 × 320 logical viewport at twice that resolution. Live follows its container and actual display density. Source base revision · Exact build source · Artifact versions and checksums · Font license.