04.37 · Micro-Interactions

Expanding Search

A search icon opens into a field, then closes when done. Best for toolbars.

Click it

Click or tap the search icon and type, then close it with Escape, × or a click outside, or press Show me.

Acme

Try it

Change a setting, then try it again or press Show me.

Opens toward

Which way the field grows out of the icon.

Speed

How quickly the field opens and closes.

Off keeps it open until Escape or the close button.

Copy the prompt

Paste it into an AI assistant such as ChatGPT, Claude or Cursor to build this in your own project.

Add an expanding search to [the toolbar or header where search should sit]. Show only a search icon until it is pressed; then open a search field out of the icon, over the items beside it, and put the text cursor in it. Reveal the field with a clip or a scale from the icon's side, never by animating its width, so nothing around it moves. Escape or a close button closes it and gives the focus back to the icon, and a closed field stays out of the Tab order. Make the icon a real button with a label. If the visitor has reduced motion turned on, open and close it at once. Match the settings listed below.

Replace the words in brackets with your own element. Your settings are added at the end.

Free and open source. If this helped, a star on GitHub helps other people find it.

Star on GitHub

What it is

The full explanation is in README.md.

Good for

  • Toolbars
  • Mobile headers
  • Docs sites
  • Dashboards

Avoid on

  • Sites where search comes first