Struct DialogState 

pub struct DialogState { /* private fields */ }

State for a Dialog component.

Contains all the state needed to render and manage a dialog, including title, message, buttons, and focus state.

Implementations

impl DialogState

pub fn new( title: impl Into<String>, message: impl Into<String>, buttons: Vec<DialogButton>, ) -> Self

Creates a new dialog with the given title, message, and buttons.

The first button is set as the primary button by default.

Example

use envision::component::{DialogButton, DialogState};

let buttons = vec![
    DialogButton::new("ok", "OK"),
    DialogButton::new("cancel", "Cancel"),
];
let state = DialogState::new("Title", "Message", buttons);
assert_eq!(state.title(), "Title");
assert_eq!(state.primary_button(), 0);

pub fn with_primary( title: impl Into<String>, message: impl Into<String>, buttons: Vec<DialogButton>, primary: usize, ) -> Self

Creates a dialog with a primary button specified.

The primary button index is clamped to the valid range.

Example

use envision::component::{DialogButton, DialogState};

let buttons = vec![
    DialogButton::new("cancel", "Cancel"),
    DialogButton::new("ok", "OK"),
];
let state = DialogState::with_primary("Title", "Message", buttons, 1);
assert_eq!(state.primary_button(), 1);

pub fn alert(title: impl Into<String>, message: impl Into<String>) -> Self

Creates a simple alert dialog with an “OK” button.

Example

use envision::component::DialogState;

let state = DialogState::alert("Error", "Something went wrong.");
assert_eq!(state.buttons().len(), 1);
assert_eq!(state.buttons()[0].id(), "ok");

pub fn confirm(title: impl Into<String>, message: impl Into<String>) -> Self

Creates a confirmation dialog with “Cancel” and “OK” buttons.

The “OK” button is set as the primary button.

Example

use envision::component::DialogState;

let state = DialogState::confirm("Delete?", "This cannot be undone.");
assert_eq!(state.buttons().len(), 2);
assert_eq!(state.buttons()[0].id(), "cancel");
assert_eq!(state.buttons()[1].id(), "ok");
assert_eq!(state.primary_button(), 1);

pub fn title(&self) -> &str

Returns the dialog title.

pub fn message(&self) -> &str

Returns the dialog message.

pub fn buttons(&self) -> &[DialogButton]

Returns the dialog buttons.

pub fn primary_button(&self) -> usize

Returns the index of the primary button.

pub fn focused_button(&self) -> usize

Returns the index of the currently focused button.

pub fn set_title(&mut self, title: impl Into<String>)

Sets the dialog title.

pub fn set_message(&mut self, message: impl Into<String>)

Sets the dialog message.

pub fn set_buttons(&mut self, buttons: Vec<DialogButton>)

Sets the dialog buttons.

Resets focus to the first button or primary button index.

pub fn set_primary_button(&mut self, index: usize)

Sets the primary button index.

The index is clamped to the valid range.

Trait Implementations

impl Clone for DialogState

fn clone(&self) -> DialogState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DialogState

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

Formats the value using the given formatter.

impl Default for DialogState

fn default() -> DialogState

Returns the “default value” for a type.