0
Fork 0
mirror of https://github.com/twbs/bootstrap.git synced 2026-11-16 06:58:43 +00:00
bootstrap/skills
Mark Otto f9a7a8941e
Unify chip input and editable Combobox (#43300)
* fix(combobox): support native form values and events

Multiple selections now submit one field per value. Commas stay in the
value, and an empty multiple selection submits no entries. Reuse an
explicit hidden input without removing application-owned fields.

Keep a stable field for input and change listeners. Sync fields before
notifications, restore initial selections on reset, and follow disabled
state and form ownership. Document the update and disposal contracts.

Forward Menu lifecycle events after its transitions. Keep native search
editing keys and cover the sticky search padding with logical CSS.

* feat(combobox): combine editable selection and chip entry

Search and select values from one editable field. Multiple selections
render as removable chips, and explicit free entry supports tags. Keep
query text separate from committed values and preserve native form data.

Use the existing Menu for positioning and lifecycle. Keep focus in the
editor while suggestions are highlighted. Preserve chip nodes, caret
positions, reset behavior, and input-method text during reconciliation.

Retire the separate Chips plugin and chip-input control. Keep static
chip styles and button-triggered Combobox markup. Document the alpha 2
markup, token, method, and event migration.

* fix(combobox): match chip fields to the default input height

Multiple values should fit the same row height as a normal input.
Use shared input spacing and typography, with smaller contextual chips.
Let the field grow when its values wrap.

Replace the text dismiss glyph with the SVG from the chip documentation.
Keep the named removal button and existing chip interaction behavior.

* fix(combobox): separate chip icon size from its hit area

Render the dismiss icon at 12px inside a 24px removal button. Move chips
closer to the field's inline start while keeping normal text padding
for an empty editor. Use logical spacing so the inset follows RTL.

* fix(combobox): tighten chip dismiss spacing

Use negative inline margins to bring the dismiss button closer to the
label and chip edge. Keep its 24px hit area and 12px SVG artwork.

* fix(combobox): derive chip corners from the field radius

Use a nested chip radius based on the wrapping field's radius, border,
and inset. Clamp the result at zero so square fields keep square chips.

* fix(combobox): balance chip insets within the field

Match the field's inline padding to its vertical padding when chips
are present. Derive chip corners from that inset and pull the dismiss
button's end margin in another 2px without reducing its hit area.

* fix(combobox): soften chip corners within balanced fields

Use half the field radius for chips so equal input padding does not
leave their corners nearly square. Keep square fields square.

* fix(combobox): restore chip selection and keyboard behavior

Highlight chips with the filled active state when users navigate or
select them. Restore modifier clicks, anchored ranges, select-all, and
deletion of highlighted chips. Keep native query editing and RTL keys.

Keep chip highlights separate from committed values. Report UI selection
through select.bs.combobox and restore the chip selection methods on
Combobox. Bulk removal honors each cancellation and emits one value
change before recovering focus.

Document the restored interaction and alpha migration. Cover range
anchors, duplicate values, disabled chips, reset, and disposal.

* fix(combobox): select chips on every focus path

Tabbing to a chip's remove button or focusing a chip directly should
show its primary selected state. Apply that highlight without changing
committed values, and dismiss the suggestion popup.

Guard focus controlled by range navigation and modifier clicks so it
does not collapse or undo the user's chip selection.

* fix(combobox): suppress inner chip focus outlines

Keep the filled selected chip and the wrapping field's focus ring as
focus indicators. Suppress the nested outlines on chips and their
remove buttons during keyboard navigation.

* fix(combobox): guard form and editor edge cases

Selection callbacks can change or dispose the component before an outer
operation completes. Stop stale selection and focus work after those
callbacks, and keep pending popup sizing from changing disposed markup.

Handle native composition events through the shared event system. Keep
unfinished input out of blur commits, reconcile completed composition,
and preserve focus after the editor loses it. Let the IME handle its
keys in both Combobox and Menu.

Follow external reset forms without a backing field, omit disabled
single options, and clear references to removed or disabled suggestions.
Add regressions and clarify the synchronous form update requirement.

* docs(chips): move standalone chips to Components

Chips can stand alone or appear within a form component. Place their
docs in Components and describe that wider use. Keep the old Forms URL
as a redirect, and update navigation and cross-links.

* fix(chips): limit hover feedback to interactive chips

Static chips change color and show a pointer cursor on hover, even
when they have no action. Keep static chips neutral and apply hover
feedback to links, buttons, and Combobox chips. A dismiss button keeps
its own hover state without changing the whole chip.

Add interactive examples and correct the documented CSS layer. Allow
for the extra selectors in the unminified CSS bundle budget.

* docs(combobox): lead with editable examples

Show search and selection in the input from the first example. Use
inputs for the shared examples and group the button variants together.
Use the editable markup in the form and setup guidance too.

* docs(combobox): restore the overview feature list

Describe editable inputs and button toggles in the original overview.
Include chips, free entry, form submission, and selection events.

* docs(combobox): preserve example indentation

Match the form field examples by adding the source indentation that
MDX strips. Record the convention in the docs guidance.

* fix(combobox): focus search directly when opening

Clicking a searchable combobox moved focus to the trigger before
the opening animation moved it to search.

Focus search as soon as the menu opens. Keep the trigger in the
tab order and return focus to it on Escape.

* docs(combobox): style the Language example label

* ci(combobox): fix bundle budgets and spelling

Round the three JavaScript bundle limits up to the next quarter
kilobyte to account for the search focus changes. Reword the docs
indentation rule so it passes the spelling check.

* fix(combobox): preserve resets and expose selection state

A canceled second reset could discard a completed reset. Keep each
pending reset until its own callback runs. Give button-mode options
listbox roles, handle Escape on the toggle, and restore chip focus
rings. Keep long values inside the field and use shared state tokens.

* fix(combobox): fit chips to the shared control size

Compact controls were 30px tall, but their fixed-height chips made
the multiple-selection field 34px tall. Derive chip and dismiss-button
heights from the space left by the control padding and borders. Check
compact, default, and spacious controls in the browser.

* docs(combobox): redirect chip input readers to the merged component

The former chip input page now points to Combobox. Explain the
consolidation at the top of that page and link the migration steps
for existing chip inputs.

* chore(combobox): account for the current main bundle size

The rebased build includes the merged Range and hash-link fixes.
Raise the three affected limits to the next standard budget step.
History 2026-11-12 12:48:15 -08:00
..
bootstrap-color-system docs(migration): cover recent v6 API changes 2026-08-30 21:15:55 -07:00
bootstrap-component docs(migration): cover recent v6 API changes 2026-08-30 21:15:55 -07:00
bootstrap-component-js Add llms.txt files, an AI docs page, and agent skills (#42770) 2026-07-28 15:11:42 -07:00
bootstrap-npm Prepare Bootstrap v6.0.0-alpha.1 release (#42997) 2026-10-08 09:37:03 -07:00
bootstrap-parcel Prepare Bootstrap v6.0.0-alpha.1 release (#42997) 2026-10-08 09:37:03 -07:00
bootstrap-utility-api Add llms.txt files, an AI docs page, and agent skills (#42770) 2026-07-28 15:11:42 -07:00
bootstrap-v4-v6-migration docs(migration): sync v6 guidance with current APIs 2026-09-28 22:07:20 -07:00
bootstrap-v5-v6-migration Unify chip input and editable Combobox (#43300) 2026-11-12 12:48:15 -08:00
bootstrap-v6-install Docs: explain how to reach Bootstrap's Sass variables and mixins with @use (#43235) 2026-10-29 20:36:59 +01:00
bootstrap-vite Prepare Bootstrap v6.0.0-alpha.1 release (#42997) 2026-10-08 09:37:03 -07:00
bootstrap-webpack Prepare Bootstrap v6.0.0-alpha.1 release (#42997) 2026-10-08 09:37:03 -07:00