Struct Item

pub struct Item<T>
where
    T: Send + Sync,
{
    pub value: T,
    /* private fields */
}

item in the menu

You can only store the same type of value in the menu

Fields

value: T

Implementations

impl<T: Send + Sync> Item<T>

pub fn new(display: &str, value: T) -> Item<T>

Examples found in repository

examples/basic.rs (line 5)

fn main() {
    let mut menu = termenu::Menu::new().unwrap();
    let mut item_list = Vec::new();
    for i in 1..=10 {
        item_list.push(termenu::Item::new(format!("{}th item", i).as_str(), i));
    }
    let selection = menu
        .set_title("test selection:")
        .add_list(item_list)
        .select()
        .unwrap();
    if let Some(selection) = selection {
        println!("You selected: {}", selection);
    }
}

examples/non-ascii.rs (lines 5-8)

fn main() {
    let mut menu = termenu::Menu::new().unwrap();
    let mut item_list = Vec::new();
    for i in 1..=10 {
        item_list.push(termenu::Item::new(
            format!("{}th オプション/选项/옵션", i).as_str(),
            i,
        ));
    }
    let selection = menu
        .set_title("test selection:")
        .add_list(item_list)
        .select()
        .unwrap();
    if let Some(selection) = selection {
        println!("You selected: {}", selection);
    }
}

examples/register_fn.rs (lines 5-10)

fn main() {
    let mut menu = termenu::Menu::new().unwrap();
    let mut item_list = Vec::new();
    for i in 1..=10 {
        item_list.push(termenu::Item::new(
            format!("{}th item", &i).as_str(),
            move || {
                println!("you selected: {}", i);
            },
        ));
    }
    let selection = menu
        .set_title("test selection:")
        .add_list(item_list)
        .select()
        .unwrap();
    if let Some(selection) = selection {
        selection();
    }
}

examples/run_multiple_times.rs (line 12)

fn run_once(menu: &mut termenu::Menu<i32>) {
    println!("[start running once]");
    let mut item_list = Vec::new();
    for i in 1..=10 {
        item_list.push(termenu::Item::new(format!("{}th item", i).as_str(), i));
    }
    let selection = menu
        .set_title("test selection:")
        .add_list(item_list)
        .select()
        .unwrap();
    if let Some(selection) = selection {
        println!("You selected: {}", selection);
    } else {
        println!("You didn't select anything");
    }
    menu.reset().unwrap();
}

examples/complex.rs (line 18)

fn main() {
    let mut menu = Menu::new().unwrap_or_else(|e| {
        quit_now!("Error: {}", e);
    });

    // build item list
    let mut item_list = Vec::new();
    for i in 1..=100 {
        item_list.push(Item::new(format!("{}th item", i).as_str(), i));
    }

    // build colorscheme, you can skip this step to use the default colorscheme
    // NOTE: sometimes your terminal might not support all the colors, so you may need to adjust
    // the colorscheme
    let mut colorscheme = termenu::ColorScheme::default();
    colorscheme
        .set_title_style(
            FontStyle::default()
                .set_shape(FontShape::Bold | FontShape::Underline)
                .set_fg_color(colored::Color::Green)
                .build(),
        )
        .set_query_style(FontStyle::default().set_shape(FontShape::Italic).build())
        .set_chosen_ln_style(
            FontStyle::default()
                .set_shape(FontShape::Underline)
                .set_fg_color(colored::Color::Black)
                .set_bg_color_256((215, 255, 0))
                .build(),
        )
        .set_more_tag_style(
            FontStyle::default()
                .set_fg_color(colored::Color::Magenta)
                .build(),
        );

    // run
    let selection = menu
        .set_title("test selection:")
        .show_end_tag(true)
        .set_max_height(0.3)
        .set_colorscheme(colorscheme)
        .add_list(item_list)
        .select() // this is the menu entry
        .unwrap_or_else(|e| {
            quit_now!("Error: {}", e);
        });

    // handle selection
    if let Some(selection) = selection {
        println!("You selected: {}", selection);
    } else {
        println!("You didn't select anything");
    }
}