К основному содержанию
правило CX Codex

accessibility · maxtrigify — правило для Claude Code: что делает и как установить

Правило accessibility для Claude Code задаёт стандарты доступности интерфейсов. Включается при верстке компонентов, форм и навигационных меню по WCAG.

Apache-2.0 ★ 141 обновлён 2026-11-17

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/accessibility.md
Открыть на GitHub

Что делает 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 и 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 от других авторов.

accessibility Thientan Soparat Правило accessibility проверяет интерактивные элементы по базовым требованиям доступности. Нужен при аудите интерфейса и перед завершением UI-компонента. CX Codex +1 ★ 3 216звёзд репо tailwindcss-accessibility JosiahSiegel Скилл tailwindcss-accessibility для Claude Code помогает создавать доступные интерфейсы на Tailwind CSS. Активируется при работе с WCAG, фокусом, контрастом и ARIA. CX Codex +1 302установок accessibility-auditor OneWave-AI Скилл accessibility-auditor проводит аудит доступности веб-страниц по стандартам WCAG 2.1 AA. Он находит дефекты вёрстки, проверяет навигацию с клавиатуры и помогает исправить разметку. CX Codex +1 346установок accessibility-a11y travisjneuman Скилл accessibility-a11y для Claude Code и Codex помогает внедрять стандарты WCAG 2.2 и проверять интерфейсы на доступность. Включается при создании UI-компонентов, аудите вёрстки или интеграции тестов в CI/CD. CX Codex +1 161установок accessibility-wcag rohitg00 Скилл accessibility-wcag для Claude Code собирает шаблоны WCAG 2.2 для настройки семантической вёрстки, ARIA-атрибутов, управления с клавиатуры и контрастности. CX Codex +1 ★ 2 858звёзд репо accessibility-compliance aj-geddes Скилл accessibility-compliance помогает внедрять требования WCAG 2.1/2.2, клавиатурную навигацию и поддержку программ чтения с экрана. CX Codex +1 490установок better-accessibility jakubkrehel Скилл better-accessibility для Claude Code проверяет интерфейс по стандарту WCAG 2.2 и правит фокус, клавиатурную навигацию, формы и разметку ARIA под экранные дикторы. CX Codex +1 39 300установок

Из того же набора18

Весь набор →
principles Правило principles для Claude Code, Codex, Cursor, GitHub Copilot, Windsurf и Cline задаёт шесть критериев проектирования компонентов для оценки кода, рефакторинга и создания интерфейсов. CX Codex +1 ★ 141звёзд репо as-child Правило as-child для Claude Code объединяет свойства и обработчики компонента с дочерним элементом без лишней DOM-обёртки. Подключается при создании составных React-компонентов и trigger-элементов. CX Codex +1 ★ 141звёзд репо documentation Правило documentation для Claude Code задаёт единый стандарт описания компонентов интерфейса. Ассистент оформляет справку со свойствами, примерами и требованиями доступности. CX Codex +1 ★ 141звёзд репо state Правило state для Claude Code задаёт паттерны управляемого и неуправляемого состояния React-компонентов. Оно включается при проектировании API компонентов. CX Codex +1 ★ 141звёзд репо polymorphism Правило polymorphism для Claude Code задаёт полиморфные React-компоненты с единым стилем и поведением. HTML-элемент меняется через проп as. CX Codex +1 ★ 141звёзд репо styling Правило styling для Claude Code задаёт стандарты вёрстки компонентов на Tailwind CSS. Направляет агента объединять классы через tailwind-merge, clsx и CVA. CX Codex +1 ★ 141звёзд репо definitions Правило definitions для Claude Code классифицирует UI-артефакты и задаёт точные названия для компонентов, блоков, шаблонов и паттернов. CX Codex +1 ★ 141звёзд репо components-build Скилл components-build для Claude Code помогает создавать, проверять и перерабатывать переиспользуемые компоненты React по спецификации components.build. Он подключается к задачам об API компонентов, доступности, стилях и типах TypeScript. CX Codex +1 ★ 141звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой