💄Interfaces

Le module Eko.UI centralise toutes les interactions avec l’interface utilisateur côté client. Il permet d’afficher des notifications, des popups, des choix interactifs, ainsi que de contrôler des comp

📦 API

Eko.UI:AddNotification(type, message, icon, duration, name?, location?, emergencyCode?, id?)

Affiche une notification enrichie.

• Paramètres

  • type (string): Type de notification (ex. : "info", "warning").

  • message (string): Texte affiché.

  • icon (string): Nom de l’icône.

  • duration (number): Durée en secondes.

  • name (string, optionnel): Nom associé.

  • location (string, optionnel): Localisation.

  • emergencyCode (string, optionnel): Code d’urgence.

  • id (number, optionnel): Identifiant unique.

---

Eko.UI:Popup(title, text, accept, cancel, color_type)

Affiche un popup avec deux boutons.

• Paramètres

  • title (string): Titre du popup.

  • text (string): Contenu.

  • accept (table): Bouton d’acceptation :

    • text: Libellé.

    • cb: Fonction callback.

  • cancel (table): Bouton d’annulation :

    • text: Libellé.

    • cb: Fonction callback.

  • color_type (0 | 1): Style visuel.

---

Eko.UI:PopupMultiChoice(title, text, choices, onConfirm)

Affiche un popup avec plusieurs choix.

• Paramètres

  • title (string): Titre.

  • text (string): Description.

  • choices (string[]): Liste des choix.

  • onConfirm (function): Callback avec le choix sélectionné.

---

Eko.UI:Toggle(component, visible, data, useMouse, keepInput, blur?)

Active ou désactive un composant d’interface.

• Paramètres

  • component (string): Nom du composant.

  • visible (boolean): Afficher ou masquer.

  • data (any): Données associées.

  • useMouse (boolean): Activer la souris.

  • keepInput (boolean): Bloquer l’input du jeu.

  • blur (boolean, optionnel): Activer le blur.

---

Eko.UI:RegisterCallback(name, cb)

Enregistre un callback côté client pour la NUI.

• Paramètres

  • name (string): Nom de l’événement.

  • cb (function): Fonction appelée :

    function(data, cb)
        -- data: données reçues
        -- cb: fonction de réponse
    end

---

Eko.UI:SendMessage(message, data)

Envoie un message à la NUI.

• Paramètres

  • message (string): Nom du message.

  • data (any): Données transmises.

---

Eko.UI:CopyToClipboard(content)

Copie du texte dans le presse-papier.

• Paramètres

  • content (string): Texte à copier.

---

Eko.UI:ToggleRadar(toggle)

Affiche ou masque le radar.

• Paramètres

  • toggle (boolean): true pour afficher.

---

Eko.UI:PlaySound(sound)

Joue un son d’interface.

• Paramètres

  • sound (string): Nom du son.

---

Eko.UI:Progress(time)

Affiche une barre de progression temporaire.

• Paramètres

  • time (integer): Durée en ms.

---

Eko.UI:UseTablet(url)

Affiche la tablette avec une URL.

• Paramètres

  • url (string): Adresse web affichée.

---

Eko.UI:OpenURL(url)

Ouvre une URL externe.

• Paramètres

  • url (string): Lien à ouvrir.

---

Eko.UI:TTS(message)

Lit un message en synthèse vocale.

• Paramètres

  • message (string): Texte à prononcer.

---

Eko.UI:ForceFocus()

Force la NUI à prendre le focus.

---

Eko.UI:IsFocused()

Vérifie si la NUI est actuellement focus.

• Retour

  • boolean: true si focus actif.

---

🛠️ Exemple d’utilisation

-- Notification simple
Eko.UI:AddNotification("info", "Bienvenue sur le serveur", "info", 5)

-- Popup avec deux choix
Eko.UI:Popup(
    "Confirmation",
    "Voulez-vous continuer ?",
    { text = "Oui", cb = function() print("Accepté") end },
    { text = "Non", cb = function() print("Annulé") end },
    0
)

-- Popup multichoix
Eko.UI:PopupMultiChoice(
    "Sélection",
    "Choisissez une option",
    { "Option 1", "Option 2", "Option 3" },
    function(choice)
        print("Vous avez choisi:", choice)
    end
)

-- Copier du texte
Eko.UI:CopyToClipboard("CodeSecret123")

-- Afficher un composant
Eko.UI:Toggle("inventory", true, { items = {} }, true, true)

-- Jouer un son
Eko.UI:PlaySound("confirm")

---

⚠️ Notes

• Ces méthodes sont uniquement disponibles côté client.

• L’API dépend du système NUI fourni avec le framework.

• Utilisez RegisterCallback pour interagir avec la NUI côté JavaScript.