Arc Rider Docs · Markdown

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

  • onChange entrega un número. Adóptalo en tu estado y devuélvelo como data.value.
  • Define min, max y step con 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&lt;ArcWidgetSliderData&gt; { onChange?: (value: number) =&gt; void; }</code></pre>