Liste de Couleurs

La fonction AddColorList dans zUI permet d'ajouter une liste de couleurs personnalisable à vos menus. Cette fonctionnalité est idéale pour offrir des options colorées, telles que des thèmes ou des choix de personnalisation visuelle. Voici comment utiliser cette fonction pour enrichir vos menus.

Fonction AddColorList

La syntaxe pour ajouter une liste de couleurs est la suivante :

zUI:AddColorList(Title, Description, Index, Items, Styles, Action)

Paramètres

• Title [string | number] : Le titre affiché en haut de la liste.
• Description [string | number | nil] : (Optionnel) Une description qui apparaît sous le titre.
• Index [number] : L'index initial sélectionné dans la liste.
• Items [table] : Un tableau contenant les couleurs disponibles. Chaque élément représente une couleur.
• Styles [table] : Des éléments pour personnaliser l'apparence de la liste. Ces styles incluent :

  • IsDisabled [boolean] : Indique si la liste est désactivée.
  • LeftBadge [BadgeName] : Affiche un badge à gauche de la liste.
  • Color [string] : Définit la couleur principale du texte.

• Action [function(onSelected, onHovered, onListChange, index)] : Une fonction qui s'exécute lorsque l'utilisateur interagit avec la liste. Cette fonction reçoit les paramètres suivants :

  • onSelected (vrai si un élément est sélectionné)
  • onHovered (vrai si un élément est survolé)
  • onListChange (vrai si la sélection a changé)
  • index (index de l'élément sélectionné)

Exemple de Création d'une Liste de Couleurs

Voici un exemple illustrant l'ajout d'une liste de couleurs dans un menu :

local currentIndex = 0
Menu:SetItems(function(Items)
    Items:AddColorList(
        "Choisissez une couleur",
        "Personnalisez votre thème",
        currentIndex,
        { "Rouge", "Vert", "Bleu", "Jaune", "Violet" },
        { IsDisabled = false, LeftBadge = "Star", Color = "#ff0000" },
        function(onSelected, onHovered, onListChange, index)
            if onListChange then
                currentIndex = index
            end
        end
    )
end)

Explication

1. Title : "Choisissez une couleur" est le titre affiché en haut de la liste.
2. Description : "Personnalisez votre thème" est la description affichée sous le titre.
3. Index : 0 indique que l'élément initialement sélectionné est "Rouge".
4. Items : { "Rouge", "Vert", "Bleu", "Jaune", "Violet" } définit les couleurs disponibles dans la liste.
5. Styles : Ces styles incluent :
   • IsDisabled : La liste est interactive car false.
   • LeftBadge : Ajoute un badge "Star" à gauche de la liste.
   • Color : Utilise le code couleur rouge "#ff0000".
6. Action : La fonction affiche dans la console les couleurs sélectionnées ou confirmées.

Résumé

Pour ajouter une liste de couleurs dans zUI :

1. Utilisez zUI:AddColorList pour créer une liste dans votre menu.
2. Spécifiez le titre, la description, l'index initial, les couleurs disponibles et les styles.
3. Implémentez une fonction Action pour réagir aux interactions de l'utilisateur.

Les listes de couleurs enrichissent vos menus en permettant aux utilisateurs de personnaliser visuellement leur expérience. Utilisez cette fonction pour des thèmes, des préférences esthétiques ou toute situation nécessitant des choix colorés.