Struct MenuBar 

pub struct MenuBar {
    pub items: Vec<MenuItem>,
    pub area: Option<Rect>,
    pub normal_style: Style,
    pub selected_style: Style,
    pub hover_style: Style,
    pub selected_hover_style: Style,
}

A horizontal menu bar with selectable items

Fields

items: Vec<MenuItem>

area: Option<Rect>

normal_style: Style

selected_style: Style

hover_style: Style

selected_hover_style: Style

Implementations

impl MenuBar

pub fn new(items: Vec<MenuItem>) -> Self

pub fn with_selected(self, index: usize) -> Self

pub fn normal_style(self, style: Style) -> Self

pub fn selected_style(self, style: Style) -> Self

pub fn hover_style(self, style: Style) -> Self

pub fn selected_hover_style(self, style: Style) -> Self

impl MenuBar

pub fn apply_theme(&mut self, theme: &AppTheme)

Applies theme colors to the menu bar in place.

Unlike with_theme which consumes self, this method updates the menu bar’s styles without consuming it. Useful for updating the theme dynamically at runtime.

Arguments

• theme - The application theme to apply

Example

use ratatui_toolkit::{MenuBar, MenuItem, AppTheme};

let theme = AppTheme::default();
let mut menu_bar = MenuBar::new(vec![
    MenuItem::new("File", 0),
    MenuItem::new("Edit", 1),
]);
menu_bar.apply_theme(&theme);

impl MenuBar

pub fn with_theme(self, theme: &AppTheme) -> Self

Applies theme colors to the menu bar.

This method configures all menu bar styles based on the provided theme, ensuring consistent styling across the application.

Arguments

• theme - The application theme to apply

Returns

Self with theme colors applied for method chaining.

Example

use ratatui_toolkit::{MenuBar, MenuItem, AppTheme};

let theme = AppTheme::default();
let menu_bar = MenuBar::new(vec![
    MenuItem::new("File", 0),
    MenuItem::new("Edit", 1),
])
.with_theme(&theme);

impl MenuBar

pub fn update_hover(&mut self, column: u16, row: u16)

pub fn handle_click(&mut self, column: u16, row: u16) -> Option<usize>

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

pub fn render(&mut self, frame: &mut Frame<'_>, area: Rect)

Render the menu bar as a connected series of items with rounded border

pub fn render_with_offset( &mut self, frame: &mut Frame<'_>, area: Rect, left_offset: u16, )

Render the menu bar with a left offset to make room for other components

pub fn render_centered(&mut self, frame: &mut Frame<'_>, area: Rect)

Render with a centered layout (useful for menu bars)

Trait Implementations

impl Clone for MenuBar

fn clone(&self) -> MenuBar

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MenuBar

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

Formats the value using the given formatter.

impl Default for MenuBar

fn default() -> Self

Returns the “default value” for a type.