Skip to content
Design System
GitHub

Localisation

Every word a component shows or says to a screen reader can be replaced from outside, and numbers, days and times follow the locale you pass. No i18n library: your app hands the kit its words.

Why labels and locale

The kit ships in English; a product may need another language, such as Traditional Chinese. A component is only translated when all of it is: the button text, the empty message, and the names only a screen reader hears (Clear, Select row, Picked up Dock A. Position 2 of 5.). Editing the installed source would be lost on the next npx shadcn add --overwrite, so every one of these words comes in through a prop.

Numbers, days and times are words too. A count of 12,345 is written 12.345 in German; 3 November 2026 is 2026年11月3日 in Taiwan. Components that write a number, a day or a time themselves take locale and format with the browser's Intl, so nothing is added to your bundle.

The pattern

Each component that says words exports a <Name>Labels type and its English default<Name>Labels, and takes labels, a partial: pass only the keys you change. A word that contains a number or a name is a function, so each language can put it where its grammar wants it.

registry/syncrobotic/ui/spinner.tsx
// The kit's own pattern, in every component that says words (here, Spinner).
export type SpinnerLabels = {
  /** The spinner's name for screen readers. */
  loading: string
}

// The English words, exported: spread them to change one or two.
export const defaultSpinnerLabels: SpinnerLabels = { loading: "Loading" }

export function Spinner({ labels, ...props }: { labels?: Partial<SpinnerLabels> /* … */ }) {
  const l = { ...defaultSpinnerLabels, ...labels } // any key you leave out stays English
  // …
}
  • Leave labels out and nothing changes: the defaults are today's English words.
  • Older single props (label, placeholder, emptyText, closeLabel…) still work, and win over labels when both are given.
  • An aria-label you pass still names the element; labels fills in when there is none.
  • locale is a BCP 47 tag (zh-TW, en-GB, de). Left out, numbers use the browser's language as before; days, times and country names keep the kit's English form.
  • Text you pass as data (titles, options, column headers, presets) is already yours to translate; labels covers only the words the kit writes itself.

Traditional Chinese, ready-made

For a Taiwan console, install the kit's own Traditional Chinese words instead of writing them: labels-zh-tw exports one object per component that takes labels (dataGridLabels, stopButtonLabels, robotMapLabels…), and locale ("zh-TW"). The wording is Taiwan usage (檔案, 設定, 影片, 連線, 網路) with the kit's terms: 警報 for alarm, 急停 for emergency stop, 機器人, 任務. Words that hold a number or a unit stay functions, so counts, distances and durations are written as the English ones are.

Each object is typed with its component's labels type, so when an update adds a key the file stops compiling until it has the Chinese word. Spread one to change a word: { ...dataGridLabels, empty: "沒有符合的機器人" }.

Terminal
npx shadcn add @syncrobotic/labels-zh-tw
app/(app)/charging/charge-window.tsx
"use client"

import { StopButton } from "@/components/stop-button"
import { TimePicker } from "@/components/ui/time-picker"
import { locale, stopButtonLabels, timePickerLabels } from "@/lib/labels-zh-tw"

export function ChargeWindow({ start, onStart, onStop }: { start?: string; onStart: (t: string) => void; onStop: () => void }) {
  return (
    <>
      <StopButton labels={stopButtonLabels} onStop={onStop} />
      {/* The words come from the pack; with locale the trigger reads "上午9:30". */}
      <TimePicker aria-label="充電開始時間" value={start} onValueChange={onStart} hour12 locale={locale} labels={timePickerLabels} />
    </>
  )
}

A worked example: zh-TW

For another language, or for your own wording, keep the kit's words for each language in one file and pass them where the components are used. The objects are plain data, so a Server Component can pass the strings; a function label (a count) needs a client file, like any other function prop.

lib/kit-labels.zh-TW.ts
// lib/kit-labels.zh-TW.ts: the kit's words for the Taiwan console, in one place.
import type { DataGridLabels } from "@/components/ui/data-grid"
import type { DatePickerLabels } from "@/components/ui/date-selector"
import type { QuestionnaireLabels } from "@/components/ui/questionnaire"

export const locale = "zh-TW"

export const dataGrid: Partial<DataGridLabels> = {
  region: "機器人列表",
  empty: "沒有符合的機器人",
  resize: (column) => `調整「${column}」欄寬`,
  ascending: "遞增排序",
  descending: "遞減排序",
  hideColumn: "隱藏此欄",
  columns: "欄位",
  showColumns: "顯示欄位",
  selected: (count, total) => `已選取 ${count} / ${total}`,
  selectAll: "選取本頁全部",
  selectRow: "選取此列",
}

export const datePicker: Partial<DatePickerLabels> = { pickDay: "選擇日期", clear: "清除" }

export const questionnaire: Partial<QuestionnaireLabels> = {
  position: (n, total) => `第 ${n} 題,共 ${total} 題`,
  percent: (n) => `${n}%`,
  back: "上一題",
  next: "下一題",
  submit: "送出檢查表",
  required: "請回答這一題再繼續。",
  requiredMark: "(必填)",
}
app/(app)/service/service-log.tsx
"use client"

import { zhTW } from "react-day-picker/locale/zh-TW"
import { DataGrid, DataGridTable } from "@/components/ui/data-grid"
import { DatePicker } from "@/components/ui/date-selector"
import * as zh from "@/lib/kit-labels.zh-TW"

export function ServiceLog({ table }: { table: Parameters<typeof DataGrid>[0]["table"] }) {
  return (
    <>
      {/* The trigger reads "2026年11月3日"; the calendar names months and days in Chinese. */}
      <DatePicker aria-label="保養日期" locale={zh.locale} calendarLocale={zhTW} labels={zh.datePicker} clearable />
      <DataGrid table={table} labels={zh.dataGrid}>
        <DataGridTable />
      </DataGrid>
    </>
  )
}
With an i18n library
// With next-intl (or any i18n library you already use),
// build the same objects from your messages.
const t = useTranslations("kit.dataGrid")
const labels: Partial<DataGridLabels> = {
  empty: t("empty"),
  selected: (count, total) => t("selected", { count, total }),
}

