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

ข้อจำกัด

ส่วนประกอบของพื้นที่ทำงานนี้ใช้ได้เฉพาะในแอปพื้นที่ทำงานและหน้าที่กำหนดเองเท่านั้น