Navigation Menu
Mix direct navigation and grouped resource links.

use blinc_cn as cn;
use blinc_core::reactive::{Signal, computed};
use blinc_layout::{binding::IntoReactive, prelude::*};
pub fn navigation_menu_demo(choice: Signal<String>) -> Div {
div()
.class("demo-wide")
.child(
cn::navigation_menu()
.item("Overview", move || choice.set("overview".into()))
.trigger("Resources", move || {
div()
.class("demo-popover-form")
.child(
cn::navigation_link("Documentation")
.description("Build your first interface")
.on_click(move || choice.set("documentation".into())),
)
.child(
cn::navigation_link("Examples")
.description("Explore what is possible")
.on_click(move || choice.set("examples".into())),
)
}),
)
.child(
bound_text(computed(move |g| {
format!(
"Page: {}",
g.get(choice)
.filter(|v| v != "rust")
.unwrap_or_else(|| "Website".into())
)
}))
.class("demo-caption"),
)
}
fn bound_text(value: impl IntoReactive<String>) -> Text {
Text::bound(value.into_reactive())
}
@layer components {
.cn-nav-menu,
.cn-nav-link {
font-family: var(--font-sans);
}
.cn-nav-link:focus-visible {
outline: 2px solid var(--focus-ring);
outline-offset: 2px;
}
.cn-nav-menu {
gap: var(--space-1);
}
.cn-nav-link {
padding: var(--space-2) var(--space-3);
cursor: pointer;
color: var(--text-secondary);
}
.cn-nav-link:hover {
background: var(--surface-elevated);
color: var(--text-primary);
}
.cn-nav-link--active {
background: var(--surface-elevated) !important;
color: var(--text-primary) !important;
}
.cn-nav-menu-content .cn-nav-link:hover {
background: var(--accent-subtle);
}
.cn-nav-menu-content .cn-nav-link {
color: var(--text-primary);
}
.cn-nav-link-description {
color: var(--text-secondary);
}
.cn-nav-menu-content {
background: var(--surface-elevated);
border: 1px solid var(--border);
border-radius: var(--radius-md);
color: var(--text-primary);
box-shadow: var(--shadow-md);
animation: cn-nav-menu-enter var(--duration-fast) var(--ease-state);
transform-origin: top center;
}
@keyframes cn-nav-menu-enter {
from {
opacity: 0;
transform: scale(0.98) translateY(-4px);
}
to {
opacity: 1;
transform: scale(1) translateY(0);
}
}
}
Usage and properties
Mix direct navigation and grouped resource links. 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 |
|---|---|---|---|
item / trigger | navigation builders | Construction | Overview and resource links |
Keyboard and interaction
Use the control’s documented keyboard commands; Tab reaches enabled controls and :focus-visible marks keyboard focus.
Customizing it
Add application CSS after the default component layer. These selectors are the restyling surface for this component:
.cn-nav-menu.cn-nav-link.cn-nav-menu-content.cn-nav-link-description.cn-nav-link--active
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.
Use .trigger(..) for a popup panel and .item(..) for a direct action:
let page = ctx.use_signal("home".to_string());
navigation_menu()
.trigger("Products", move || {
div().flex_col().gap(2.0)
.child(navigation_link("Analytics")
.description("Usage and performance")
.on_click(move || page.set("analytics".to_string())))
.child(navigation_link("Reports")
.on_click(move || page.set("reports".to_string())))
})
.item("Pricing", move || page.set("pricing".to_string()))
.item("About", move || page.set("about".to_string()))
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.