Struct FileTreeView 

pub struct FileTreeView { /* private fields */ }

View state for file tree navigation and filtering

Implementations

impl FileTreeView

pub fn new(tree: FileTree) -> Self

Create a new file tree view

pub fn set_viewport_height(&mut self, height: usize)

Set the viewport height (should be called during rendering)

pub fn tree(&self) -> &FileTree

Get the underlying tree

pub fn tree_mut(&mut self) -> &mut FileTree

Get mutable reference to the underlying tree

pub fn get_display_nodes(&self) -> Vec<(NodeId, usize)>

Get currently visible nodes with their indent levels

Returns a list of (NodeId, indent_level) tuples for rendering.

pub fn get_selected(&self) -> Option<NodeId>

Get the currently selected node ID

pub fn set_selected(&mut self, node_id: Option<NodeId>)

Set the selected node

pub fn select_next(&mut self)

Select the next visible node

pub fn select_prev(&mut self)

Select the previous visible node

pub fn select_page_up(&mut self)

Move selection up by a page (viewport height)

pub fn select_page_down(&mut self)

Move selection down by a page (viewport height)

pub fn update_scroll_for_selection(&mut self)

Update scroll offset to ensure symmetric scrolling behavior

This should be called after navigation to implement symmetric scrolling:

• When moving down, cursor moves to bottom of viewport before scrolling
• When moving up, cursor moves to top of viewport before scrolling

Uses the stored viewport_height which is updated during rendering.

pub fn select_first(&mut self)

Select the first visible node

pub fn select_last(&mut self)

Select the last visible node

pub fn select_parent(&mut self)

Select the parent of the currently selected node

pub fn get_scroll_offset(&self) -> usize

Get the scroll offset

pub fn set_scroll_offset(&mut self, offset: usize)

Set the scroll offset

pub fn ensure_visible(&mut self, viewport_height: usize)

Ensure the selected node is visible within the viewport

Adjusts scroll offset if necessary to keep the selected node visible.

Arguments

• viewport_height - Number of visible lines in the viewport

pub fn get_sort_mode(&self) -> SortMode

Get the sort mode

pub fn set_sort_mode(&mut self, mode: SortMode)

Set the sort mode

pub fn get_selected_entry(&self) -> Option<&DirEntry>

Get selected node entry (convenience method)

pub fn navigate_to_path(&mut self, path: &Path)

Navigate to a specific path if it exists in the tree

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

Get the index of the selected node in the visible list

pub fn get_node_at_index(&self, index: usize) -> Option<NodeId>

Get visible node at index (accounting for scroll offset)

pub fn visible_count(&self) -> usize

Get the number of visible nodes

pub fn ignore_patterns(&self) -> &IgnorePatterns

Get reference to ignore patterns

pub fn ignore_patterns_mut(&mut self) -> &mut IgnorePatterns

Get mutable reference to ignore patterns

pub fn toggle_show_hidden(&mut self)

Toggle showing hidden files

pub fn toggle_show_gitignored(&mut self)

Toggle showing gitignored files

pub fn is_node_visible(&self, node_id: NodeId) -> bool

Check if a node should be visible (not filtered by ignore patterns)

pub fn load_gitignore_for_dir(&mut self, dir_path: &Path) -> Result<()>

Load .gitignore for a directory

This should be called when expanding a directory to load its .gitignore

pub async fn expand_and_select_file(&mut self, path: &Path) -> bool

Expand all parent directories and select the given file path

This is useful for revealing a specific file in the tree when switching focus to the file explorer. All parent directories will be expanded as needed, and the file will be selected.

Arguments

• path - The full path to the file to reveal and select

Returns

Returns true if the file was successfully expanded and selected, false otherwise. This will return false if:

• The path is not under the root directory
• The path doesn’t exist
• There was an error expanding intermediate directories

Trait Implementations

impl Debug for FileTreeView

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

Formats the value using the given formatter.