Enum Selector 

pub enum Selector {
    Id {
        widget_id: String,
        window_id: Option<String>,
    },
    Text(String),
    Role(String),
    Label(String),
    Focused,
}

A selector that identifies a widget in the UI tree.

Used by the automation layer to target interactions (click, type_text, etc.) and queries (find, assert). The selector is resolved against the current widget tree to locate the target.

Variants

Id

Match a widget by its ID (local or scoped path).

The widget_id may be a bare local name ("save"), a scoped path ("form/save"), or a window-qualified ID ("main#save"). Bare names and partial scoped paths also match as trailing segments, so "form/save" finds a node with the fully qualified id "main#form/save". When window_id is set, the search is restricted to that window’s subtree.

Fields

widget_id: String

Target widget ID.

window_id: Option<String>

Target window ID.

Text(String)

Match a widget by its visible text content.

Searches the content, label, value, and placeholder props for a matching string.

Role(String)

Match a widget by its accessibility role.

Label(String)

Match a widget by its accessibility label.

Focused

Match the widget that currently has keyboard focus.

Implementations

impl Selector

pub fn id(id: &str) -> Selector

Create an ID selector.

If the ID contains #, the prefix is extracted as the window ID for scoped search.

pub fn id_in_window(id: &str, window_id: &str) -> Selector

Create an ID selector with an explicit window scope.

pub fn text(text: &str) -> Selector

Create a text content selector.

pub fn role(role: &str) -> Selector

Create an accessibility role selector.

pub fn label(label: &str) -> Selector

Create an accessibility label selector.

pub fn focused() -> Selector

Create a focused widget selector.

pub fn from_wire(value: &Value) -> Option<Selector>

Parse a selector from the wire protocol JSON format.

Expected format: {"by": "id"|"text"|"role"|"label"|"focused", "value": "...", "window_id": "..."}

pub fn to_wire(&self) -> Value

Encode this selector to the wire protocol JSON format.

impl Selector

pub fn find<'a>(&self, root: &'a TreeNode) -> Option<&'a TreeNode>

Find the first matching node in the tree.

Returns a reference to the matching TreeNode, or None if no node matches the selector criteria.

pub fn find_all<'a>(&self, root: &'a TreeNode) -> Vec<&'a TreeNode>

Find all matching nodes in the tree.

Returns a Vec of references to every TreeNode that matches.

Trait Implementations

impl Clone for Selector

fn clone(&self) -> Selector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Selector

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

Formats the value using the given formatter.

impl Display for Selector

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

Formats the value using the given formatter.

impl Eq for Selector

impl From<&str> for Selector

Convenience conversion from &str to Selector::Id.

Bare strings are treated as ID selectors. Supports the # syntax for window qualification ("main#save").

fn from(s: &str) -> Selector

Converts to this type from the input type.

impl From<String> for Selector

fn from(s: String) -> Selector

Converts to this type from the input type.

impl PartialEq for Selector

fn eq(&self, other: &Selector) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Selector