Melhore a Legibilidade e Manutenção do Código CSS criando Estilos Dinâmicos

Aprenda a utilizar as variáveis CSS para criar aplicações web cada vez mais sofisticadas e eficientes.

Na medida que um projeto web vai crescendo e se tornando cada vez mais complexo, acaba sendo muito comum ter um código CSS extenso com milhares de linhas e dentro deste código é muito provável que a frequência de repetição de valores atribuídos as propriedades sejam grandes também.

Como você pode ver no exemplo abaixo, existem repetições dos mesmos valores nas propriedades color e background-color:

.one {
    color: #f0f0f0;
    background-color: #a52a2a;
}

.two {
    color: #f0f0f0;
    background-color: #a52a2a;
}

.three {
    color: #f0f0f0;
    background-color: #a52a2a;
}

.four {
    color: #f0f0f0;
    background-color: #a52a2a;
}

No caso do exemplo acima, a mesma cor pode ser usada em centenas de lugares diferentes no código. Como os valores das propriedades normais são relativamente fixos, caso no futuro decida trocar a cor de todos os elementos que tem a mesma cor, isso exigirá de você um trabalho manual de pesquisar em todo o código o valor da cor e realizar a substituição para a nova cor.

No entanto, a sua vida de desenvolvedor web começa a se tornar mais produtiva ao utilizar as variáveis CSS, no qual permite que um valor seja armazenado em um local e em seguida pode ser referenciado em vários outros locais.

É importante deixar bem claro que as variáveis CSS são basicamente propriedades personalizadas e não diretamente variáveis ​​reais de programação. O valor da variável CSS é calculado onde é necessário, é limitado ao escopo do elemento e não pode ser manipulado dinamicamente ou ter seu valor alterado durante a execução do estilo.

Enquanto as variáveis em linguagens de programação são armazenadores de dados que podem conter diferentes tipos de valores e são manipuladas e modificadas durante a execução do programa, as variáveis em CSS são usadas para armazenar valores específicos para serem reutilizados em propriedades CSS.

Agora, no exemplo abaixo trocando os valores fixos pelas variáveis e utilizando a função var() no lugar do valor da propriedade para recuperar o valor da variável, caso você decida fazer uma mudança de cor, você só precisaria alterar o valor da variável e todas as instâncias em que a variável é utilizada serão atualizadas automaticamente:

:root {
    --text-primary: #f0f0f0;
    --bg-primary: #a52a2a;
}

.one {
    color: var(--text-primary);
    background-color: var(--bg-primary);
}

.two {
    color: var(--text-primary);
    background-color: var(--bg-primary);
}

.three {
    color: var(--text-primary);
    background-color: var(--bg-primary);
}

.four {
    color: var(--text-primary);
    background-color: var(--bg-primary);
}

Muito legal né? Se quiser saber todo o potencial que as variáveis CSS tem a oferecer fique até o final deste artigo.

Boa leitura!

---

Sumário

• Variáveis são basicamente Propriedades
• Escopo da Variável
• Função var()
• Valores Inválidos de Propriedades e Variáveis

---

Variáveis são basicamente Propriedades

Ok, a minha intensão aqui não é confundi-lo(a)! Mas sim, mostrar que as variáveis CSS e propriedades CSS carregam o mesmo resultado de definição de estilos em um documento e são semelhantes em termos de sintaxe e uso, porém possuem funcionalidades completamente diferentes uma da outra como veremos logo a seguir.

Identificador da Variável

As variáveis são facilmente identificadas com um hífen duplo (--), seguido de um nome qualquer para a variável que faz a diferenciação de letras maiúsculas para minúsculas e por fim, um valor que seja válido para a variável:

--bg-secondary: #00ff00;

Como você pode ver no exemplo acima, um dos benefícios adicionais das variáveis é que o nome que você define para ela são personalizados e relativamente semânticos, isso significa, que o identificador --bg-secondary é mais fácil de entender como uma cor de fundo secundária em relação a uma cor de fundo principal (ou primária), ao invés de inserir diretamente como valor na propriedade o código hexadecimal #00ff00.

Já as propriedades em comparação com as variáveis não permitem o uso de hifens no início do nome, isso porque, os hifens são usados para separar palavras em propriedades compostas como font-size, text-align e etc. Em exceção, existem propriedades específicas com os prefixos -webkit, -moz, -ms e -o que usam um único hífen no início do nome, essas propriedades são usadas para recursos experimentais que ainda não foram totalmente padronizados ou incorporados às especificações oficiais do CSS.

--text-selected: none;

user-select: none;

-webkit-user-select: none;
-moz-user-select: none;
-ms-user-select: none;

Dessa maneira, com ou sem hífen, você consegue diferenciar qual é a finalidade da propriedade.

Valor da Variável

