Folder Editor

Provides an interactive editor for selecting folder paths, supporting hierarchical navigation and integration with various folder types.

Remarks

The Folder Editor control enables users to browse, select, and manage folder paths within Grooper. It supports hierarchical navigation of local, network, FTP, and SFTP folder structures, adapting its UI and icons to the underlying folder type. The editor is used for properties that require folder selection, such as batch/test folders, export destinations, and configuration paths.

UI Components

• Folder Tree View:
  • Displays folders in a hierarchical tree structure.
  • Supports expanding/collapsing nodes to navigate subfolders.
  • Visual cues and icons indicate folder type (e.g., network, FTP, SFTP, local).
  • Selected folder is highlighted for clarity.
• Path Input and Selection:
  • Shows the currently selected folder path.
  • Allows direct input or selection from the tree.
  • Prefix and delimiter adapt to the folder type (e.g., \\ for NTFS, / for FTP/SFTP).
• Contextual Icons and Titles:
  • Icons and titles change based on folder type and hierarchy level (e.g., network, server, share, folder).
  • Provides immediate feedback about the folder's context.
• Expand/Collapse Logic:
  • Automatically expands nodes on the selected path for quick navigation.
  • Collapses unrelated branches to reduce clutter.

Interactive Features

• Folder Navigation:
  • Click to expand/collapse folders and select a path.
  • Double-click or press Enter to confirm selection.
  • Keyboard navigation: Up/Down to move, Left/Right to expand/collapse.
• Type-Specific Behavior:
  • Adapts icons, titles, and path delimiters for NTFS, FTP, and SFTP folders.
  • Provides custom logic for root, server, share, and folder levels.
• Selection Feedback:
  • Highlights the selected folder and displays its full path.
  • Expands nodes along the selected path for visibility.

Usage Guidance

Use the Folder Editor to select valid folder paths for properties requiring folder input. Navigate the tree to find the desired folder, or enter the path directly. The editor ensures only valid folders are selectable and provides visual feedback for the current selection.

• For network shares, use the NTFS view to browse servers and shares.
• For FTP/SFTP exports, use the corresponding view to select remote folders.
• Icons and titles help clarify the folder's context and type.

Accessibility

• Fully navigable by keyboard and mouse.
• Screen reader support for tree nodes, icons, and path input.
• Visual highlighting for selection, focus, and expanded nodes.

Example

┌───────────── Folder Editor ─────────────┐
│ {Tree View}                             │
│   - Local Network                       │
│     - Server: SERVER01                  │
│       - Network Share: \\ShareA         │
│         - Folder: \\ShareA\Docs         │
│   - FTP Server                          │
│     - Folder: /exports                  │
│   - SFTP Server                         │
│     - Folder: /secure                   │
│ {Selected Path}: \\SERVER01\ShareA\Docs │
└─────────────────────────────────────────┘