Avatar
Represent people with initials, status and grouped avatars.
use blinc_cn as cn;
use blinc_layout::prelude::*;
pub fn avatar_demo() -> Div {
div()
.class("demo-stack")
.class("demo-stack--center")
.child(cn::avatar().fallback("AL").online().size(cn::AvatarSize::Large))
.child(
cn::avatar_group()
.max(3)
.child(cn::avatar().fallback("AL"))
.child(cn::avatar().fallback("JD"))
.child(cn::avatar().fallback("MK"))
.child(cn::avatar().fallback("RS")),
)
}
@layer components {
.cn-avatar {
font-family: var(--font-sans);
}
.cn-avatar {
background: var(--cn-avatar-bg, var(--surface));
color: var(--cn-avatar-fg, var(--text-primary));
border-radius: var(--radius-full);
overflow: hidden;
}
.cn-avatar-placeholder {
color: var(--text-tertiary);
}
.cn-avatar-status[data-status="online"] {
background: var(--success);
}
.cn-avatar-status[data-status="offline"] {
background: var(--text-tertiary);
}
.cn-avatar-status[data-status="away"] {
background: var(--warning);
}
.cn-avatar-status[data-status="busy"] {
background: var(--error);
}
.cn-avatar-group .cn-avatar {
border-color: var(--border-secondary);
}
.cn-avatar-group__more {
background: var(--surface-elevated);
border-color: var(--border-secondary);
color: var(--text-tertiary);
}
.cn-avatar--square {
border-radius: var(--radius-default);
}
}
Usage and properties
Represent people with initials, status and grouped avatars. 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 |
|---|---|---|---|
fallback | string | Construction | Initials |
size | AvatarSize | Construction | See the compiled example |
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-avatar.cn-avatar-placeholder.cn-avatar--square.cn-avatar-status.cn-avatar-group.cn-avatar-group__more
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.
An image can fall back to initials:
avatar().src("user.jpg").alt("Jane Doe").fallback("JD")
Sizes are ExtraSmall (24px), Small (32px), Medium (40px, the default),
Large (48px) and ExtraLarge (64px):
div().flex_row().gap(2.0)
.child(avatar().fallback("JD").size(AvatarSize::Small))
.child(avatar().fallback("AL").size(AvatarSize::Large))
.online(), .offline(), .away() and .busy() add a status dot:
avatar().fallback("JD").online()
The root is .cn-avatar; its fill and initials use --cn-avatar-bg and
--cn-avatar-fg. An empty avatar shows .cn-avatar-placeholder. The status
dot is .cn-avatar-status with data-status.
Avatar Group
avatar_group()
.max(3)
.child(avatar().fallback("JD"))
.child(avatar().fallback("AL"))
.child(avatar().fallback("MK"))
.child(avatar().fallback("RS"))
.child(avatar().fallback("TW"))
This shows three avatars and a +2 chip. The group is .cn-avatar-group;
the overflow chip is .cn-avatar-group__more. Their rings and fills are CSS.
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.