Struct Dialog 

pub struct Dialog {
    pub id: WidgetId,
    pub title: StyledText,
    pub body: Vec<StyledText>,
    pub buttons: Vec<DialogButton>,
    pub severity: Option<DialogSeverity>,
    pub vertical_buttons: bool,
    pub table: Option<DialogTable>,
    pub input: Option<DialogInput>,
}

Declarative description of a dialog.

Examples

use quadraui::{
    Dialog, DialogButton, DialogHit, DialogMeasure, Rect, StyledText, ToolbarItemMeasure,
    WidgetId,
};

let dialog = Dialog {
    id: WidgetId::new("dialog:confirm_close"),
    title: StyledText::plain("Unsaved changes"),
    body: vec![StyledText::plain("Close without saving?")],
    buttons: vec![DialogButton {
        id: WidgetId::new("dialog:ok"),
        label: "OK".to_string(),
        is_default: true,
        is_cancel: false,
        tint: None,
    }],
    severity: None,
    vertical_buttons: false,
    table: None,
    input: None,
};

let measure = DialogMeasure {
    width: 40.0,
    title_height: 1.0,
    body_height: 1.0,
    table_height: 0.0,
    input_height: 0.0,
    button_row_height: 1.0,
    button_width: 10.0,
    button_gap: 1.0,
    padding: 1.0,
};

let viewport = Rect::new(0.0, 0.0, 80.0, 24.0);
// `input` is `None` above, so `layout` never calls this closure — it's
// only reached by the `DialogInput::Toolbar` body variant.
let layout = dialog.layout(viewport, measure, |_| ToolbarItemMeasure::new(10.0));
let ok = layout.visible_buttons[0].bounds;
assert_eq!(layout.hit_test(ok.x, ok.y), DialogHit::Button(dialog.buttons[0].id.clone()));

Fields

id: WidgetId

title: StyledText

body: Vec<StyledText>

Body content lines. Each entry is one line rendered top-to-bottom. Supports per-line styled spans for keybinding references, help text, and other multi-line content.

buttons: Vec<DialogButton>

severity: Option<DialogSeverity>

Optional severity tint — backends may add an icon or edge accent. None = neutral.

vertical_buttons: bool

When true, buttons are stacked vertically (useful for narrow dialogs or many-choice dialogs like code-action pickers). When false, buttons are horizontal, right-aligned.

table: Option<DialogTable>

Optional structured table rendered between the body text and the DialogInput slot. Used for keybindings grids, comparison tables, etc.

Layout order: title → body → table → input → buttons.

input: Option<DialogInput>

Optional content rendered between the table and the button row.

• DialogInput::TextInput — single-line text field; used for rename prompts, input-required confirms.
• DialogInput::Toolbar — horizontal action strip; used when the dialog wants an inline action bar (e.g. “Preview / Skip / Apply”) in addition to the modal OK/Cancel buttons.

Apps own the value; interactions resolve via DialogLayout::hit_test / DialogHit.

Implementations

impl Dialog

pub fn layout<F>( &self, viewport: Rect, measure: DialogMeasure, measure_toolbar_item: F, ) -> DialogLayout

where F: Fn(&ToolbarButton) -> ToolbarItemMeasure,

Compute dialog layout.

Arguments

• viewport — parent surface bounds; the dialog is centered within this.
• measure — sub-region widths/heights. Backends measure the body text (wrapping to measure.width) and set body_height accordingly; ditto for title and buttons. input_height is used for both the text-input and toolbar variants — set it to the desired slot height regardless of which DialogInput kind is present.
• measure_toolbar_item — per-item width callback for the toolbar variant. When self.input is not DialogInput::Toolbar, this callback is never called and may be |_| ToolbarItemMeasure::new(0.0).

Centering

The dialog box is placed at the viewport’s horizontal + vertical center. Button row is at the bottom of the box, right-aligned (horizontal) or stretched (vertical).

pub fn default_button_id(&self) -> Option<&WidgetId>

Convenience: find the default button’s id (first with is_default = true, or the last button as a fallback).

pub fn cancel_button_id(&self) -> Option<&WidgetId>

Convenience: find the cancel button’s id (first with is_cancel = true).

pub fn measure_generic( &self, char_width: f32, line_height: f32, viewport: Rect, border_chrome_inset: f32, ) -> DialogMeasure

Derive a DialogMeasure from char_width and line_height without real text measurement. This is the char-cell approximation used where char_width == line_height == 1.0 on TUI (one character cell) and the backend’s real glyph metrics on pixel backends.

border_chrome_inset optionally shrinks the resulting width to leave room for a border the rasteriser draws outside DialogLayout::bounds rather than inside it — e.g. a TUI backend whose box-drawing glyphs live one cell past the content box, the same convention tui::context_menu::draw_context_menu (behind the tui feature) already uses for ContextMenu. Pass 0.0 when the border is painted inside the returned bounds — this crate’s own tui::dialog::draw_dialog and every pixel backend do this.

Does not measure Self::table or Self::buttons’ rendered pixel width beyond the char-cell approximation above; callers with real text measurement available should prefer Self::measure_generic_measured.

pub fn measure_generic_measured( &self, char_width: f32, line_height: f32, viewport: Rect, border_chrome_inset: f32, measure: &dyn TextMeasure, ) -> DialogMeasure

Like Self::measure_generic, but sizes DialogMeasure::button_width from each DialogButton::label’s real rendered width through measure instead of the fixed char_width * 8.0 estimate — the widest button sets a uniform width for the row (button_width is shared by every button; see DialogMeasure::button_width’s doc), plus 2 char-widths of horizontal padding, floored at the original char_width * 8.0 so a row of short labels (“OK” / “No”) doesn’t shrink below what every existing caller of Self::measure_generic already renders.

Every other field is identical to Self::measure_generic — only the button row’s width changes.

Trait Implementations

impl Clone for Dialog

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 Dialog

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Dialog

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Dialog

impl PartialEq for Dialog

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Dialog

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 Dialog