Struct Selection 

pub struct Selection<K: Clone + PartialEq + 'static> { /* private fields */ }

Selection state for keys of type K. Cheap to copy.

Implementations

impl<K: Clone + PartialEq + 'static> Selection<K>

pub fn from_signal(items: Signal<Vec<K>>) -> Self

Wrap an existing item signal without allocating hook state.

This retains the pre-range-selection constructor contract and is safe outside component renders. Range operations derive their anchor from the first selected item; use use_selection_from_signal or Self::from_signals when the anchor must persist independently.

pub fn from_signals(items: Signal<Vec<K>>, anchor: Signal<Option<K>>) -> Self

Wrap existing item and anchor signals.

This is the non-hook constructor for state owned outside the current component. Supplying both signals makes range-anchor lifetime explicit and prevents it from being reset by reconstruction.

pub fn is_selected(&self, key: &K) -> bool

Is key currently selected?

pub fn select_only(&mut self, key: K)

Replace the selection with just key.

pub fn toggle(&mut self, key: K)

Add or remove key (Ctrl/Cmd+click semantics).

pub fn clear(&mut self)

Clear the selection.

pub fn items(&self) -> Vec<K>

Snapshot of the selected keys, in selection order.

pub fn len(&self) -> usize

Number of selected keys.

pub fn is_empty(&self) -> bool

Is nothing selected?

pub fn click(&mut self, key: K, modifiers: Modifiers)

Apply the standard click convention: plain click selects only this key; a click with Ctrl or Cmd held toggles it.

pub fn select_range(&mut self, ordered: &[K], to: &K, additive: bool) -> bool

Select the inclusive range from the current anchor to to in the caller’s stable visual order. Returns false when either endpoint is absent from ordered.

pub fn click_in_order(&mut self, key: K, modifiers: Modifiers, ordered: &[K])

Standard click behavior plus Shift-range selection.

pub fn keyboard_range( &mut self, ordered: &[K], current: usize, step: isize, extend: bool, ) -> Option<usize>

Move a keyboard focus index and optionally extend selection from the anchor. Returns the new index, clamped to the collection.

Trait Implementations

impl<K: Clone + PartialEq + 'static> Clone for Selection<K>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<K: Clone + PartialEq + 'static> Copy for Selection<K>

impl<K: Clone + PartialEq + 'static> PartialEq for Selection<K>

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

Equality operator ==.

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

Inequality operator !=.