States checklist
Дизайнеры рисуют «успешное» состояние и забывают остальные. 80% пользовательского опыта живёт в нестандартных состояниях.
Минимальный набор для любого экрана с данными
| Состояние |
Когда показать |
Что должно быть |
| Loading |
Данные ещё не пришли |
Skeleton (не спиннер), не блокировать UI |
| Empty (cold) |
Никогда не было данных (новый юзер) |
Объяснение + onboarding-кнопка |
| Empty (clean) |
Данные были, сейчас 0 (всё прочитано / выполнено) |
Похвала + нейтральная иллюстрация |
| Empty (filtered) |
Применён фильтр, под него ничего нет |
«Очистить фильтр» |
| Error (network) |
Запрос упал |
«Не удалось загрузить» + Retry |
| Error (forbidden) |
403 |
Что произошло + куда пойти |
| Error (not found) |
404 на конкретный ресурс |
Ссылка на список |
| Partial |
Загрузилась часть |
Показать что есть + индикатор «загружается ещё» |
| Stale |
Данные устарели |
«Обновить» + timestamp |
| Offline |
Сеть пропала |
Баннер + что доступно офлайн |
Минимальный набор для форм
- Default (пустая, до фокуса)
- Focused (поле в фокусе)
- Filled (введено)
- Validating (асинхронная проверка)
- Error (с конкретным сообщением)
- Success (после отправки)
- Disabled
- Read-only (если применимо)
Минимальный набор для кнопок
- Default
- Hover
- Active (нажата)
- Focus-visible
- Disabled
- Loading (асинхронное действие)
- Success-flash (200ms после успеха)
Чек-лист (использовать как linter перед сдачей)
Для каждого экрана прототипа:
Шаблоны компонентов
templates/states.html — готовая страница с примерами всех состояний для копирования.
<!-- Skeleton -->
<div class="skeleton">
<div class="line w-3/4"></div>
<div class="line w-1/2"></div>
<div class="line w-2/3"></div>
</div>
<!-- Empty (cold) -->
<div class="empty">
<div class="empty-icon"><!-- placeholder --></div>
<h2>Здесь будут ваши проекты</h2>
<p>Начните с создания первого проекта.</p>
<button>Создать проект</button>
</div>
<!-- Error -->
<div class="error" role="alert">
<h3>Не удалось загрузить</h3>
<p>Проверьте подключение и повторите.</p>
<button>Повторить</button>
<button class="secondary">Подробности</button>
</div>
CSS skeleton-анимации:
.skeleton .line {
height: 12px; border-radius: 6px;
background: linear-gradient(90deg, #eee 0%, #f5f5f5 50%, #eee 100%);
background-size: 200% 100%;
animation: shimmer 1.4s infinite;
}
@keyframes shimmer {
0% { background-position: 200% 0; }
100% { background-position: -200% 0; }
}
@media (prefers-reduced-motion) {
.skeleton .line { animation: none; background: #eee; }
}
Правила
- Skeleton, не спиннер, на загрузке списков и страниц. Спиннер — только для action-кнопок (200ms-3s).
- Не показывай loading младше 200ms — мерцание раздражает. Дебаунс.
- После 5 секунд — добавь «занимает дольше обычного» сообщение.
- Empty-state не должен быть пустым — это тоже экран, заполни смыслом.
- Error-сообщения — конкретны, без «Произошла ошибка».
Legacy reference
Прежняя расширенная версия скилла (дерево @2026-04-30) сохранена целиком в references/legacy-states-checklist.md. Секции там: 8 обязательных состояний, Чеклист на экран, Empty state design, Error state design, Loading state — когда что показывать, Disabled vs read-only vs locked, Куда сложить варианты состояний, Антипаттерны.
1---2name: states-checklist3version: 1.0.04description: "Чек-лист состояний экрана перед сдачей прототипа: empty, loading, error, partial, success. Триггеры: «happy path только», «8 состояний UI»."5metadata:6 source: https://skillmd.com/skills/jhamidun/states-checklist7---89# States checklist1011Дизайнеры рисуют «успешное» состояние и забывают остальные. **80% пользовательского опыта живёт в нестандартных состояниях.**1213## Минимальный набор для любого экрана с данными1415| Состояние | Когда показать | Что должно быть |16|---|---|---|17| **Loading** | Данные ещё не пришли | Skeleton (не спиннер), не блокировать UI |18| **Empty (cold)** | Никогда не было данных (новый юзер) | Объяснение + onboarding-кнопка |19| **Empty (clean)** | Данные были, сейчас 0 (всё прочитано / выполнено) | Похвала + нейтральная иллюстрация |20| **Empty (filtered)** | Применён фильтр, под него ничего нет | «Очистить фильтр» |21| **Error (network)** | Запрос упал | «Не удалось загрузить» + Retry |22| **Error (forbidden)** | 403 | Что произошло + куда пойти |23| **Error (not found)** | 404 на конкретный ресурс | Ссылка на список |24| **Partial** | Загрузилась часть | Показать что есть + индикатор «загружается ещё» |25| **Stale** | Данные устарели | «Обновить» + timestamp |26| **Offline** | Сеть пропала | Баннер + что доступно офлайн |2728## Минимальный набор для форм2930- Default (пустая, до фокуса)31- Focused (поле в фокусе)32- Filled (введено)33- Validating (асинхронная проверка)34- Error (с конкретным сообщением)35- Success (после отправки)36- Disabled37- Read-only (если применимо)3839## Минимальный набор для кнопок4041- Default42- Hover43- Active (нажата)44- Focus-visible45- Disabled46- Loading (асинхронное действие)47- Success-flash (200ms после успеха)4849## Чек-лист (использовать как linter перед сдачей)5051Для каждого экрана прототипа:52- [ ] Что видит юзер, который только что зарегистрировался (cold empty)?53- [ ] Что видит, если очистил всё / выполнил всё (clean empty)?54- [ ] Что видит, если выключил wifi на 3 секунды (loading + error)?55- [ ] Что видит, если ввёл неправильные данные в форму?56- [ ] Что видит, если кликнул на ссылку, которая ведёт в удалённый объект?57- [ ] Что видит на slow-3g (skeleton нужен)?58- [ ] Что видит, если у него отключены картинки (alt-текст осмыслен)?5960## Шаблоны компонентов6162`templates/states.html` — готовая страница с примерами всех состояний для копирования.6364```html65<!-- Skeleton -->66<div class="skeleton">67 <div class="line w-3/4"></div>68 <div class="line w-1/2"></div>69 <div class="line w-2/3"></div>70</div>7172<!-- Empty (cold) -->73<div class="empty">74 <div class="empty-icon"><!-- placeholder --></div>75 <h2>Здесь будут ваши проекты</h2>76 <p>Начните с создания первого проекта.</p>77 <button>Создать проект</button>78</div>7980<!-- Error -->81<div class="error" role="alert">82 <h3>Не удалось загрузить</h3>83 <p>Проверьте подключение и повторите.</p>84 <button>Повторить</button>85 <button class="secondary">Подробности</button>86</div>87```8889CSS skeleton-анимации:9091```css92.skeleton .line {93 height: 12px; border-radius: 6px;94 background: linear-gradient(90deg, #eee 0%, #f5f5f5 50%, #eee 100%);95 background-size: 200% 100%;96 animation: shimmer 1.4s infinite;97}98@keyframes shimmer {99 0% { background-position: 200% 0; }100 100% { background-position: -200% 0; }101}102@media (prefers-reduced-motion) {103 .skeleton .line { animation: none; background: #eee; }104}105```106107## Правила108109- **Skeleton, не спиннер**, на загрузке списков и страниц. Спиннер — только для action-кнопок (200ms-3s).110- **Не показывай loading младше 200ms** — мерцание раздражает. Дебаунс.111- **После 5 секунд** — добавь «занимает дольше обычного» сообщение.112- **Empty-state не должен быть пустым** — это тоже экран, заполни смыслом.113- **Error-сообщения — конкретны**, без «Произошла ошибка».114115## Legacy reference116117Прежняя расширенная версия скилла (дерево @2026-04-30) сохранена целиком в `references/legacy-states-checklist.md`. Секции там: 8 обязательных состояний, Чеклист на экран, Empty state design, Error state design, Loading state — когда что показывать, Disabled vs read-only vs locked, Куда сложить варианты состояний, Антипаттерны.