Forms

Textarea

Write a message with a themed multiline field.

Open ↗
Textarea interaction recorded with the Blinc headless renderer
Hybrid · dark · native recording · 2×

Usage and properties

Write a message with a themed multiline field. 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.

PropertyTypeUpdate modelThis example
documentSharedTextAreaStateShared documentvalues.multiline
rows / placeholderusize / stringConstruction4 / Tell us what you are building…
on_changeFn(&str)CallbackUpdates the character count
disabledbool or IntoReactive<bool>Boundvalues.disabled

Keyboard and interaction

Tab focuses the field and the next Tab leaves it. Typing, arrow keys, selection and clipboard shortcuts apply; Enter inserts a new line. :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-textarea
  • .blinc-ime-composition

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.

Multi-line text input, bound to a SharedTextAreaState:

use blinc::layout::widgets::text_area::text_area_state;

let description = text_area_state();

cn::textarea(&description)
    .label("Description")
    .placeholder("Enter description...")
    .rows(4)
    .on_change(|value| println!("description: {value}"))

.error("msg") shows the message and turns the border red; .disabled(true) dims the field. The message under a field is .cn-field-error, or .cn-field-description for .description(..), coloured by those rules. It is styled like Input: one element with the class cn-textarea, whose border and fill per state are :hover, :focus, [data-invalid] and :disabled rules, eased by a transition. Its placeholder, description and error follow signals as an input's do.

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.