Components that take locale

  • Prop
    locale
    What it formats
    Formats the counts (a BCP 47 tag such as "zh-TW"). Left out, the browser's language.
  • Prop
    locale
    What it formats
    Writes the day on the trigger in this language with Intl ("2026年11月3日" for "zh-TW"), unless displayFormat is given. Left out, the trigger reads "3 Nov 2026" as before. The calendar's month and day names follow calendarLocale.
  • Prop
    calendarLocale
    What it formats
    react-day-picker's locale for the calendar's month and day names and its labels: import { zhTW } from "react-day-picker/locale/zh-TW".
  • Prop
    locale
    What it formats
    Writes the day on the trigger in this language with Intl ("2026年11月3日" for "zh-TW"), unless displayFormat is given. Left out, the trigger reads "3 Nov 2026" as before. The calendar's month and day names follow calendarLocale.
  • Prop
    calendarLocale
    What it formats
    react-day-picker's locale for the calendar's month and day names and its labels: import { zhTW } from "react-day-picker/locale/zh-TW".
  • Prop
    locale
    What it formats
    Formats the options' counts (a BCP 47 tag such as "zh-TW"). Left out, the browser's language.
  • Prop
    locale
    What it formats
    BCP 47 tag for the numbers and the time ("zh-TW", "de"): pass the app's locale. Left out, numbers are written in English ("en") and the time on a 24-hour clock, the same on the server and in every browser, so the page hydrates cleanly. A tag Intl cannot read falls back to "en".
  • Prop
    locale
    What it formats
    Formats the numbers (a BCP 47 tag such as "zh-TW"). Left out, the browser's language.
  • Prop
    locale
    What it formats
    The language of the country names and their order (a BCP 47 tag such as "zh-TW"). English when left out.
  • Prop
    locale
    What it formats
    Formats the numbers and shares (a BCP 47 tag such as "zh-TW"). Left out, the browser's language.
  • Prop
    locale
    What it formats
    Writes the times as this language does (a BCP 47 tag such as "zh-TW"). Left out, "09:30" or "9:30 AM" as before.

Calendar takes react-day-picker's own locale and labels (import { zhTW } from "react-day-picker/locale/zh-TW", one module per language; react-day-picker/locale exports the same objects): month names, weekdays and its buttons follow it.

Every component's labels

44 components, each key with its English default and what it is. Functions receive the number or name to place in the sentence.

Alarm

  • critical
    English default
    "Critical"
  • high
    English default
    "High"
  • low
    English default
    "Low"
  • unacknowledged
    English default
    "Unacknowledged"
  • acknowledged
    English default
    "Acknowledged"Alone, or before acknowledgedAt: "Acknowledged 13:42".
  • cleared
    English default
    "Cleared, not acknowledged"Cleared before anyone acknowledged it, when clearedAt is not given.
  • clearedWhen
    English default
    (t) => `Cleared ${t}, not acknowledged`The same with the time it cleared: "Cleared 14:07, not acknowledged".
  • acknowledge
    English default
    "Acknowledge"
  • shelve
    English default
    "Shelve"
  • unshelve
    English default
    "Unshelve"
  • shelvedUntil
    English default
    "Shelved until"Before the time the alarm comes back: "Shelved until 15:30".

AlarmList

  • critical
    English default
    "Critical"
  • high
    English default
    "High"
  • low
    English default
    "Low"
  • unacknowledged
    English default
    "Unacknowledged"
  • acknowledged
    English default
    "Acknowledged"Alone, or before acknowledgedAt: "Acknowledged 13:42".
  • cleared
    English default
    "Cleared, not acknowledged"Cleared before anyone acknowledged it, when clearedAt is not given.
  • clearedWhen
    English default
    (t) => `Cleared ${t}, not acknowledged`The same with the time it cleared: "Cleared 14:07, not acknowledged".
  • acknowledge
    English default
    "Acknowledge"
  • shelve
    English default
    "Shelve"
  • unshelve
    English default
    "Unshelve"
  • shelvedUntil
    English default
    "Shelved until"Before the time the alarm comes back: "Shelved until 15:30".
  • title
    English default
    "Alarms"
  • summary
    English default
    (active: number, unacknowledged: number) => string
  • none
    English default
    "No active alarms"
  • acknowledgeAll
    English default
    "Acknowledge all"The header button while every unacknowledged alarm is in view.
  • acknowledgeShown
    English default
    (n: number) => `Acknowledge ${n} shown`The same button when some are out of view (folded low alarms in a flood): "Acknowledge 2 shown".
  • acknowledgeNonCritical
    English default
    (n: number) => `Acknowledge ${n} non-critical`The same button while critical alarms are unacknowledged, which it leaves to their own rows: "Acknowledge 3 non-critical".
  • acknowledgedCount
    English default
    (n: number) => `${n} alarm${n === 1 ? "" : "s"} acknowledged`Announced after "Acknowledge all": "3 alarms acknowledged".
  • shelvedGroup
    English default
    (n: number) => `Shelved · ${n}`"Shelved · 2"
  • hidden
    English default
    (sup: number, oos: number) => [sup && `${sup} suppressed by design`, oos && `${oos} out of service`].filter(Boolean).join(" · ")"2 suppressed by design · 1 out of service"
  • flood
    English default
    (n: number, m: number) => `Alarm flood: ${n} alarms in ${m} min. Critical and high first; low alarms are grouped.`The flood banner.
  • lowGroup
    English default
    (n: number) => `${n} low alarm${n === 1 ? "" : "s"}`"18 low alarms"
  • many
    English default
    (n: number) => `${n} new alarms`Announced instead of every title when many arrive at once: "23 new alarms".
  • loading
    English default
    "Loading alarms"Read out while the first load runs.
  • errorEmpty
    English default
    "Could not load alarms. There may be alarms you cannot see here."The error with no alarms to show: it must not read as "no alarms".
  • errorStale
    English default
    "Could not update alarms. This list may be out of date."The error while older alarms are still shown.
  • updatedAt
    English default
    (t: string) => `Last updated ${t}`"Last updated 13:42"
  • retry
    English default
    "Try again"

