Mini Widgets
Badges
Badge en React
Muestra estados o marcas breves en tablas, tarjetas y formularios.
Referencia para @arcrider/arcwidgets-react@0.1.0-alpha.5. <a href="/docs/react/intro/setup-react">Instalación</a> · <a href="/docs/react/intro/react-components">Todos los componentes</a>.
Ejemplo completo
import { ArcWidgetBadge, ArcWidgetLayout } from '@arcrider/arcwidgets-react';
const svg = (d: string) => ( <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" style={{ width: '1em', height: '1em', fill: 'currentColor' }} > <path d={d} /> </svg> );
const iconCheck = svg( 'M229.66,77.66l-128,128a8,8,0,0,1-11.32,0l-56-56a8,8,0,0,1,11.32-11.32L96,188.69,218.34,66.34a8,8,0,0,1,11.32,11.32Z', ); const iconClock = svg( 'M128,24A104,104,0,1,0,232,128,104.11,104.11,0,0,0,128,24Zm0,192a88,88,0,1,1,88-88A88.1,88.1,0,0,1,128,216Zm64-88a8,8,0,0,1-8,8H128a8,8,0,0,1-8-8V72a8,8,0,0,1,16,0v48h48A8,8,0,0,1,192,128Z', ); const iconWarning = svg( 'M236.8,188.09,149.35,36.22a24.76,24.76,0,0,0-42.7,0L19.2,188.09a23.51,23.51,0,0,0,0,23.72A24.35,24.35,0,0,0,40.55,224h174.9a24.35,24.35,0,0,0,21.33-12.19A23.51,23.51,0,0,0,236.8,188.09ZM120,104a8,8,0,0,1,16,0v40a8,8,0,0,1-16,0Zm8,88a12,12,0,1,1,12-12A12,12,0,0,1,128,192Z', ); const iconX = svg( 'M205.66,194.34a8,8,0,0,1-11.32,11.32L128,139.31,61.66,205.66a8,8,0,0,1-11.32-11.32L116.69,128,50.34,61.66A8,8,0,0,1,61.66,50.34L128,116.69l66.34-66.35a8,8,0,0,1,11.32,11.32L139.31,128Z', ); const iconDot = svg('M128,48a80,80,0,1,0,80,80A80,80,0,0,0,128,48Z');
// One singleColor derives text, icon, background and border. const statuses = [ { value: 'Active', icon: iconCheck, singleColor: '#16A34A' }, { value: 'Online', icon: iconDot, singleColor: '#0EA5E9' }, { value: 'In progress', icon: iconClock, singleColor: '#D97706' }, { value: 'Warning', icon: iconWarning, singleColor: '#CA8A04' }, { value: 'Error', icon: iconX, singleColor: '#DC2626' }, { value: 'Inactive', singleColor: '#64748B' }, ];
export default function Example() { return ( <ArcWidgetLayout data={{ direction: 'horizontal', alignX: 'center', alignY: 'center', width: '100%', height: '100%', gap: '12px', paddingX: '24px', backgroundColor: '#F8FAFC', border: { radius: '12px' }, blocks: statuses.map((status) => ({ width: 'auto', value: ( <ArcWidgetBadge data={{ iconPosition: 'left', fontWeight: '600', ...status }} /> ), })), }} /> ); }</code></pre>
Props del componente
id
ID de DOM opcional. No es necesario en el uso normal; se genera automáticamente si se omite.
data
Configuración de tipo ArcWidgetBadgeData. Pasa los cambios como objetos nuevos; gestiona los datos de negocio y la selección en el estado de React.
onAction
Fallback opcional (type: string, ...args: unknown[]) => unknown. El callback concreto tiene prioridad. Detalles: <a href="/docs/react/patterns/react-state-events">Estado y eventos</a>.
Este widget es un componente de representación y no ofrece callbacks de interacción propios.
Configuración
Los siguientes campos pertenecen a data. Los tamaños se indican como strings, los números y valores de tiempo según su tipo respectivo.
value
Etiqueta del badge; los valores vacíos no muestran ninguna etiqueta.
Tipo: ArcWidgetSlot.
icon
Contenido del icono; solo se renderiza si iconPosition está establecido.
Tipo: ArcWidgetSlot.
width
Ancho del badge; por defecto se ajusta a su contenido.
Tipo: string.
height
Alto del badge; 'auto' mantiene la altura del contenido.
Tipo: string.
iconPosition
Lado de la etiqueta en el que se coloca el icono; sin este campo el icono queda oculto.
Tipo: 'left' | 'right'.
iconSize
Ancho y alto de un icono SVG; 'auto' mantiene el valor por defecto. Valor por defecto: 1.15em.
Tipo: string.
iconColor
Color de relleno de un icono SVG; recurre a singleColor.
Tipo: string.
fontColor
Color de la fuente; recurre a singleColor. Valor por defecto: #3e6fff.
Tipo: string.
fontSize
Tamaño de fuente como valor CSS. Valor por defecto: 12px.
Tipo: string.
fontWeight
Grosor de la fuente. Valor por defecto: 400.
Tipo: string | number.
backgroundColor
Color de fondo; recurre a singleColor con un 20 % de opacidad. Valor por defecto: #dbe4ff.
Tipo: string.
borderColor
Color del borde de 1px; establécelo igual que backgroundColor para un aspecto sin borde. Recurre a singleColor con un 40 % de opacidad. Valor por defecto: #3E6FFF.
Tipo: string.
borderRadius
Redondeo de las esquinas. Valor por defecto: 0.6em.
Tipo: string.
singleColor
Color hexadecimal de seis dígitos, p. ej. '#16A34A', del que se derivan los colores de fuente, icono, fondo y borde cuando se omiten.
Tipo: string.
paddingX
Espaciado interno a izquierda y derecha. Valor por defecto: 0.3em.
Tipo: string.
paddingY
Espaciado interno arriba y abajo. Valor por defecto: 0.25em.
Tipo: string.
Comportamiento y límites
value admite texto y JSX. Para colores de estado uniformes puedes establecer singleColor o diseñar el fondo y la fuente por separado.
- El badge no tiene un callback de clic propio. Usa un botón envolvente si el estado debe ser interactivo.
Los campos ArcWidgetSlot admitidos permiten elementos JSX individuales, texto o descriptores de widget. Pasa texto externo como texto JSX; los strings HTML se interpretan como HTML. <a href="/docs/react/patterns/nested-widget-descriptors">Combinar contenidos</a>.
Tipos de datos
Estos tipos relacionados con el widget se exportan desde el paquete. También están disponibles tipos comunes como ArcWidgetSlot, ArcWidgetStyles y ArcReactWidgetProps. Los objetos de configuración son cerrados, por lo que una clave mal escrita o no admitida se notifica como error de tipo.
export interface ArcWidgetBadgeData {
value?: ArcWidgetSlot;
icon?: ArcWidgetSlot;
iconPosition?: 'left' | 'right';
width?: string;
height?: string;
iconSize?: string;
iconColor?: string;
fontColor?: string;
fontSize?: string;
fontWeight?: string | number;
backgroundColor?: string;
borderColor?: string;
borderRadius?: string;
singleColor?: string;
paddingX?: string;
paddingY?: string;
}
export interface ArcWidgetBadgeProps extends ArcReactWidgetProps<ArcWidgetBadgeData> {}</code></pre>