Saltar al contenido
Alea0.1
Pro
  1. Alea
  2. Componentes
  3. Capas
  4. Toggletip e InfoLabel

Capas

Toggletip e InfoLabel

Un botón pequeño de información que abre un popover al presionarlo, con título, texto y enlaces; tres íconos y dos tamaños. InfoLabel pone uno junto a la etiqueta de un campo.

import { Toggletip, InfoLabel } from '@alea/ui';

Ejemplos

Toggletip e InfoLabel

Un pequeño botón de información que abre un popover al presionarlo, con un título y enlaces. InfoLabel pone uno junto a la etiqueta de un campo.

Usage this month

Legacy export

Tokens

Los tokens de diseño que usa este componente, con su valor en el tema actual. Cambia cualquiera para darle otro estilo.

Color

  • --alea-status-warning…
  • --alea-surface-hover…
  • --alea-text…
  • --alea-text-muted…

Type

  • --alea-font-size-sm…

Props

Toggletip props

Un pequeño botón de información que abre un popover al presionarlo: para explicaciones que la gente quizá quiera leer, con enlaces si hace falta. Escape o un clic afuera lo cierra.

PropTipoPor defectoDescripción
childrenobligatoriaReactNode-Lo que dice el popover. Puede tener enlaces y botones (a diferencia de un Tooltip).
aria-labelstring-El nombre del botón para lectores de pantalla. Por defecto "Más información".
icon"warning" | "info" | "help"'info'El ícono: info (por defecto), help o warning.
placement"start" | "end" | "bottom" | "top"'top'Dónde se abre. Por defecto top.
size"sm" | "md"'sm'sm (ícono de 16 px, por defecto) o md (20 px).
titleReactNode-Un título arriba del popover.

InfoLabel props

Una etiqueta con un botón de información al lado, para campos que necesitan una explicación más larga que el texto de ayuda.

PropTipoPor defectoDescripción
childrenobligatoriaReactNode-El texto de la etiqueta.
infoobligatoriaReactNode-Lo que explica el botón de información.
aria-labelstring-El nombre del botón para lectores de pantalla. Por defecto "Más información".
classNamestring-Clases extra.
htmlForstring-El id del campo que etiqueta, para usarla como etiqueta del campo.
icon"warning" | "info" | "help"-El ícono: info (por defecto), help o warning.
isRequiredboolean-Marca el campo como obligatorio.
placement"start" | "end" | "bottom" | "top"-Dónde se abre. Por defecto top.
size"sm" | "md"-sm (ícono de 16 px, por defecto) o md (20 px).
titleReactNode-Un título arriba del popover.

Especificaciones

Generado desde el código: las variantes de los tipos, los estados y tokens del CSS, y los patrones de motion que aplican. Las grillas muestran el componente real en ambos temas; los números se miden en la página.

Toggletip

Variantes
iconwarninginfohelp
placementstartendbottomtop
sizesmmd
Estados
HoverPressed
Oscuro y claro
Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
Clases para estilos
.alea-toggletip-btn.alea-toggletip
Atributos data
data-size=mddata-icon=warning

InfoLabel

Variantes
iconwarninginfohelp
placementstartendbottomtop
sizesmmd
Oscuro y claro
Cada color viene de tokens del tema, así que sigue a data-theme (y a presets como Graphite) en la página o en cualquier contenedor. El contraste se revisa en ambos temas.
Clases para estilos
.alea-info-label.alea-label-required

Accesibilidad

  • Un botón real llamado "Más información" (o tu texto) que abre un diálogo en popover; Escape lo cierra y el foco vuelve al botón.
  • A diferencia de un tooltip, se abre al presionarlo y puede tener enlaces, así que funciona en pantallas táctiles y con lectores de pantalla.

Teclado

TeclaAcción
Enter o EspacioLo abre
EscapeLo cierra
TabEntra a sus enlaces

Qué hacer y qué evitar

Hacer

  • Úsalo para explicaciones que la gente puede querer, no para algo que necesita para terminar la tarea.

Evitar

  • No escondas errores ni pasos obligatorios en un toggletip.
Probado con axe, teclado y roles de lector de pantalla