Ir para o conteúdo
Promovaweb

Estilos e CSS

Revisado em

O Astro aplica escopo ao CSS escrito em <style> dentro de um componente. Estilos globais e seletores :global() ampliam esse alcance.

Formas de aplicar CSS

Forma Alcance
<style> HTML escrito no próprio componente
<style is:global> Seletores sem escopo local
article :global(p) Parágrafos dentro do article escopado, incluindo conteúdo externo
import '../styles/global.css' CSS global nas páginas que carregam o import
<link rel="stylesheet" href="/estilos.css" /> Arquivo de public/, carregado sem processamento do Astro

Escopo do componente

O compilador associa os seletores aos elementos do componente. Na estratégia padrão, o HTML recebe um atributo data-astro-cid-….

<header>
<a href="/">Início</a>
</header>
<style>
header {
display: flex;
padding: 1rem;
}
</style>
Elemento Recebe o estilo de header do exemplo?
<header> escrito nesse componente Sim
<header> de outro componente Não
<footer> do mesmo componente Não, pois o seletor é header

Estilos globais no layout

Local Conteúdo
src/styles/global.css Estilos compartilhados, como fonte e margem do body
Frontmatter de um layout Importação do arquivo CSS
Páginas que usam o layout Carregam os estilos importados

O nome global.css é convencional. A importação de CSS externo não aplica escopo de componente.

---
import '../styles/global.css'
---
<slot />

Estilos para Markdown e slots

Seletor no <style> local Efeito
article p Exige que os elementos correspondam ao escopo do componente
article :global(p) Mantém o escopo no article e alcança os parágrafos internos
:global(p) Alcança parágrafos sem exigir o escopo local

O HTML renderizado de Markdown não recebe o escopo do componente que o envolve. O seletor article :global(p) alcança os parágrafos desse conteúdo:

<article>
<slot />
</article>
<style>
article :global(p) {
line-height: 1.7;
}
</style>

Diretivas de classes e estilos

Sintaxe Função
class:list={['aviso', { ativo: true }]} Produz class="aviso ativo"
class:list={['aviso', false, null]} Descarta valores falsos e produz class="aviso"
<style define:vars={{ cor }}> Expõe um valor do frontmatter como variável CSS, acessível por var(--cor)
<style is:global> Desativa o escopo do bloco
<style is:inline> Mantém o bloco sem processamento, sem escopo e na posição escrita

Tailwind e Sass

Ferramenta Instalação Uso
Tailwind npx astro add tailwind Adiciona o plugin @tailwindcss/vite
Tailwind no CSS @import "tailwindcss"; Arquivo CSS importado no layout ou na página
Sass npm install sass <style lang="scss"> ou <style lang="sass">

Estilos que não aparecem

Sintoma Conferência
Markdown sem o estilo esperado Usar :global() na parte do seletor referente ao conteúdo renderizado
CSS ausente em uma página Conferir se a página carrega o layout ou o import
Declaração sobrescrita Conferir a especificidade e a ordem dos estilos no inspetor do navegador
Tailwind sem efeito Conferir o plugin Vite, o import de tailwindcss e a importação do CSS na página
StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.