AnnotatedImage

  • predicted
    English default
    "Predicted"The legend's words, and the kind in each annotation's spoken name.
  • truth
    English default
    "Ground truth"
  • previous
    English default
    "Previous version"
  • legend
    English default
    "Line styles"Names the legend for screen readers.
  • count
    English default
    (n) => (n === 0 ? "No annotations" : n === 1 ? "1 annotation" : `${n} annotations`)"3 annotations".
  • annotation
    English default
    ({ label, kind, score }) => [label, kind.toLowerCase(), score].filter(Boolean).join(", ")One annotation as it is read out: "person, predicted, 0.92". kind is the legend word; score is already written.
  • score
    English default
    (n) => n.toFixed(2)A score as it is written, on the picture and read out.
  • layers
    English default
    (names) => `Layers: ${names.join(", ")}`"Layers: depth", read after the annotations when there are overlays.
  • loading
    English default
    "Loading picture"Read out while the skeleton shows.
  • failed
    English default
    "The picture could not be loaded"Shown in place of the picture when it cannot load.

AnnotationLegend

  • legend
    English default
    "Line styles"Names the legend for screen readers.
  • previous
    English default
    "Previous version"
  • predicted
    English default
    "Predicted"The legend's words, and the kind in each annotation's spoken name.
  • truth
    English default
    "Ground truth"

Attachment

  • uploadFailed
    English default
    "Upload failed"Under the name when the upload failed and no error says why.
  • failed
    English default
    "Failed"The image variant's caption in the same case.
  • uploading
    English default
    (name) => `Uploading ${name}`The progress bar's name: "Uploading report.pdf".
  • percent
    English default
    (n) => `${n} %`How far the upload is: "40 %".
  • retry
    English default
    (name) => `Retry ${name}`The action buttons' names, each with the file's name.
  • download
    English default
    (name) => `Download ${name}`
  • cancel
    English default
    (name) => `Cancel ${name}`
  • remove
    English default
    (name) => `Remove ${name}`

Autocomplete

  • placeholder
    English default
    "Search"In the empty field.
  • empty
    English default
    "No matches"In the list when nothing matches.
  • searching
    English default
    "Searching…"In the list while loading and nothing is shown yet.
  • searchingStatus
    English default
    "Searching"The spinner's name while loading.
  • clear
    English default
    "Clear"The clear button's name.
  • showAll
    English default
    "Show all"The chevron's name, which opens the full list.
  • suggestions
    English default
    "Suggestions"Names the list (and its popover) when the field has no aria-label.

Breadcrumb

  • nav
    English default
    "Breadcrumb"The landmark's name for screen readers.

CameraFeed

  • keys
    English default
    "Space pauses and resumes the view, F goes full screen. Pausing freezes this view only; the robot keeps streaming."Read after the feed's name: the keys it answers to.
  • live
    English default
    "Live"
  • latency
    English default
    (ms) => `${Math.round(ms)} ms`Written after "Live": "180 ms".
  • connecting
    English default
    "Connecting"The state word while connecting, and the line over the skeleton.
  • connectingLong
    English default
    "Connecting to camera…"Shown in the state while connecting, after the word; the line over the skeleton says the whole thing.
  • stalled
    English default
    "Stalled"
  • lastFrame
    English default
    (time) => `last frame ${time}`After "Stalled": when the last frame arrived.
  • formatTime
    English default
    (d) => [d.getHours(), d.getMinutes(), d.getSeconds()].map((n) => String(n).padStart(2, "0")).join(":")The time of the last frame. 24-hour clock by default; pass the site's own format or time zone.
  • paused
    English default
    "Paused"
  • offline
    English default
    "Camera offline"
  • noCamera
    English default
    "No camera"
  • retry
    English default
    "Reconnect"
  • pauseView
    English default
    "Pause view"
  • resumeView
    English default
    "Resume view"
  • mute
    English default
    "Mute"
  • unmute
    English default
    "Unmute"
  • snapshot
    English default
    "Take snapshot"
  • fullscreen
    English default
    "Full screen"
  • exitFullscreen
    English default
    "Leave full screen"

ChipGroup

  • more
    English default
    (n) => `${n} more`The button that unfolds the chips past max: "4 more".
  • less
    English default
    "Show fewer"The same button once unfolded.

CodeBlock

  • copy
    English default
    (title) => (title ? `Copy ${title}` : "Copy code")The copy button's name, from the block's title when it has one: (title) => "Copy " + title.
  • copied
    English default
    "Copied"Said after a copy.
  • failed
    English default
    "Could not copy: select the text and copy it"Said when the browser refused the copy.
  • show
    English default
    "Show value"The secret toggle's name; aria-pressed says whether the value is shown.
  • hidden
    English default
    "Hidden"Read in place of the dots while a secret is hidden.
  • code
    English default
    "Code"The scroll box's name when there is no title.

CommandDialog

  • title
    English default
    "Search"The palette's name for screen readers.
  • description
    English default
    "Search pages, robots and actions"Read after the name: what can be searched.

CopyButton

  • copy
    English default
    "Copy"The icon button's name before a press.
  • copied
    English default
    "Copied"Said after a copy, and shown on a text button.
  • failed
    English default
    "Could not copy: select the text and copy it"Said when the browser refused (no clipboard access); it stays until the next press.
  • notCopied
    English default
    "Not copied"Shown on a text button when the copy failed.

