Confirm funkcija

Odnosi se na: Aplikacije platna – aplikacije utemeljene na modelu

Pomoću ove funkcije korisniku prikažite dijaloški okvir za potvrdu.

Opis

Funkcija Confirm na vrhu trenutnog zaslona prikazuje dijaloški okvir s dva gumba : gumbom za potvrdu i gumbom odustani . U aplikacijama utemeljenim na modelu ti gumbi po zadanom su lokalizirani na verzije "U redu" odnosno "Odustani". Confirm dostupan je i u aplikacijama platna za prikaz jednostavnog potvrdnog dijaloškog okvira i vraćanje Booleova rezultata.

Korisnik mora odabrati jedan od gumba prije odbacivanja dijaloškog okvira. Osim odabira gumba Odustani, dijaloški se okvir može odbaciti i gestama specifičnima za određenu platformu (kao što je tipka Esc ili klik izvan dijaloškog okvira). U aplikacijama platna taj se put za odbacivanje tretira kao da nema radnje (to jest, vraća se blank).

Napomena

U aplikacijama platna funkcija Confirm koristi dijaloški okvir Fluent. Provjerite jesu li omogućene moderne kontrole U suprotnom će se pojaviti nativni dijaloški okvir preglednika.

Sintaksa

Confirm( Message [, OptionsRecord ] )
  • Poruka - Obavezno. Poruka koja se prikazuje korisniku.
  • OptionsRecord - Nije obavezno. Navedite postavke mogućnosti za dijaloški okvir. Dostupne mogućnosti potražite u nastavku.

Mogućnosti

Pomoću parametra OptionsRecord prilagodite dijaloški okvir za potvrdu:

Mogućnost Opis
Gumb za potvrdu Tekst koji će se prikazati na gumbu za potvrdu, koji zamjenjuje zadani lokalizirani tekst "U redu" ili "Confirm".
Gumb za otkazivanje Tekst koji će se prikazati na gumbu Odustani, koji zamjenjuje zadani lokalizirani tekst "Odustani".
Naslov Tekst koji će se prikazati kao naslov dijaloškog okvira. Prikazuje se u većem, bolder fontu od poruke. Možda će biti odrezana ako je jako duga.
Podnaslov Tekst koji će se prikazati kao podnaslov dijaloškog okvira. Prikazuje se između naslova i poruke. Možda će biti odrezana ako je jako duga.

Zadano ponašanje

Oznake gumba: Ako ne navedite prilagođene oznake gumba, koristi Confirm lokalizirani zadani tekst gumba:

  • U aplikacijama platna (pretpregled) zadane su postavke "Confirm" i "Odustani" (lokalizirano).
  • U aplikacijama utemeljenim na modelu zadane su postavke "U redu" i "Odustani" (lokalizirano).

Povratna vrijednost:Confirm vraća true se ako korisnik odabire gumb za potvrdu i u suprotnom false .

Primjeri

Aplikacije stvorene prema modelu

Jednostavna potvrda prije uklanjanja zapisa

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

Prikazuje dijaloški okvir za potvrdu sa zadanim gumbima. Ako korisnik odabire gumb za potvrdu, zapis će se ukloniti.

Potvrda s prilagođenim naslovom

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

Dodaje naslov dijaloškom okviru za potvrdu prije uklanjanja zapisa.

Custom button labels for user preference

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

Koristi prilagođene oznake gumba za snimanje jednostavnih preferenci. Rezultat se pohranjuje u globalnoj varijabli FavColor.

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

Prikazuje modalni poruku koju korisnik mora potvrditi prije nastavka. Povratna vrijednost nije potvrđena.

Aplikacije od gotovih gradivnih elemenata

Confirm prije brisanja

Koristi Confirm se za sprječavanje slučajnog brisanja zapisa:

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

Prikazuje dijaloški okvir za potvrdu s naslovom, podnaslovom i prilagođenim oznakama gumba. Zapis će se izbrisati samo ako korisnik odaaši.

Confirm prije spremanja obrasca

Koristi Confirm se za provjeru korisničke namjere prije slanja podataka:

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

Prikazuje dijaloški okvir za potvrdu prije slanja obrasca. Obrazac se šalje samo ako korisnik to potvrdi.

Rezultat spremišta u varijabli za više akcija

Pohranite rezultat potvrde koji će se koristiti u više nizvodnih operacija:

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

Booleov se rezultat pohranjuje i može varConfirmed se referencira više puta za uvjetne logike.

Potpuna prilagodba sa svim mogućnostima

Prikaz svih dostupnih mogućnosti prilagodbe:

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

Prikazuje potpuno prilagođeni dijaloški okvir s naslovom, podnaslovom, porukom i prilagođenim oznakama gumba.

Najčešća pitanja

Mogu li sakriti gumb Odustani?

Ne. Trenutni dizajn uvijek prikazuje i gumbe Confirm i Odustani. Korisnici moraju imati mogućnost odbacivanja ili otkazivanja dijaloškog okvira.

Mogu li dodati treći gumb ili više od dvije mogućnosti?

Ne. Confirm podržava točno dvije mogućnosti: akciju potvrde i akciju otkazivanja. Za scenarije koji zahtijevaju više odabira razmislite o korištenju drugog uzorka korisničkog sučelja, kao što je prilagođeni zaslon ili kontrola padajućeg izbornika.

Blokira Confirm li ostale operacije?

Da. Confirm prikazuje se kao modalni dijaloški okvir koji korisnik mora odbaciti prije interakcije s drugim dijelovima aplikacije.

Vidi također

Notify – prikazuje nemodalni natpis pri vrhu zaslona za koji nije potrebno odbaciti korisnika.

  • Last updated on