Struct FileBrowser 

pub struct FileBrowser { /* private fields */ }

An explorer of folders and files: a breadcrumb that goes back, a header that sorts, and a list of any length with icon, name, size and date. The entries are data from the app, which answers on_navigate and on_open with another folder; it never touches the file system, so it serves a backup on a server as well as a disk. A click selects alone, Ctrl or Cmd adds, and Shift takes a range. The arrows, Home and End move, Space adds, Enter opens, and Backspace goes up.

use ravenrs_widgets::{FileBrowser, FileEntry, Ui};

let browser = FileBrowser::new(
    ["Backups", "2026"],
    vec![FileEntry::folder("October"), FileEntry::file("notes.txt", 2048)],
)
.on_open(|entry| println!("{}", entry.name))
.on_navigate(|depth| println!("{depth}"));
let mut ui = Ui::new(browser, ravenrs_style::Theme::raven_dark());
ui.update();

Implementations

impl FileBrowser

pub fn new( path: impl IntoIterator<Item = impl Into<String>>, entries: impl Into<Rc<[FileEntry]>>, ) -> Self

The folder at path, from the root, with entries inside it. Keep the entries in an Rc between builds when they are many: they are sorted again only when they are not the same ones.

pub fn selection(self, selection: Binding<BTreeSet<String>>) -> Self

The ids of the selected entries, to read and to change from outside.

pub fn sort(self, sort: Binding<FileSort>) -> Self

The order, to keep or to set from outside.

pub fn mode(self, mode: SelectionMode) -> Self

How entries can be selected (SelectionMode::Multiple by default).

pub fn on_navigate(self, handler: impl Fn(usize) + 'static) -> Self

Called with the depth of the place to go back to, 0 being the root.

pub fn on_open(self, handler: impl Fn(&FileEntry) + 'static) -> Self

Called with an entry on a double click or on Enter.

pub fn height(self, height: f32) -> Self

A fixed height. It takes the height its parent gives it by default.

pub fn label(self, label: impl Into<String>) -> Self

What screen readers call it, instead of the name in Labels.

Trait Implementations

impl Debug for FileBrowser

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

Formats the value using the given formatter.

impl View for FileBrowser

fn build(&self, cx: &mut BuildCx<'_>) -> NodeId

Creates this view’s node for the current build.

fn type_name(&self) -> &'static str

The name the diagnostics panel shows this view’s cost under.