DataGrid

  • region
    English default
    "Data"Names the scrolling grid when DataGridTable has no aria-label.
  • empty
    English default
    "No rows"In the grid when there are no rows.
  • resize
    English default
    (column) => `Resize ${column}`A column's resize handle: "Resize Robot".
  • ascending
    English default
    "Ascending"The column header menu.
  • descending
    English default
    "Descending"
  • unpin
    English default
    "Unpin"
  • pinLeft
    English default
    "Pin to the left"
  • hideColumn
    English default
    "Hide column"
  • columns
    English default
    "Columns"The button that opens the column menu (DataGridColumnVisibility).
  • showColumns
    English default
    "Show columns"The heading inside that menu.
  • selected
    English default
    (count, total) => `${count} of ${total} selected`DataGridSelectionSummary: "3 of 48 selected".
  • selectAll
    English default
    "Select all on this page"selectColumn's checkboxes.
  • selectRow
    English default
    "Select row"
  • details
    English default
    "Details"expandColumn's header (screen readers only) and its button.
  • showDetails
    English default
    "Show details"
  • hideDetails
    English default
    "Hide details"

DataGridPagination

  • range
    English default
    (from: number, to: number, total: number) => `${from}–${to} of ${total}`
  • previous
    English default
    "Previous page"
  • next
    English default
    "Next page"
  • page
    English default
    (n: number) => `Page ${n}`
  • empty
    English default
    "Nothing to show"

DatePicker, DateRangePicker

  • pickDay
    English default
    "Pick a day"DatePicker's trigger when no day is picked.
  • pickRange
    English default
    "Pick a range"DateRangePicker's trigger when no range is picked.
  • clear
    English default
    "Clear"The clear button's name.
  • presets
    English default
    "Presets"Names the group of presets.

DialogContent

  • close
    English default
    "Close"The close button's name for screen readers.

Filters

  • label
    English default
    "Filters"Names the whole bar.
  • remove
    English default
    (rule: string) => `Remove filter: ${rule}`
  • clear
    English default
    "Clear all"
  • from
    English default
    "From"
  • to
    English default
    "To"
  • matchAll
    English default
    "Active filters, all must match"Names the list of chips, so a screen reader hears how they combine.
  • more
    English default
    (first: string, more: number) => `${first} +${more}`Several values on a chip: the first and how many more.
  • and
    English default
    "and"Between chips: rules combine with AND.
  • add
    English default
    "Filter"
  • chooseField
    English default
    "Choose a field"
  • chooseOperator
    English default
    (field: string) => `${field}: choose an operator`
  • enterValue
    English default
    (field: string, operator: string) => `${field} ${operator}: enter a value`
  • chooseValue
    English default
    (field: string, operator: string) => `${field} ${operator}: choose a value`
  • searchFields
    English default
    "Search fields"
  • searchOperators
    English default
    "Search operators"
  • searchOptions
    English default
    "Search values"
  • noMatches
    English default
    "No matches. Try another word."
  • apply
    English default
    "Apply"
  • back
    English default
    "Back"
  • editField
    English default
    (text: string) => `${text}, change field`Accessible names of the chip's parts. They start with the words shown (WCAG 2.5.3).
  • editOperator
    English default
    (text: string) => `${text}, change operator`
  • editValue
    English default
    (text: string) => `${text}, change value`
  • operators
    English default
    { contains: "contains", not_contains: "does not contain", is: "is", is_not: "is not", any_of: "is any of", none_of: "is none of", eq: "=", neq: "≠", lt: "<", gt: ">", between: "between", before: "before", after: "after", is_true: "is true", is_false: "is false", } as Record<FilterOperator, string>

Graph, GraphList

  • from
    English default
    (names) => `from ${and(names)}`The part of a node's name listing its inputs: "from Hall B captures and Synthetic pallets v4".
  • to
    English default
    (names) => `to ${and(names)}`The part listing its outputs: "to Picking detector v3.2".
  • status
    English default
    { active: "Running", normal: "Done", warning: "Needs attention", danger: "Failed", offline: "Not run" }Default words per status, when a node has no statusLabel.
  • instructions
    English default
    "Arrow keys move along the connections: forward to outputs, back to inputs, across to the next node in the same column."Read once when focus enters the graph.
  • inputs
    English default
    "Inputs"GraphList: the headings of a node's two rows.
  • outputs
    English default
    "Outputs"
  • loading
    English default
    "Loading"Read while loading.

ImageGrid

  • loading
    English default
    "Loading pictures"Read out while the skeleton shows.
  • broken
    English default
    "Could not load"Read before the file name of a picture that could not load.
  • reveal
    English default
    "Show picture"The button on a hidden picture.
  • viewLarger
    English default
    (name) => `View ${name} larger`The corner button that opens the lightbox while picking.
  • previous
    English default
    "Previous"
  • next
    English default
    "Next"
  • close
    English default
    "Close"
  • position
    English default
    (n, total) => `${n} of ${total}`"3 of 24".

Island

  • attention
    English default
    "Another dog needs attention"
  • status
    English default
    "Device status"
  • offline
    English default
    "offline"
  • charging
    English default
    "charging"
  • battery
    English default
    (n) => `battery ${n}%`
  • notifications
    English default
    (unread) => `Notifications, ${unread} unread`

IslandAlarm

  • critical
    English default
    "Critical"
  • high
    English default
    "High"
  • low
    English default
    "Low"
  • unacknowledged
    English default
    "Unacknowledged"
  • acknowledged
    English default
    "Acknowledged"Alone, or before acknowledgedAt: "Acknowledged 13:42".
  • cleared
    English default
    "Cleared, not acknowledged"Cleared before anyone acknowledged it, when clearedAt is not given.
  • clearedWhen
    English default
    (t) => `Cleared ${t}, not acknowledged`The same with the time it cleared: "Cleared 14:07, not acknowledged".
  • acknowledge
    English default
    "Acknowledge"
  • shelve
    English default
    "Shelve"
  • unshelve
    English default
    "Unshelve"
  • shelvedUntil
    English default
    "Shelved until"Before the time the alarm comes back: "Shelved until 15:30".
  • more
    English default
    (n: number) => `+${n}`
  • moreAlarms
    English default
    "more unacknowledged"
  • many
    English default
    (n: number) => string

