Pular para o conteúdo
Tipografia

Link

/componentes/link.mdmarkdown cru, para quem lê com agent em vez de olho

Na frase

O pedido saiu para entrega. Veja o rastreio do pedido ou volte para a lista de entregas.

Para fora do site

Para registrar uma reclamação, use o Consumidor.gov.br (abre em nova aba).

Tons e sublinhado ao passar

Com o link do router

Importar
import { Link } from '@rivocode/ui'

Quando usar

A âncora da casa: sublinhada, com anel de foco visível, nos tons de texto do tema.

<Link href="/pedidos">Ver pedidos</Link>

O sublinhado vem ligado. No meio de uma frase a cor sozinha não basta para separar o link do texto em volta, e quem não distingue a cor fica sem saber onde clicar. underline="hover" só sublinha ao passar, e só vale fora do texto corrido: numa lista de links do rodapé ou da navegação, onde a posição já diz que aquilo é link.

tone escolhe a cor: accent é o link solto na página, neutral e muted servem à lista de links, e inherit pega a cor da frase. Use inherit dentro de um Alert ou de qualquer fundo de estado, onde a cor do tom já foi medida contra aquele fundo e o acento não foi.

Para fora do site

external abre em outra aba com rel="noopener noreferrer", desenha a seta de saída e diz "(abre em nova aba)" ao leitor de tela, depois do texto do link. Quem enxerga vê a seta; quem ouve, a frase. O labels.external troca a frase, e o rel que você passar é mantido, somado aos dois de segurança.

<Link href="https://www.consumidor.gov.br" external>
  Consumidor.gov.br
</Link>

O render troca a âncora pelo link do seu router, e o desenho continua o daqui. O href, a navegação e o pré-carregamento passam a ser do router.

import { Link } from '@rivocode/ui'
import { NavLink } from 'react-router'

<Link render={<NavLink to="/clientes" />}>Ver todos os clientes</Link>

Quase todo router também exporta um Link, e os dois nomes não cabem no mesmo arquivo. Renomeie um deles na importação (import { Link as RouterLink } from 'react-router'), ou use o NavLink, como acima.

Quando não usar

  • Ação que muda alguma coisa: Button. Link navega, botão age: salvar, excluir, abrir um diálogo e enviar um formulário são ações, e um link que faz isso não responde à barra de espaço, não abre em outra aba e mente para quem ouve a tela.
  • Navegação que precisa parecer botão, como o "Novo pedido" do topo da página: Button com render={<a href="…" />}. A tag continua sendo de link, e o desenho é o do botão.
  • Item de menu que leva a outra página: MenuLinkItem, que anda pelas setas junto com os outros itens do menu.

No React Native

Traduz, como um Text com accessibilityRole="link", e por isso vai dentro da frase como no web: <Text>Veja o <Link href="…">espelho</Link>.</Text> quebra linha junto com o texto em volta. tone tem os mesmos quatro valores, e o sublinhado é fixo.

Quem navega é o onPress, e não um render. Não há âncora no React Native para trocar pela do router, então a composição do web vira callback: onPress={() => router.push("/pedidos")}. Sem onPress, o toque abre o href pelo Linking, que é o caminho para https:, mailto: e tel:.

external desenha a seta e avisa pela dica, a accessibilityHint, que o leitor de tela lê depois do nome; o texto é o labels.external, e o padrão é “Abre fora do app.”. Quando o filho é texto puro, o nome acessível é ele, sem a seta. A seta é o ArrowUpRight do lucide-react-native, o mesmo do web; ela pinta o papel do tone, e com inherit a cor do style quando ela vem, ou fg sem ela, porque o SVG não herda a cor do texto de fora. Não há underline: no toque não existe passar por cima, e o sublinhado é sempre o do texto corrido.

API

PropTipoPadrão
external

Abre em outra aba, com `rel="noopener noreferrer"`, desenha a seta de saida e avisa o leitor de tela com o `labels.external`.

booleanfalse
labels

Os textos da peca, para trocar o idioma: `external` e o aviso que o leitor de tela ouve depois do texto de um link `external`, "(abre em nova aba)" sem ele.

Partial<LinkLabels>sem padrão
refRef<HTMLAnchorElement>sem padrão
render

Troca o elemento mantendo a aparencia, para o link do router: `<Link render={<RouterLink to="/pedidos" />}>`.

ReactElement<unknown, string | JSXElementConstructor<any>>sem padrão
tone

O papel de cor.

LinkTone"accent"
underline

`always` sublinha sempre, e e o que a pagina precisa quando o link mora no meio de uma frase: a cor sozinha nao basta para quem nao distingue a cor.

"always" | "hover""always"

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.