Os valores que podem ser atribuídos as variáveis são os mesmos que correspondem a qualquer valor de propriedade que pode ser uma sequência de um ou mais valores, desde que a sequência não contenha um valor não permitido pela propriedade ou simplesmente seja um valor inválido:

--horizontal: left;
--text-color: #0000ff;
--shadow: 0 0 10px #3a3939, 0 0 20px #666565;
--gradient: linear-gradient(90deg, #3c719e 0%, #2323ab 35%);

Embora existam semelhanças entre as variáveis CSS e propriedades CSS, ambas têm propósitos e funcionalidades diferentes, enquanto uma é usada para armazenar e reutilizar valores, a outra define estilos específicos para elementos individuais.

Herança da Variável

As variáveis CSS podem ser herdadas, assim como as propriedades normais do CSS, isso significa, que ao definir um valor para uma variável em um elemento, ela será aplicada automaticamente a todos os elementos que forem descendentes desse mesmo elemento, a menos que eles definam um novo valor.

Como, por exemplo:

.father {
    --font-small: 16px;
}

.child-1 {
    --font-small: 3.4em;
}

<div class="father">
    <div class="child-1"></div>
    <div class="child-2"></div>
</div>

No exemplo acima, o resultado para cada elemento será:

• Para o elemento com a classe .father será definido: 16px.
• Para o elemento com a classe .child-1 será definido: 3.4em.
• Para o elemento com a classe .child-2 será definido o valor herdado do elemento pai: 16px.

Por conta disso, toda vez que você usar uma variável em um determinado elemento, tanto este elemento quanto os elementos dentro dele, também poderão ter os mesmos valores definidos na variável.

---

Escopo da variável

As variáveis CSS possuem como escopo os elementos em que as mesmas foram declaradas. O escopo nada mais é que a área ou contexto em que uma variável pode ser acessada e utilizada.

Existem dois tipos de escopos para as variáveis o escopo Global e Local. As variáveis de escopo global é uma variável que está disponível para ser usada em todo o documento, enquanto as variáveis de escopo local, limita o uso da variável em elementos específicos.

Escopo da Global

É muito útil o escopo global para tornar uma variável CSS acessível para todos os elementos do documento.

Como, por exemplo:

:root {
    --bg-dark: #1b1a1a;
}

#first-box {
    background-color: var(--bg-dark);
}

#second-box {
    background-color: var(--bg-dark);
}

No exemplo acima, a variável --bg-dark foi declarada no escopo da pseudo-classe :root, isso significa, que essa variável vai estar disponível para qualquer elemento. Faz sentido, declarar neste caso a variável no escopo global já que na página pode existir vários elementos com um design escuro.

A pseudo-classe :root é comumente utilizada para a declaração de variáveis, isso porque, ela é semelhante à raiz de uma árvore e basicamente se refere ao elemento <html> que faz com que todos os outros elementos do documento fiquem contidos dentro dele, assim como os ramos e nós de uma árvore estão contidos na raiz da árvore.

Ao utilizar a pseudo-classe :root para declarar as suas variáveis, lembre-se que ela é semelhante ao seletor de elemento html, exceto que ela possui a especificidade mais alta de 0–0–1–0, enquanto o seletor htmlpossui a especificidade mais baixa de 0–0–0–1.

Escopo Local

O escopo local é a limitação que uma variável CSS vai ter para ser acessível dentro de um determinado elemento.

Como, por exemplo:

#third-box {
    --bg-info: #00ff00;
    background-color: var(--bg-info);
}

#fourth-box {
    background-color: var(--bg-info);
}

No exemplo acima, a variável --bg-info foi declarada no escopo do elemento que possui o id (#third-box), isso significa, que essa variável só vai estar disponível dentro deste elemento, ou seja, a cor de fundo só vai ser aplicada nele ou nos elementos dentro dele.

Enquanto ao tentar chamar a mesma variável para o elemento com id (#fourth-box) ela é "especificada como não definida" e a cor de fundo não será aplicada. Se você tiver a certeza que apenas alguns elementos na página vai receber um estilo específico, faz sentido usar o escopo local no elemento pai desses elementos.

Dependendo da sua necessidade, você pode declarar a variável com o mesmo nome ou com outros valores diferentes para elementos distintos:

#third-box {
    --bg-info: #00ff00;
    background-color: var(--bg-info);
}

#fourth-box {
    --bg-info: #0000ff;
   background-color: var(--bg-info);
}

No exemplo acima, as variáveis estão sendo declaradas em escopos diferentes (cada variável possui o seu próprio escopo), isso quer dizer que não são as mesmas variáveis.

---

Função var()

Como foi visto anteriormente nos exemplos, a função var() do CSS é usada para referenciar e aplicar os valores das variáveis CSS em diferentes propriedades ao longo do código:

:root {
    --text-dark: #0e0e0e;
}

.section-alert {
    color: var(--text-dark);
}

