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/postcssnpm install -D tailwindcss @tailwindcss/postcssyarn add -D tailwindcss @tailwindcss/postcssbun add -D tailwindcss @tailwindcss/postcssAdicione o plugin do PostCSS ao seu arquivo postcss.config.mjs:
export default {
plugins: {
'@tailwindcss/postcss': {},
},
}Importe o Tailwind no seu arquivo CSS global:
@import 'tailwindcss';Importe o arquivo CSS no seu arquivo 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:
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>
)
}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:
.blog {
padding: 24px;
}import styles from '@/styles/blog.module.css'
export default function Page() {
return <main className={styles.blog}></main>
}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:
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:
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:
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:
import { BaseButton } from './base-button'
import styles from './page.module.css'
export default function Page() {
return <BaseButton className={styles.primary} />
}import { BaseButton } from './base-button'
import styles from './page.module.css'
export default function Page() {
return <BaseButton className={styles.primary} />
}import styles from './base-button.module.css'
export function BaseButton() {
return <button className={styles.primary} />
}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.cssem 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-importsdo ESLint. - Você pode usar a opção
cssChunkingnonext.config.jspara 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.cssminificados 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.