Noções Básicas de Estilos de Componentes

Todos os componentes Sites internos compartilham uma estrutura de classe CSS semelhante.

Cada componente tem as três seguintes classes CSS aplicadas a seu elemento <div> mais externo:

 scs-component scs-type design-style

O type é o tipo de componente (como image, gallery ou divider). O design-style é a classe de estilo escolhida para um componente, conforme definido no arquivo do tema.

Noções Básicas de Estilos de Tema

O arquivo design.json de um tema lista todos os estilos (quadro, sombra, destacado etc.) que podem ser aplicados a cada tipo de componente (como botão ou imagem). Cada estilo tem um nome para exibição e um nome da classe. O nome para exibição é mostrado na guia Estilo do painel Definições. O nome da classe se refere a um seletor de CSS no arquivo design.css do tema. Por exemplo, a entrada para o componente button é a seguinte:

"scs-button": {
         "styles": [{
                          "name": "COMP_STYLE_ALTA_SMALL",
                          "class": "scs-button-default-style"
                          },
                    {
                          "name": "COMP_STYLE_ALTA_LARGE",
                          "class": "scs-button-style-2"
                          },
                    {
                          "name": "COMP_STYLE_SIMPLE",
                          "class": "scs-button-style-3"
                          }
                    ]
},

Os nomes dos componentes internos são traduzidos, de modo que você vê uma chave para obter o nome do estilo diretamente do pacote de recursos. Se você adicionar um componente button a uma página e depois escolher o estilo Simples no painel Definições > Estilo, o arquivo design.json associará o nome para exibição Simples (chave COMP_STYLE_SIMPLE) ao nome da classe scs-button-style-3. O button será renderizado com as seguintes classes:

scs-component scs-button scs-button-style-3

Se nenhum estilo for escolhido para um componente em questão, o estilo padrão, scs-type-default-style, será utilizado. No exemplo anterior, o botão será renderizado com as seguintes classes:

scs-component scs-button scs-button-default-style 

O Estilo scs-component-content

Para cada componente interno, dentro do scs-component <div> mencionado anteriormente, há um content <div> com o nome da classe scs-component-content. Em outras palavras:

scs-component scs-type design-style
scs-component-content

No arquivo design.css, a classe scs-component-content muitas vezes é usada para estilizar a "caixa" em volta do componente (por exemplo, para aplicar uma borda ou sombra).

Vale mencionar que no arquivo comp.css interno, a classe scs-component-content comum é definida com position:relative e display:inline-block, entre outras propriedades CSS.

Enquanto scs-component-content é útil para estilizar a "caixa" em volta do componente, as classes específicas do componente são necessárias para estilizar totalmente um componente. Consulte Estilo Específico do Componente.