Struct FilePickerState 

pub struct FilePickerState {
    pub current_dir: PathBuf,
    pub root: Option<PathBuf>,
    pub entries: Vec<DirEntry>,
    pub cursor: usize,
    pub offset: usize,
    pub selected: Option<PathBuf>,
    /* private fields */
}

Mutable state for the file picker.

Fields

current_dir: PathBuf

Current directory being displayed.

root: Option<PathBuf>

Root directory for confinement (if set, cannot navigate above this).

entries: Vec<DirEntry>

Directory entries (sorted: dirs first, then files).

cursor: usize

Currently highlighted index.

offset: usize

Scroll offset (first visible row).

selected: Option<PathBuf>

The selected/confirmed path (set when user presses enter on a file).

Implementations

impl FilePickerState

pub fn new(current_dir: PathBuf, entries: Vec<DirEntry>) -> Self

Create a new state with the given directory and entries.

pub fn with_root(self, root: impl Into<PathBuf>) -> Self

Set a root directory to confine navigation.

When set, the user cannot navigate to a parent directory above this root.

pub fn from_path(path: impl AsRef<Path>) -> Result<Self>

Create state from a directory path by reading the filesystem.

Sorts entries: directories first (alphabetical), then files (alphabetical). Returns an error if the directory cannot be read.

pub fn cursor_up(&mut self)

Move cursor up.

pub fn cursor_down(&mut self)

Move cursor down.

pub fn cursor_home(&mut self)

Move cursor to the first entry.

pub fn cursor_end(&mut self)

Move cursor to the last entry.

pub fn page_up(&mut self, page_size: usize)

Page up by page_size rows.

pub fn page_down(&mut self, page_size: usize)

Page down by page_size rows.

pub fn enter(&mut self) -> Result<bool>

Enter the selected directory (if cursor is on a directory).

Returns Ok(true) if navigation succeeded, Ok(false) if cursor is on a file, or an error if the directory cannot be read.

pub fn go_back(&mut self) -> Result<bool>

Go back to the parent directory.

Returns Ok(true) if navigation succeeded.

Trait Implementations

impl Clone for FilePickerState

fn clone(&self) -> FilePickerState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilePickerState

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

Formats the value using the given formatter.