From visual clue to behavior contract
How to identify a UI element you can’t name
A component name is useful only when it leads to the correct interaction, focus, keyboard, dismissal, and mobile behavior.
01
Describe observable evidence
Start with what opens the interface, where it appears, whether the page behind it remains usable, what content it contains, and how it closes. You do not need to know the component name. A concrete behavior such as “a card opens on focus and contains a link” is more useful than a visual label such as “small popup.”
02
Compare nearby alternatives
The diagnostic keeps two or three plausible candidates instead of pretending the first keyword match is correct. It then asks only questions that can change the result. This matters because Tooltip, Popover, and Hover Card may share a floating shape while requiring different interactivity and persistence rules.
03
Copy a testable brief
The final output turns the selected pattern into an implementation contract. It records trigger, dismissal, modality, focus, keyboard behavior, placement, mobile behavior, excluded alternatives, and observable acceptance checks. Give that brief to a coding agent, then test the result instead of trusting the label alone.
Need a manual process first? Read the step-by-step guide to identifying an unnamed UI pattern.
Use the right level of language
UI element, UI component, or UI pattern?
These terms describe different levels of the same interface. Start with the UI element you can observe, move to the component a developer can build, then confirm the pattern whose behavior matches the task.
01
UI element
The broadest user-facing term for something visible or interactive, such as a field, button, panel, icon, or floating surface. Use it when you can describe the thing but cannot name it yet.
02
UI component
A reusable implementation unit in a design system or codebase. A component may expose several states and behaviors, and its library name does not always identify the underlying interaction correctly.
03
UI pattern
A repeatable solution to an interface problem. The pattern connects the visible form to expected behavior, including trigger, focus, keyboard support, dismissal, placement, and mobile adaptation.