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

Otimização de fontes

O módulo next/font otimiza automaticamente suas fontes e remove requisições de rede externas, para mais privacidade e desempenho.

Ele inclui hospedagem própria integrada para qualquer arquivo de fonte. Isso significa que você pode carregar fontes web de forma otimizada, sem deslocamento de layout.

Para começar a usar o next/font, importe-o de next/font/local ou next/font/google, chame-o como uma função com as opções apropriadas e defina o className do elemento ao qual você quer aplicar a fonte. Por exemplo:

app/layout.tsx
import { Geist } from 'next/font/google'

const geist = Geist({
  subsets: ['latin'],
})

export default function Layout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en" className={geist.className}>
      <body>{children}</body>
    </html>
  )
}

As fontes têm escopo no componente em que são usadas. Para aplicar uma fonte a todo o app, adicione-a ao Layout raiz.

Google Fonts

Você pode hospedar qualquer Google Font por conta própria, de forma automática. As fontes são incluídas como arquivos estáticos e servidas a partir do mesmo domínio do seu deploy, o que significa que o navegador não envia requisições ao Google quando o usuário visita seu site.

Para começar a usar uma Google Font, importe a fonte escolhida de next/font/google:

app/layout.tsx
import { Geist } from 'next/font/google'

const geist = Geist({
  subsets: ['latin'],
})

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en" className={geist.className}>
      <body>{children}</body>
    </html>
  )
}

Recomendamos usar fontes variáveis para o melhor desempenho e flexibilidade. Mas, se não puder usar uma fonte variável, será necessário especificar um peso:

app/layout.tsx
import { Roboto } from 'next/font/google'

const roboto = Roboto({
  weight: '400',
  subsets: ['latin'],
})

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en" className={roboto.className}>
      <body>{children}</body>
    </html>
  )
}

Fontes locais

Para usar uma fonte local, importe a função localFont de next/font/local e especifique o src do arquivo da fonte local. O caminho é relativo ao arquivo em que você chama localFont. Você pode guardar as fontes em qualquer lugar do projeto, inclusive na pasta public ou junto do código, dentro da pasta app. Por exemplo, para usar uma fonte armazenada em app/fonts/:

app/layout.tsx
import localFont from 'next/font/local'

const myFont = localFont({
  src: './my-font.woff2',
})

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en" className={myFont.className}>
      <body>{children}</body>
    </html>
  )
}

Se você quiser usar vários arquivos para uma única família de fontes, src pode ser um array:

const roboto = localFont({
  src: [
    {
      path: './Roboto-Regular.woff2',
      weight: '400',
      style: 'normal',
    },
    {
      path: './Roboto-Italic.woff2',
      weight: '400',
      style: 'italic',
    },
    {
      path: './Roboto-Bold.woff2',
      weight: '700',
      style: 'normal',
    },
    {
      path: './Roboto-BoldItalic.woff2',
      weight: '700',
      style: 'italic',
    },
  ],
})

Referência da API

Veja a Referência da API com o conjunto completo de recursos do Next.js Font