Struct SemanticsRegion 

pub struct SemanticsRegion {
    pub id: Option<NodeId>,
    pub identifier: Option<String>,
    pub label: Option<String>,
    pub role: Role,
    pub actions: ActionSet,
    pub child: Option<Box<Node>>,
}

Wraps a subtree in an explicit semantics node.

Use SemanticsRegion when a shell or renderer needs a stable semantic target around an otherwise normal widget subtree. For example, the server shell uses semantic regions as mount points for focused browser islands.

Fields

id: Option<NodeId>

Explicit node identity for the region.

identifier: Option<String>

Stable semantic identifier exposed to renderers and shell adapters.

label: Option<String>

Optional accessible label for the region.

role: Role

Semantic role. Defaults to a generic region.

actions: ActionSet

Actions attached to the semantic region.

child: Option<Box<Node>>

Wrapped child subtree.

Implementations

impl SemanticsRegion

pub fn new(child: Node) -> Self

Creates a semantic wrapper around an existing child node.

Use builder methods to add a stable identifier, accessible label, role, or action metadata before converting the region back into a Node.

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

Sets an explicit node id for the region.

This is useful when generated browser artifacts need to send actions back to a known mount point. Prefer leaving it unset unless the shell or renderer requires a stable id.

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

Sets the semantic identifier exposed to shells and HTML renderers.

Identifiers are intended to be stable within a route. They are used by tests, accessibility bridges, and progressive enhancement code to find the right semantic region without depending on generated DOM structure.

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

Sets the accessible label for the semantic region.

Use this when the wrapped child does not already expose enough text for assistive technologies to describe the region or control clearly.

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

Sets the semantic role of the region.

Choose the role that matches the user-visible behavior of the wrapped child. For example, a styled region that behaves like a button should use Role::Button and expose a default action.

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

Attaches the action that should run when the region is activated.

This is the semantic equivalent of a button press. It lets renderers expose activation consistently across mouse, keyboard, accessibility, and browser-island event paths.

pub fn into_node(self) -> Node

Converts the semantic region into a normal widget tree node.

Trait Implementations

impl Clone for SemanticsRegion

fn clone(&self) -> SemanticsRegion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticsRegion

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

Formats the value using the given formatter.

impl Default for SemanticsRegion

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SemanticsRegion

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<SemanticsRegion> for Node

fn from(w: SemanticsRegion) -> Self

Converts to this type from the input type.

impl Lower for SemanticsRegion

fn lower(&self, cx: &mut LoweringContext<'_>) -> NodeId

Lower this widget into the IR, returning the root node id.

impl Serialize for SemanticsRegion

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

where __S: Serializer,

Serialize this value into the given Serde serializer.