Confirm funció

S'aplica a: Aplicacions de llenç Aplicacions basades en models

Utilitza aquesta funció per mostrar un quadre de diàleg de confirmació a l'usuari.

Descripció

La Confirm funció mostra un quadre de diàleg a la part superior de la pantalla actual amb dos botons: un botó de confirmar i un botó de cancel·lar . En aplicacions basades en models, aquests botons per defecte mostren versions localitzades de "OK" i "Cancel·la" respectivament. Confirm també està disponible a les aplicacions Canvas per mostrar un diàleg de confirmació senzill i retornar un resultat booleà.

L'usuari ha d'escollir un dels botons abans que el diàleg sigui descartat. A més de seleccionar el botó Cancel·lar, el diàleg es pot descartar mitjançant gestos específics de la plataforma (com la tecla Esc o clicar fora del diàleg). En les aplicacions canvas, aquest camí de descart es tracta com si no fos cap acció (és a dir, retorna blank).

Nota

A les aplicacions de canvas, la Confirm funció utilitza el diàleg Fluent. Assegura't que els controls moderns estiguin activats; en cas contrari, apareix el diàleg natiu del navegador.

Sintaxi

Confirm( Message [, OptionsRecord ] )
  • Missatge : obligatori. Missatge que es mostrarà a l'usuarisi.
  • OptionsRecord : opcional. Proporcioneu la configuració de les opcions per al quadre de diàleg. Vegeu a continuació les opcions disponibles.

Opcions

Utilitza el paràmetre OptionsRecord per personalitzar el diàleg de confirmació:

Opció Descripció
Botó de confirmació El text s'ha de mostrar al botó de confirmació, substituint el text localitzat per defecte "OK" o "Confirm".
Cancel·laBotó El text s'ha de mostrar al botó de cancel·lar, substituint el text localitzat per defecte "Cancel·la".
Títol El text s'ha de mostrar com a títol de diàleg. Mostrada en una font més gran i en negreta que el missatge. Pot ser truncat si és molt llarg.
Subtítol El text s'ha de mostrar com a subtítol de diàleg. Es mostra entre el títol i el missatge. Pot ser truncat si és molt llarg.

Comportament per defecte

Etiquetes de botons: Si no proporciones etiquetes de botons personalitzades, utilitza Confirm text de botó per defecte localitzat:

  • A les aplicacions de canvas (previsualització), les opcions per defecte són "Confirm" i "Cancel·la" (localitzada).
  • En aplicacions basades en models, els valors per defecte són "OK" i "Cancel·la" (localitzat).

Valor de retorn:Confirm retorna true si l'usuari selecciona el botó de confirmar, i false en altres cas.

Exemples

Aplicacions basades en models

Confirmació senzilla abans d'eliminar un registre

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

Mostra un diàleg de confirmació amb botons per defecte. Si l'usuari selecciona el botó de confirmar, el registre s'elimina.

Confirmació amb títol personalitzat

If( Confirm( "Are you sure?", { Title: "Delete Confirmation" } ), Remove( ThisItem ) )

Afegeix un títol al diàleg de confirmació abans d'eliminar un registre.

Etiquetes de botons personalitzades per preferència de l'usuari

Set( FavColor,
     If( Confirm( "What is your favorite color?",
                  { ConfirmButton: "Red", CancelButton: "Green" }
         ),
         "Red",
         "Green"
     )
)

Utilitza etiquetes de botons personalitzades per captar una preferència senzilla. El resultat s'emmagatzema a la variable FavColorglobal .

Confirm( "There was a problem, please review your order." )

Mostra un missatge modal que l'usuari ha de reconèixer abans de continuar. No es comprova el valor de retorn.

Aplicacions de llenç

Confirm Abans d'esborrar

Ús Confirm per evitar l'eliminació accidental de registres:

// Button.OnSelect
If(
    Confirm(
        "Are you sure you want to delete this record?",
        {
            Title: "Delete confirmation",
            Subtitle: "This action can't be undone.",
            ConfirmButton: "Delete",
            CancelButton: "Cancel"
        }
    ),
    Remove(YourDataSource, Gallery1.Selected);
    Notify("Record deleted.", NotificationType.Success)
)

Mostra un diàleg de confirmació amb títol, subtítols i etiquetes de botons personalitzades. El registre només s'elimina si l'usuari selecciona Eliminar.

Confirm abans de desar un formulari

Per Confirm validar la intenció de l'usuari abans d'enviar dades:

// Save button.OnSelect
If(
    Confirm(
        "Do you want to save these changes?",
        { Title: "Save changes" }
    ),
    SubmitForm(EditForm1);
    ResetForm(EditForm1);
    Notify("Changes saved successfully.", NotificationType.Success)
)

Mostra un diàleg de confirmació abans d'enviar el formulari. El formulari només s'envia si l'usuari ho confirma.

Emmagatzemar resultat en una variable per a múltiples accions

Emmagatzemeu el resultat de confirmació per utilitzar-lo en múltiples operacions posteriors:

// Button.OnSelect
Set(
    varConfirmed,
    Confirm("Do you want to proceed with this operation?")
);

If(
    varConfirmed,
    Notify("Processing your request...", NotificationType.Information);
    /* Additional operations */,
    Notify("Operation canceled.", NotificationType.Warning)
)

El resultat booleà s'emmagatzema a varConfirmed i es pot referenciar diverses vegades per a la lògica condicional.

Personalització completa amb totes les opcions

Mostra totes les opcions de personalització disponibles:

// Button.OnSelect
If(
    Confirm(
        "This is the main message that describes what the user needs to confirm.",
        {
            Title: "Action Required 🔔",
            Subtitle: "Please choose one of the options below.",
            ConfirmButton: "Yes, proceed",
            CancelButton: "No, cancel"
        }
    ),
    Notify("User confirmed!", NotificationType.Success),
    Notify("User canceled.", NotificationType.Warning)
)

Mostra un diàleg totalment personalitzat amb títol, subtítols, missatges i etiquetes de botons personalitzades.

Preguntes freqüents

Puc amagar el botó de Cancel·lar?

No. El disseny actual sempre mostra tant el Confirm botó com el de Cancel·lar. Els usuaris han de tenir la capacitat de desestimar o cancel·lar el diàleg.

Puc afegir un tercer botó o més de dues opcions?

No. Confirm Suporta exactament dues opcions: una acció de confirmació i una acció de cancel·lació. Per a escenaris que requereixen múltiples opcions, considera utilitzar un patró d'interfície diferent, com ara una pantalla personalitzada o un control desplegable.

Bloqueja Confirm altres operacions?

Sí. Confirm es mostra com un diàleg modal que l'usuari ha de descartar abans de poder interactuar amb altres parts de l'aplicació.

Consulteu també

Notificació - Mostra un missatge de banner no modal a la part superior de la pantalla que no requereix que l'usuari la desestimi.

  • Last updated on