מאפיינים של רכיבי בד ציור (ניסויי)

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

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

קיימים ארבעה סוגים מאפיינים הזמינים ליצרנים:

1. מאפייני נתונים: מאפייני נתונים נוגעים לנתונים, כמו צבע או ערך טקסט. ניתן להגדיר את מאפיין נתונים כקלט או פלט, המציין אם הרכיב מספק נתונים לאפליקציה (פלט) או שהאפליקציה מספקת נתונים לרכיב (קלט). מאפייני נתונים הם המאפיינים היחידים שמשתתפים בזרימת הנתונים של האפליקציה.
2. מאפייני פונקציה: מאפייני פונקציה קשורים ללוגיקה, כגון ביצוע חישוב המבוסס על פרמטרים ספציפיים או שינוי טקסט. ניתן להגדיר מאפיין פונקציה כקלט או פלט, המציין אם הרכיב מספק פונקציה לאפליקציה (פלט) או שהאפליקציה מספקת פונקציה לרכיב (קלט). מאפייני פונקציה אינם משתתפים בזרימת הנתונים של אפליקציה, ואינם יכולים להשתמש במשתנים או ברכיבים של האפליקציה.
3. מאפייני פעולה: מאפייני פעולה הם סוג של מאפיין העוסק בלוגיקה ומתנהג כמו פלט פונקציה. לפיכך, הלוגיקה מוגדרת לרכיב, והלוגיקה הזו יכולה להשתמש בביטויים משורשרים ולטפל באוספים או משתנים ("אופן פעולה"). לדוגמה, מאפיין פעולת Clear() יכול לספק פונקציונליות שהאפליקציה יכולה לקרוא לה כדי לנקות כמה ערכים ברכיב, או מפאיין פעולת Save() שמעדכן מקור נתונים.
4. מאפייני אירוע: מאפייני אירוע הם קטגוריה של מאפיין הכוללת לוגיקה ומתפקדת כפונקציית קלט. לפיכך, האפלקציה מגדירה את הלוגיקה, לה הרכיב יכול לקרוא והלגיקה הזאת יכולה להשתמש בביטויים משורשרים ולטפל באוספים או משתנים ("אופן פעולה"). בדרך כלל שמות המאפיינים הללו משקפים אירוע כגון OnSelect או OnChanged.

מאפיין נתונים

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

1. בחלונית המאפיינים של הרכיב, בחר מאפיין מותאם אישית חדש.
2. בחלונית מאפיין מותאם אישית חדש , הזן שם תצוגה Slider Color.
3. בחר סוג מאפיין נתונים ובחר בערך הגדרת מאפיין קלט.
4. לבסוף, מהרשימה הנפתחת סוג נתונים, בחר צבע.
5. לחץ על יצירה.

אחר כך, בחר בפקד המחוון Slider1. מצא את המאפיין ValueFill שלו ובשורת הנוסחאות הזן Component1.SliderColor. Component1 מתייחס לשם הרכיב שלנו, ו- SliderColor הוא השם של המאפיין שהוספנו לפניכן.

כעת לרכיב שלנו יש מאפיין SliderColor שניתן להגדיר באפליקציה הצורכת, כדי להעביר צבע לרכיב כדי להגדיר את המאפיין ValueFill של המחוון.

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

1. בחלונית המאפיינים של הרכיב, בחר מאפיין מותאם אישית חדש.
2. בחלונית מאפיין מותאם אישית חדש, הזן שם תצוגה Slider Value.
3. בחר סוג מאפיין של נתונים ובחר בערך הגדרת מאפיין קלט.
4. לבסוף, מהרשימה הנפתחת סוג נתונים, בחר מספר.
5. לחץ על יצירה.

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

1. בחלונית המאפיינים של הרכיב, לחץ על המאפיין Slider Value.
2. בסרגל הנוסחאות, החלף את ערך ברירת המחדל 100 בנוסחה הבאה: Slider1.Value.

עכשיו המאפיין SliderValue של הרכיב שלנו ישקף את הערך של המחוון בתוך הרכיב, שאותו ניתן לקרוא מהאפליקציה הצורכת.

מאפיין פונקציה

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

פונקציית פלט היא דרך פשוטה ליצור פונקציה מותאמת אישית עבור Power Apps. הרכיב מגדיר פונקציין פלט עם ביטוי שלוקח כמה ארגומנטים ומחזיר ערך. לאחר מכן ניתן להשתמש בפונקציה זו באפליקציה באמצעות שם הרכיב (למשל Component1) על ידי קריאה ל- Component1.MyFunction(arg1, arg2).

פונקציית קלט היא דרך שבה אפליקציה צורכת יכולה לספק לוגיקה לרכיב, בדומה למצביע פונקציה או לפונקציית התקשרות חוזרת. לדוגמה, ייתכן שהרכיב שלך עוסק בשמות של אנשים ויש לו פונקציית קלט עם הארגומנטים firstname ו- lastname והוא מכבד מחרוזת חזרה. האפליקציה יכולה להגדיר את ביטוי הפונקציה להחזיר $"{firstname} {lastname}" או שהיא יכול להגדיר ביטוי עבור $"{lastname}, {firstname}". הרכיב יכול פשוט לקרוא לפונקציה שיצרן האפליקציה סיפק, ולהשתמש במחרוזת המוחזרת.

מאפיין פעולה

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

בדוגמה של דוגמאות המחוון שבהן השתמשנו לפניכן עבור מאפיין נתונים, נוכל להציג מאפיין פעולה שנקרא ResetValue כדי להחזיר את המחוון לערך ברירת המחדל שלו. אנחנו יכולים להשתמש בנוסחה Reset( Slider1 ) לשם כך. כעת, מופעים של הרכיב שלנו באפליקציה יכולים לקרוא ל- Component1.ResetValue() כדי להחזיר את המחוון לערך ברירת המחדל.

מאפיין ארוע

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

ערכי ברירת מחדל עבור מאפיינים או ארגומנטים

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

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