Customizar Grupos da Barra de Ferramentas no Criador de Sites

Para componentes customizados, pode customizar cópias dos grupos da barra de ferramentas prontos a utilizar apresentados na barra de ferramentas do Criador de Sites.

Pode criar a sua própria versão de um componente pronto a utilizar que tenha um conjunto restrito e esteja disponível no identificador customizado. As customizações efetuadas não afetam os componentes prontos a utilizar.

Pode criar a sua própria versão do componente pronto a utilizar que tenha um conjunto restrito e esteja disponível no identificador customizado, mas não irá afetar nenhum dos componentes prontos a utilizar.

Os grupos da barra de ferramentas definem aquilo que vê na barra de ferramentas quando clica no componente Title ou Paragraph para o editar. Pode retirar e reordenar o que é suportado pelo componente Title ou Paragraph, mas não são permitidos plug-ins adicionais.

Para customizar os grupos da barra de ferramentas no Criador de Sites, é necessário utilizar a mesma sintaxe que o CKEditor utiliza para a configuração de toolbarGroups. Consulte https://ckeditor.com/latest/samples/toolbarconfigurator/index.html#basic.

Os componentes Título e Parágrafo suportam os seguintes grupos:

"basicstyles" - restrito a negrito/itálico/sublinhado https://ckeditor.com/cke4/addon/basicstyles
"styles" - Estilos de Tipos de Letra https://docs.ckeditor.com/ckeditor4/latest/guide/dev_styles.html
"colors" - Cores de Texto e Segundo Plano https://docs.ckeditor.com/ckeditor4/latest/guide/dev_colorbutton.html
"undo" - Desfaz/Refaz a instância atual no CKEditor
"links" - Plugin customizado para ligar a caixa de diálogo
"paragraph" - lista de marcas/lista numerada e suporte de indentação
- "list"
- "indent"
"align" - esquerda/direita/centro
"cleanup" - retira quaisquer estilos para o texto selecionado

O componente Paragraph também suporta os plug-ins de inserção de imagem e tabela”

"insert"
- "image"
- "table"

Além disso, pode utilizar a entrada de separador de linhas:

Nota:

Se definir outro valor na configuração do grupo de barras de ferramentas, o valor será retirado antes de a barra de ferramentas do Criador de Sites ser criada. Não pode fornecer "extraPlugins". Só é suportada a configuração "name"/"groups". Todas as entradas "items" serão ignoradas.

Por exemplo, se quiser impedir que os seus utilizadores definam tipos de letra, cores, estilos ou tamanhos, pode atualizar a configuração da barra de ferramentas como se segue. Para os valores "id", deve especificar valores customizados que sejam diferentes dos valores originais.

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

Validação

Substitua o seu ficheiro components.json pelo código anterior e, em seguida, edite o seu site (renove o browser se já estiver a editar). Neste momento, quando editar um componente Title, já não serão mostrados os estilos de tipos de letra ou as cores para seleção. O componente Paragraph irá continuar a mostrar estes elementos e a lista de tamanhos de tipos de letra disponíveis estará limitada a 16, 24 e 48.

Grupos da Barra de Ferramentas por Omissão

Seguem-se os grupos da barra de ferramentas por omissão para Título e Parágrafo:

Título

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

Parágrafo

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