Struct Pressable 

pub struct Pressable {

    pub id: Option<WidgetId>,
    pub child: Widget,
    pub on_press: Option<ActionEnvelope>,
    pub label: Option<String>,
    pub semantics_identifier: Option<String>,
    pub hyperlink: Option<Hyperlink>,
    pub popover_target: Option<PopoverTarget>,
    pub role: PressableRole,
    pub focus_policy: FocusPolicy,
    pub disabled: bool,
    pub layout: BoxStyle,
    pub flex_grow: f32,
    pub flex_shrink: f32,
    pub style: PressableStyle,
    pub hover_style: Option<PressableStyle>,
    pub pressed_style: Option<PressableStyle>,
    pub focused_style: Option<PressableStyle>,
    pub disabled_style: Option<PressableStyle>,
    pub transition: Option<MotionTransition>,
    pub ripple: Option<RippleFx>,
}

A visually neutral accessible interaction surface.

Pressable contributes no visual chrome or geometry unless explicitly supplied through PressableStyle or BoxStyle. It still provides semantic activation, focus handling, keyboard activation, pointer state, optional transitions, and optional ripple feedback.

Example

Pressable::new(Text::new("Open report"))
    .id(WidgetId::explicit("report.open"))
    .semantics_identifier("report.open")
    .label("Open report")
    .role(PressableRole::Button)
    .on_press(open_report)
    .layout(BoxStyle::default().padding_symmetric(
        Length::points(tokens.spacing.m),
        Length::points(tokens.spacing.s),
    ))
    .into()

Fields

id: Option<WidgetId>

Optional stable identity used for interaction state, focus, and motion.

child: Widget

Child content rendered inside the interaction surface.

on_press: Option<ActionEnvelope>

Action dispatched when the pressable is activated.

label: Option<String>

Accessible label exposed to assistive technologies.

semantics_identifier: Option<String>

Stable semantic identifier used by tests and accessibility tooling.

hyperlink: Option<Hyperlink>

Optional genuine navigation destination.

popover_target: Option<PopoverTarget>

Optional standards-based HTML popover invocation.

role: PressableRole

Accessibility role exposed by the semantic node.

focus_policy: FocusPolicy

How pointer activation should affect keyboard focus.

disabled: bool

Whether the pressable can receive focus or activation.

layout: BoxStyle

Typed layout box model for size, margin, padding, and placement.

flex_grow: f32

Legacy point-based flex grow factor.

flex_shrink: f32

Legacy point-based flex shrink factor.

style: PressableStyle

Base visual state.

hover_style: Option<PressableStyle>

Style overlay while hovered.

pressed_style: Option<PressableStyle>

Style overlay while actively pressed.

focused_style: Option<PressableStyle>

Style overlay while focused.

disabled_style: Option<PressableStyle>

Style overlay while disabled.

transition: Option<MotionTransition>

Optional transition for state-style changes.

ripple: Option<RippleFx>

Optional ripple feedback.

Implementations

impl Pressable

pub fn new(child: impl Into<Widget>) -> Self

Creates a neutral pressable around child.

pub fn id(self, id: WidgetId) -> Self

Uses an explicit stable identity for interaction, focus, and motion.

pub fn on_press(self, action: ActionEnvelope) -> Self

Dispatches action for pointer, keyboard, or accessibility activation.

pub fn disabled(self, disabled: bool) -> Self

Enables or disables activation and focus participation.

pub fn layout(self, style: BoxStyle) -> Self

Applies the shared typed box model without introducing visual defaults.

pub fn focus_policy(self, policy: FocusPolicy) -> Self

Selects how pointer activation affects keyboard focus.

pub fn style(self, style: PressableStyle) -> Self

Sets the base visual style.

pub fn hover(self, style: PressableStyle) -> Self

Sets the style overlay while the pointer is over the pressable.

pub fn pressed(self, style: PressableStyle) -> Self

Sets the style overlay while the pressable is active.

pub fn focused(self, style: PressableStyle) -> Self

Sets the style overlay while the pressable owns keyboard focus.

pub fn disabled_style(self, style: PressableStyle) -> Self

Sets the style overlay while activation is disabled.

pub fn transition(self, transition: MotionTransition) -> Self

Animates supported properties between interaction states.

pub fn ripple(self, ripple: RippleFx) -> Self

Enables optional ripple feedback.

pub fn semantics_identifier(self, identifier: impl Into<String>) -> Self

Sets a stable semantic identifier for tests and accessibility tools.

pub fn label(self, label: impl Into<String>) -> Self

Sets the accessible label.

pub fn role(self, role: PressableRole) -> Self

Sets button, link, or menu-item semantics.

pub fn href(self, href: impl Into<String>) -> Self

Makes this pressable a genuine hyperlink.

pub fn hyperlink(self, hyperlink: Hyperlink) -> Self

pub fn popover_target( self, id: impl Into<String>, action: PopoverAction, ) -> Self

Trait Implementations

impl Clone for Pressable

fn clone(&self) -> Pressable

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Pressable

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Pressable

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Pressable

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Pressable> for Widget

fn from(pressable: Pressable) -> Self

Converts to this type from the input type.

impl Serialize for Pressable

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.