Gestures
Recognise taps, long presses and directional swipes.
use blinc_core::reactive::{Signal, computed};
use blinc_layout::{binding::IntoReactive, prelude::*};
pub fn gestures_demo(choice: Signal<String>) -> Div {
use blinc_layout::widgets::gesture::GestureExt;
let message = choice;
div()
.class("demo-stack")
.child(
div()
.class("demo-gesture")
.id("demo-action")
.child(text("Tap, hold or swipe"))
.on_tap(move |_| message.set("Tapped".into()))
.on_long_press(move |_| message.set("Long press".into()))
.on_swipe(move |direction, _| message.set(format!("Swiped {direction:?}"))),
)
.child(
bound_text(computed(move |g| {
let message = g.get(message).unwrap_or_default();
if message == "rust" {
"Try an interaction".into()
} else {
message
}
}))
.class("demo-caption"),
)
}
fn bound_text(value: impl IntoReactive<String>) -> Text {
Text::bound(value.into_reactive())
}
Usage and properties
Recognise taps, long presses and directional swipes. This built-in widget is provided by blinc_layout; the polished action controls in the example use blinc_cn.
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 |
|---|---|---|---|
on_tap / on_long_press / on_swipe | Gesture handlers | Callback | Update a Signal<String> message |
Keyboard and interaction
Tap, hold or swipe the surface. These gestures use pointer input; provide a labelled keyboard action when an essential operation depends on a gesture.
Customizing it
Add application CSS after the default component layer. These selectors are the restyling surface for this component:
.demo-gesture
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.
GestureExt adds tap, long-press and directional swipe recognition to a Div.
use blinc::layout::prelude::*;
use blinc::layout::widgets::gesture::GestureExt;
use blinc::core::reactive::signal;
let message = signal(String::new());
let surface = div().class("gesture-surface")
.child(text("Tap, hold or swipe"))
.on_tap(move |_| message.set("Tapped".into()))
.on_long_press(move |_| message.set("Long press".into()))
.on_swipe(move |direction, _| message.set(format!("Swiped {direction:?}")));
Gesture callbacks update bindings; use computed for derived labels and effect for external side effects. Each surface owns its recognizer. Gestures are pointer interactions; provide a labelled keyboard action when a gesture performs an essential operation.
The recognizer adds no visual style or public CSS class. Give its surface an application class and use theme variables:
.gesture-surface {
padding: var(--space-6);
background: var(--surface-elevated);
color: var(--text-primary);
border: 1px solid var(--border);
border-radius: var(--radius-lg);
}
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.