Référence des traductions

Les traductions sont fortement typées. Vous pouvez fournir des surcharges soit via le provider, soit directement dans la configuration de table sous translations.keys.

Important : quand vous utilisez le catalogue form (create/edit via getFormConfig), le formulaire utilise la même fonction de traduction t() que la table, c'est-à-dire le même objet DataTableTranslations passé au provider. Vous devez inclure les clés form et value dans cet objet pour que les labels de champs, placeholders (y compris le champ value-type) et boutons de formulaire se résolvent correctement. Sinon, vous verrez des clés brutes comme value.string_placeholder dans l'UI.

Structure du type

type DataTableTranslations = {
  actions: { delete: string; edit: string; copy: string; export: string; save: string; cancel: string; confirm: string; title: string; view: string };
  bulk: { close_menu: string; confirm_copy_description: string; confirm_delete_description: string; confirm_title: string };
  calculations: { none: string; count: string; percent: string; more: string; count_all: string; count_values: string; count_unique: string; count_empty: string; count_not_empty: string; count_true: string; count_false: string; percent_empty: string; percent_not_empty: string; percent_true: string; percent_false: string; sum: string; average: string; median: string; min: string; max: string; range: string; calculate: string };
  columns: { title: string; hide: string; show: string; visible: string; hidden: string; drag: string; resetOrder: string; toggleVisibility: string; hideAll: string; showAll: string; edit_property: string; filter: string; hide_in_view: string; reorder: string; sort_ascending: string; sort_descending: string };
  menu: { /* ... */ footer_calculations: string; footer_calculations_on: string; footer_calculations_off: string };
  pagination: { first: string; last: string; next: string; previous: string; of: string; page: string; rowsPerPage: string; showing: string; selectedCount: string };
  selection: { rows: string };
  // ... see full type in types/translations.ts
}

Surcharge inline (config)

translations: {
  namespace: 'common',
  keys: {
    'columns.title': 'Columns',
    'actions.title': 'Actions',
  },
}

Via provider

Vous pouvez fournir un objet DataTableTranslations complet au provider pour une localisation cohérente sur toutes les tables.

Où les traductions s'appliquent

• Filtres (avancés) : les libellés d'opérateurs (Contains, Equals, Starts with, etc.) utilisent les clés filters.operators.*. Les options du menu et la valeur sélectionnée affichée lorsque le select est fermé sont traduites, donc l'opérateur courant apparaît toujours dans la locale active (par ex. “Contient” au lieu de “contains”).
• Pagination : tous les libellés sont traduits : “Rows per page” (pagination.rowsPerPage), le texte “Page X of Y” (pagination.showing, avec {page} et {total}), et les labels des boutons first/previous/next/last (pagination.first, pagination.previous, etc.). La pagination par défaut et la pagination de style boutons (SafePagination) utilisent ces clés.
• Calculs de footer : les libellés du menu de calcul et les résultats utilisent les clés calculations.*. Le toggle du menu options utilise menu.footer_calculations, menu.footer_calculations_on et menu.footer_calculations_off.

Traductions de formulaire (catalogue form)

Quand vous utilisez getFormConfig et le formulaire create/edit intégré (catalogue form), le formulaire résout tous les labels, placeholders et textes de boutons depuis le même objet DataTableTranslations passé au provider. Ajoutez une section form et value dans cet objet.

• form – Labels de champs (utilisez labelKey dans votre form config, par ex. form.name), boutons de formulaire (cancel, submit, create, update) et messages succès/erreur. Le catalogue form utilise aussi createForm.title et createForm.description pour l'en-tête de dialog/drawer. Pour les champs select, utilisez form.valueType_options.boolean etc. si vous utilisez optionKeys.
• value – Utilisé par le champ value-type : value.string_placeholder, value.json_placeholder, value.number_placeholder, et pour le switch booléen value.enabled / value.disabled.

Dans votre form config, définissez labelKey (et éventuellement placeholderKey, optionKeys) sur chaque champ pour que le form builder remplace labels/options par t(labelKey).

Exemple d'objet (form + value)

