May 24, 2021

Autosuggest: Fix missing/invalid group headings in some cases


Jan 21, 2021

Autosuggest: Ensure input occupies the full width of its container


Jan 6, 2021

Autosuggest: Fix bug where async suggestions may not be visible

This fixes a bug where suggestions wouldn't become visible if the suggestions prop was initially empty and then populated asynchronously, only becoming visible on the next user interaction, e.g. typing in the field.


Dec 8, 2020

Autosuggest: Add support for custom messages when no suggestions are present

If no suggestions are available and you'd like to provide an explanation to the user, you can now pass an object with a messages property to the suggestions prop.


  suggestions={{ message: 'No suggestions available.' }}


Nov 18, 2020

Autosuggest: Add filterSuggestions function, allow suggestions prop to be a function

The logic for filtering suggestions typically lives on the server rather than the client because it’s impractical to send all possible suggestions over the network. However, when prototyping in Playroom or working with smaller datasets, you may want to perform this filtering on the client instead. For this case, we now provide a filterSuggestions function to make this as painless as possible.

To better support this behaviour, you can now pass a function to the suggestions prop. When executed, this function will be passed the current value of the field.


import { Autosuggest, filterSuggestions } from 'braid-design-system';

    { text: 'Apples', value: 1 },
    { text: 'Bananas', value: 2 }


Nov 9, 2020

Autosuggest: Support custom label text for suggestions

You can now optionally provide different suggestion text from the value that gets inserted into the text field.


  suggestions={[{ text: 'apples', label: 'Add "apples"' }]}


Nov 6, 2020

Autosuggest: Forward ref prop to input element


Oct 13, 2020

Autosuggest: Add hideSuggestionsOnSelection prop

Typically we hide the suggestion list when a selection is made, assuming that the field is now populated with the desired value. However, if the surrounding application clears the text field when a selection is made, this clashes with the user expectation that the field has been reverted back to its initial state with suggestions visible. To cater for this, we now allow you to opt out of this behaviour via the hideSuggestionsOnSelection boolean prop.


<Autosuggest hideSuggestionsOnSelection={false} {...rest} />


Oct 1, 2020

Autosuggest, Dialog: Lighten backdrop opacity from 0.7 to 0.4


Sep 17, 2020

TextField, PasswordField, Textarea, Autosuggest, Dropdown, MonthPicker: Add decription to aria-describedby


Sep 16, 2020

Autosuggest: Add translations prop to enable internationalisation


Sep 16, 2020

Autosuggest: Improve screen reader experience

Add description informing user that suggestions will appear below field. Also, notify users about how many suggestions are available, and about automatic selections.


Sep 10, 2020

Autosuggest: Update to ARIA 1.2 combobox spec


Jul 1, 2020

Autosuggest: Fix suggestion double tap bug on iOS

Tapping a suggestion on iOS triggers the hover state rather than a selection, forcing users to tap a second time to select the suggestion.

This is due to the way that iOS simulates mouse events in a touch environment. If the document is updated during a mouseover, mouseenter or mousemove event, the subsequent click event is never fired. While it may seem counterintuitive, this ensures that touch users are able to see hover effects that make changes to the page.

To fix this, we now trigger our suggestion hover logic on touchstart so that the document doesn't change during mouse events, which then allows the click event to fire uninterrupted.


May 21, 2020

Autosuggest: Apply darker background when disabled

When disabled, Autosuggest elements didn't have the same dark background as other disabled fields. This has now been fixed.


May 11, 2020

TextField, Autosuggest, PasswordField: Improved support for field buttons with browser extensions.

The implementation of internal spacing within fields has been adjusted to better support browser extensions for password managers.

Affects the following components:

  • PasswordField: visibility toggle button
  • TextField: clear button
  • Autosuggest: clear button


May 11, 2020

TextField, Autosuggest, PasswordField: Prevent field buttons firing on right click

Field buttons, such as clear and password visibility toggle, fire on mouse down to ensure focus is retained on the relevant field. We now ensure that the button only recognises left mouse button clicks.

Affects the following components:

  • PasswordField: visibility toggle button
  • TextField: clear button
  • Autosuggest: clear button


May 1, 2020

Autosuggest: Support suggestion descriptions

You can now provide a description as part of each suggestion item, e.g.:

      text: 'Apples',
      value: 123,
      description: 'Juicy and delicious',


Apr 28, 2020

Autosuggest: Don't select suggestions onBlur when using automaticSelection and suggestions are closed


Apr 22, 2020

Autosuggest: When using the automaticSelection prop, we now prevent automatic selection from ocurring if the input value hasn't changed since focusing the field


Mar 10, 2020

Hide webkit native clear field on search type inputs