ProgressBar

Progression & retour visuel

Engine\Native\ProgressBar compose une piste et un remplissage proportionnel, tous deux pill-rounded (radius = height / 2), superposés via un Stack interne : le premier Container occupe toute la largeur, le second n'occupe que width * percent. Contrairement à un élément HTML, il prend une largeur en pixels explicite plutôt que de s'étirer au parent, car un Stack ne résout pas les largeurs en pourcentage.

Exemple

<?php

use Engine\Native\ProgressBar;
use Engine\Color;

$bar = new ProgressBar(
    width: 240.0,
    percent: 0.4,
    fillColor: Color::green(600),
);

Une barre de 240px de large affiche 40% de remplissage vert sur une piste grise par défaut, avec une hauteur de 8px et des coins totalement arrondis.

Constructeur

Paramètre	Type	Défaut	Description
width	float	—	Largeur totale de la piste, en pixels.
percent	float	—	Valeur entre 0.0 et 1.0, bornée automatiquement.
height	float	8.0	Hauteur de la piste et du remplissage.
trackColor	?Color	null → Tokens::surfaceMuted()	Couleur de la piste de fond.
fillColor	?Color	null → Tokens::ink()	Couleur du remplissage proportionnel.

À savoir. Le radius pill (height / 2) est calculé automatiquement à partir de height ; il n'y a pas de paramètre radius séparé — changer la forme des coins passe uniquement par height.

Voir aussi

• CircularProgress
• Async
• Tokens (fondamentaux)