Fusionnez ceci dans l'objet DataTableTranslations que vous passez à la table (par ex. à côté de actions, columns, filters, etc.) :

const myTableTranslations = {
  // ... actions, columns, filters, etc. ...

  form: {
    cancel: "Cancel",
    create: "Create",
    createError: "Failed to create",
    createForm: {
      description: "Add a new item.",
      title: "Create item",
    },
    created: "Created successfully",
    name: "Name",
    slug: "Slug",
    category: "Category",
    description: "Description",
    enabled: "Enabled",
    valueType: "Value type",
    value: "Value",
    submit: "Save",
    update: "Update",
    updateError: "Failed to update",
    updated: "Updated successfully",
    valueType_options: {
      boolean: "Boolean",
      number: "Number",
      string: "String",
      json: "JSON",
    },
  },
  value: {
    string_placeholder: "Default string value",
    json_placeholder: "{}",
    number_placeholder: "0",
    enabled: "Enabled",
    disabled: "Disabled",
  },
};

Exemple de form config avec labelKey et optionKeys pour utiliser ces clés :

defineFormConfig({
  id: "my-entity",
  defaultValues: { name: "", slug: "", valueType: "string", value: null, enabled: false },
  fields: [
    { name: "name", type: "text", label: "Name", labelKey: "form.name", required: true },
    { name: "slug", type: "text", label: "Slug", labelKey: "form.slug", required: true },
    {
      name: "valueType",
      type: "select",
      label: "Value type",
      labelKey: "form.valueType",
      optionKeys: [
        "form.valueType_options.boolean",
        "form.valueType_options.number",
        "form.valueType_options.string",
        "form.valueType_options.json",
      ],
      options: [
        { label: "boolean", value: "boolean" },
        { label: "number", value: "number" },
        { label: "string", value: "string" },
        { label: "json", value: "json" },
      ],
    },
    {
      name: "value",
      type: "value-type",
      label: "Value",
      labelKey: "form.value",
      valueTypeField: "valueType",
      supportedTypes: ["boolean", "json", "number", "string"],
    },
  ],
  schema: mySchema,
  translations: {
    namespace: "my.namespace",
    keys: {
      cancel: "form.cancel",
      submit: "form.submit",
      create: "form.create",
      update: "form.update",
      created: "form.created",
      updated: "form.updated",
      createError: "form.createError",
      updateError: "form.updateError",
      "createForm.title": "form.createForm.title",
      "createForm.description": "form.createForm.description",
    },
  },
});

Voir aussi :

• DataTable
• Columns
• Provider & Setup (getFormConfig)

Toutes les clés (dot-path)

Utilisez les clés suivantes pour construire votre objet de traduction. Toutes les valeurs sont des strings.

actions

Utilisé par les actions de ligne, le bouton d'export de la barre d'outils et le menu des actions de masse (onglets Edit, Copy, Export, Delete et boutons de dialogue).

bulk

Chaînes utilisées par le panneau des actions de masse (affiché quand une ou plusieurs lignes sont sélectionnées). Supporte {action}, {count} et le pluriel ICU : {count, plural, one {item} other {items}}.

columns

common

filters

filters.operators

filters.types

filters.date_shortcuts

filters.advanced

filters.faceted

filters.add_menu

filters.presets

pagination

Utilisé par la pagination par défaut et la pagination de style boutons (par ex. “Lignes par page”, “Page 1 of 2”). pagination.showing est utilisé pour le texte “Page X of Y” et supporte {page} et {total}. Valeur anglaise par défaut : "Page {page} of {total}" (exemple français : "Page {page} sur {total}").

search

selection

Utilisé pour l'en-tête de la colonne de sélection et le compteur du menu des actions de masse (par ex. “3 rows selected”). Supporte {count} et l'ICU plural.

sorting

views

state

url_state

demo

table

calculations

menu

form (catalogue form)

Incluez ces clés lors de l'utilisation des formulaires create/edit pour que labels, placeholders et boutons se résolvent. Utilisez labelKey / optionKeys dans votre form config pour pointer vers ces clés.

value (value-type field)

Utilisé par le champ value-type du formulaire pour les placeholders et labels booléens.

root