JointState

  • title
    English default
    "Joint states"The panel's name when there is no label.
  • joint
    English default
    "Joint"Column headings on a wide panel; on a narrow one they are written before each value.
  • position
    English default
    "Position"
  • velocity
    English default
    "Velocity"
  • effort
    English default
    "Effort"
  • degrees
    English default
    (v) => `${v}°`A revolute position, given already formatted: "42.0" → "42.0°".
  • millimetres
    English default
    (v) => `${v} mm`A prismatic position: "120.5" → "120.5 mm".
  • degreesPerSecond
    English default
    (v) => `${v} °/s`
  • millimetresPerSecond
    English default
    (v) => `${v} mm/s`
  • newtonMetres
    English default
    (v) => `${v} N·m`Effort without an effort limit, revolute.
  • newtons
    English default
    (v) => `${v} N`Effort without an effort limit, prismatic.
  • effortPercent
    English default
    (v) => `${v} %`Effort as a share of the effort limit: "34" → "34 %".
  • range
    English default
    (lower, upper) => `range ${lower} to ${upper}`The limits, read by screen readers (the track's end numbers are drawn for the eye).
  • noLimits
    English default
    "No limits (continuous)"Written where the track would be for a joint without limits.
  • nearLower
    English default
    "Near lower limit"
  • nearUpper
    English default
    "Near upper limit"
  • atLower
    English default
    "At lower limit"
  • atUpper
    English default
    "At upper limit"
  • beyondLower
    English default
    "Past lower limit"
  • beyondUpper
    English default
    "Past upper limit"
  • stale
    English default
    "Stale"
  • lastUpdate
    English default
    (time) => `last update ${time}`After "Stale": when the last joint state arrived.
  • formatTime
    English default
    (d, locale) => locale ? d.toLocaleTimeString(locale, { hour: "2-digit", minute: "2-digit", second: "2-digit", hourCycle: "h23" }) : [d.getHours(), d.getMinutes(), d.getSeconds()].map(pad).join(":")The time of the last update. 24-hour clock by default; with locale, that locale's 24-hour time.
  • loading
    English default
    "Loading joint states…"
  • empty
    English default
    "No joint states yet"
  • emptyHint
    English default
    "Positions show here once the robot publishes them."

LoadMore

  • showing
    English default
    (shown, total, locale) => `Showing ${shown.toLocaleString(locale)} of ${total.toLocaleString(locale)}`"Showing 40 of 125". locale is LoadMore's, for formatting the numbers.
  • more
    English default
    (next, left, locale) => `Show ${next.toLocaleString(locale)} more (${left.toLocaleString(locale)} left)`"Show 20 more (85 left)"

MediaPlayer

  • keys
    English default
    "Space or K plays and pauses, the arrow keys move 5 seconds, J and L 10 seconds, M mutes, F goes full screen."Read after the player's name: the keys it answers to.
  • play
    English default
    "Play"
  • pause
    English default
    "Pause"
  • mute
    English default
    "Mute"
  • unmute
    English default
    "Unmute"
  • speed
    English default
    (rate) => `Playback speed ${rate}×`The speed button's name; it must contain the visible "1×".
  • captions
    English default
    "Captions"
  • fullscreen
    English default
    "Full screen"
  • exitFullscreen
    English default
    "Leave full screen"
  • seek
    English default
    "Position in clip"The timeline's name.
  • position
    English default
    (current, total) => `${current} of ${total}`The timeline's value as read out: "0:42 of 1:00".
  • markers
    English default
    "Events in this clip"Heading of the list of markers under the player.
  • loading
    English default
    "Loading clip"
  • buffering
    English default
    "Buffering"
  • unavailable
    English default
    "Clip unavailable""Clip unavailable", written before the reason.
  • retry
    English default
    "Reload clip"
  • mediaError
    English default
    (code) => code === 1 ? "loading was stopped." : code === 2 ? "the network dropped while it was loading." : code === 3 ? "the file is damaged or this browser cannot decode it." : "the file was not found, or it is not a video this browser plays."Why the browser could not play it, by MediaError code (1 aborted, 2 network, 3 decode, 4 not supported).

MetricCard

  • better
    English default
    ", better"Read after a change for the better: "+1, better".
  • worse
    English default
    ", worse"Read after a change for the worse: "+6, worse".
  • loading
    English default
    "Loading"Read in place of the value while it loads.
  • unavailable
    English default
    "Not available"Read in place of the dash when the value is unavailable.

NumberField

  • decrease
    English default
    "Decrease"
  • increase
    English default
    "Increase"

Pagination

  • range
    English default
    (from: number, to: number, total: number) => `${from}–${to} of ${total}`
  • previous
    English default
    "Previous page"
  • next
    English default
    "Next page"
  • page
    English default
    (n: number) => `Page ${n}`
  • empty
    English default
    "Nothing to show"

PhoneInput

  • country
    English default
    "Country"The country menu's name for screen readers.
  • phoneNumber
    English default
    "Phone number"The number box's name (unless aria-label or a Field names it) and its placeholder.

PointCloud

  • viewName
    English default
    "3D point cloud"What the view is, read after label as its name: "Front lidar, 3D point cloud". The name stays the same while scans arrive; the count and the extent are in its description instead.
  • keys
    English default
    "Drag to rotate, right-drag or two fingers to pan; the wheel or a pinch zooms once the view has focus. Arrow keys rotate, Shift with the arrows pans, plus and minus zoom, 0 resets the view."Read after the summary when the view has focus: what the pointer and the keys do.
  • count
    English default
    (n) => (n === 1 ? "1 point" : `${n.toLocaleString("en-US")} points`)"123,456 points".
  • bounds
    English default
    (b) => `x ${fixed1(b.min[0])} to ${fixed1(b.max[0])} m forward, y ${fixed1(b.min[1])} to ${fixed1(b.max[1])} m left, z ${fixed1(b.min[2])} to ${fixed1(b.max[2])} m up`The extent, read by screen readers and shown nowhere else: "x −4.0 to 12.0 m forward, …".
  • robotAtOrigin
    English default
    "The robot is at the origin, facing x"Read with the summary when robot is drawn.
  • frameTime
    English default
    (ms) => `Frame ${ms < 10 ? ms.toFixed(1) : Math.round(ms)} ms`How long the last frame took, from the start of drawing until the GPU finished it, in the footer.
  • loading
    English default
    "Loading the point cloud"
  • empty
    English default
    "No points"Said in the view when there is nothing to draw.
  • error
    English default
    "The point cloud could not be loaded."
  • retry
    English default
    "Load again"
  • stale
    English default
    "Stale"
  • lastScan
    English default
    (time) => `last scan ${time}`After "Stale": when the last cloud arrived.
  • formatTime
    English default
    (d) => [d.getHours(), d.getMinutes(), d.getSeconds()].map((n) => String(n).padStart(2, "0")).join(":")The time of the last cloud. 24-hour clock by default; pass the site's own format or time zone.
  • noWebGL
    English default
    "This browser cannot draw the 3D view."The browser cannot draw 3D: the first line, then why and what to do.
  • noWebGLHint
    English default
    "WebGL 2 is turned off or not supported. Turn on hardware acceleration, or open this page in a current browser."
  • contextLost
    English default
    "Restoring the 3D view…"Said while the browser gives the 3D view back after taking it away (a GPU reset, too many views open).
  • resetView
    English default
    "Reset view"
  • fit
    English default
    "Fit to points"
  • axisX
    English default
    "x forward"The words on the axes gizmo: each axis by its direction, so it never relies on colour.
  • axisY
    English default
    "y left"
  • axisZ
    English default
    "z up"
  • scaleHeight
    English default
    "Height"The colour scale's name in the footer, by what it shows.
  • scaleIntensity
    English default
    "Intensity"
  • metres
    English default
    (m) => `${fixed1(m)} m`The values at the colour scale's ends.
  • intensityValue
    English default
    (v) => (Math.abs(v) >= 100 ? Math.round(v).toString() : Number(v.toPrecision(3)).toString())

Questionnaire, QuestionField

  • submit
    English default
    "Submit"The last page's button.
  • required
    English default
    "Answer this question to continue."Under a required question left empty.
  • review
    English default
    "Review"The counter on the review page.
  • position
    English default
    (n, total) => `Question ${n} of ${total}`The counter: "Question 2 of 5".
  • percent
    English default
    (n) => `${n} %`Beside the counter: "40 %".
  • progress
    English default
    "Progress"The progress bar's name.
  • answers
    English default
    "Your answers"Names the list on the review page.
  • edit
    English default
    "Edit"The review page's button for each answer.
  • editQuestion
    English default
    (n) => `, question ${n}`Read after Edit by screen readers only: ", question 2".
  • back
    English default
    "Back"
  • next
    English default
    "Next"
  • notAnswered
    English default
    "Not answered"The review page, for a question with no answer.
  • scaleAnswer
    English default
    (value, max) => `${value} of ${max}`A scale answer on the review page: "4 of 5".
  • upTo
    English default
    (max) => `Up to ${max}.`Under a multiple-choice question with max: "Up to 3."
  • requiredMark
    English default
    " (required)"Read after a required question's title by screen readers only.

RobotMap, RobotMapList

  • instructions
    English default
    "Arrow keys move the map, plus and minus zoom, 0 shows the whole site. The robot list beside the map has the same robots as text."Read once when focus enters the map.
  • zoomIn
    English default
    "Zoom in"
  • zoomOut
    English default
    "Zoom out"
  • fit
    English default
    "Show the whole site"
  • status
    English default
    { active: "Working", normal: "Idle", warning: "Needs attention", danger: "Stopped", offline: "Offline" }Default words per status, for robots without statusLabel.
  • zoneKind
    English default
    { restricted: "No entry", slow: "Slow zone", charging: "Charging", other: "Marked" }Default names per zone kind, and the kind's word in the list.
  • empty
    English default
    "No robots on this site right now."Said over the map and in the list when there are no robots.
  • loading
    English default
    "Loading the map"
  • error
    English default
    "The map could not be loaded."
  • retry
    English default
    "Reload the map"
  • count
    English default
    (n) => (n === 1 ? "1 robot" : `${n} robots`)How many robots the map shows, read with the instructions.
  • selected
    English default
    (name, status) => `Selected: ${name}, ${status}`The selected robot, read with the instructions.
  • north
    English default
    (deg) => `North is ${Math.round(((deg % 360) + 360) % 360)}° clockwise from the top`Where north is, when northDeg is given.
  • northLetter
    English default
    "N"The letter on the north arrow.
  • position
    English default
    (x, y) => `${metres(x)} m across, ${metres(y)} m down`RobotMapList: a robot's position.
  • inZone
    English default
    (zone, kind) => (kind ? `In ${zone} (${kind.toLowerCase()})` : `In ${zone}`)RobotMapList: the zone a robot is in.
  • inUnnamedZone
    English default
    (kind) => `In a ${kind.toLowerCase()} zone`RobotMapList: the zone a robot is in, when the zone has no name.
  • noZone
    English default
    "Outside the marked zones"RobotMapList: a robot outside every zone.
  • heading
    English default
    (deg) => `Facing ${Math.round(((deg % 360) + 360) % 360)}°`RobotMapList: which way it faces.
  • metres
    English default
    (m) => `${m} m`The scale bar's length.
  • costTitle
    English default
    "Cost"The costmap's legend: its name and the two ends of its ramp ("Cost: low → lethal").
  • costLow
    English default
    "low"
  • costHigh
    English default
    "lethal"
  • at
    English default
    (x, y) => `${x.toFixed(1)}, ${y.toFixed(1)} m`A place in metres, as the crosshair's readout and the announcements write it.
  • editKeys
    English default
    "Arrow keys move the crosshair, Shift for bigger steps; Enter or Space places, Esc cancels. Right-drag or two fingers move the map."The keys of an edit mode, read with the instructions.
  • goalHint
    English default
    "Press to place the goal, drag to point it. Esc cancels."The mode banner: what a click does and how to finish or cancel, per mode and step.
  • goalTurnHint
    English default
    "Left and right arrows turn the goal, Enter sets it, Esc cancels."
  • waypointsHint
    English default
    "Click to add a waypoint, drag one to move it. Delete removes the selected one."
  • carryHint
    English default
    "Arrow keys move it, Enter drops it, Esc puts it back."
  • zoneHint
    English default
    "Click to place a new zone's first corner."
  • zoneEditableHint
    English default
    "Click to start a new zone, or drag a corner to move it."
  • zoneDrawHint
    English default
    "Click to add a corner; click the first corner or press Enter to finish. Backspace removes the last, Esc cancels."
  • panHint
    English default
    "Right-drag or two fingers move the map."The banner's second line on a wide map: how to pan while editing.
  • goalPlaced
    English default
    (x, y) => `Goal at ${defaultLabels.at(x, y)}. Left and right arrows turn it, Enter sets it.`Said in the live region as each edit happens.
  • goalSet
    English default
    (x, y, heading) => `Goal set at ${defaultLabels.at(x, y)}${heading === undefined ? "" : `, heading ${Math.round(heading)}°`}`
  • goalCancelled
    English default
    "Goal cancelled"
  • waypointAdded
    English default
    (n, x, y) => `Waypoint ${n} added at ${defaultLabels.at(x, y)}`
  • waypointPicked
    English default
    (n) => `Waypoint ${n} picked up. Arrow keys move it, Enter drops it, Esc puts it back.`
  • waypointMoved
    English default
    (n, x, y) => `Waypoint ${n} moved to ${defaultLabels.at(x, y)}`
  • waypointRemoved
    English default
    (n) => `Waypoint ${n} removed`
  • moveCancelled
    English default
    "Move cancelled"
  • cornerAdded
    English default
    (n, x, y) => `Corner ${n} at ${defaultLabels.at(x, y)}`
  • cornerRemoved
    English default
    (left) => (left === 1 ? "Last corner removed, 1 left" : `Last corner removed, ${left} left`)
  • cornerPicked
    English default
    "Corner picked up. Arrow keys move it, Enter drops it, Esc puts it back."
  • cornerMoved
    English default
    (x, y) => `Corner moved to ${defaultLabels.at(x, y)}`
  • zoneDrawn
    English default
    (n) => `Zone drawn with ${n} corners`
  • zoneCancelled
    English default
    "Zone cancelled"

RobotModel

  • keys
    English default
    "Drag to turn the view, right-drag to move it, and the wheel or a pinch to zoom once the view has focus. Arrow keys turn, Shift with the arrows moves, plus and minus zoom, 0 resets the view and F fits the robot. The view only shows the robot; it does not move it."Read after the summary when the view has focus: what the pointer and the keys do.
  • robot
    English default
    "Robot"The name when neither label nor the URDF gives one.
  • jointCount
    English default
    (n) => (n === 1 ? "1 joint" : `${n} joints`)"6 joints": the joints that move.
  • summary
    English default
    (robot, n) => `${robot}, 3D view, ${n === 1 ? "1 joint" : `${n} joints`}`The summary the view is read as: the robot, that it is a 3D view, and how many joints move.
  • highlighted
    English default
    (items) => `Highlighted: ${items.join("; ")}`Added to the summary when something is highlighted: each item is one joint or link, described.
  • jointValue
    English default
    (value, type) => (type === "prismatic" || type === "planar" || type === "floating" ? millimetres(value) : degrees(value))A joint's value in words: degrees for revolute and continuous joints, millimetres for prismatic ones (ROS sends radians and metres). Planar and floating joints are written with poseValue instead.
  • poseValue
    English default
    (values, type) => POSE_AXES[type] .flatMap(([axis, angle], i) => { const v = values[i] return v === undefined || !Number.isFinite(v) ? [] : [`${axis} ${angle ? degrees(v) : millimetres(v)}`] }) .join(", ")A planar ([x, y, θ]) or floating ([x, y, z, roll, pitch, yaw]) joint's value in words, each component with its own unit: "x 120 mm, y −40 mm, θ 30°". Components that are not finite numbers are left out.
  • jointDetail
    English default
    (value, lower, upper) => [value && `at ${value}`, lower !== undefined && upper !== undefined && `limits ${lower} to ${upper}`].filter(Boolean).join(", ")A highlighted joint described: its value and its limits. value and the limits are already in words.
  • link
    English default
    "link"A highlighted link (not a joint) described.
  • loading
    English default
    "Loading robot model…"
  • loadingMeshes
    English default
    (loaded, total) => `Loading meshes, ${loaded} of ${total}`While meshes arrive: "Loading meshes, 3 of 7".
  • error
    English default
    "The robot model could not be loaded."The first line of the error.
  • errorDetail
    English default
    (path, reason) => `${path}: ${reason}`What failed, under it: the file in words and why.
  • invalidUrdf
    English default
    "not a URDF (no <robot> element, or the XML is broken)"Why a URDF is not one: it is not XML, or it has no <robot>.
  • missingPackage
    English default
    (pkg) => `no path given for package “${pkg}”`A package:// path whose package has no entry in packages and no meshBaseUrl to fall back on.
  • unsupportedMesh
    English default
    "this mesh format is not supported (STL and COLLADA are)"A mesh in a format the default loader does not read.
  • retry
    English default
    "Load again"
  • empty
    English default
    "No robot model to show."With no URDF given.
  • stale
    English default
    "Stale"
  • lastUpdate
    English default
    (time) => `last update ${time}`After "Stale": when the joints last changed.
  • formatTime
    English default
    (d) => [d.getHours(), d.getMinutes(), d.getSeconds()].map((n) => String(n).padStart(2, "0")).join(":")The time of the last update. 24-hour clock by default; pass the site's own format or time zone.
  • noWebgl
    English default
    "3D view unavailable: this browser cannot draw 3D (WebGL is off or not supported)."The fallback's first line, when this browser cannot draw 3D.
  • noWebglDetail
    English default
    "The joint positions are listed below instead."Under it: what the person can still read.
  • jointsHeading
    English default
    "Joint positions"The fallback's list of joints.
  • noValue
    English default
    "No value"A joint with no value in joints.
  • contextLost
    English default
    "Restoring the 3D view…"While the graphics context comes back after the GPU reset it.
  • contextFailed
    English default
    "The 3D view could not be restored."The context did not come back within a few seconds; under it, Load again draws the view anew.
  • resetView
    English default
    "Reset the view"
  • fitView
    English default
    "Fit the robot in view"
  • axes
    English default
    { x: "Forward", y: "Left", z: "Up" }The axes gizmo's words for the robot's own frame (ROS REP 103: x forward, y left, z up).

RouteProgress

  • loading
    English default
    "Loading page"The bar's name for screen readers.

SearchField

  • label
    English default
    "Search"Names the search landmark and the box, for screen readers.
  • placeholder
    English default
    "Search"In the empty box.

Sortable

  • pickedUp
    English default
    (name, position, total) => `Picked up ${name}. Position ${position} of ${total}.`On lifting an item: "Picked up Dock A. Position 2 of 5."
  • moved
    English default
    (name, position, total) => `${name} moved to position ${position} of ${total}.`On each move.
  • droppedAt
    English default
    (name, position, total) => `${name} dropped at position ${position} of ${total}.`On dropping it over a place.
  • dropped
    English default
    (name) => `${name} dropped.`On dropping it nowhere.
  • cancelled
    English default
    (name) => `Moving ${name} cancelled.`On Escape.
  • instructions
    English default
    "To reorder, press Space, move with the arrow keys, press Space again to drop, or Escape to cancel."Read when a handle takes focus: how to move with the keyboard.

Spinner

  • loading
    English default
    "Loading"The spinner's name for screen readers.

Stepper, StepperCompact

  • optional
    English default
    "Optional"Under the title of an optional step (when optional is true rather than words of its own).
  • unavailable
    English default
    "unavailable"Read by screen readers after each step's title, by its state.
  • done
    English default
    "completed"
  • error
    English default
    "has an error"
  • current
    English default
    "current step"
  • upcoming
    English default
    "not started"
  • position
    English default
    (n, total) => `Step ${n} of ${total}`StepperCompact's counter: "Step 2 of 5".
  • progress
    English default
    "Steps"StepperCompact's progress bar name.

StopButton

  • ready
    English default
    "Emergency stop"
  • idle
    English default
    "Stop"
  • sending
    English default
    "Sending…"
  • unconfirmed
    English default
    "Not confirmed, press again"
  • bluetooth
    English default
    "Emergency stop"
  • bluetooth-sent
    English default
    "Delivered over Bluetooth"
  • dead
    English default
    "No connection"
  • holdAll
    English default
    "Keep holding to stop all"

TeleopPad

  • name
    English default
    "Drive the robot"The pad's accessible name. Name the robot when there is more than one: "Drive 7F3A".
  • roleDescription
    English default
    "drive pad"Read after the role name, instead of "application".
  • hint
    English default
    "Hold to drive"First line of the description, and the status before the first drive.
  • release
    English default
    "Release to stop"
  • keys
    English default
    "Arrow keys or W A S D drive while held. Space stops."
  • driving
    English default
    "Driving"
  • speedUnit
    English default
    "m/s"
  • stopped
    English default
    "Stopped"
  • lost
    English default
    "Stopped: input lost. Hold again to drive"Stopped because input was lost (cancel, blur, hidden, timeout): the operator must lift and press again.
  • disabled
    English default
    "Disabled"
  • limit
    English default
    "Speed limit"Before the cap, e.g. "Speed limit 60 %".

TextDiff

  • added
    English default
    "added:"Read before an insertion.
  • removed
    English default
    "removed:"Read before a deletion.
  • end
    English default
    "(end)"Read after either, so the listener hears where the change ends.
  • summary
    English default
    (added, removed) => [added ? `+${plural(added)}` : "", removed ? `−${plural(removed)}` : ""].filter(Boolean).join(", ")The summary line.
  • none
    English default
    "No changes"Instead of the summary when the texts are the same.
  • empty
    English default
    "Empty"In a side-by-side column whose text is empty.

ThemeToggle

  • light
    English default
    "Light"
  • system
    English default
    "Match system"
  • dark
    English default
    "Dark"

TimePicker

  • placeholder
    English default
    "Pick a time"On the trigger when no time is picked.
  • times
    English default
    "Times"Names the list of times when the picker has no aria-label.

Trace, TraceHeader

  • pending
    English default
    "Waiting"Each status in words, read after a step's title and used in TraceHeader's counts.
  • running
    English default
    "Running"
  • done
    English default
    "Done"
  • warning
    English default
    "Warning"
  • error
    English default
    "Failed"
  • skipped
    English default
    "Skipped"
  • count
    English default
    (n, status) => `${n} ${status.toLowerCase()}`TraceHeader's count per status: "3 done", from the status word above.
  • duration
    English default
    (ms) => formatDuration(ms)How long a step took, from ms: "1.2 s".

Tree

  • toggle
    English default
    (name) => `Items under ${name}`The disclosure button's name in list mode; aria-expanded says whether it is open.