Resumen
UseTag para categorías, prioridades u otros atributos breves. Conserve una etiqueta de texto para que el significado no dependa del color. Use Estado cuando necesite un indicador de estado y comentarios de carga.
”Uso”
color es obligatorio y acepta un color del tema o transparent. El elemento predeterminado siempre es un span, incluso cuando se proporciona un controlador de clic nativo. Añada un icono decorativo con startIcon; la etiqueta proporciona su significado accesible.
Variantes
soft es el estilo predeterminado. solid resalta la etiqueta, outline añade un borde y ghost elimina el fondo. Use borderStyle="dashed" con outline y weight="medium" para una etiqueta más destacada.
Colores
Mantén la etiqueta significativa sin depender de su color. El catálogo compara el tratamiento suave predeterminado; la misma paleta está disponible para las demás variantes.Filtrar por una etiqueta
render. Coloque su controlador de clic, atributos nativos, ref y estado deshabilitado en ese propietario. Un botón real proporciona foco y activación con Intro y Espacio. El estado de selección corresponde a su aplicación; use aria-pressed para un interruptor y un estilo visible para el estado seleccionado. Para la navegación, renderiza un enlace con su destino, como <a href="/records" />. Los propietarios nativos conservan la apariencia de Tag.
Etiquetas largas
De forma predeterminada,truncate={true} trunca las etiquetas de texto con restricciones y muestra su texto completo en una descripción emergente al pasar el cursor. Establece truncate={false} para mantener la etiqueta completa en su ancho natural sin una descripción emergente, incluso cuando su elemento principal sea más estrecho. El diseño del elemento principal gestiona el ajuste de línea, el desplazamiento y el recorte.
”Props”
Los tipos y valores predeterminados se generan a partir de los tipos públicos del componente. También se aceptan atributos nativos y controladores de eventos."dashed" | "solid"
predeterminado:"solid"
Border style used by the outline variant.
"amber" | "blue" | "bronze" | "brown" | "crimson" | "cyan" | "gold" | "grass" | "gray" | "green" | "iris" | "jade" | "lime" | "mint" | "orange" | "pink" | "plum" | "purple" | "red" | "ruby" | "sky" | "tomato" | "transparent" | "turquoise" | "violet" | "yellow"
requerido
Theme color for the tag, or
transparent for an unfilled label.MouseEventHandler<HTMLSpanElement>
Native click handler. Does not change the default span or add keyboard activation.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, TagState>
Replaces the default span. Compose a button or link to provide explicit interaction semantics.
ReactNode
Decorative icon before the label. Hidden from assistive technology.
boolean
predeterminado:"true"
Truncates constrained string labels and exposes the full text in a tooltip. Set to
false to keep the full label at its natural width without a tooltip, even inside a narrower parent."ghost" | "outline" | "soft" | "solid"
predeterminado:"soft"
Visual treatment of the tag background and border.
"medium" | "regular"
predeterminado:"regular"
Font weight of the label.