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

List and detail

A sidebar list beside a filling detail pane. The application owns which row is selected. The clip owns the list offset. on_scroll reports start..end for the next view. Jump with scroll_to on scroll_id. Selecting a row outside the viewport moves the clip. Change scroll_id when the row set is a different list. A focused list moves the primary row with arrows, Page, Home, and End.

#![allow(unused)]
fn main() {
use icedtea::a11y::{A11y, Role};
use icedtea::collection::{ItemClick, Selection, VecList, VisibleWindow};
use icedtea::i18n::Direction;
use icedtea::pattern;
use icedtea::theme;
use icedtea::widget;
use icedtea::{Element, Task};

struct App {
    list: VecList,
    sel: Selection,
    window: VisibleWindow,
}

#[derive(Clone)]
enum Message {
    Select(ItemClick),
    Scroll(VisibleWindow),
    Check(usize),
}

impl App {
    fn update(&mut self, message: Message) -> Task<Message> {
        match message {
            Message::Select(click) => self.sel.apply_item_click(click),
            Message::Scroll(w) => self.window = w,
            Message::Check(_) => {}
        }
        Task::none()
    }

    fn view(&self) -> Element<'_, Message> {
        let tok = theme::named("dark").tokens;
        let side = widget::list_view(
            &self.list,
            &self.sel,
            Message::Select,
            tok,
            widget::ListOpts {
                window: self.window,
                row_h: 32.0,
                overscan: 2,
                on_scroll: Message::Scroll,
                empty: "No rows",
                meta_color: |_| tok.muted,
                scroll_id: None,
                face: icedtea::collection::RowFace::FLUSH,
                on_check: Message::Check,
            },
            A11y::new("files", Role::List),
        );
        let title = self
            .sel
            .primary()
            .and_then(|i| self.list.items.get(i).map(|r| r.title.clone()))
            .unwrap_or_else(|| "Nothing selected".into());
        let detail = widget::label(title, tok, A11y::new("detail", Role::Status));
        pattern::list_detail(
            side,
            detail,
            icedtea::layout::fixed(icedtea::layout::LIST_PANE),
            tok,
        )
    }
}
}

layout::LIST_PANE (360px) sizes the sidebar so a two-line mail title fits beside a checkbox. The detail child fills. Selection stays on indices. Pass RowHeights::PerRow when rows are not one height. RowFace::Card wraps the title on a surface; Flush wraps when the row is tall enough for two lines, otherwise one clipped line.