[New Component] TreeView
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 8/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- csharp
- Ambito
- accessibility, frontend
Direzione di ricerca
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.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
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
- Lingua principale
- HTML
- Stelle
- 1.2k
- Fork
- 111
- Merge medio
- 4m
- PR unite (30g)
- 55
Preparare l'ambiente
Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di vikramlearning/blazorbootstrap
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
vikramlearning/blazorbootstrap#1388 ·
I maintainer di solito rispondono entro 1 giorno
-
NET 11 SupportAperta
Difficoltà 3/5 1-2 giorni Idoneità per principianti 28/100
vikramlearning/blazorbootstrap#1362 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 25/100
vikramlearning/blazorbootstrap#1346 ·
I maintainer di solito rispondono entro 1 giorno
-
Showcase: rich sample websites built with Blazor BootstrapForse già presa @gvreddy04 l’ha presa 8 giorni fa. Aperta
vikramlearning/blazorbootstrap#1343 · 1 assegnatario ·
I maintainer di solito rispondono entro 1 giorno
-
area-autocomplete area-forms area-multi-select new component
Difficoltà 5/5 Più di una settimana Idoneità per principianti 12/100
vikramlearning/blazorbootstrap#1338 ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di vikramlearning/blazorbootstrap
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
I maintainer di solito rispondono entro 1 giorno
-
browser: chrome package: @carbon/react type: bug 🐛
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
carbon-design-system/carbon#24074 ·
I maintainer di solito rispondono entro 1 giorno
-
bug trading ui
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
userFRM/egui-charts#3280 ·
I maintainer di solito rispondono entro 1 giorno
-
Filter sidebar: the "Only" button can't be reached by keyboard, and Tab drops focus to the pageApertaBug Website Accessibility
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
ProjectSidewalk/SidewalkWebpage#5999 ·
I maintainer di solito rispondono entro 1 giorno
-
a11y team Accessibility Bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 1 giorno