Pular para o conteúdo
Documentação do Next.js PT-BR

Como usar CSS no seu app

O Next.js oferece várias formas de estilizar seu app usando CSS, incluindo:

Tailwind CSS

O Tailwind CSS é um framework CSS utility-first que oferece classes utilitárias de baixo nível para criar designs personalizados.

Instale o Tailwind CSS:

pnpm add -D tailwindcss @tailwindcss/postcss

Adicione o plugin do PostCSS ao seu arquivo postcss.config.mjs:

postcss.config.mjs
export default {
  plugins: {
    '@tailwindcss/postcss': {},
  },
}

Importe o Tailwind no seu arquivo CSS global:

styles/globals.css
@import 'tailwindcss';

Importe o arquivo CSS no seu arquivo pages/_app.js:

pages/_app.js
import '@/styles/globals.css'

export default function MyApp({ Component, pageProps }) {
  return <Component {...pageProps} />
}

Agora você já pode usar as classes utilitárias do Tailwind no seu app:

pages/index.tsx
export default function Home() {
  return (
    <main className="flex min-h-screen flex-col items-center justify-between p-24">
      <h1 className="text-4xl font-bold">Welcome to Next.js!</h1>
    </main>
  )
}

Bom saber: se você precisar de suporte a navegadores muito antigos, veja as instruções de configuração do Tailwind CSS v3.

CSS Modules

Os CSS Modules limitam o escopo do CSS localmente, gerando nomes de classes únicos. Isso permite usar a mesma classe em arquivos diferentes sem se preocupar com colisões de nomes.

Para começar a usar CSS Modules, crie um novo arquivo com a extensão .module.css e importe-o em qualquer componente dentro do diretório pages:

styles/blog.module.css
.blog {
  padding: 24px;
}
pages/blog/index.tsx
import styles from '@/styles/blog.module.css'

export default function Page() {
  return <main className={styles.blog}></main>
}

CSS global

Você pode usar CSS global para aplicar estilos em todo o seu app.

Importe a folha de estilo no arquivo pages/_app.js para aplicar os estilos a todas as rotas do seu app:

pages/_app.js
import '@/styles/global.css'

export default function MyApp({ Component, pageProps }) {
  return <Component {...pageProps} />
}

Por causa da natureza global das folhas de estilo, e para evitar conflitos, você deve importá-las dentro de pages/_app.js.

Folhas de estilo externas

O Next.js permite importar arquivos CSS a partir de um arquivo JavaScript. Isso é possível porque o Next.js estende o conceito de import além do JavaScript.

Importe estilos de node_modules

Desde o Next.js 9.5.4, é permitido importar um arquivo CSS de node_modules em qualquer lugar do seu app.

Para folhas de estilo globais, como bootstrap ou nprogress, importe o arquivo dentro de pages/_app.js. Por exemplo:

pages/_app.js
import 'bootstrap/dist/css/bootstrap.css'

export default function MyApp({ Component, pageProps }) {
  return <Component {...pageProps} />
}

Para importar o CSS exigido por um componente de terceiros, você pode fazer isso no componente. Por exemplo:

components/example-dialog.js
import { useState } from 'react'
import { Dialog } from '@reach/dialog'
import VisuallyHidden from '@reach/visually-hidden'
import '@reach/dialog/styles.css'

function ExampleDialog(props) {
  const [showDialog, setShowDialog] = useState(false)
  const open = () => setShowDialog(true)
  const close = () => setShowDialog(false)

  return (
    <div>
      <button onClick={open}>Open Dialog</button>
      <Dialog isOpen={showDialog} onDismiss={close}>
        <button className="close-button" onClick={close}>
          <VisuallyHidden>Close</VisuallyHidden>
          <span aria-hidden>×</span>
        </button>
        <p>Hello there. I am a dialog</p>
      </Dialog>
    </div>
  )
}

Ordem e mesclagem

O Next.js otimiza o CSS nos builds de produção dividindo (mesclando) automaticamente as folhas de estilo em partes. A ordem do seu CSS depende da ordem em que você importa os estilos no código.

Por exemplo, base-button.module.css vai ficar antes de page.module.css, já que <BaseButton> é importado antes de page.module.css:

page.tsx
import { BaseButton } from './base-button'
import styles from './page.module.css'

export default function Page() {
  return <BaseButton className={styles.primary} />
}
base-button.tsx
import styles from './base-button.module.css'

export function BaseButton() {
  return <button className={styles.primary} />
}

Recomendações

Para manter a ordem do CSS previsível:

  • Tente concentrar as importações de CSS em um único arquivo de entrada JavaScript ou TypeScript
  • Importe estilos globais e folhas do Tailwind na raiz do seu app.
  • Use o Tailwind CSS para a maioria das necessidades de estilo, já que ele cobre padrões de design comuns com classes utilitárias.
  • Use CSS Modules para estilos específicos de componentes quando as classes utilitárias do Tailwind não forem suficientes.
  • Adote uma convenção de nomes consistente para os seus CSS Modules. Por exemplo, use <name>.module.css em vez de <name>.tsx.
  • Extraia estilos compartilhados para componentes compartilhados, evitando importações duplicadas.
  • Desative linters ou formatadores que ordenam importações automaticamente, como a regra sort-imports do ESLint.
  • Você pode usar a opção cssChunking no next.config.js para controlar como o CSS é dividido.

Desenvolvimento e produção

  • Em desenvolvimento (next dev), as alterações de CSS são aplicadas na hora, com o Fast Refresh.
  • Em produção (next build), todos os arquivos CSS são automaticamente concatenados em vários arquivos .css minificados e divididos por rota (code-split), garantindo que a menor quantidade possível de CSS seja carregada para cada rota.
  • O CSS continua sendo carregado em produção mesmo com o JavaScript desativado, mas em desenvolvimento o JavaScript é necessário para o Fast Refresh.
  • A ordem do CSS pode se comportar de forma diferente em desenvolvimento. Sempre confira o build (next build) para verificar a ordem final do CSS.

Próximos passos

Saiba mais sobre os recursos mencionados nesta página.