React Spreadsheet Lokalisierung

React Spreadsheet verfügt über zwei separate Lokalisierungsmechanismen für verschiedene Aspekte der Benutzeroberfläche.

Zwei Lokalisierungsmechanismen

Mechanismus	Prop	Was wird gesteuert
UI-Lokalisierung	spreadsheetLocale	Menübezeichnungen, Toolbar-Tooltips, Dialogtexte und lokalisierte Formelnamen
Zahlen-/Datumsformatierung	localization	Dezimaltrennzeichen, Währungssymbol, Datums-/Uhrzeitanzeigeformat

Diese Props sind unabhängig voneinander: Sie können eine oder beide verwenden.

UI-Lokalisierung (spreadsheetLocale)

Die spreadsheetLocale-Prop akzeptiert ein SpreadsheetLocale-Objekt mit zwei Eigenschaften:

• locale - ein Record<string, string> mit UI-String-Überschreibungen
• formulas - ein Record<string, [string, string?][]> mit lokalisierten Formelnamen, gruppiert nach Kategorie

const locale: SpreadsheetLocale = {
    locale: {
        "File": "Datei",
        "Edit": "Bearbeiten",
        "Insert": "Einfügen",
        "Undo": "Rückgängig",
        "Redo": "Wiederherstellen",
        // ... weitere UI-Strings
    },
    formulas: {
        "MATCH": [
            ["Suchwert", "Erforderlich. Der Wert, der im Sucharray abgeglichen werden soll."],
            ["Sucharray", "Erforderlich. Ein Zellbereich oder ein Array-Bezug."],
        ],
        // ... weitere Formelkategorien
    },
};

<ReactSpreadsheet sheets={sheets} spreadsheetLocale={locale} />

Warnung

spreadsheetLocale ist eine Init-Only-Prop. Eine Änderung nach dem ersten Rendering führt dazu, dass das Widget zerstört und neu erstellt wird. Der Rückgängig/Wiederherstellen-Verlauf und der UI-Zustand (Auswahl, Scrollposition) werden zurückgesetzt.

Zahlen-/Datumsformatierung (localization)

Die localization-Prop steuert, wie Zahlen und Datumsangaben angezeigt werden: Dezimaltrennzeichen, Währungssymbole und Datumsmuster. Sie verwendet dasselbe Format wie die DHTMLX Spreadsheet-Konfigurationseigenschaft localization.

<ReactSpreadsheet
    sheets={sheets}
    localization={{
        decimal: ",",
        thousands: " ",
        currency: "€",
    }}
/>

Warnung

localization ist ebenfalls eine Init-Only-Prop. Änderungen lösen einen vollständigen Zerstörungs-/Neuaufbau-Zyklus aus.

Verwandte API und Anleitungen

• Lokalisierung - DHTMLX Spreadsheet Lokalisierungsanleitung
• SpreadsheetLocale-Typ - TypeScript-Interface-Referenz