[Doc] Добавить в документации отдельных компонентов пункты о доступности

[eugpoloz]

Описание

В рамках этой задачи надо:

• напилить специальный milestone, например, "Документация по доступности компонентов"
• составить список компонентов, для которых нужно расписать доступность
  • для "сложных" компонентов — сразу упоминать пункт о доступности (см. [Enhancement] Улучшить доступность Search #2531)
• и завести для каждого неохваченного компонента отдельную задачку

Чеклист

#3337 – пример хорошего PR с внедрением доступности, на который можно равняться

• Компонент соответствует требованиям a11y.
• Написаны unit тесты на кейсы связанные с a11y.
• В Readme.md компонента есть раздел Доступность

  Пример 1. https://vkcom.github.io/VKUI/5.0.3/#/Tabs
  Пример 2. https://mui.com/material-ui/react-text-field/#accessibility.

---

Draft идеи про отедльный файл по доступности

Я бы попробовала делать доку по доступности отдельным файлом (например, Readme.a11y.md) и импортить его в "основную" доку, как советуют тут:

import * as React from "react";
import { HasRootRef } from "../../types";
import "./Div.css";

export interface DivProps
  extends React.HTMLAttributes<HTMLDivElement>,
    HasRootRef<HTMLDivElement> {}

/**
 * @see https://vkcom.github.io/VKUI/#/Div
 *
 * Доступность компонента:
 * @example ./Readme.a11y.md
 */
export const Div = ({ children, getRootRef, ...restProps }: DivProps) => {
  return (
    <div {...restProps} ref={getRootRef} vkuiClass="Div">
      {children}
    </div>
  );
};

Правда, сходу у меня такое не завелось и файл не подтянулся. 🤣