docs: clarify search ownership and icon-rail click behavior
Search: DS renders dumb input, app owns filterQuery state and passes it to each SidebarTree. Icon-rail click: fires both onCollapseToggle and onToggle simultaneously, no navigation. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -89,6 +89,8 @@ The outer shell. Provides the sidebar frame, search input, scrollable content ar
|
|||||||
| `children` | `ReactNode` | - | `Sidebar.Header`, `Sidebar.Section`, `Sidebar.Footer` |
|
| `children` | `ReactNode` | - | `Sidebar.Header`, `Sidebar.Section`, `Sidebar.Footer` |
|
||||||
| `className` | `string` | - | Additional CSS class |
|
| `className` | `string` | - | Additional CSS class |
|
||||||
|
|
||||||
|
**Search state ownership:** The DS renders the search input and calls `onSearchChange` on every keystroke. The consuming app owns the state (`filterQuery`) and passes it to each `SidebarTree`. This lets the app control filtering behavior (e.g., clear search on section switch, filter only certain sections).
|
||||||
|
|
||||||
**Expanded layout (default):**
|
**Expanded layout (default):**
|
||||||
```
|
```
|
||||||
+---------------------------+
|
+---------------------------+
|
||||||
@@ -123,7 +125,7 @@ The outer shell. Provides the sidebar frame, search input, scrollable content ar
|
|||||||
- `[<<]` / `[>>]` toggle button in top-right corner (chevron icon)
|
- `[<<]` / `[>>]` toggle button in top-right corner (chevron icon)
|
||||||
- Width transition: CSS `width` + `transition: width 200ms ease`
|
- Width transition: CSS `width` + `transition: width 200ms ease`
|
||||||
- When collapsed, search input is hidden
|
- When collapsed, search input is hidden
|
||||||
- When collapsed, clicking a section icon calls `onCollapseToggle` (to expand) and that section's `onToggle` (to open it)
|
- When collapsed, clicking a section icon fires both `onCollapseToggle` and that section's `onToggle` simultaneously. The sidebar expands and the section opens in one motion. No navigation occurs — the user clicks a tree item after the section is visible to navigate.
|
||||||
|
|
||||||
#### `<Sidebar.Header>`
|
#### `<Sidebar.Header>`
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user