Fügen Sie in der ui_config.json-Datei die Definition der neuen Funktion im Abschnitt Symbolleisten hinzu. Speichern Sie die Datei und laden Sie sie hoch.
In der Regel können Sie eine neue Gruppe von Symbolleistenschaltflächen erstellen und ihr eine oder mehrere Symbolleistenschaltflächen hinzufügen. Sie können auch eine neue Symbolleistenschaltfläche zu einer vorhandenen Symbolleistengruppe hinzufügen. Zum Erstellen einer neuen Symbolleistengruppe sind die folgenden Details erforderlich:
type: Geben Sie blockGroup als type an. Dieser Wert gibt an, dass Sie eine Blockgruppe erstellen, die eine oder mehrere Symbolleistengruppen enthalten würde.
extraClass: Name der Klasse(n), durch Leerzeichen getrennt
items: Legen Sie die Definition aller Gruppen in der Symbolleiste fest. Jede Gruppe kann ein oder mehrere Symbolleistensymbole enthalten. Um Symbole innerhalb einer Symbolleistengruppe zu definieren, müssen Sie erneut das type Attribut innerhalb der items definieren und deren Wert auf buttonGroup festlegen. Geben Sie einen oder mehrere Klassennamen in der extraclass Eigenschaft an. Geben Sie den Funktionsnamen in der Eigenschaft label an. Der folgende Ausschnitt aus der ui_config.json zeigt die Definition für den Haupt-Symbolleistenblock, gefolgt von der buttonGroup Definition:
"
„toolbar“: {
„type“: „blockGroup“,
„extraClass“:
„Symbolleistenvorgänge“,
„items“: [
{
„type“: „buttonGroup“,
„extraClass“: „left-Controls“,
„label“: „Left Controls“,
„items“: [
"
Innerhalb der items müssen Sie die Definition für ein oder mehrere Symbolleistensymbole angeben.
Sie müssen die folgenden Eigenschaften definieren, um ein Symbolleistensymbol hinzuzufügen:
type: Geben Sie button als type an. Dieser Wert gibt an, dass Sie eine Symbolleistenschaltfläche hinzufügen.
Symbol: Geben Sie den Namen des Coral-Symbols an, das Sie in der Symbolleiste verwenden möchten.
Variante: Geben Sie quiet als variant an.
title: Geben Sie die QuickInfo für das Symbol an.
on-click: Geben Sie den Befehlsnamen an, der für die Funktion in der JavaScript-Datei definiert ist. Wenn für den Befehl Eingabeparameter erforderlich sind, geben Sie den Befehlsnamen wie folgt an:
„JavaScript
„on-click“: {„name“: „AUTHOR_INSERT_ELEMENT“, „args“: „simpltable“}
"
Einblenden oder ausblenden: Wenn Sie die show-Eigenschaft definieren, geben Sie die Modi an, in denen das Symbol angezeigt wird. Zu den möglichen Werten gehören - @isAuthorMode, @isSourceMode, @isPreviewMode, true (Anzeige in allen Modi) oder false (Ausblenden in allen Modi).
Anstelle von show können Sie auch die Eigenschaft hide definieren. Die möglichen Werte sind dieselben wie in show Eigenschaft, mit dem einzigen Unterschied, dass das Symbol für den angegebenen Modus nicht angezeigt wird.
Das folgende Beispiel zeigt die AEM Guides-Versionsnummer, wenn der/die Benutzende auf das Symbol Version anzeigen in der Symbolleiste klickt.
Fügen Sie den folgenden Code zu einer JavaScript-Datei hinzu:
$(document).ready(setTimeout(function() {
fmxml.commandHandler.subscribe({
key: 'user.alert',
next: function() {
alert("AEM Guides version x.x")
}
})
}, 1000))
Fügen Sie die Funktion in der Datei ui_config.json wie folgt hinzu:
"type": "button",
"icon": "alert","variant": "quiet","title": "About AEM Guides","show": "true","on-click": "user.alert"
HINWEIS