שתף באמצעות


Spinner לִשְׁלוֹט

פקד המשמש ליצירת חוויית טעינה.

הערה

תיעוד מלא וקוד מקור רכיב נמצאים במאגר רכיבי הקוד של GitHub.

פקד מחוון התקדמות.

תיאור‬‏‫‬

'מחוון התקדמות' הוא מיתאר מעגל המסתובב סביב עצמו ומציין למשתמש שמתבצע עיבוד לפריטים. הוא מופיע כאשר לתהליך לא ברור כמה זמן המשימה תימשך, לכן היא הופכת לגירסת ביניים של ProgressIndicator.

מחווני ההתקדמות יכולים להשתנות בגודלם, והם יכולים להיות מוטבעים בתוכן או במרכז. מחווני ביצוע מופיעים בדרך כלל לאחר עיבוד או ביצוע פעולה. הם עדינים ובדרך כלל לא תופסים הרבה מקום, אבל הם מועברים מהמשימה שהושלמה.

רכיב קוד זה מספק מעטפת סביב הפקד 'מחוון התקדמות' של Fluent UI לשימוש בדפי בד ציור ובדפים מותאמים אישית. עיין בתיעוד הרכיבים לשיטות עבודה מומלצות.

‏‫מאפיינים עיקריים‬

מאפיין‬ תיאור‬‏‫‬
Label תווית אופציונלית לתיבת טווח.
SpinnerSize גודל מחוות ההתקדמות שיש לעבד. בחירות: xSmall, Small, Medium, Large
SpinnerAlignment יישור מחוון ההתקדמות בתוך גבולות הפקד. בחירות: Left, Center, Right
LabelPosition הצבה אופציונלית של תווית מחוון ההתקדמות למיקום מסוים. בחירות: Bottom, Top, Left, Right

מאפייני סגנון

מאפיין‬ תיאור‬‏‫‬
Theme מקבל מחרוזת JSON שנוצרת באמצעות Fluent UI Theme Designer ‎(windows.net)‎. השארה ללא ערך תביא לשימוש בערכת הנושא המוגדרת כברירת מחדל על ידי Power Apps. ראה הגדרת ערכת נושא לקבלת הדרכה לגבי אופן ההגדרה.
AccessibilityLabel תווית Aria לקוראי מסך

דוגמה

הצגת מחוון ההתקדמות בעת הטעינה

הפוך את פקד מחוון ההתקדמות לגלוי כאשר התהליך מתחיל ולאחר מכן הסתר אותו כשהתהליך מושלם.

השתמש במשתנה כדי לשלוט בנראות מחוון ההתקדמות ולעדכן את הערכים לפני בלוק הקוד של התהליך ואחריו.

UpdateContext({ var_showLoader: true });

/* Some code ... */

UpdateContext({ var_showLoader: false });

לאחר מכן, ספק את המשתנה var_showLoader כערך עבור המאפיין IsLoading של מחוון ההתקדמות.

הגבלות

ניתן להשתמש ברכיב קוד זה רק ביישומי בד ציור ובדפים מותאמים אישית.