🖲️ User Selection Tools

Utilities for capturing user choices.

---

Simple Selection (Yes/No)

Uses volume buttons: Up = Yes, Down = No.

if $yes; then
    # Volume Up (Yes)
    package_extract_dir system /system
else
    # Volume Down (No)
    package_extract_dir vendor /vendor
fi

---

multi_option

Creates a multi-option menu with volume button navigation.

Argument	Description
VAR	Variable to store selection
NUM	Number of options
loop	Loops options until selection (optional)
selected=TEXT	Custom text for selection (use %i for option num)
skipped=TEXT	Custom text for skipping (use %i for option num)

ui_print " 1. First option"
ui_print " 2. Second option"
ui_print " 3. Third option"
ui_print " 4. Fourth option"

# Basic usage
multi_option "my_menu" 4

# With looping
multi_option "my_menu" 4 loop

# Custom messages
multi_option "my_menu" 4 "selected=YOU SELECTED: %i" "skipped=YOU SKIPPED: %i"

if undefined my_menu; then
    abort "No valid selection was obtained"
fi

if [[ $my_menu == 1 ]]; then
    ui_print "Welcome to option 1"
elif [[ $my_menu == 2 ]]; then
    ui_print "Welcome to option 2"
elif [[ $my_menu == 3 ]]; then
    ui_print "Welcome to option 3"
elif [[ $my_menu == 4 ]]; then
    ui_print "Welcome to option 4"
fi

note

If NUM is omitted, it loops infinitely until an option is selected.