Symbolleistengruppen in Sitebuilder anpassen

Für benutzerdefinierte Komponenten können Sie Kopien von Out-of-the-box-Symbolleistengruppen anpassen, die in der Sitebuilder-Symbolleiste angezeigt werden.

Sie können Ihre eigene Version einer Out-of-the-box-Komponente erstellen, die ein eingeschränktes Set umfasst und mit dem benutzerdefinierten Tag verfügbar ist. Out-of-the-box-Komponenten selbst sind nicht von Anpassungen betroffen.

Sie können Ihre eigene Version einer Out-of-the-box-Komponente erstellen, die ein eingeschränktes Set umfasst und mit dem benutzerdefinierten Tag verfügbar ist, ohne dabei die Out-of-the-box-Komponenten zu beeinträchtigen.

Symbolleistengruppen legen fest, was in der Symbolleiste angezeigt wird, wenn Sie auf die Titel- oder Absatzkomponente klicken, um sie zu bearbeiten. Sie können von der Titel- oder Absatzkomponente unterstützte Elemente entfernen und neu anordnen. Zusätzliche Plug-ins sind aber nicht zulässig.

Um Symbolleistengruppen in Sitebuilder anzupassen, verwenden Sie dieselbe Syntax wie die von CKEditor für die toolbarGroups-Konfiguration. Siehe https://ckeditor.com/latest/samples/toolbarconfigurator/index.html#basic.

Die Titel- und die Absatzkomponente unterstützen die folgenden Gruppen:

Die Absatzkomponente unterstützt auch die Plug-ins zum Einfügen von Bildern und Tabellen

  • "insert"

    • "image"

    • "table"

Darüber hinaus können Sie das folgende Zeilentrennzeichen verwenden:

  • "/"

Hinweis:

Wenn Sie einen anderen Wert in der Konfiguration der Symbolleistengruppe festlegen, wird der Wert vor der Erstellung der Sitebuilder-Symbolleiste entfernt. Sie können nicht "extraPlugins" angeben. Nur die "name"/"groups"-Konfiguration wird unterstützt. Alle "items"-Einträge werden ignoriert. 

Beispiel: Sie möchten verhindern, dass Benutzer Schriftarten, Farben, Stile oder Größen definieren. In diesem Fall können Sie die Symbolleistenkonfiguration wie folgt aktualisieren. Als "id"-Werte müssen Sie benutzerdefinierte Werte angeben, die sich von Out-of-the-box-Werten unterscheiden.

[{
    "name": "<category name>",
    "list": [{
        "type": "scs-title",
        "id": "<custom-value>",
        "config": {
            "toolbarGroups": [{
                    "name": "basicstyles",
                    "groups": ["basicstyles"]
                }, {
                    "name": "undo",
                    "groups": ["undo"]
                },
                "/", {
                    "name": "links",
                    "groups": ["links"]
                }, {
                    "name": "paragraph",
                    "groups": ["list", "indent"]
                },
                "/", {
                    "name": "align",
                    "groups": ["align"]
                },
                {
                    "name": "insert",
                    "groups": ["image", "table"]
                }, {
                    "name": "cleanup",
                    "groups": ["cleanup"]
                }
            ]
        }
    }, {
        "type": "scs-paragraph",
        "id": "<custom-value>",
        "config": {
            "fontSize_sizes": "16/16px;24/24px;48/48px;"
        }
    }]
}]

Validierung

Ersetzen Sie die Datei components.json durch den oben genannten Code, und bearbeiten Sie die Site dann (aktualisieren Sie den Browser, wenn Sie die Site bereits bearbeiten). Wenn Sie eine Titelkomponente bearbeiten, werden die Schriftstile oder -farben jetzt nicht mehr zur Auswahl angezeigt. Bei einer Absatzkomponente werden die Optionen weiterhin angezeigt. Die Liste der verfügbaren Schriftgrade ist aber auf 16, 24 und 48 beschränkt.

Standard-Symbolleistengruppen

Standard-Symbolleistengruppen für Titel und Absatz:

  • Titel

    [{
            "name": "basicstyles",
            "groups": ["basicstyles"]
        }, {
            "name": "styles",
            "groups": ["styles"]
        }, {
            "name": "colors",
            "groups": ["colors"]
        }, {
            "name": "undo",
            "groups": ["undo"]
        },
        "/", {
            "name": "links",
            "groups": ["links"]
        }, {
            "name": "paragraph",
            "groups": ["list", "indent"]
        }, {
            "name": "align",
            "groups": ["align"]
        }, {
            "name": "cleanup",
            "groups": ["cleanup"]
        }
    ]
  • Absatz

    [{
            "name": "basicstyles",
            "groups": ["basicstyles"]
        }, {
            "name": "styles",
            "groups": ["styles"]
        }, {
            "name": "colors",
            "groups": ["colors"]
        }, {
            "name": "undo",
            "groups": ["undo"]
        },
        "/", {
            "name": "links",
            "groups": ["links"]
        }, {
            "name": "paragraph",
            "groups": ["list", "indent"]
        }, {
            "name": "align",
            "groups": ["align"]
        }, {
            "name": "insert",
            "groups": ["image", "table"]
        }, {
            "name": "cleanup",
            "groups": ["cleanup"]
        }
    ]