Waveform
Display audio amplitude and played progress with theme-aware colours.
use blinc_layout::prelude::*;
pub fn waveform_demo() -> Div {
let samples: Vec<f32> = serde_json::from_str(include_str!("../../assets/night-drive-waveform.json")).unwrap();
div()
.class("demo-wide")
.child(
blinc_layout::widgets::media::waveform(std::sync::Arc::new(samples))
.progress(0.42)
.w_full()
.h(112.0)
.into_div(),
)
.child(text("Amplitude · played and remaining").class("demo-caption"))
}
Usage and properties
Enable the blinc_layout media feature for audio, video and waveform widgets.
Use the installation guide to create a Blinc application. This widget is available from blinc_layout; the demo uses the same Hybrid theme as the component library. 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 |
|---|---|---|---|
buckets | Arc<Vec<f32>> | Construction | 120 peak amplitudes from Night Drive |
progress | f32 | Construction | 0.42 |
Keyboard and interaction
This preview displays content without a keyboard action.
Customizing it
Add application CSS after the default component layer. These selectors are the restyling surface for this component:
.blinc-waveform
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.
Standalone amplitude visualization:
use blinc::layout::widgets::media::waveform;
waveform(buckets)
.progress(0.5)
.played_color(Color::BLUE)
.unplayed_color(Color::GRAY)
.w_full().h(60.0)
.into_div()
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.