Del via

funktionen Confirm

Gælder for: Modeldrevne apps, lærredsapps

Brug denne funktion til at få vist en bekræftelsesdialogboks til brugeren.

Description

Funktionen Confirm viser en dialogboks oven på den aktuelle skærm med to knapper: en bekræft knap og en annulleringsknap . I modeldrevne apps er disse knapper som standard lokaliserede versioner af henholdsvis "OK" og "Annuller". Confirm er også tilgængelig i lærredsapps til visning af en enkel bekræftelsesdialogboks og returnering af et boolesk resultat.

Brugeren skal vælge en af knapperne, før dialogboksen afvises. Ud over at vælge knappen Annuller kan dialogboksen afvises via platformspecifikke håndbevægelser (f.eks. Esc-tasten eller klik uden for dialogboksen). I lærredsapps behandles denne afskedigelsessti som ingen handling (dvs. den returnerer blank).

Bemærk

I lærredsapps bruger funktionen Confirm dialogboksen Fluent. Sørg for, at moderne kontrolelementer er aktiveret. Ellers vises den oprindelige browserdialogboks.

Syntaks

Confirm( Message [, OptionsRecord ] )
  • Besked - Påkrævet. Meddelelse, der skal vises til brugeren.
  • OptionsRecord - Valgfrit. Angiv mulige indstillinger for dialogboksen. Se nedenfor for at få oplysninger om tilgængelige indstillinger.

Indstillinger

Brug parameteren OptionsRecord til at tilpasse bekræftelsesdialogboksen:

Mulighed Description
Bekræft knap Den tekst, der skal vises på knappen Bekræft, og erstatter den oversatte standardtekst "OK" eller "Confirm".
Annuller knap Den tekst, der skal vises på knappen Annuller, erstatter den oversatte standardtekst "Annuller".
Titel Den tekst, der skal vises som dialogboksens titel. Vises med en større skrifttype med federe end meddelelsen. Den kan blive afkortet, hvis den er meget lang.
Undertekst Den tekst, der skal vises som dialogboksens undertitel. Vises mellem titlen og meddelelsen. Den kan blive afkortet, hvis den er meget lang.

Standardfunktionsmåde

Knapnavne: Hvis du ikke angiver brugerdefinerede knapnavne, Confirm bruges lokaliseret standardknaptekst:

  • I lærredsapps (prøveversion) er standarderne "Confirm" og "Annuller" (oversat).
  • I modeldrevne apps er standarderne "OK" og "Annuller" (oversat).

Returværdi:Confirm returnerer true , hvis brugeren vælger knappen Bekræft, og false ellers.

Eksempler

Modelbaserede apps

Enkel bekræftelse, før du fjerner en post

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

Viser en bekræftelsesdialogboks med standardknapper. Hvis brugeren vælger knappen Bekræft, fjernes posten.

Bekræftelse med brugerdefineret titel

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

Føjer en titel til bekræftelsesdialogboksen, før du fjerner en post.

Brugerdefinerede knapnavne til brugerindstillinger

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

Bruger brugerdefinerede knapnavne til at hente en enkel indstilling. Resultatet gemmes i den globale variabel FavColor.

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

Viser en modal meddelelse, som brugeren skal bekræfte, før der fortsættes. Returværdien er ikke markeret.

Lærredapps

Confirm før sletning

Bruges Confirm til at forhindre utilsigtet sletning af poster:

// 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)
)

Viser en bekræftelsesdialogboks med titel, undertitel og brugerdefinerede knapnavne. Posten slettes kun, hvis brugeren vælger Slet.

Confirm før du gemmer en formular

Bruges Confirm til at validere brugerhensigt, før du sender data:

// 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)
)

Viser en bekræftelsesdialogboks, før formularen sendes. Formularen sendes kun, hvis brugeren bekræfter.

Gem resultat i en variabel for flere handlinger

Gem det bekræftelsesresultat, der skal bruges i flere downstream-handlinger:

// 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)
)

Det booleske resultat gemmes i varConfirmed og kan refereres flere gange til betinget logik.

Fuld tilpasning med alle indstillinger

Vis alle tilgængelige tilpasningsindstillinger:

// 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)
)

Viser en fuldt tilpasset dialogboks med titel, undertitel, meddelelse og brugerdefinerede knapnavne.

Ofte stillede spørgsmål

Kan jeg skjule knappen Annuller?

Nej. I det aktuelle design vises både Confirm knapperne og Annuller altid. Brugerne skal have mulighed for at afvise eller annullere dialogboksen.

Kan jeg tilføje en tredje knap eller mere end to indstillinger?

Nej. Confirm understøtter præcis to indstillinger: en bekræft handling og en annulleringshandling. I scenarier, der kræver flere valgmuligheder, kan du overveje at bruge et andet mønster for brugergrænsefladen, f.eks. et brugerdefineret skærm- eller rullelistekontrolelement.

Blokerer Confirm andre handlinger?

Ja. Confirm vises som en modal dialogboks, som brugeren skal afvise, før vedkommende kan interagere med andre dele af appen.

Se også

Notify – Viser en bannermeddelelse, der ikke er modal, øverst på skærmen, som ikke kræver, at brugeren afskediges.

  • Last updated on