Mas, existe uma funcionalidade a mais que cerca essa função que é o valor de fallback que veremos logo a seguir, no qual pode ser útil ao trabalhar com Custom elements e Shadow DOM.

Valor de Fallback

O valor de fallback é um valor alternativo na função var() usado quando a variável fornecida não estiver definida ou for inválida.

A sintaxe é bem simples, a função var() aceita dois argumentos separados por uma vírgula, por tanto, o primeiro argumento é o nome da variável e caso for definido um segundo argumento ele será o valor de fallback que será usado no lugar da variável indisponível.

Como, por exemplo:

.section-alert {
    color: var(--text-dark, #202020);
}

No exemplo acima, se a variável text-dark não estiver disponível o valor #202020 será utilizado na propriedade.

Entenda que o valor de fallback não é usado para oferecer um valor alternativo para navegadores que não oferecem suporte a variáveis e sim, para navegadores que oferecem suporte a variáveis para que o mesmo possa escolher um valor diferente se a variável fornecida não estiver definida ou tiver um valor inválido.

Múltiplos Valores de Fallback

Como a função var() aceita apenas dois argumentos, caso você faça algo semelhante ao exemplo abaixo será considerado inválido:

.section-info {
    color: var(--text-dark, #202020, #454545);
}

Porém, você consegue fornecer mais de um valor de fallback, definindo no segundo argumento da função var() outra função var():

.section-info {
    color: var(--text-dark, var(--text-normal, #454545));
}

No exemplo acima, caso a variável --text-dark esteja indisponível será usado a variável --text-normal e que por sua vez, se também não estiver disponível será usado o valor de argumento #454545.

---

Valores Inválidos de Propriedades e Variáveis

Se você tentar atribuir um valor qualquer a uma propriedade normal que seja inválido, quando o navegador encontrar este valor ele simplesmente vai descartar e os elementos vão receber os valores que teriam se a declaração simplesmente não existisse.

Como, por exemplo:

div {
    background-color: orange;
}

div {
    background-color: 4rem;
}

No exemplo acima, foi especificado o valor de 4rem a propriedade background-color da segunda regra, esse valor definitivamente está incorreto já que essa propriedade e todas as propriedades do CSS aceita um determinado conjunto de valores válidos. O valor 4rem é comum e pode ser utilizado em propriedades como font-size, padding, margine etc.

Nesse caso, por conta do valor ser inválido para essa propriedade a declaração é descartada e o resultado é como se a regra não existisse ou seja, a primeira regra será aplicada e a cor de fundo da div ficará laranja.

Isso ocorre, porque o navegador segue as regras da cascata no processamento e renderização de estilos. Quando várias regras se aplicam ao mesmo elemento, o navegador precisa determinar qual delas deve prevalecer. Essas regras são brevemente avaliadas com base em sua especificidade e ordem de precedência (no caso do exemplo anterior pelo fato das duas regras terem seletores com a mesma especificidade foi levado em conta a ordem de precedência).

Por tanto, quando o navegador encontra uma declaração com um valor inválido para uma propriedade normal, ele entende que essa declaração não é válida e a descarta. O navegador então passa para a próxima declaração que seja possivelmente válida. Se não houver mais nenhuma declaração aplicável, o navegador utiliza o valor herdado ou inicial do elemento.

Isso garante, uma melhor experiência de navegação estável e confiável para os usuários, evitando que os elementos sejam exibidos de forma confusa ou não intencional quando não há declarações de estilo explícitas.

No entanto, as variáveis vão se comportar de maneira diferente em relação as propriedades normais. Quando o navegador encontra uma função var() referenciando uma variável inválida, o valor inicial ou herdado da propriedade é usado.

O exemplo abaixo é exatamente o do exemplo anterior, exceto que é usado uma variável:

:root {
    --bg-color: 4rem;
}

div {
    background-color: orange;
}

div {
    background-color: var(--bg-color);
}

Nesse caso, o valor 4rem da variável é inválido para a propriedade background-color da última regra e a ordem de precedência não será levada em consideração aqui, ou seja, a cor orange da segunda regra não será aplicada. Como a propriedade background-color não é herdável, o navegador aplicará o valor inicial dessa propriedade, que é transparente ou rgba(0, 0, 0, 0).

---

Conclusão

Essas são as variáveis CSS que podem ser usadas em diversos momentos e situações para fornecer maior flexibilidade e reutilização de código. Portanto, se você precisar definir valores comuns, trabalhar com responsividade ou criar temas e personalização, pode ser muito útil utilizar variáveis CSS. Elas não apenas simplificam o processo de manutenção do código, mas também tornam o design mais consistente e fácil de ajustar conforme necessário. Adotar variáveis CSS é uma prática inteligente que pode elevar a eficiência e a qualidade de seus projetos de desenvolvimento web.