Documentation pass: every claim in docs/ and the meta files was audited against the source and the drift fixed — around ninety corrections. CONTRIBUTING and the CI workflow now run cargo test with --features test-support (the gated test_support module made both the documented commands and the CI build fail to compile), make example becomes make examples, make doctest-md and the debhelper requirement of make clean are documented, and patch shape asks for a CHANGELOG entry. theming.md loses the nonexistent surface.backdrop, gains the real gradient defaults (linear-rgb, oklab), the six slot variants including typography, the ten-field palette, a truthful effects-consumer table, the ThemePreference/from_hour API and a responsive-sizing note; the stale docstrings in src/theme that fed the drift are fixed too. architecture.md's "Known gaps" section is rewritten against reality (multi-touch slots, xdg-activation, a11y live regions and SetValue/Increment/Decrement are implemented), gains a module map, subsurfaces and window-lifecycle coverage, and correct crustace/loginmanager paths. widgets.md fixes the ten factual errors (stateless spinner, toast/combo via overlays(), tooltip hover contract, row has no max_width, scroll axes, multiline text_edit, dialog panic wording) and now states the column() 16 px default padding — the recurring ambush — plus row's differing 0 default and dialog's max_width. onboarding, README and cookbook get the remaining sweep: build/test instructions, complete example lists, img_widget, clipping-parity honesty, ~30 Hz software cap, read_rgba_pixels signature, tab indentation in snippets, and rustdoc-style links that rendered literally are gone everywhere. CHANGELOG is restructured per Keep a Changelog with the missing entries (window_resizable, claims_raw_touch, Row::align_top/fill_height, caret fixes, dependency pins) and the pad_v Added/Changed contradiction resolved. New adaptive-layout API: ltk::orientation() with the Orientation enum, backed by viewport_size()/set_viewport_size — the runtime records the main surface's physical dimensions on every configure, before App::on_resize, so view() can branch a layout on portrait vs landscape without hand-tracking resizes. The portrait rule matches Length::orient (square counts as portrait); embedders driving core::UiSurface call set_viewport_size themselves. Documented in the crate root's responsive-design section and architecture.md. Fluid-vs-fixed sizing fixes in widgets, all the same disease — fluid content inside a fixed-pixel box. TextEdit::fixed_width takes impl Into<Length> (f32 call sites keep compiling as px) and the time picker's digit fields move to Length::fluid( 72.0 ), matching their fluid font so digits can no longer outgrow the box. Dialog::max_width takes impl Into<Length> with a Length::fluid( 480.0 ) default so the card scales with the stock buttons inside it, and the card's interior no longer stacks the column() default 16 px padding on top of CARD_PADDING — that double inset squeezed the action row until its buttons clipped on narrow windows. App::on_pointer_axis now triggers a view rebuild and repaint; previously state mutated in the hook did not paint until the next unrelated event. Examples reworked to be honest demos: responsive's mode/density controls become stock buttons in a grid/column so they follow the modes they demonstrate instead of overflowing; dialog's openers stack vertically, and the example gains the app-level ESC handler so the ESC chain closes an open dialog first and quits second; widgets' tab strip now switches real per-tab pages; carousel gains pointer/touch drag through the horizontal-swipe hooks (crustace's pager pattern), one-tile-per-detent mouse wheel, and snap math driven by the real surface width from on_resize instead of a hardcoded 800; clip_path arranges its cells by ltk::orientation() and sizes them from the counter-axis of the flow.
229 lines
6.4 KiB
Rust
229 lines
6.4 KiB
Rust
use std::time::Instant;
|
|
|
|
use ltk::{
|
|
App, Element, Keysym, WidgetId,
|
|
column, row, text, text_edit, spacer, separator, slider,
|
|
toggle, checkbox, radio, progress_bar, scroll,
|
|
spinner, tabs,
|
|
};
|
|
|
|
#[derive( Clone )]
|
|
enum Msg
|
|
{
|
|
ToggleWifi,
|
|
ToggleBluetooth,
|
|
ToggleDarkMode,
|
|
CheckNotifications,
|
|
CheckUpdates,
|
|
SelectThemeLight,
|
|
SelectThemeDark,
|
|
SelectThemeAuto,
|
|
SliderChanged( f32 ),
|
|
SelectTab( usize ),
|
|
NoteChanged( String ),
|
|
Tick,
|
|
}
|
|
|
|
struct WidgetsApp
|
|
{
|
|
wifi: bool,
|
|
bluetooth: bool,
|
|
dark_mode: bool,
|
|
notifications: bool,
|
|
updates: bool,
|
|
theme: usize,
|
|
progress: f32,
|
|
volume: f32,
|
|
tab: usize,
|
|
note: String,
|
|
started_at: Instant,
|
|
}
|
|
|
|
impl WidgetsApp
|
|
{
|
|
fn new() -> Self
|
|
{
|
|
Self
|
|
{
|
|
wifi: true,
|
|
bluetooth: false,
|
|
dark_mode: true,
|
|
notifications: true,
|
|
updates: false,
|
|
theme: 2,
|
|
progress: 0.65,
|
|
volume: 0.7,
|
|
tab: 0,
|
|
note: String::new(),
|
|
started_at: Instant::now(),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl App for WidgetsApp
|
|
{
|
|
type Message = Msg;
|
|
|
|
fn view( &self ) -> Element<Msg>
|
|
{
|
|
// Pull text colours from the active theme so the example
|
|
// reads correctly under both light and dark mode without
|
|
// touching the example code.
|
|
let palette = ltk::theme_palette();
|
|
let primary = palette.text_primary;
|
|
let secondary = palette.text_secondary;
|
|
|
|
let title = text( "ltk widgets" ).size( 24.0 ).color( primary ).align_center();
|
|
|
|
// Segmented tab strip — each tab shows its own page below.
|
|
let tabs_strip: Element<Msg> = tabs( [ "General", "Audio", "Network" ] )
|
|
.selected( self.tab )
|
|
.on_select( Msg::SelectTab )
|
|
.into();
|
|
|
|
let toggles = column::<Msg>()
|
|
.spacing( 0.0 )
|
|
.push( text( "Toggle" ).size( 13.0 ).color( secondary ) )
|
|
.push( toggle( self.wifi ).label( "Wi-Fi" ).on_toggle( Msg::ToggleWifi ) )
|
|
.push( toggle( self.bluetooth ).label( "Bluetooth" ).on_toggle( Msg::ToggleBluetooth ) )
|
|
.push( toggle( self.dark_mode ).label( "Dark mode" ).on_toggle( Msg::ToggleDarkMode ) );
|
|
|
|
let checkboxes = column::<Msg>()
|
|
.spacing( 0.0 )
|
|
.push( text( "Checkbox" ).size( 13.0 ).color( secondary ) )
|
|
.push( checkbox( self.notifications ).label( "Notifications" ).on_toggle( Msg::CheckNotifications ) )
|
|
.push( checkbox( self.updates ).label( "Auto updates" ).on_toggle( Msg::CheckUpdates ) );
|
|
|
|
let radios = column::<Msg>()
|
|
.spacing( 0.0 )
|
|
.push( text( "Radio" ).size( 13.0 ).color( secondary ) )
|
|
.push( radio( self.theme == 0 ).label( "Light" ).on_select( Msg::SelectThemeLight ) )
|
|
.push( radio( self.theme == 1 ).label( "Dark" ).on_select( Msg::SelectThemeDark ) )
|
|
.push( radio( self.theme == 2 ).label( "Auto" ).on_select( Msg::SelectThemeAuto ) );
|
|
|
|
let vol_label = format!( "Volume: {:.0}%", self.volume * 100.0 );
|
|
let prog_label = format!( "Progress: {:.0}%", self.progress * 100.0 );
|
|
|
|
// Spinner — animation phase derived from the wall clock so the
|
|
// arc rotates at one revolution per second.
|
|
let phase = self.started_at.elapsed().as_secs_f32();
|
|
let spin_row: Element<Msg> = row::<Msg>()
|
|
.spacing( 12.0 )
|
|
.push( spinner().phase( phase ) )
|
|
.push( text( "Loading…" ).size( 14.0 ).color( primary ) )
|
|
.into();
|
|
|
|
// Multiline text area — Enter inserts a newline, Tab leaves it.
|
|
let textarea = text_edit( "Type a note (multi-line)", &self.note )
|
|
.multiline( true )
|
|
.rows( 4 )
|
|
.id( WidgetId( "widgets/note" ) )
|
|
.on_change( Msg::NoteChanged );
|
|
|
|
// One page per tab, so selecting a tab visibly swaps the content.
|
|
let page: Element<Msg> = match self.tab.min( 2 )
|
|
{
|
|
0 => column::<Msg>()
|
|
.padding( 0.0 )
|
|
.spacing( 12.0 )
|
|
.push( toggles )
|
|
.push( separator() )
|
|
.push( checkboxes )
|
|
.push( separator() )
|
|
.push( radios )
|
|
.into(),
|
|
1 => column::<Msg>()
|
|
.padding( 0.0 )
|
|
.spacing( 12.0 )
|
|
.push( text( vol_label ).size( 13.0 ).color( secondary ) )
|
|
.push( slider( self.volume ).on_change( Msg::SliderChanged ) )
|
|
.push( text( prog_label ).size( 13.0 ).color( secondary ) )
|
|
.push( progress_bar( self.progress ) )
|
|
.into(),
|
|
_ => column::<Msg>()
|
|
.padding( 0.0 )
|
|
.spacing( 12.0 )
|
|
.push( text( "Spinner" ).size( 13.0 ).color( secondary ) )
|
|
.push( spin_row )
|
|
.push( separator() )
|
|
.push( text( "Multiline text edit" ).size( 13.0 ).color( secondary ) )
|
|
.push( textarea )
|
|
.into(),
|
|
};
|
|
|
|
let content = column::<Msg>()
|
|
.padding( 32.0 )
|
|
.spacing( 12.0 )
|
|
.push( title )
|
|
.push( tabs_strip )
|
|
.push( separator() )
|
|
.push( page )
|
|
.push( spacer() )
|
|
.push(
|
|
text( "Esc = quit" )
|
|
.size( 12.0 )
|
|
.color( secondary )
|
|
.align_center(),
|
|
);
|
|
|
|
scroll( content ).into()
|
|
}
|
|
|
|
fn update( &mut self, msg: Msg )
|
|
{
|
|
match msg
|
|
{
|
|
Msg::ToggleWifi => self.wifi = !self.wifi,
|
|
Msg::ToggleBluetooth => self.bluetooth = !self.bluetooth,
|
|
Msg::ToggleDarkMode => self.dark_mode = !self.dark_mode,
|
|
Msg::CheckNotifications => self.notifications = !self.notifications,
|
|
Msg::CheckUpdates => self.updates = !self.updates,
|
|
Msg::SelectThemeLight => self.theme = 0,
|
|
Msg::SelectThemeDark => self.theme = 1,
|
|
Msg::SelectThemeAuto => self.theme = 2,
|
|
Msg::SliderChanged( v ) => self.volume = v,
|
|
Msg::SelectTab( i ) => self.tab = i,
|
|
Msg::NoteChanged( s ) => self.note = s,
|
|
Msg::Tick => {}
|
|
}
|
|
}
|
|
|
|
fn on_key( &mut self, keysym: Keysym ) -> Option<Msg>
|
|
{
|
|
if keysym == Keysym::Escape { std::process::exit( 0 ); }
|
|
None
|
|
}
|
|
|
|
// Drive the spinner — the runtime keeps redrawing while this returns
|
|
// `true`, and `view()` reads the wall clock to compute the phase, so
|
|
// no explicit Tick message is even needed for the visual to advance.
|
|
fn is_animating( &self ) -> bool { true }
|
|
|
|
fn poll_interval( &self ) -> Option<std::time::Duration>
|
|
{
|
|
// Suppress the dead-code warning on Msg::Tick; a real app would
|
|
// also use the timer to drive non-visual periodic work here.
|
|
Some( std::time::Duration::from_millis( 250 ) )
|
|
}
|
|
|
|
fn poll_external( &mut self ) -> Vec<Msg>
|
|
{
|
|
// Consumed: the timer above keeps the runtime warm, but the
|
|
// spinner reads the wall clock directly so no Tick is required.
|
|
// We still emit one occasionally so the message variant is
|
|
// exercised — keeps the example honest about the pattern apps
|
|
// usually use for clock work.
|
|
if self.started_at.elapsed().as_millis() % 1_000 < 250
|
|
{
|
|
vec![ Msg::Tick ]
|
|
} else {
|
|
vec![]
|
|
}
|
|
}
|
|
}
|
|
|
|
fn main()
|
|
{
|
|
ltk::run( WidgetsApp::new() );
|
|
}
|