tw.progressbar

Cote : Client

Barre de progression NUI avec gestion de file d'attente et plusieurs themes visuels.

Fonctions

tw.progressbar.start(message, duration, callback, options?)

Demarre une barre de progression. Si une est deja active, la nouvelle est mise en file d'attente.

Parametre	Type	Description
message	string	Texte affiche sur la barre de progression
duration	integer	Duree en millisecondes
callback	function	Appelee a la fin naturelle (non appelee si annulee)
options	table?	Options visuelles (voir ci-dessous)

Options :

Champ	Type	Defaut	Description
theme	string	'linear'	'linear' (barre), 'circle' (cercle), ou 'innercircle' (cercle avec compte a rebours)
color	string	'rgb(124, 45, 45)'	Valeur de couleur CSS
width	string	'20vw'	Valeur de largeur CSS

---

tw.progressbar.cancel()

Annule la barre de progression actuellement active. Le callback n'est pas appele.

---

tw.progressbar.cancelAll()

Annule la barre de progression active et toutes celles en file d'attente.

Exemples

Barre lineaire (par defaut)

tw.progressbar.start("Collecting herbs...", 5000, function()
    -- Ceci s'execute apres 5 secondes si non annule
    tw.notif.rightSuccess("Herbs collected!")
end)

Theme cercle avec couleur personnalisee

tw.progressbar.start("Crafting...", 8000, function()
    tw.notif.rightSuccess("Item crafted!")
end, {
    theme = 'circle',
    color = '#ffffff',
    width = '20vw',
})

Cercle interieur avec compte a rebours

tw.progressbar.start("Cooking meat...", 10000, function()
    tw.notif.rightSuccess("Meat cooked!")
end, {
    theme = 'innercircle',
    color = 'rgb(50, 150, 50)',
})

Annulation sur appui de touche

tw.progressbar.start("Searching...", 6000, function()
    -- termine
end)

-- Ailleurs, par exemple lors d'un mouvement du joueur :
tw.progressbar.cancel()

Notes

• Le callback est uniquement appele a la fin naturelle. Si cancel() ou cancelAll() est appele, le callback est ignore.
• Plusieurs appels a start() mettent les barres de progression en file d'attente ; elles s'executent l'une apres l'autre.
• cancelAll() vide toute la file d'attente, pas seulement la barre active.