
O Astro aplica escopo ao CSS escrito em <style> dentro de um componente. Estilos globais e seletores :global() ampliam esse alcance.
| 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-….
| 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'
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:
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 |