Bagikan melalui

SubwayNav kontrol (pratinjau)

  • Artikel

[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]

Kontrol yang digunakan untuk memandu pengguna melalui suatu proses.

Catatan

Dokumentasi lengkap dan kode sumber ditemukan di repositori komponen kode GitHub.

Kontrol SubwayNav.

Penting

  • Ini adalah fitur pratinjau.
  • Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Description

Kontrol memungkinkan SubwayNav Anda memvisualisasikan langkah-langkah yang diperlukan untuk wizard tertentu. Wizard adalah komponen yang memandu pengguna untuk menyelesaikan langkah-langkah yang telah ditentukan sebelumnya untuk mencapai tugas penyiapan atau pembuatan.

Komponen kode ini menyediakan pembungkus di sekitar versi Office 365 Kontrol Admin yang bercabang SubwayNav.

Penting

Jangan membuka bug dengan tim Kontrol Admin - selalu kirimkan masalah ke Repositori Github Creator Kit di/ aka.ms/creatorkitbug.

Properti kunci

Nama Description
Items Tabel Item (langkah) untuk dirender (lihat Items skema tabel di bawah).
WizardCompleteorError Ditampilkan sebagai "Status SubwayNav"

Items Properti tabel

Setiap objek dalam Items tabel input harus menggunakan properti berikut untuk merender dengan benar:

Nama Description
ItemLabel Label untuk langkah
ItemKey Kunci yang akan digunakan untuk menunjukkan item/langkah mana yang dipilih. Kunci harus unik.
ParentItemKey Opsional. ItemKey dari induk, digunakan untuk merender sublangkah.
ItemState Menentukan status langkah. Status yang didukung berikut tersedia:
Current,, NotStarted, Completed, Unsaved, ViewedNotCompleted Error CurrentWithSubSteps Skipped WizardComplete
ItemDisabled Opsional. Apakah langkah dinonaktifkan.
ItemVisuallyDisabled Opsional. Apakah langkah tersebut dinonaktifkan secara visual.

Properti tambahan

Nama Description
AccessibilityLabel Aria-label pembaca layar.
InputEvent Aktivitas untuk dikirim ke kontrol. Misalnya SetFocus. Lihat di bawah.
Theme Menerima string JSON yang dihasilkan menggunakan Desainer Tema Fluent UI (windows.net). Membiarkan ini kosong akan menggunakan tema default yang didefinisikan oleh Power Apps.

Contoh

  • Mendukung SetFocus sebagai InputEvent.

Contoh nilai koleksi input untuk properti Item:

Table(
    { ItemKey:"1", ItemLabel:"Step 1", ItemState:"Current" },
    { ItemKey:"2", ItemLabel:"Step 2", ItemState:"Completed" },
    { ItemKey:"3", ItemLabel:"Step 3", ItemState:"Unsaved" },
    { ItemKey:"4", ItemLabel:"Step 4", ItemState:"ViewedNotCompleted" },
    { ItemKey:"5", ItemLabel:"Step 5", ItemState:"Error" },
    { ItemKey:"6", ItemLabel:"Step 6", ItemState:"WizardComplete" }
)

Untuk mendapatkan langkah yang dipilih oleh pengguna, gunakan OnSelect properti atau OnChange kontrol SubwayNav .

Contoh kode:

Notify( Concatenate(Self.Selected.ItemLabel, " selected and its status is ", Self.Selected.ItemState ));

Contoh untuk skenario Sublangkah

Di bawah ini adalah contoh kumpulan item contoh yang menentukan bagaimana sublangkah perlu ditautkan dengan main/induk langkah menggunakan ParentItemKey.

Table(
    { ItemKey:"1", ItemLabel:"Step 1", ItemState:"Current" },
    { ItemKey:"2", ItemLabel:"Step 2 have sub-steps", ItemState:"WizardComplete" },
    { ItemKey:"3", ItemLabel:"Sub Step 2.1", ParentItemKey:"2", ItemState:"Error" },
    { ItemKey:"4", ItemLabel:"Sub Step 2.2", ParentItemKey:"2", ItemState:"WizardComplete" }, 
    { ItemKey:"5", ItemLabel:"Sub Step 3.1", ParentItemKey:"8", ItemState:"ViewedNotCompleted" }, 
    { ItemKey:"6", ItemLabel:"Sub Step 3.2", ParentItemKey:"8", ItemState:"Unsaved" }, 
    { ItemKey:"7", ItemLabel:"Sub Step 3.2", ParentItemKey:"8", ItemState:"Unsaved" }, 
    { ItemKey:"8", ItemLabel:"Step 3 too have sub-steps", ItemState:"Unsaved" }, 
    { ItemKey:"9", ItemLabel:"Step 4", ItemState:"Error" }, 
    { ItemKey:"10", ItemLabel:"Step 5", ItemState:"WizardComplete" }
)

Skema Keluaran

Status setiap item (langkah) berubah saat kita memilih atau pindah ke langkah yang berbeda terjadi secara internal, terutama & Current . CurrentWithSubStep Status saat ini dapat ditentukan menggunakan properti Output yang dipanggil Steps.

Contoh kode (direferensikan dari SubwayNav kontrol):

Self.Steps

Contoh kode (mereferensikan langkah-langkah dari kontrol lain):

SubwayNav1.Steps

Pembatasan

Komponen kode ini hanya dapat digunakan pada aplikasi kanvas dan halaman kustom.