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

pub fn collect_symlink_mappings(&self) -> HashMap<PathBuf, PathBuf>

Collect symlink mappings from expanded symlink directories.

Returns a HashMap where keys are symlink paths and values are their canonical targets. This is used to create decoration aliases so files under symlinked directories can show their git status correctly.

pub fn search_query(&self) -> &str

Get the current search query

pub fn is_search_active(&self) -> bool

Check if search is active

pub fn search_push_char(&mut self, c: char)

Add a character to the search query and jump to first match

pub fn search_pop_char(&mut self)

Remove the last character from the search query

pub fn search_clear(&mut self)

Clear the search query

pub fn select_next_match(&mut self)

Select the next matching node (when search is active)

pub fn select_prev_match(&mut self)

Select the previous matching node (when search is active)

pub fn get_match_for_node(&self, node_id: NodeId) -> Option<FuzzyMatch>

Get match result for a node’s name (for highlighting)

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

Check if a node matches the current search

Trait Implementations

impl Debug for FileTreeView

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

Formats the value using the given formatter.