Bagikan melalui

fungsi Confirm

Berlaku untuk: Aplikasi Kanvas Berbasis model aplikasi

Gunakan fungsi ini untuk menampilkan kotak dialog konfirmasi kepada pengguna.

Description

Fungsi ini Confirm menampilkan kotak dialog di atas layar saat ini dengan dua tombol: tombol konfirmasi dan tombol batalkan . Di aplikasi berbasis model, tombol ini secara default ke versi "OK" dan "Batal" yang dilokalkan masing-masing. Confirm juga tersedia di aplikasi kanvas untuk menampilkan dialog konfirmasi sederhana dan mengembalikan hasil Boolean.

Pengguna harus memilih salah satu tombol sebelum dialog ditutup. Selain memilih tombol Batalkan, dialog dapat ditutup melalui gerakan khusus platform (seperti kunci Esc atau mengklik di luar dialog). Di aplikasi kanvas, jalur pemecatan ini diperlakukan sebagai tidak ada tindakan (yaitu mengembalikan blank).

Catatan

Di aplikasi kanvas, Confirm fungsi menggunakan dialog Fasih. Pastikan kontrol modern diaktifkan; jika tidak, dialog browser asli muncul.

Sintaks

Confirm( Message [, OptionsRecord ] )
  • Pesan - Wajib. Pesan yang ditampilkan kepada pengguna.
  • OptionsRecord - Opsional. Berikan pengaturan opsi untuk kotak dialog. Lihat di bawah ini untuk opsi yang tersedia.

Opsi

Gunakan parameter OptionsRecord untuk mengkustomisasi dialog konfirmasi:

Option Description
Tombol Konfirmasi Teks yang akan ditampilkan pada tombol konfirmasi, mengganti teks "OK" atau "Confirm" yang dilokalkan default.
Tombol Batal Teks yang akan ditampilkan pada tombol batalkan, mengganti teks "Batal" yang dilokalkan default.
Titel Teks yang akan ditampilkan sebagai judul dialog. Ditampilkan dalam font yang lebih besar dan lebih berani daripada pesan. Mungkin terpotong jika sangat lama.
Subjudul Teks yang akan ditampilkan sebagai subtitel dialog. Ditampilkan antara judul dan pesan. Mungkin terpotong jika sangat lama.

Perilaku bawaan

Label tombol: Jika Anda tidak menyediakan label tombol kustom, Confirm gunakan teks tombol default yang dilokalkan:

  • Di aplikasi kanvas (pratinjau), defaultnya adalah "Confirm" dan "Batal" (dilokalkan).
  • Di aplikasi berbasis model, defaultnya adalah "OK" dan "Batal" (dilokalkan).

Mengembalikan nilai:Confirm mengembalikan true jika pengguna memilih tombol konfirmasi, dan false sebaliknya.

Contoh

Aplikasi yang diarahkan model

Konfirmasi sederhana sebelum menghapus rekaman

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

Menampilkan dialog konfirmasi dengan tombol default. Jika pengguna memilih tombol konfirmasi, rekaman akan dihapus.

Konfirmasi dengan judul kustom

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

Menambahkan judul ke dialog konfirmasi sebelum menghapus rekaman.

Label tombol kustom untuk preferensi pengguna

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

Menggunakan label tombol kustom untuk mengambil preferensi sederhana. Hasilnya disimpan dalam variabel FavColorglobal .

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

Menampilkan pesan modal yang harus diakui pengguna sebelum melanjutkan. Nilai yang dikembalikan tidak diperiksa.

Aplikasi kanvas

Confirm sebelum menghapus

Gunakan Confirm untuk mencegah penghapusan rekaman yang tidak disengaja:

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

Menampilkan dialog konfirmasi dengan label judul, subtitel, dan tombol kustom. Rekaman hanya dihapus jika pengguna memilih Hapus.

Confirm sebelum menyimpan formulir

Gunakan Confirm untuk memvalidasi niat pengguna sebelum mengirimkan 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)
)

Menampilkan dialog konfirmasi sebelum mengirimkan formulir. Formulir hanya dikirimkan jika pengguna mengonfirmasi.

Menyimpan menghasilkan variabel untuk beberapa tindakan

Simpan hasil konfirmasi untuk digunakan dalam beberapa operasi hilir:

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

Hasil Boolean disimpan dan dapat direferensikan varConfirmed beberapa kali untuk logika bersyarat.

Kustomisasi penuh dengan semua opsi

Tampilkan semua opsi kustomisasi yang tersedia:

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

Menampilkan dialog yang sepenuhnya disesuaikan dengan judul, subtitel, pesan, dan label tombol kustom.

FAQs

Dapatkah saya menyembunyikan tombol Batalkan?

Tidak. Desain saat ini selalu menampilkan Confirm tombol Batal dan Batal. Pengguna harus memiliki kemampuan untuk menutup atau membatalkan dialog.

Bisakah saya menambahkan tombol ketiga atau lebih dari dua opsi?

Tidak. Confirm mendukung tepat dua opsi: tindakan konfirmasi dan tindakan pembatalan. Untuk skenario yang memerlukan beberapa pilihan, pertimbangkan untuk menggunakan pola UI yang berbeda seperti layar kustom atau kontrol dropdown.

Apakah Confirm memblokir operasi lain?

Ya. Confirm ditampilkan sebagai dialog modal yang harus ditutup pengguna sebelum mereka dapat berinteraksi dengan bagian lain dari aplikasi.

Lihat juga

Beri tahu - Menampilkan pesan banner non-modal di bagian atas layar yang tidak memerlukan pemecatan pengguna.

  • Last updated on