readonly

Beschreibung

Optional. Aktiviert oder deaktiviert den Nur-Lesen-Modus

Verwendung

readonly?: boolean;

Standardkonfiguration

readonly: false

Beispiel

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
  readonly: true,
  // other config parameters
});

Details

Im Nur-Lesen-Modus sind die Symbolleiste, das Menü und die Formelleiste ausgeblendet, und das Kontextmenü sowie das Symbol des Spaltenmenüs sind nicht verfügbar. Die Tabellenblatt-Tabs bleiben erhalten, jedoch ohne die Schaltfläche zum Hinzufügen eines Tabellenblatts, das Kontextmenü der Tabellenblätter und das Umbenennen per Doppelklick.

Benutzer können die Daten weiterhin lesen und kopieren:

• die Zelle A1 ist nach dem Laden der Daten aktiv
• die Zellen können per Tastatur navigiert und per Maus ausgewählt werden, und die Auswahl-Events werden bei diesen Aktionen ausgelöst
• die Zellen können mit Ctrl (Cmd) + C kopiert und mit Ctrl (Cmd) + F durchsucht werden
• die Tabellenblätter können in den Tabellenblatt-Tabs und per Tastatur gewechselt werden
• die Links in Zellen können geöffnet werden, aber die Schaltflächen zum Bearbeiten und Entfernen eines Links sind im Link-Popup deaktiviert

Änderungen der Daten werden abgelehnt:

• Eingaben, Bearbeitungstasten, Ausschneiden und Einfügen, Rückgängig und Wiederholen sowie die Tastenkombinationen zum Formatieren von Zellen, Einfügen eines Links, Hinzufügen eines Tabellenblatts oder Einblenden ausgeblendeter Zeilen und Spalten werden ignoriert, und Screenreader kündigen "The sheet is read-only" an
• die Methoden, die Daten bearbeiten, zum Beispiel setValue(), setStyle() und deleteRow(), sowie die Methode startEdit() werden ignoriert. Die Methoden parse() und load() laden weiterhin Daten
• der Fill-Handle ist ausgeblendet
• die Spalten und Zeilen können nicht durch Ziehen ihrer Ränder in der Größe geändert werden, und ein Doppelklick auf einen Spaltenrand passt die Spaltenbreite nicht an die Daten an

Um auch die Tastaturnavigation und die Auswahl zu deaktivieren, setzen Sie die Option selection auf false. In diesem Fall hat die Tabellenkalkulation keine aktive Zelle, und die Zellen können weder per Maus, Tastatur noch API ausgewählt werden:

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
  readonly: true,
  selection: false,
  // other config parameters
});

Changelog: Die Tastaturnavigation, die Auswahl, das Kopieren und die Suche im Nur-Lesen-Modus wurden in v6.0.4 hinzugefügt

Verwandte Artikel:

• Konfiguration
• Anpassung
• Barrierefreiheit: Einrichtung für den Nur-Lesen-Modus

Verwandtes Beispiel: Spreadsheet. Nur-Lesen