Struct BoardModel 

pub struct BoardModel {
    pub id: WidgetId,
    pub columns: Vec<BoardColumn>,
    pub selected_card_id: Option<CardId>,
    pub col_scroll_offset: usize,
}

Top-level model for a [Board] widget.

The host constructs this from its own state each frame and passes it to backend.draw_board(rect, &model).

Examples

use quadraui::{board_layout, BoardCard, BoardColumn, BoardHit, BoardMeasure, BoardModel, WidgetId};

let model = BoardModel {
    id: WidgetId::new("board:issues"),
    columns: vec![BoardColumn {
        id: WidgetId::new("column:backlog"),
        title: "Backlog".to_string(),
        cards: vec![BoardCard {
            id: WidgetId::new("card:1"),
            title: "Fix flaky test".to_string(),
            labels: vec![],
            badges: vec![],
            hint: None,
        }],
        scroll_offset: 0,
    }],
    selected_card_id: None,
    col_scroll_offset: 0,
};

let measure = BoardMeasure::new(20.0, 1.0, 1.0, 3.0, 1.0);
let layout = board_layout(&model, 0.0, 0.0, 80.0, 24.0, measure);

assert_eq!(layout.hit_test(1.0, 2.0), BoardHit::Card(WidgetId::new("card:1")));

Fields

id: WidgetId

Unique identifier for this board widget.

columns: Vec<BoardColumn>

Ordered list of columns rendered left-to-right.

selected_card_id: Option<CardId>

The currently selected card, if any (host-owned).

col_scroll_offset: usize

Horizontal scroll: index of the first visible column. Updated by the host in response to h/l navigation when the board overflows the viewport.

Implementations

impl BoardModel

pub fn move_selection(&mut self, dir: MoveDir)

Handle a keyboard event on the focused board.

Returns a BoardAction if the key is consumed, None if the caller should handle it.

Keybindings (v1 hardcoded, generic navigation only)

Key	Action
j / ↓	Move selection down
k / ↑	Move selection up
h / ←	Move selection left (between columns)
l / →	Move selection right (between columns)
Enter	Open issue
g	Jump to top of focused column
G	Jump to bottom of focused column

Hosts that need workflow-specific verbs (e.g. merge, dispatch, review) should handle those keys themselves before or after calling this method — it only ever consumes the generic navigation keys above. Move the selection in the given direction, updating selected_card_id and col_scroll_offset as needed.

Callers that want the BoardAction for external routing should use [handle_key] instead. This method is for apps (like BoardApp) that just want the state to update immediately.

pub fn jump_to_top(&mut self)

Select the first card in the currently-focused column.

pub fn jump_to_bottom(&mut self)

Select the last card in the currently-focused column.

pub fn selected_col_index(&self) -> Option<usize>

Return the column index of the currently-selected card, if any.

pub fn selected_position(&self) -> Option<(usize, usize)>

Return (col_index, card_index) of the currently-selected card, or None if no card is selected (or the selected id is no longer present on the board).

pub fn handle_key( &self, key: &str, _modifiers: Modifiers, ) -> Option<BoardAction>

Trait Implementations

impl Clone for BoardModel

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BoardModel

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BoardModel

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for BoardModel

impl PartialEq for BoardModel

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for BoardModel

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BoardModel