Mini Widgets
Custom Slider
Slider en React
Modifica un valor numérico dentro de un rango fijo, por ejemplo una ocupación o un objetivo.
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
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 ArcWidgetSliderData. 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>.
onChange
El usuario ha soltado el regulador o ha pulsado la barra. Recibe el nuevo valor; adóptalo en tu estado.
onChange?: (value: number) => void;
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
Valor actual, limitado a min…max. Valor por defecto: min.
Tipo: number.
min
Valor mínimo. Valor por defecto: 0.
Tipo: number.
max
Valor máximo. Valor por defecto: 100.
Tipo: number.
step
Incremento al arrastrar o al pulsar la barra. Valor por defecto: 1.
Tipo: number.
width
Ancho del widget, p. ej. "300px".
Tipo: string.
height
Altura del widget, p. ej. "40px".
Tipo: string.
track
Aspecto de la barra: height, backgroundColor, borderRadius.
Tipo: ArcWidgetSliderTrackStyle.
fill
Aspecto de la parte rellena: backgroundColor.
Tipo: ArcWidgetSliderFillStyle.
thumb
Aspecto del regulador: width, height, backgroundColor, borderColor, borderWidth, borderRadius.
Tipo: ArcWidgetSliderThumbStyle.
valueDisplay
Valor actual junto al slider: show (por defecto true), color, fontSize.
Tipo: ArcWidgetSliderValueDisplay.
statusDisplay
Entradas de estado por rango de valores. Una entrada se aplica mientras el valor es igual o superior a su value; gana la entrada coincidente más alta, que muestra su label en color y sobrescribe track, fill y thumb.
Tipo: ArcWidgetSliderStatusDisplay[].
Comportamiento y límites
onChangeentrega un número. Adóptalo en tu estado y devuélvelo comodata.value.
- Define
min,maxystepcon valores razonables. El widget no guarda nada por sí mismo; conserva el valor en tu propio estado.
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 ArcWidgetSliderTrackStyle {
height?: string;
backgroundColor?: string;
borderRadius?: string;
}
export interface ArcWidgetSliderFillStyle { backgroundColor?: string; }
export interface ArcWidgetSliderThumbStyle { width?: string; height?: string; backgroundColor?: string; borderColor?: string; borderWidth?: string; borderRadius?: string; }
export interface ArcWidgetSliderValueDisplay { show?: boolean; color?: string; fontSize?: string; }
export interface ArcWidgetSliderStatusDisplay { value: number; label: string; color?: string; track?: ArcWidgetSliderTrackStyle; fill?: ArcWidgetSliderFillStyle; thumb?: ArcWidgetSliderThumbStyle; }
export interface ArcWidgetSliderData { value?: number; min?: number; max?: number; step?: number; width?: string; height?: string; track?: ArcWidgetSliderTrackStyle; fill?: ArcWidgetSliderFillStyle; thumb?: ArcWidgetSliderThumbStyle; valueDisplay?: ArcWidgetSliderValueDisplay; statusDisplay?: ArcWidgetSliderStatusDisplay[]; }
export interface ArcWidgetSliderProps extends ArcReactWidgetProps<ArcWidgetSliderData> { onChange?: (value: number) => void; }</code></pre>