Dostosowywanie grup narzędzi w konstruktorze serwisów

Dla składników niestandardowych można dostosować kopie gotowych (standardowych) grup narzędzi, wyświetlanych na pasku narzędzi konstruktora serwisów.

Można utworzyć własną wersję standardowego składnika, mającego ustawione ograniczenia i dostępnego w znaczniku "custom". Żadne dostosowania nie mają wpływu na standardowe składniki.

Można utworzyć własną wersję standardowego składnika, mającego ustawione ograniczenia i dostępnego w znaczniku "custom", lecz nie wpłynie ona na żaden standardowy składnik.

Grupy narzędzi decydują o tym, co zostanie wyświetlone na pasku narzędzi, gdy użytkownik kliknie na składniku "tytuł" lub "akapit", aby go edytować. Można usunąć grupy narzędzi obsługiwanych przez składnik "tytuł" lub "akapit", ale dodatkowe wtyczki nie są dozwolone.

Aby dostosować grupy narzędzi w konstruktorze serwisów, należy użyć tej samej składni, której używa CKEditor dla konfiguracji toolbarGroups. Zob. https://ckeditor.com/latest/samples/toolbarconfigurator/index.html#basic.

Składniki "tytuł" i "akapit" obsługują następujące grupy:

"style podstawowe" — ograniczone do: pogrubienie, kursywa, podkreślenie; https://ckeditor.com/cke4/addon/basicstyles
"style" — style czcionek; https://docs.ckeditor.com/ckeditor4/latest/guide/dev_styles.html
"kolory" — kolory tekstu i tła; https://docs.ckeditor.com/ckeditor4/latest/guide/dev_colorbutton.html
"cofnięcie" — cofa/ponawia bieżące działanie w edytorze CKEditor
"łącza" — niestandardowa wtyczka dialogowego okna łącza
"akapit" — obsługa list wypunktowanych/numerowanych oraz wcięć
- "lista"
- "wcięcie"
"wyrównanie" — do lewej, do prawej, wyśrodkuj
"czyszczenie" — usuwa wszystkie style z wybranego tekstu

Składnik akapit obsługuje także wtyczki wstawiania obrazów i tabel

"wstaw"
- "obraz"
- "tabela"

Dodatkowo można używać wpisu separatora wierszy:

Uwaga:

Jeśli w konfiguracji grupy (paska narzędzi) ustawiono dowolną inną wartość, to — przed utworzeniem paska narzędzi konstruktora serwisów — wartość ta zostanie usunięta. Nie można udostępnić "extraPlugins" (dodatkowych wtyczek). Obsługiwane są tylko konfiguracje "nazwa"/"grupa". Wszelkie wpisy "elementy" będą ignorowane.

Na przykład, aby uniemożliwić użytkownikom definiowanie czcionek, kolorów, stylów lub rozmiarów, można zaktualizować konfigurację, jak pokazano poniżej. Dla "id" trzeba określić własne wartości różniące się od wartości standardowych.

[{
    "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;"
        }
    }]
}]

Weryfikacja

Należy zastąpić swój plik components.json pokazanym wcześniej kodem, a następnie edytować swój serwis (jeśli już jest edytowany, należy odświeżyć przeglądarkę). Od tej pory, gdy będzie edytowany składnik "tytuł", nie będą już pokazywane możliwe do wybrania style ani kolory czcionek. Będą one nadal pokazywane dla składnika "akapit", lecz lista dostępnych rozmiarów czcionek będzie ograniczona do 16, 24 i 48.

Domyślne grupy narzędzi

Domyślne grupy narzędzi "Tytuł" i "Akapit":

Tytuł

[{
        "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"]
    }
]

Akapit

[{
        "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"]
    }
]