Aller au contenu principal
OndesOndes Core/ Docs

Référence SDK

Ondes.UI

Contrôlez l'interface native avec des toasts, modales, drawers et plus.

Le module Ondes.UI permet de contrôler l'interface native de l'application hôte avec des options de personnalisation avancées.

showToast(options)

Affiche une notification temporaire en bas de l'écran.

ParamètreTypeDescription
messageStringTexte à afficher.
typeString'info', 'success', 'error', 'warning'.
durationNumberDurée en ms (défaut: 3000).
positionString'top' ou 'bottom' (défaut).
backgroundColorStringCouleur personnalisée (hex).
boldBooleanTexte en gras.
JS
await Ondes.UI.showToast({
    message: class="code-string">"Sauvegarde effectuée !",
    type: class="code-string">"success",
    duration: 4000,
    bold: true
});

showAlert(options)

Affiche une boîte de dialogue modale informative.

ParamètreTypeDescription
titleStringTitre de la modale.
messageStringContenu du message.
buttonTextStringTexte du bouton (défaut: "OK").
iconStringNom de l'icône.
iconColorStringCouleur de l'icône (hex).
borderRadiusNumberRayon des coins (défaut: 16).
dismissibleBooleanFermer en cliquant à l'extérieur (défaut: true).
JS
await Ondes.UI.showAlert({
    title: class="code-string">"Maintenance",
    message: class="code-string">"Le serveur sera indisponible ce soir.",
    buttonText: class="code-string">"J'ai compris",
    icon: class="code-string">"warning",
    iconColor: class="code-string">"#f59e0b"
});

showConfirm(options)

Affiche une boîte de confirmation avec deux choix. Retourne Promise<Boolean>.

ParamètreTypeDescription
titleStringTitre.
messageStringQuestion posée à l'utilisateur.
confirmTextStringTexte du bouton de validation.
cancelTextStringTexte du bouton d'annulation.
confirmColorStringCouleur du bouton de confirmation.
iconStringIcône affichée.
JS
const ok = await Ondes.UI.showConfirm({
    title: class="code-string">"Supprimer",
    message: class="code-string">"Êtes-vous sûr de vouloir supprimer cet élément ?",
    confirmText: class="code-string">"Oui, supprimer",
    cancelText: class="code-string">"Annuler",
    confirmColor: class="code-string">"#ef4444",
    icon: class="code-string">"delete"
});

if (ok) {
    deleteItem();
}

showInputDialog(options)

Affiche une boîte de dialogue avec un champ de saisie. Retourne Promise<String|null>.

ParamètreTypeDescription
titleStringTitre.
messageStringMessage explicatif.
placeholderStringTexte indicatif dans le champ.
keyboardTypeString'text', 'email', 'number', 'phone', 'url'.
obscureTextBooleanMasquer le texte (mot de passe).
maxLengthNumberLongueur maximale.
prefixIconStringIcône au début du champ.
JS
const name = await Ondes.UI.showInputDialog({
    title: class="code-string">"Nouveau dossier",
    message: class="code-string">"Entrez le nom du dossier",
    placeholder: class="code-string">"Mon dossier",
    prefixIcon: class="code-string">"folder",
    confirmText: class="code-string">"Créer",
    maxLength: 50
});

if (name) {
    createFolder(name);
}