@epam/ai-dial-react-file-manager 0.3.0-dev.13 → 0.3.0-dev.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -28,6 +28,12 @@ export interface DialFoldersTreeProps {
|
|
|
28
28
|
forbiddenSymbolsRegExp?: RegExp;
|
|
29
29
|
forbiddenSymbolsTooltip?: ReactNode;
|
|
30
30
|
newFolderDefaultName?: string;
|
|
31
|
+
/** Accessible name of the `role="tree"` root. Defaults to `'Folders'`. */
|
|
32
|
+
ariaLabel?: string;
|
|
33
|
+
/** Moves focus to the selected row (or the first row) when the tree mounts. */
|
|
34
|
+
autoFocus?: boolean;
|
|
35
|
+
/** Called when Escape is pressed on a row, e.g. to close an overlay hosting the tree. */
|
|
36
|
+
onEscape?: () => void;
|
|
31
37
|
}
|
|
32
38
|
/**
|
|
33
39
|
* DialFoldersTree — A hierarchical folder tree component with nested expand/collapse support, selection highlighting,
|
|
@@ -122,11 +128,18 @@ export interface DialFoldersTreeProps {
|
|
|
122
128
|
* @param [onCreateFolderSave] - Optional Callback fired when create new folder is confirmed
|
|
123
129
|
* @param [onCreateFolderCancel] - Optional Callback fired when create new folder is cancelled
|
|
124
130
|
* @param [newFolderDefaultName] - Optional new folder default name.
|
|
131
|
+
* @param [ariaLabel='Folders'] - Accessible name of the `role="tree"` root.
|
|
132
|
+
* @param [autoFocus=false] - Moves focus to the selected row (or the first row) on mount.
|
|
133
|
+
* @param [onEscape] - Callback fired when Escape is pressed on a row.
|
|
125
134
|
* @remarks
|
|
126
135
|
* - Folder and file data must follow the `DialFile` model.
|
|
127
136
|
* - The `expandedPaths`, `loadingPaths`, `selectedPath`, and `renamedPath` props are externally controlled.
|
|
128
137
|
* - Inline renaming is fully customizable using `onRenameSave`, `onRenameCancel`, and `onRenameValidate`.
|
|
129
138
|
* - Context menus can be attached to both folders and files using `getContextMenuItems`.
|
|
130
139
|
* - Use `showFiles={false}` to render only folders for a simplified tree.
|
|
140
|
+
* - Rows are `role="treeitem"` with a roving tabIndex: Arrow Up/Down and
|
|
141
|
+
* Home/End move focus, Arrow Right/Left expand, collapse or move to the
|
|
142
|
+
* parent (mirrored under `dir="rtl"`), Enter/Space activate the row as a
|
|
143
|
+
* click does, and Escape calls `onEscape`.
|
|
131
144
|
*/
|
|
132
145
|
export declare const DialFoldersTree: FC<DialFoldersTreeProps>;
|