[New Component] TreeView
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 8/100
- Issue-Typ
- Feature
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- csharp
- Bereich
- accessibility, frontend
Rechercherichtung
This is a new component, not a fix, and the payload has no existing code to start from. Read the related issue #1065 and the draft API, then look at how existing components are laid out under blazorbootstrap/Components/. Done would require a first slice of the v1 list (for example basic data binding and expand/collapse) with XML docs and a demo page, agreed with the maintainers before coding.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Summary
Add a data-bound TreeView<TItem> component for hierarchical data with lazy loading, selection (including tri-state checkboxes), search, and full keyboard support.
Motivation
TreeView is requested across the Blazor UI ecosystem and in this repository as a hierarchical list (#1065). Common uses: folder browsers, category pickers, organization charts, and permission editors.
Proposed API (draft)
<TreeView TItem="Folder"
Data="rootFolders"
TextField="f => f.Name"
ChildrenSelector="f => f.SubFolders"
HasChildrenSelector="f => f.HasSubFolders"
ChildrenProvider="LoadChildrenAsync"
SelectionMode="TreeViewSelectionMode.Checkbox"
@bind-SelectedItems="selectedFolders"
@bind-ExpandedItems="expandedFolders">
<ItemTemplate Context="folder">
<Icon Name="IconName.Folder" /> @folder.Name
</ItemTemplate>
</TreeView>
Must-have features (v1)
- Data binding:
Data,TextField,ChildrenSelector,HasChildrenSelector,ItemTemplate,IconSelector. - Lazy loading:
ChildrenProvider(async) with per-node loading indicator. - Expand/collapse:
@bind-ExpandedItems,ExpandAllAsync,CollapseAllAsync,OnExpandedChanged. - Selection:
SelectionMode(TreeViewSelectionMode: None, Single, Multiple, Checkbox) with@bind-SelectedItem/@bind-SelectedItems. - Checkbox mode: tri-state parents (checked / unchecked / indeterminate) with up and down propagation; option to disable cascading.
- Disabled nodes (
DisabledSelector);OnNodeClickevent. - Search/filter (
FilterTextor built-in search box) that auto-expands branches containing matches and highlights them. - UI updates when the bound collections change (add, remove, rename nodes).
Accessibility
- WAI-ARIA tree pattern:
role="tree",treeitem,group,aria-expanded,aria-selected/aria-checked,aria-level. - Keyboard: Up/Down, Right (expand / first child), Left (collapse / parent), Home/End, Enter/Space, type-ahead,
*expands siblings. - Roving tabindex (only one node in tab order).
Out of scope (later)
- Drag-and-drop to move or reparent nodes.
- Tree select inside a dropdown.
- Virtualization for very large trees.
Acceptance criteria
- Component in
blazorbootstrap/Components/TreeView/. - XML docs on all public parameters, methods, and events.
- Demo page covering: basic, icons, templates, lazy loading, single, multiple, checkbox tri-state, disabled nodes, expand/collapse all, search, dynamic updates, keyboard navigation.
- Verified in Server and WebAssembly demo hosts.
- Docs page
docs/docs/05-components/tree-view.mdx. - Builds for .NET 8, 9, 10.
Related
#1065
- Vorherrschende Sprache
- HTML
- Sterne
- 1.2k
- Forks
- 111
- Ø Merge
- 4 Min.
- Gemergte PRs (30 T.)
- 55
Entwicklungsumgebung
Dieses Projekt bietet weder Dev-Container noch Dockerfile noch Beitragsleitfaden – die Einrichtung liegt bei Ihnen. Beginnen Sie mit der README; die allgemeinen Schritte stehen in unserem Leitfaden für den ersten Beitrag.
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus vikramlearning/blazorbootstrap
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
vikramlearning/blazorbootstrap#1388 ·
Maintainer antworten meist innerhalb von 1 Tag
-
NET 11 SupportOffen
Schwierigkeit 3/5 1-2 Tage Anfängerfreundlichkeit 28/100
vikramlearning/blazorbootstrap#1362 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 25/100
vikramlearning/blazorbootstrap#1346 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Showcase: rich sample websites built with Blazor BootstrapEvtl. vergeben @gvreddy04 hat das vor 8 Tagen übernommen. Offen
vikramlearning/blazorbootstrap#1343 · 1 zugewiesene Person ·
Maintainer antworten meist innerhalb von 1 Tag
-
area-autocomplete area-forms area-multi-select new component
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 12/100
vikramlearning/blazorbootstrap#1338 ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in vikramlearning/blazorbootstrap
Ähnliche Issues
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag
-
browser: chrome package: @carbon/react type: bug 🐛
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 70/100
carbon-design-system/carbon#24074 ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug trading ui
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
userFRM/egui-charts#3280 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Filter sidebar: the "Only" button can't be reached by keyboard, and Tab drops focus to the pageOffenBug Website Accessibility
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
ProjectSidewalk/SidewalkWebpage#5999 ·
Maintainer antworten meist innerhalb von 1 Tag
-
a11y team Accessibility Bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
Maintainer antworten meist innerhalb von 1 Tag