bestdeejay-design/agent-skills / skills/mobile-frontend
mobile-frontend
VerifiedComposite skill for quality mobile-first frontend — codified rules (spacing, type scale, anchors, safe-area, tap-targets), build, and multi-level verification with per-element menu/nav debugging.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.3 KB |
| readme.ru.md | markdown | 1.8 KB |
| references/debug-menu-nav.md | markdown | 4.8 KB |
| references/mobile-checklist.md | markdown | 3.5 KB |
| references/tokens.md | markdown | 3.3 KB |
| skill.json | config | 1.9 KB |
references/debug-menu-nav.md
View on GitHub# Debug: Menu & Navigation
Самый частый источник мобильных багов. Проигрыш симптом → причина → фикс.
## 1. Меню не открывается / не закрывается по тапу
**Симптом:** тап по гамбургеру ничего не делает или меню «залипает».
**Причины и фиксы:**
- Обработчик навешен на невидимый элемент (оверлей перекрывает кнопку). Проверьте,
что `z-index` кнопки выше оверлея, а оверлей `pointer-events:none` когда скрыт.
- `aria-expanded` есть, но класс видимости не переключается. Держите одну функцию
`setMenu(open)`, которая атомарно меняет и класс, и `aria-expanded`, и `inert` на фоне.
- Кнопка < 44px и «не попадает» под палец — увеличьте tap-target.
```js
function setMenu(open){
menu.classList.toggle('is-open', open);
btn.setAttribute('aria-expanded', String(open));
document.body.classList.toggle('menu-open', open);
backdrop.toggleAttribute('inert', !open);
}
btn.addEventListener('click', () => setMenu(!menu.classList.contains('is-open')));
```
## 2. Меню не закрывается при выборе пункта
**Причина:** ссылки внутри не вызывают `setMenu(false)`.
**Фикс:** делегируйте клик по пунктам:
```js
menu.addEventListener('click', (e) => {
if (e.target.closest('a')) setMenu(false);
});
```
## 3. Фокус уходит из меню / ловушка не работает
**Симптом:** при `Tab` фокус проваливается на фон (за меню) или теряется.
**Фикс — фокус-ловушка в открытом меню:**
```js
const focusable = () => menu.querySelectorAll('a[href],button:not([disabled])');
menu.addEventListener('keydown', (e) => {
if (e.key !== 'Tab') return;
const f = [...focusable()]; if (!f.length) return;
const first = f[0], last = f[f.length-1];
if (e.shiftKey && document.activeElement === first){ e.preventDefault(); last.focus(); }
else if (!e.shiftKey && document.activeElement === last){ e.preventDefault(); first.focus(); }
});
```
## 4. Esc не закрывает
```js
document.addEventListener('keydown', (e) => { if (e.key === 'Escape' && menu.classList.contains('is-open')) setMenu(false); });
```
## 5. Якоря упираются в фиксированную шапку
**Симптом:** переход по `#section` прячет заголовок секции под sticky-хедером.
**Фикс:** `scroll-margin-top` (см. tokens.md) + не забыть `scroll-behavior: smooth`.
Для SPA-роутера — компенсировать скролл вручную: `window.scrollTo(0, y - headerH - 16)`.
## 6. z-index стекинг: меню под контентом или над модалкой
**Правило слоёв:**
```
фон контента 10
sticky шапка 100
оверлей меню 200
панель меню 210
модалка/тост 1000+
```
Не используйте `9999` «на всякий случай» — это ломает модалки.
## 7. Меню скрыто за home-indicator (safe-area)
**Симптом:** нижние пункты меню упираются в индикатор на iPhone.
**Фикс:** `padding-bottom: calc(var(--space-3) + env(safe-area-inset-bottom))` на меню/таббаре.
## 8. Анимация меню вызывает «прыжок» CLS
**Причина:** меню в потоке (push-content) меняет высоту при открытии.
**Фикс:** меню позиционируйте `position: fixed` (оверлей), не сдвигайте контент.
Или анимируйте `transform`, а не `height`/`margin`.
## 9. Трансформ ломает `position: fixed` внутри меню
**Симптом:** дочерний `fixed` элемент позиционируется относительно меню, а не вьюпорта.
**Причина:** предок с `transform`/`filter`/`will-change` создаёт containing block.
**Фикс:** уберите `transform` с предка меню или вынесите fixed-элемент наружу.
## Быстрая проверка (Playwright)
```js
// открыто ли меню по aria-expanded
const expanded = await page.getAttribute('#menuBtn', 'aria-expanded');
// клик по пункту закрывает
await page.click('#menu a[href="#about"]');
const stillOpen = await page.getAttribute('#menuBtn', 'aria-expanded');
// должно стать "false"
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |