Package org.patternfly.extension.finder

package org.patternfly.extension.finder

Provides a multi-column finder component inspired by the macOS Finder for hierarchical data navigation.

The finder displays data in a series of columns, where selecting an item in one column reveals its children in the next column. Columns support asynchronous loading, keyboard navigation, filtering, sorting, and an optional preview pane. Finder paths can be serialized for URL routing and restored programmatically.

Key classes:

• Finder - the main container managing columns and navigation
• FinderColumn - a single column displaying a list of items
• FinderItem - an individual selectable item within a column
• FinderPreview - preview pane shown alongside the columns
• FinderPath - lightweight path for serialization and URL routing

Usage

Finder finder = finder()
    .addColumn(finderColumn("categories")
        .addItem(finderItem("cat-1", "Category 1")
            .nextColumn(() -> finderColumn("items")
                .addItem(finderItem("item-1", "Item 1"))
                .addItem(finderItem("item-2", "Item 2")))));

See Also:

• Finder
• FinderColumn
• FinderPath

Class	Description
Finder	A finder provides column-based hierarchical navigation inspired by the macOS Finder.
FinderColumn	A column in the Finder, displaying a list of FinderItems that can be selected, filtered, and sorted.
FinderColumnActions	Container for action buttons and dropdowns in a FinderColumn header.
FinderColumnHeader	The header of a FinderColumn, displaying the column title and optional actions.
FinderColumnSearch	The FinderColumnSearch class is a subcomponent designed to handle search functionality within a finder column.
FinderItem	An item within a FinderColumn, representing a selectable entry with optional icon, description, and actions.
FinderItemActions	Container for action buttons and dropdowns displayed on a FinderItem.
FinderItemDescription	A text description displayed below the main content of a FinderItem.
FinderPath	A lightweight finder path containing only string-based segments.
FinderPreview	A preview panel displayed alongside the Finder columns when an item is selected.
FinderSegment	A lightweight segment of a FinderPath containing only string identifiers.
PreviewHandler	Handler for populating a FinderPreview when a FinderItem is selected.
ResolvedFinderPath	A resolved finder path containing live references to FinderColumn and FinderItem instances.
ResolvedFinderSegment	A segment of a ResolvedFinderPath containing live references to the FinderColumn and selected FinderItem.