# Interaction State

Interaction states describe a control's current condition, such as default, hover, focus, pressed, selected, disabled, loading, or invalid.

- Type: framework
- Domain: Experience & interface
- Level: Foundational
- Last reviewed: 2026-09-24
- Original: [Soroush’s Product Wiki](<https://wiki.soroush.uk/topic/interaction-state/>)

## What it means

An interaction-state model specifies how a component looks, behaves, and is exposed programmatically as user input and system conditions change. States can coexist: a selected item may also be focused, hovered, or disabled. State is distinct from a temporary transition animation.

## Why it matters

Explicit state models make feedback consistent across design and code, reveal missing edge cases, and help users understand what can be acted on and what changed. They also keep visual appearance aligned with semantic state for assistive technologies.

## When to use it

Define states for every interactive component and any system condition that changes availability, validity, selection, or progress. Keep the model proportional for simple native controls, and document combinations carefully for reusable design-system components.

## How it works

1. List user and system events that can change the component's condition.
2. Define mutually exclusive states and combinations such as selected plus focused.
3. Specify behavior, visible cues, content, semantics, and transitions for each relevant state.
4. Avoid disabling controls when an explanation and recoverable action would serve users better.
5. Test state changes across keyboard, pointer, touch, assistive technology, errors, latency, and high contrast.

## A practical example

A Save button has default, hover, visible focus, pressed, submitting, success, and error states. During submission it remains labeled, exposes busy status, and prevents duplicate activation; failure restores actionability and connects the error to a recovery step.

## Where it breaks

State matrices grow quickly, and documenting every theoretical combination can obscure the meaningful ones. Visual specifications cannot replace native semantics or behavioral tests, and disabled states often conceal why an action is unavailable.

## Common mistakes

- Designing only default and hover states.
- Treating focus, selection, hover, and pressed as interchangeable.
- Communicating state with color alone.
- Showing a visual state that is not exposed programmatically.

## Visualization

[View the visualization on the website](<https://wiki.soroush.uk/topic/interaction-state/#visualization-interaction-state>)

## Sources

1. [Developing a Keyboard Interface](<https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/>) — W3C Web Accessibility Initiative · Technical guidance
2. [WAI-ARIA 1.2](<https://www.w3.org/TR/wai-aria-1.2/>) — World Wide Web Consortium · Standard

## Related topics

- [Interaction Design](<https://wiki.soroush.uk/topic/interaction-design/>)
- [Design System](<https://wiki.soroush.uk/topic/design-system/>)
- [Focus Management](<https://wiki.soroush.uk/topic/focus-management/>)
