[New Component] MultiSelect input with search (also usable as searchable single select)

Aperta
#1,338 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

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
12/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
bootstrap, csharp
Ambito
frontend

Direzione di ricerca

The target location is blazorbootstrap/Components/Form/MultiSelectInput/, which does not exist yet, so start by reading the existing form input components in blazorbootstrap/Components/Form/ and the docs page pattern under docs/docs/04-forms/. This is a large multi-part feature with a contested scope, so it is better suited to a maintainer discussion than a first contribution. Done would mean the v1 checklist in the issue is met, which is well beyond a single change.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

area-autocomplete area-forms area-multi-select new component

Summary

Add a MultiSelectInput<TItem, TValue> dropdown component with built-in search, select-all, chip display, grouping, and virtualization. A single-selection mode covers the "searchable select" request.

Motivation

This is the most requested missing component, both in this repository and across the Blazor UI ecosystem:

  • Search inside select control — #559
  • Select component with filter — #1133
  • Allow AutoComplete to function as a dropdown — #1144
  • Dropdown with search field — #579, #854

Proposed API (draft)

<EditForm Model="filter">
    <MultiSelectInput TItem="Employee" TValue="int"
                      Data="employees"
                      TextField="e => e.Name"
                      ValueField="e => e.Id"
                      GroupBy="e => e.Department"
                      @bind-Value="filter.EmployeeIds"
                      AllowSearch="true" ShowSelectAll="true"
                      SelectedDisplay="MultiSelectDisplay.Chips" />
</EditForm>

<MultiSelectInput TItem="Country" TValue="string" SelectionMode="MultiSelectMode.Single"
                  DataProvider="CountriesProvider" @bind-SelectedValue="countryCode" />

Must-have features (v1)

  • Multiple mode: Value / ValueChanged / ValueExpression as IEnumerable<TValue> with EditForm validation.
  • Single mode: SelectedValue binding — searchable replacement for <select>.
  • Data sources: Data (client-side filter) and DataProvider (server-side search with debounce and loading indicator).
  • Search box inside the dropdown (AllowSearch), with FilterOperator (Contains, StartsWith).
  • Select all / Clear all; MaxSelectedItems.
  • SelectedDisplay (MultiSelectDisplay: Chips with remove buttons, Count summary "3 selected", Comma list).
  • Option grouping (GroupBy), disabled options (DisabledSelector), ItemTemplate.
  • Virtualization for large data sets.
  • Size (MultiSelectInputSize), Disabled, Placeholder, ShowClearButton.
  • Dropdown positions correctly inside Modal, Offcanvas, and scrollable containers.
  • Search input stays responsive on Blazor Server under latency (see #407 / #1247).

Accessibility

  • Combobox + listbox ARIA pattern; aria-multiselectable in multiple mode.
  • Arrow keys, Home/End, Enter/Space to toggle, Escape to close, type-ahead.
  • Selected count announced via a polite live region.

Out of scope (later)

  • Creating a new option from search text.
  • Cascading selects.

Acceptance criteria

  • Component in blazorbootstrap/Components/Form/MultiSelectInput/.
  • XML docs on all public parameters and events.
  • Demo page covering: multiple, single searchable, client data, server data provider, grouping, select all, max items, display modes, templates, disabled options, virtualization, inside Modal, EditForm validation.
  • Verified in Server and WebAssembly demo hosts.
  • Docs page docs/docs/04-forms/multi-select-input.mdx.
  • Builds for .NET 8, 9, 10.

Related

#559, #1133, #1144, #579, #854, #574

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

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di vikramlearning/blazorbootstrap

Tutte le issue di vikramlearning/blazorbootstrap

Issue simili

Altre issue su Web Dev

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.