IconLogoMark
IconUiExpandCollapseDown

Release NotesIconUiExpandCollapseDown

ComponentsIconUiExpandCollapseDown

AvatarsIconUiExpandCollapseDown
ButtonsIconUiExpandCollapseDown
Data VisualizationIconUiExpandCollapseDown
DialogsIconUiExpandCollapseDown
IconsIconUiExpandCollapseDown
ModulesIconUiExpandCollapseDown
NotificationsIconUiExpandCollapseDown
ThemesIconUiExpandCollapseDown
TypeIconUiExpandCollapseDown

GuidelinesIconUiExpandCollapseDown

PatternsIconUiExpandCollapseDown

WordsIconUiExpandCollapseDown

ResourcesIconUiExpandCollapseDown

Search Input

/

Design

Help users find content they're looking for.

Search inputs find relevant information through a word or phrase. They can be used to find content without navigation, or to filter existing content into something more specific.

IconWarning
Version 5+
If using Uniform Version 5 or later, please refer to our Storybook docs for the Search Input documentation and examples.

Size

Size should be determined by the amount of white space in the interface the search input will be used in.

IconSearch

X-Small: Rarely used, but helpful in dense interfaces with constraints.

Mobile

Stick to using native components when designing search for mobile and display the results in table or list views.

Usage

Labels

Labels are mandatory on all fields, but they don’t always have to be visible. This is especially true for search, so make use of hidden labels as they make a difference in accessibility.

Layout

Search should appear only once in an interface and relate to the content it’s presented with.

Don't exclude search from the context of the interface.

Don'texclude search from the context of the interface.

Do keep search relevant to the user’s workflow.

Dokeep search relevant to the user’s workflow.

Results

Results should always relate to the information input by the user and never take them out of context. If a basketball team is searching for opponents in the area, results shouldn’t return all opponents in every sport.

Don't ignore key words used and return irrelevant information.

Don'tignore key words used and return irrelevant information.

Do treat search as a way to discover content.

Dotreat search as a way to discover content.

Microcopy

Placeholders

Placeholders are required and should use verbs to suggest what the results will return.

Don't use placeholders in place of hidden labels.

Don'tuse placeholders in place of hidden labels.

Do provide instruction with an appropriate action.

Doprovide instruction with an appropriate action.

They should follow non-label text guidelines, but don’t put punctuation at the end.

Accessibility

Audit Results

See our full accessibility audit for more information about these results.

PlatformVisualInteractiveAutomatedDetails
ReactIconCritical ViolationIconConfirmation PassIconConfirmation Pass
  • IconCriticalForm element placeholder text color does not meet 4.5:1 color contrast ratio.
React NativeIconCritical ViolationIconWarning WarningIconWarning N/A
  • IconCriticalForm element placeholder text color does not meet 4.5:1 color contrast ratio.
  • IconWarningAt least one variation of this component does not meet the 44px touch target standard. (AAA)

Platform

platformnotes
Web
  • Stick to the guidelines above.
Apple
  • Stick to the guidelines above.
Android
  • Stick to the guidelines above.