Struct ReorderGroup 

pub struct ReorderGroup<K>(/* private fields */);

Retain in the view. Owns order, stable-key geometry and pointer gesture lifetime. Supports one-dimensional lists, variable item sizes, keyboard Alt+Arrow reorder, Escape/deactivation cancellation, and release outside item bounds. Supply native roles/labels/click handlers on each card. Host owns persistence, removal focus restoration and scrolling/autoscroll policy; multi-column sorting is not implied.

Implementations

impl<K: Clone + Eq + Hash + 'static> ReorderGroup<K>

pub fn new(order: Vec<K>, axis: Axis) -> Result<Self, AnimationError>

Creates a group, rejecting duplicate keys transactionally.

use gpui_kit::{div, prelude::*};
use gpui_motion_kit::{Axis, ReorderGroup};
let group = ReorderGroup::new(vec![1usize, 2, 3], Axis::Y)?; // persistent view field
let mut list = div().flex().flex_col();
for &key in group.order().iter() {
    list = list.child(group.item(("row", key), key, div().id(("card", key)).child(key.to_string())));
}

pub fn order(&self) -> Ref<'_, [K]>

Current logical order. Drop this borrow before processing input or updating.

pub fn on_change( self, callback: impl Fn(&[K], &mut Window, &mut App) + 'static, ) -> Self

Registers a callback after pointer commit or keyboard reorder. The callback runs without borrowing group state and may update application entities.

pub fn set_order(&self, order: Vec<K>) -> Result<(), AnimationError>

Updates membership/order and cancels an active gesture. Duplicate keys fail without mutation. Invoke on model changes, not every render. Notify the view.

pub fn item<E: IntoElement + StatefulInteractiveElement + 'static>( &self, id: impl Into<ElementId>, key: K, child: E, ) -> ReorderElement<K, E>

Wraps a styled item in measured position interpolation and native handlers. The key must belong to this group. Preserve the same Kit ID through reorder.

pub fn is_dragging(&self) -> bool

Whether a pointer currently owns a reorder gesture.

Trait Implementations

impl<K: Clone> Clone for ReorderGroup<K>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.