ProgressIndicator ควบคุม
ตัวควบคุมที่ใช้เพื่อสร้างประสบการณ์การโหลด
หมายเหตุ
รหัสแหล่งที่มาของส่วนประกอบและข้อมูลเพิ่มเติมใน ที่เก็บส่วนประกอบของโค้ด GitHub
Description
ตัวบ่งชี้ความคืบหน้าใช้เพื่อแสดงสถานะเสร็จสิ้นของการดำเนินการที่ใช้เวลานานกว่าสองวินาที หากไม่สามารถระบุสถานะของความคืบหน้าได้ ให้ใช้ Spinner หรือใช้ชนิด Indeterminate Indicator แทน ตัวบ่งชี้ความคืบหน้าสามารถปรากฏในแผงใหม่ ในหน้าต่างเมนูลอย ภายใต้ UI ที่เริ่มต้นการทำงาน หรือแม้แต่สามารถแทนที่ UI เริ่มต้นตราบใดที่ UI กลับมาได้หากคุณยกเลิกหรือหยุดกิจกรรม
ส่วนประกอบของโค้ดนี้จัดเตรียมแรปเปอร์รอบตัวควบคุม Fluent UI ProgressIndicator เพื่อใช้ในพื้นที่ทำงานและหน้าแบบกำหนดเอง ดูคู่มือส่วนประกอบสำหรับแนวทางปฏิบัติที่ดีที่สุด
คุณสมบัติ
คุณสมบัติที่สำคัญ
| คุณสมบัติ | Description |
|---|---|
Label |
ป้ายชื่อเสริมสำหรับ Spinner |
Percentage Complete |
เปอร์เซ็นต์ของการดำเนินการที่เสร็จสิ้น ในระดับ 0 ถึง 1 หากไม่ได้ตั้งค่า ตัวระบุไม่แน่นอนจะแสดงขึ้น |
TypeOfIndicator |
ระบุชนิดของลักษณะตัวบ่งชี้ ตัวเลือก: Default Indicator หรือ IndeterminateIndicator |
HideProgressState |
ระบุจริงเพื่อซ่อนสถานะความคืบหน้า |
BarHeight |
ระบุความสูงของแถบตามความเหมาะสม |
คุณสมบัติ Style
| คุณสมบัติ | Description |
|---|---|
Theme |
ยอมรับสตริง JSON ที่สร้างขึ้นโดยใช้ ตัวออกแบบธีม Fluent UI (windows.net) การเว้นว่างไว้จะใช้ธีมเริ่มต้นที่กำหนดโดย Power Apps ดูที่ ชุดรูปแบบ สำหรับความช่วยเหลือเกี่ยวกับวิธีกำหนดค่า |
AccessibilityLabel |
ป้ายชื่อ aria สำหรับโปรแกรมอ่านหน้าจอ |
พฤติกรรม
แสดงความคืบหน้าในการโหลด
ทำให้ ProgressIndicator ควบคุมตัวเอง (หรือพื้นผิวที่อยู่ภายใน) ที่มองเห็นได้เมื่อกระบวนการเริ่มต้น จากนั้นอัปเดตตัวแปรด้วยค่าเมื่อส่วนต่างๆ ของกระบวนการเสร็จสิ้น ซ๋อนเมื่อกระบวนการเสร็จสมบูรณ์ ใช้ตัวแปรเพื่อควบคุมการมองเห็นของตัวควบคุม และอัปเดตค่าระหว่างบล็อกรหัสหลักของกระบวนการที่ต้องการการบ่งชี้
UpdateContext({ var_showProgress: true , var_progressValue: 0 });
/* Some code ... */
UpdateContext({ var_progressValue: 25 });
/* Some code ... */
UpdateContext({ var_progressValue: 50 });
/* Some code ... */
UpdateContext({ var_progressValue: 75 });
/* Some code ... */
UpdateContext({ var_progressValue: 100 });
Notify("Successfully completed process", NotificationType.Success);
UpdateContext({ var_showProgress: false });
ให้ตัวแปร var_showProgress เป็นค่าของคุณสมบัติ Visible ของ ProgressIndicator (หรือพื้นผิวที่มีอยู่) และกำหนดตัวแปร var_progressValue สำหรับคุณสมบัติ Value
ข้อจำกัด
ส่วนประกอบของพื้นที่ทำงานนี้ใช้ได้เฉพาะในแอปพื้นที่ทำงานและหน้าที่กำหนดเองเท่านั้น