Skip to content

Доступность и локализация

Клавиатура

Canvas чарта фокусируем (Tab); в фокусе:

КлавишаДействие
/ следующая/предыдущая точка первой видимой серии (подсветка)
Escсброс подсветки

Контейнер получает role="img" и aria-label из title.text; подсвеченная точка анонсируется скринридерам через скрытый aria-live-регион.

Локализация

Встроенные строки переопределяются через locale.localeText:

ts
Charts.create({
  ...,
  locale: {
    localeText: {
      loading: 'Loading…',
      noData: 'No data to display',
      downloadPng: 'Download PNG',
      resetZoom: 'Reset zoom',
    },
  },
});

Ключи: loading, noData, renderError (оверлеи), downloadPng, resetZoom (контекстное меню). Тексты осей и легенды приходят из ваших данных и formatter-ов, поэтому отдельной локализации не требуют — как и большинство подсказок.

Исключение — подсказка, которая разбирает величину на части: части ей приходится называть самой, и это уже слова библиотеки, а не ваши. Они тоже ключи:

СерияКлючиПо умолчанию
каскадwaterfallTotal, waterfallCumulativeTotal, Cumulative
ящик с усамиboxPlotMax, boxPlotQ3, boxPlotMedian, boxPlotQ1, boxPlotMinmax, q3, median, q1, min
свечи, OHLCohlcOpen, ohlcHigh, ohlcLow, ohlcCloseO, H, L, C
гистограмма по календарным корзинамquarterQ
ts
locale: {
  localeText: {
    waterfallTotal: 'Итог',
    waterfallCumulative: 'Накопленный итог',
    boxPlotMedian: 'Медиана',
  },
},

tooltip.renderer пишет подсказку целиком и ни одному ключу не подчиняется.

Опции

ОпцияТипОписание
locale.localeTextPartial<Record<LocaleKey, string>>переопределение строк UI

Ключи LocaleKey: loading, noData, downloadPng, resetZoom и ключи подсказок выше — значения по умолчанию лежат в DEFAULT_LOCALE.

Клавиатура (включена всегда): стрелки — перемещение подсветки по точкам серии, Escape — сброс подсветки и зума. Состояние анонсируется через ARIA live-region.