accessibility · maxtrigify — правило для Claude Code: что делает и как установить
Правило accessibility для Claude Code задаёт стандарты доступности интерфейсов. Включается при верстке компонентов, форм и навигационных меню по WCAG.
Apache-2.0 ★ 141 обновлён 2026-11-17
.claude/rules/accessibility.mdЧто делает accessibility
Правило заставляет агента выбирать семантический HTML вместо обёрток из div, реализовывать управление с клавиатуры и заполнять атрибуты ARIA. Внутри зафиксированы структуры для диалогов, выпадающих списков и вкладок.
Текст запрещает вешать aria-hidden="true" на интерактивные узлы, требует постоянные текстовые метки через <label> вместо исчезающих плейсхолдеров и задаёт контрастность текста от 4.5:1. Для мобильных интерфейсов указан минимальный размер сенсорной зоны 44x44 пикселя.
Какие задачи решает
- заменить несемантические теги на нативные элементы интерфейса
- настроить клавиатурную навигацию со стрелками и клавишей Escape
- связать поля ввода с постоянными текстовыми подписями
- добавить ARIA-роли и оповещения через живые регионы
Примеры запросов агенту
- Сверстай модальное окно с навигацией по Tab и закрытием по клавише Escape
- Проверь контрастность цветов и размер кнопок на мобильных экранах
- Добавь текстовые подписи и статус ошибки для формы ввода
Как установить accessibility
Вручную: положить файлы
.claude/rules/accessibility.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/accessibility.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/accessibility.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/accessibility.mdВручную: положить файлы
.clinerules/accessibility.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об accessibility
Как установить accessibility в Claude Code?
Сохраните файл правила в репозитории по пути .claude/rules/accessibility.md.
Что делает accessibility?
Направляет помощника на соблюдение требований доступности: использование нативных тегов, разметку ARIA, навигацию с клавиатуры и сохранение видимого фокуса.
Какие размеры сенсорных зон требует правило accessibility?
Для интерактивных элементов на мобильных экранах задаётся минимальная высота и ширина 44x44 пикселя.
Исходный текст
accessibility.md · Apache-2.0
---
title: Accessibility Guidelines
impact: CRITICAL
impactDescription: Essential for inclusive component design
tags: accessibility, a11y, aria, keyboard, screen-reader, focus, wcag
---
## Accessibility Guidelines
Accessibility (a11y) is not optional—it's a fundamental requirement. Every component must be usable by everyone, including people with visual, motor, auditory, or cognitive disabilities.
### Core Principles
#### 1. Semantic HTML First
Always start with the most appropriate HTML element:
**Incorrect (generic div):**
```tsx
<div onClick={handleClick} className="button">
Click me
</div>
```
**Correct (semantic element):**
```tsx
<button onClick={handleClick}>Click me</button>
```
#### 2. Keyboard Navigation
Every interactive element must be keyboard accessible:
```tsx
function Menu() {
const handleKeyDown = (e: React.KeyboardEvent) => {
switch (e.key) {
case "ArrowDown":
focusNextItem();
break;
case "ArrowUp":
focusPreviousItem();
break;
case "Home":
focusFirstItem();
break;
case "End":
focusLastItem();
break;
case "Escape":
closeMenu();
break;
}
};
return (
<div role="menu" onKeyDown={handleKeyDown}>
{/* items */}
</div>
);
}
```
#### 3. Screen Reader Support
Use ARIA attributes when necessary:
```tsx
<nav aria-label="Main navigation">
<ul>
<li><a href="/" aria-current="page">Home</a></li>
</ul>
</nav>
<div aria-live="polite" aria-atomic="true">
{isLoading && <span>Loading results...</span>}
</div>
```
#### 4. Visual Accessibility
Support users with visual impairments:
```css
/* Visible focus indicators */
button:focus-visible {
outline: 2px solid var(--color-focus);
outline-offset: 2px;
}
/* Sufficient color contrast (4.5:1 for normal text) */
.text {
color: #333;
background: white;
}
```
### ARIA Rules
1. **Don't use ARIA if you can use semantic HTML**
2. **Don't change native semantics unless necessary**
3. **All interactive elements must be keyboard accessible**
4. **Don't hide focusable elements** - Never use `aria-hidden="true"` on focusable elements
5. **All interactive elements must have accessible names**
### Component Patterns
#### Modal/Dialog
```tsx
function Modal({ isOpen, onClose, children }) {
return isOpen ? (
<div role="dialog" aria-modal="true" aria-labelledby="modal-title">
<button onClick={onClose} aria-label="Close dialog">
×
</button>
{children}
</div>
) : null;
}
```
#### Dropdown Menu
```tsx
<button
aria-haspopup="true"
aria-expanded={isOpen}
aria-controls="dropdown-menu"
>
Menu
</button>;
{
isOpen && (
<ul id="dropdown-menu" role="menu">
<li role="menuitem" tabIndex={-1}>
Item 1
</li>
</ul>
);
}
```
#### Tabs
```tsx
<div role="tablist" aria-label="Tabs">
<button role="tab" aria-selected={activeTab === 0} aria-controls="panel-0">Tab 1</button>
</div>
<div id="panel-0" role="tabpanel" aria-labelledby="tab-0">{/* content */}</div>
```
### Focus Management
```css
/* Show outline only for keyboard focus */
*:focus-visible {
outline: 2px solid var(--color-focus);
outline-offset: 2px;
}
```
### Live Regions
```tsx
// Polite announcement
<div role="status" aria-live="polite">{savedMessage && "Saved"}</div>
// Assertive announcement
<div role="alert" aria-live="assertive">{errorMessage}</div>
```
### Common Pitfalls
**Placeholder as labels:**
```tsx
// ❌ Placeholder disappears
<input placeholder="Email address" />
// ✅ Persistent label
<label>Email address <input type="email" /></label>
```
**Empty buttons:**
```tsx
// ❌ No accessible name
<button><TrashIcon /></button>
// ✅ Screen reader text
<button aria-label="Delete item"><TrashIcon aria-hidden="true" /></button>
```
**Disabled elements:**
```tsx
// ✅ Use aria-disabled and explain
<button
aria-disabled={!isValid}
aria-describedby="submit-help"
onClick={isValid ? handleSubmit : undefined}
>Submit</button>
<span id="submit-help">{!isValid && 'Fill required fields'}</span>
```
### Mobile Accessibility
```css
/* Minimum 44x44px touch targets */
.button {
min-height: 44px;
min-width: 44px;
}
```
```html
<!-- Allow zooming -->
<meta name="viewport" content="width=device-width, initial-scale=1" />
```
© maxtrigify · Apache-2.0 · maxtrigify/Otto
Похожие правила IDE
Все правила IDE по теме «Фронтенд и UI» →Сначала — accessibility от других авторов.