Panoramica
Progress espone le parti Base UI installate: Root, Track, Indicator, Label e Value. Importale da twenty-ui/primitives/feedback. Usa ProgressBar o ProgressRing per un aspetto pratico con lo stesso contratto semantico.
Utilizzo
Root gestisce il valore controllato e la semantica accessibile della barra di avanzamento. Label fornisce il relativo nome accessibile. Value visualizza il valore formattato. Track e Indicator descrivono il riempimento visivo; la larghezza dell’indicatore deriva dall’intervallo normalizzato della radice. Le parti non impongono un aspetto.
50%, mentre aria-valuenow è 70, aria-valuemin è 20 e aria-valuemax è 120. L’applicazione gestisce le richieste, la tempistica e gli aggiornamenti dell’avanzamento. Non sono presenti defaultValue né un avanzamento automatico.
Valori, intervalli e avanzamento indeterminato
min è impostato per impostazione predefinita su 0 e max su 100. Fornisci limiti finiti con min \< max. I valori finiti esterni all’intervallo vengono limitati per il valore semantico, il valore formattato e il riempimento visivo. Il completamento avviene al valore massimo. La modifica dell’intervallo ricalcola la percentuale senza modificare il valore non elaborato fornito dall’applicazione.
Passa value={null} quando la quantità di avanzamento è sconosciuta. La radice ha quindi uno stato indeterminato, omette aria-valuenow e usa indeterminate progress come testo predefinito del valore accessibile. Anche i valori non finiti restano indeterminati; non vengono convertiti in zero. In tale stato, l’elemento Indicator non elaborato non ha una larghezza percentuale calcolata, pertanto la composizione sceglie il relativo aspetto indeterminato.
Etichette e formattazione
ComponiProgress.Label all’interno di Root oppure imposta aria-label o aria-labelledby nativi. Usa aria-valuetext per un’alternativa leggibile dall’utente quando una percentuale non è sufficiente.
Il formattatore predefinito visualizza la percentuale normalizzata. locale e format mantengono il contratto Intl.NumberFormat installato; un format esplicito formatta il valore numerico limitato. getAriaValueText(formattedValue, value) riceve quel testo formattato e il valore non elaborato dell’applicazione, incluso null. Modifica il testo del valore accessibile senza modificare il riempimento.
Progress.Value riceve sia il valore formattato sia il valore non elaborato tramite il callback figlio facoltativo. Per l’avanzamento indeterminato, il callback riceve indeterminate come testo formattato; senza callback, la parte del valore non visualizza alcun contenuto. Il contenuto visualizzato non diventa automaticamente il nome accessibile o il testo del valore accessibile.
Proprietà native, ref e composizione
Ogni parte conserva le proprietà native, i ref e il contratto di composizione
render installato. Inoltra le proprietà e il ref forniti quando sostituisci un elemento. I callback className, style e render ricevono lo stato pubblico con status: progressing, complete o indeterminate. Gli attributi di stato rendono lo stesso stato disponibile agli stili.
Il punto di ingresso esporta ProgressStatus e i tipi Props e State per ogni parte, inclusi ProgressRootProps, ProgressRootState, ProgressIndicatorProps e ProgressIndicatorState. Ogni parte inoltra i gestori di eventi nativi. Le applicazioni gestiscono l’orchestrazione delle funzionalità e i callback di completamento.
Props
Progress.Root
Class applied to this part, or a callback receiving its progress status.
Intl.NumberFormat options for the clamped numeric value. The default displays the normalized percentage.
Receives the formatted value and raw value, including null, and returns an accessible value description.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, ProgressRootState>
Composes this part with an element or render callback. Forward the supplied props and ref to the corresponding DOM element.
Inline styles applied to this part, or a callback receiving its progress status.
Controlled value in the min/max range. Use null for indeterminate progress.
Progress.Track
Class applied to this part, or a callback receiving its progress status.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, ProgressTrackState>
Composes this part with an element or render callback. Forward the supplied props and ref to the corresponding DOM element.
Inline styles applied to this part, or a callback receiving its progress status.
Progress.Indicator
Class applied to this part, or a callback receiving its progress status.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, ProgressIndicatorState>
Composes this part with an element or render callback. Forward the supplied props and ref to the corresponding DOM element.
Inline styles applied to this part, or a callback receiving its progress status.
Progress.Value
Optional callback receiving the formatted value and raw value. Indeterminate progress passes indeterminate as formatted text. Without a callback, indeterminate progress displays no content.
Class applied to this part, or a callback receiving its progress status.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, ProgressValueState>
Composes this part with an element or render callback. Forward the supplied props and ref to the corresponding DOM element.
Inline styles applied to this part, or a callback receiving its progress status.
Progress.Label
Class applied to this part, or a callback receiving its progress status.