Design
The Search Field is a flexible input component that lets users find specific content or information by entering free-text queries. It is a primary navigation and discovery tool, helping users bypass complex menu structures to find exact items, categories, or data points quickly. By supporting various states (collapsed, expanded) and brand-specific configurations (Toyota, Lexus), it ensures a consistent search experience across the entire ecosystem.
Anatomy
Section titled “Anatomy”- Search field
- Leading icon
- Input
- Clear
- Trailing icon
- Slot
When to use it
Section titled “When to use it”Use a search field when:
- Discovery is the goal. Users need to find information within a large, diverse, or unknown dataset (for example help articles, product catalogs, or global site search).
- The input is open-ended. Users may type keywords, phrases, or specific IDs rather than selecting from a list.
- The content is large or dynamic. The results are too numerous to be predefined or displayed in a simple list.
Use a searchable dropdown instead when:
- Selection is required. The user must pick a specific, valid value from a fixed, closed list (for example a country or currency).
- Data integrity matters. You need to prevent users from entering custom text that doesn’t match your database.
- The list is finite. The options are predefined, even if the list is long enough to require a filter.
Search field vs searchable dropdown vs dropdown
Section titled “Search field vs searchable dropdown vs dropdown”Search field
Use a search field when users need to find something in a large or unknown set of content.
What it is: a free-text input where users can type anything (keywords, phrases, IDs).
What happens: it shows results, filters content, or takes users directly to what they are looking for.
Use it when:
- The list of possible results is very large or not predefined.
- Users may not know the exact name of what they are searching for.
- The goal is discovery or navigation (for example products, files, help articles).
Searchable dropdown
Use a searchable dropdown when users must choose from a fixed list of options.
What it is: a dropdown with a built-in search to filter long lists.
What happens: users select one value from a predefined set.
Use it when:
- The options are known and limited to a closed list.
- Accuracy is important (users must pick a valid option).
- The list is long enough to need filtering (for example countries, departments, currencies).
Must the user select from a predefined, closed list?
If no, use a search field.
Are there more than 7–10 options in that list?
If no, use a dropdown or radio buttons.
Does the user know the name of what they are looking for beforehand?
If yes, use a searchable dropdown. If no, use a categorized dropdown or a modal or picker.
Properties
Section titled “Properties”Expansion
Toggle between Collapsed (icon only) and Expanded (full input).
Type
Contained has a background container. Divided has only a bottom divider.
Size
Small (44 px) and Large (56 px).
Scheme
Available in Neutral and Contrast to ensure accessibility across different backgrounds.
Icons
To meet the specific visual standards of Toyota and Lexus, the search icon and secondary elements are fully customizable. The search icon can be placed on either the left (Toyota) or the right (Lexus). Lexus also supports a decorative icon on the left and a functional search icon on the right at the same time.
Clear
A clear (✕) icon button lets users clear their query once they start typing.
Slots
The component includes dedicated slots, allowing designers and developers to inject custom elements to meet specific functional needs beyond the standard configuration.
Text overflow
The text is limited to a single line. It must not wrap or increase the height of the component. An ellipsis shows that text continues beyond the visible area, and the clear button stays fixed on the right.
How to use slots
Section titled “How to use slots”- Select the component. Click on the component instance in your canvas that contains a slot.
- Access the slot property. Navigate to the Properties section in the right-hand panel. Find the Slot List property and click the + (plus) icon.
- Choose a replacement. After clicking the plus icon, the panel view will change. Click the + again to open a dropdown menu featuring Recommended Components.
- Swap the content. Select your desired component from the list to inject it into the slot.
- Refine and duplicate. Once the new component is inside the slot, you can duplicate it (if needed) and modify its specific properties directly from the panel.
Best practices
Section titled “Best practices”Do
Provide a clear placeholder (for example “Search for a model…”) to give users a hint of what they can find. Allow users to clear their query quickly using a clear (✕) icon button once they start typing.
Don't
Don’t use a search field if there are fewer than 7–10 items to choose from; a standard selection component is better. Don’t make the search field too short; ensure it is wide enough to display typical search queries without cutting off text.