Pular para o conteúdo
// visualizar em
salvo em todas as páginas

Link

Link que leva a pessoa para outra página, para uma parte desta página ou para um arquivo. Para ações como salvar, copiar ou excluir, use Button.

Padrão WAI-ARIA linkComponente clienteCódigo ↗
minimal · light · #3fa34d
variant

Instalação

Configure o Camaleo uma vez (Instalação) e importe o que precisar. Ele renderiza no servidor.

import { Link } from "@camaleo/react";

Anatomia

Um <a> comum. A variante de destaque coloca uma seta depois do texto. Os dois têm um data-slot que você pode usar no CSS.

Exemplos

Cada exemplo é um arquivo real que você pode copiar. Todos usam o estilo, o modo e a cor escolhidos na barra acima.

minimal · light · #3fa34d

Antes de escolher um estilo, leia o guia de instalação. Leva uns cinco minutos.

Variantes

Use o link padrão dentro de frases, o discreto onde há muitos links juntos (um rodapé, uma linha de termos) e o de destaque para o próximo passo de uma seção.

Link de destaque

Ele fica sozinho numa linha, então ganha uma seta e uma área de toque de 24px de altura, fácil de acertar no celular.

Página atual num menu

Clique numa seção. O aria-current="page" avisa o leitor de tela em qual página a pessoa está; o negrito mostra isso para quem enxerga.

Abre em nova aba

Uma nova aba quebra o botão Voltar, então avise. O ícone mostra isso, e um texto escondido coloca "abre em uma nova aba" no nome que o leitor de tela lê.

Baixar um arquivo

Clique para baixar um CSV de verdade. Coloque o formato e o tamanho no texto, para a pessoa saber o que vem antes de tocar numa conexão lenta.

Pular para o conteúdo
Acme Cobrança

Faturas de outubro

Clique logo acima desta caixa e aperte Tab: a primeira parada é um link que pula o menu.

Pular para o conteúdo

Clique logo acima da caixa e aperte Tab. A primeira parada é um link escondido que aparece com o foco e pula o menu. Assim quem usa teclado não passa pelo menu em toda página.

Com o roteador do Next.js

Passe render={<NextLink href="…" />}. O roteador cuida do clique sem recarregar a página, e o link mantém o visual do estilo.

Em contexto

Links ficam onde a pessoa decide para onde ir. São pedaços inteiros de interface para copiar, no estilo que você escolheu.

O Camaleo 1.0 saiu.
Ler as notas da versão
Aviso de nova versãoLink

Como os estilos funcionam

Cada estilo muda cores, formas e fontes pelos tokens. Seus componentes continuam iguais.

Card com título em linkCard · Link

Boas práticas

FaçaDiga para onde o link leva.

Quem usa leitor de tela costuma pular de link em link. Cada um precisa fazer sentido fora da frase.

Clique aqui para baixar o relatório anual de 2025.

Evite"Clique aqui" ou "Saiba mais".

Numa lista de links, dez "Clique aqui" soam iguais e não dizem nada.

FaçaUm link de destaque para o próximo passo.

Use para o caminho principal de uma seção, como começar um guia.

EviteUm link que exclui, salva ou copia.

Ações são do Button. O leitor de tela anuncia um link como "ir para algum lugar", e ninguém espera que ele mude dados.

Props

PropriedadeTipoPadrãoDescrição
variant"default" | "muted" | "standalone""default"O visual do link: default dentro de frases, muted para links secundários e standalone para um link sozinho, com seta.
renderobject—Troca o elemento renderizado, por exemplo pelo link do Next.js: render={<NextLink href="/docs" />}.

Link aceita todos os atributos de <a>, como href, target, rel, download e aria-current.

Styling hooks

Mude o visual sem copiar o componente: use os atributos ou defina os tokens num elemento pai, num estilo ou no próprio link.

Atributos

data-variantdefault · muted · standalone
aria-currentpage (você define no link da página atual)

Tokens que ele lê

Cor

--cml-accent-text--cml-border--cml-fg--cml-fg-muted--cml-fg-secondary--cml-focus-offset--cml-focus-ring--cml-focus-width--cml-success

Forma e tamanho

--cml-star-size

Tipografia e movimento

--cml-duration-base--cml-duration-fast--cml-ease-standard--cml-font-control--cml-font-weight-control

Só deste componente

--cml-crumb-chevron--cml-item-check--cml-star-fill

Acessibilidade

TabVai para o próximo link.
EnterSegue o link. A barra de espaço não funciona, ao contrário de um botão.

Relacionados

Esta página foi útil? · Editar esta página no GitHub