Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Motion

Pick a Job. Hold a Run. Pass progress into the constructor. The application owns the clock. Tokens::with_reduced_motion(true) collapses every duration to 0 ms so progress snaps to the target.

JobWhen to use itConstructor
EnterDialog, menu, sheet, toast, tooltipoverlay
Switch(FadeThrough)Tab body, settings group, unrelated destinationsswitch
Switch(SharedAxis)Next/previous peers (timeline, wizard, list to detail)switch
Disclose(Block)Expander, accordion, tree branchexpand
Disclose(Inline)Drawer, folder railexpand
Attention(Shake)Invalid field after a failed checkattention
Attention(Pulse)Live or recording markattention
ValueDeterminate progress or ringvalue_animation

Enter decelerates in; exit is shorter and accelerates. Run::lasting holds a custom enter length and keeps that exit ratio (the gallery duration slider does this). Shared axis travels 12 dp: incoming uses progress on that slide, leaving uses 1 - progress on the opposite slide. Fade through finishes the leaving fade before the incoming fade starts.

Drive a constructor

use icedtea::motion::{self, Enter, Job, Slide};

let mut run = motion::run(Job::Enter(Enter::Dialog), false, tok.reduced_motion);
run.go(true, iced::time::Instant::now());
let t = run.progress(iced::time::Instant::now());
let paint = tok.fade(t);
let sheet = motion::overlay(body, t, Slide::End, tok, a11y);

Build overlay and switch children with Tokens::fade. For switch, use SwitchFace::incoming_fade / outgoing_fade.

dialog_sheet, side_sheet, command_palette_view, context_menu, cascade_menu, drawer, expander, accordion_view, and tree_view take that same 0–1 progress (tree_view as animating: Option<(id, progress)>).

Mix several jobs

Each surface has its own Run. A sheet, an expander, and a progress value can run together. The subscription fires while any of them reports is_live (or while toasts still have TTL).

bounce_out is a curve for a hop that is not a named job. Sample it like Ease.

See Material Design 3 for the token names. Constructors are listed under Chrome. Progress is under Readout.