คุณสมบัติส่วนประกอบพื้นที่ทำงาน (การทดลอง)

ส่วนประกอบพื้นที่ทำงาน อนุญาตให้ผู้สร้างสร้างคุณสมบัติประเภทต่างๆ เพื่อถ่ายทอดค่าหรือตรรกะระหว่างส่วนประกอบและแอปที่โฮสต์ส่วนประกอบ คุณสมบัติเป็นส่วนสำคัญในการสร้างส่วนประกอบแบบโต้ตอบและใช้ซ้ำได้

ชนิดของคุณสมบัติ

ผู้สร้างมีคุณสมบัติสี่ประเภท:

1. คุณสมบัติของข้อมูล: คุณสมบัติของข้อมูลเกี่ยวข้องกับข้อมูล เช่น ค่าสีหรือข้อความ คุณสมบัติ Data สามารถตั้งค่าเป็น Input หรือ Output ซึ่งแสดงว่าส่วนประกอบให้ข้อมูลกับแอป (Output) หรือแอปให้ข้อมูลกับส่วนประกอบ (Input) คุณสมบัติ Data เป็นคุณสมบัติเดียวที่เข้าร่วมในโฟลว์ข้อมูลของแอป
2. คุณสมบัติของฟังก์ชัน: คุณสมบัติของฟังก์ชันเกี่ยวข้องกับตรรกะ เช่น การคำนวณตามพารามิเตอร์เฉพาะหรือการแก้ไขข้อความ คุณสมบัติ Function สามารถตั้งค่าเป็น Input หรือ Output ซึ่งแสดงว่าส่วนประกอบกำหนดฟังก์ชันให้แอปสามารถเรียก (Output) หรือแอปกำหนดฟังก์ชันให้ส่วนประกอบสามารถเรียก (Input) คุณสมบัติของ ฟังก์ชัน ไม่เข้าร่วมในโฟลว์ข้อมูลของแอป และไม่สามารถใช้ส่วนประกอบหรือตัวแปรของแอปได้
3. คุณสมบัติของการดำเนินการ: คุณสมบัติของการดำเนินการเป็นคุณสมบัติประเภทหนึ่งที่จัดการกับตรรกะและทำงานเหมือนกับ Output Function ดังนั้น ส่วนประกอบจึงมีการกำหนดตรรกะ และตรรกะนั้นสามารถใช้นิพจน์แบบลูกโซ่และจัดการกับคอลเลกชันหรือตัวแปร ("ลักษณะการทำงาน") ตัวอย่างเช่น คุณสมบัติ การดำเนินการ Clear() อาจมีฟังก์ชันการทำงานที่แอปสามารถเรียกเพื่อล้างค่าบางค่าในส่วนประกอบ หรือคุณสมบัติ การดำเนินการ Save() ที่อัปเดตแหล่งข้อมูล
4. คุณสมบัติของเหตุการณ์: คุณสมบัติของเหตุการณ์เป็นประเภทของคุณสมบัติที่เกี่ยวข้องกับตรรกะและฟังก์ชันที่เป็น Input Function ดังนั้น แอปจะกำหนดตรรกะว่าส่วนประกอบใดสามารถเรียกได้ และตรรกะนั้นสามารถใช้นิพจน์แบบลูกโซ่และจัดการกับคอลเลกชันหรือตัวแปร ("ลักษณะการทำงาน") โดยทั่วไป ชื่อของคุณสมบัติเหล่านี้จะแสดงถึงเหตุการณ์เช่น OnSelect หรือ OnChanged

คุณสมบัติข้อมูล

การใช้งานคุณสมบัติข้อมูลเป็นเรื่องง่ายที่จะจินตนาการ ตัวควบคุมมาตรฐานในแอปมักจะมีคุณสมบัติข้อมูลหลายอย่าง เพื่อตั้งค่าเริ่มต้น สีข้อความ ขนาด ฯลฯ มาดูตัวอย่างง่ายๆ ที่เราต้องการทำให้คุณสมบัติของตัวควบคุมภายในส่วนประกอบสามารถใช้งานสำหรับแอปโฮสติ้ง ในตัวอย่างนี้ ส่วนประกอบของเรามีชื่อว่า Component1 เราจะใส่ตัวควบคุม แถบเลื่อน ไว้ในส่วนประกอบของเรา เราจะมีคุณสมบัติ Input เพื่อระบุสีจากแอปที่ใช้ และคุณสมบัติ Output ที่ส่วนประกอบสามารถบอกแอปว่าค่าปัจจุบันของ slider คืออะไร ตัวอย่างต่อไปนี้ถือว่าส่วนประกอบของคุณมีตัวควบคุม แถบเลื่อน ที่ชื่อ Slider

1. ในบานหน้าต่างคุณสมบัติของส่วนประกอบ ให้เลือก คุณสมบัติที่กำหนดเองใหม่
2. ในบานหน้าต่าง คุณสมบัติที่กำหนดเองใหม่ ให้ป้อนชื่อที่แสดง Slider Color
3. เลือก ชนิดคุณสมบัติ เป็น Data และเลือกค่า คำนิยามคุณสมบัติ เป็น Input
4. สุดท้าย จากดรอปดาวน์ ชนิดข้อมูล ให้เลือก สี
5. คลิก สร้าง

จากนั้นเลือกตัวควบคุม แถบเลื่อน Slider1 ค้นหาคุณสมบัติ ValueFill และในแถบสูตร ให้ป้อน Component1.SliderColor Component1 หมายถึงชื่อส่วนประกอบของเรา และ SliderColor เป็นชื่อของคุณสมบัติที่เราเพิ่มไว้ก่อนหน้านี้

ตอนนี้ส่วนประกอบของเรามีคุณสมบัติ SliderColor ซึ่งสามารถตั้งค่าได้ในแอปที่ใช้ เพื่อส่งสีไปยังส่วนประกอบที่จะตั้งค่าคุณสมบัติ ValueFill ของแถบเลื่อน

นอกจากนี้ เรายังต้องการให้ค่าของแถบเลื่อนไปยังแอปที่ใช้ เพื่อให้บรรลุเป้าหมายนี้ เราจะเพิ่มคุณสมบัติ Output

1. ในบานหน้าต่างคุณสมบัติของส่วนประกอบ ให้เลือก คุณสมบัติที่กำหนดเองใหม่
2. ในบานหน้าต่าง คุณสมบัติที่กำหนดเองใหม่ ให้ป้อนชื่อที่แสดง Slider Value
3. เลือก ชนิดคุณสมบัติ ของ ข้อมูล และเลือก คำนิยามคุณสมบัติ เป็นค่า Output
4. สุดท้าย จากดรอปดาวน์ ชนิดข้อมูล ให้เลือก ตัวเลข
5. คลิก สร้าง

เมื่อคุณสมบัติ Data เป็น Output ส่วนประกอบจะกำหนดค่าให้กับแอปที่ใช้งาน ในการกำหนดสูตรนี้ เราต้องตั้งค่าคุณสมบัติ SliderValue ใหม่ในส่วนประกอบเป็นคุณสมบัติ Value ของแถบเลื่อน

1. ในบานหน้าต่างคุณสมบัติของส่วนประกอบ ให้คลิกคุณสมบัติ Slider Value
2. ในแถบสูตร ให้แทนที่ค่าเริ่มต้นของ 100 ด้วยสูตรต่อไปนี้: Slider1.Value

ตอนนี้ คุณสมบัติ SliderValue ของส่วนประกอบของเราจะแสดงค่าของแถบเลื่อนภายในส่วนประกอบ ซึ่งสามารถอ่านได้จากแอปที่ใช้

คุณสมบัติของฟังก์ชัน

คุณสมบัติของฟังก์ชันประกอบด้วยนิพจน์ที่ส่งคืนค่า โดยปกติแล้ว ฟังก์ชันจะรับอาร์กิวเมนต์บางอย่างที่ใช้ในการคำนวณหรือกำหนดค่าที่จะส่งคืน

ฟังก์ชัน Output เป็นวิธีง่ายๆ ในการสร้างฟังก์ชันแบบกำหนดเองสำหรับ Power Apps ส่วนประกอบจะกำหนดฟังก์ชัน Output ด้วยนิพจน์ที่รับอาร์กิวเมนต์และส่งคืนค่า ฟังก์ชันนี้สามารถใช้ในแอปโดยใช้ชื่อของส่วนประกอบ (เช่น Component1) โดยการเรียก Component1.MyFunction(arg1, arg2)

ฟังก์ชัน Input เป็นวิธีสำหรับแอปที่ใช้เพื่อระบุตรรกะให้กับส่วนประกอบ คล้ายกับตัวชี้ฟังก์ชันหรือฟังก์ชันเรียกกลับ ตัวอย่างเช่น ส่วนประกอบของคุณอาจเกี่ยวข้องกับชื่อของบุคคลและมีฟังก์ชัน input ที่มีอาร์กิวเมนต์ firstname และ lastname และใช้การคืนกลับสตริง แอปสามารถกำหนดนิพจน์ของฟังก์ชันที่จะส่งคืน $"{firstname} {lastname}" หรืออาจเลือกที่จะกำหนดนิพจน์สำหรับ $"{lastname}, {firstname}" ส่วนประกอบสามารถเรียกใช้ฟังก์ชันที่ผู้สร้างแอปจัดเตรียมไว้ให้ และใช้สตริงที่ส่งคืนได้

คุณสมบัติการดำเนินการ

คุณสมบัติของการดำเนินการคล้ายกับคุณสมบัติของฟังก์ชันชนิด Output แต่อนุญาตให้ใช้สูตรผลข้างเคียงและการเกี่ยวโยงนิพจน์ได้ ส่วนประกอบอาจมีชื่อคุณสมบัติของการดำเนินการที่ชื่อ AddRecord ซึ่งอนุญาตให้แอปเพิ่มเรกคอร์ดไปยังคอลเลกชันภายในส่วนประกอบ หรือการดำเนินการ Reset ที่ล้างตัวแปรหรือคอลเลกชันภายในส่วนประกอบ

ในตัวอย่างของแถบเลื่อนตัวอย่างที่ใช้สำหรับ คุณสมบัติของข้อมูล ก่อนหน้านี้ เราขอเริ่มใช้คุณสมบัติของการดำเนินการที่ชื่อว่า ResetValue เพื่อตั้งค่าแถบเลื่อนกลับเป็นค่าเริ่มต้น เราสามารถใช้สูตร Reset( Slider1 ) สำหรับสิ่งนี้ ตอนนี้ อินสแตนซ์ของส่วนประกอบของเราในแอปสามารถเรียก Component1.ResetValue() เพื่อตั้งค่าแถบเลื่อนกลับเป็นค่าเริ่มต้น

คุณสมบัติของเหตุการณ์

มีคุณสมบัติชนิด เหตุการณ์ ที่ใช้ร่วมกันจำนวนมากป้อนข้อมูลคุณสมบัติของฟังก์ชันลักษณะการทำงานอย่างมีประสิทธิภาพในตัวควบคุมมาตรฐาน OnSelect บนตัวควบคุม ปุ่ม เป็นตัวอย่างที่ชัดเจนที่สุด ส่วนประกอบสามารถกำหนดคุณสมบัติของเหตุการณ์จำนวนเท่าใดก็ได้ และเรียกเหตุการณ์เหล่านี้ว่าฟังก์ชัน ตัวอย่างเช่น ส่วนประกอบที่มีตัวควบคุม ปุ่ม อาจมีคุณสมบัติของเหตุการณ์ที่ชื่อ OnButtonClicked ใน OnSelect ของตัวควบคุม ปุ่ม ส่วนประกอบสามารถเรียกคุณสมบัติ Component1.OnButtonClicked() ได้ แอปที่ใช้งานสามารถกำหนดตรรกะของตัวเองสำหรับคุณสมบัตินี้ เพื่อดำเนินการเมื่อกดปุ่มภายในส่วนประกอบ

ค่าเริ่มต้นสำหรับคุณสมบัติหรืออาร์กิวเมนต์

ค่าเริ่มต้นสามารถระบุค่าเริ่มต้นสำหรับอาร์กิวเมนต์หรือคุณสมบัติในกรณีที่ไม่มีการตั้งค่า ซึ่งลักษณะนี้ไม่เหมาะกับคุณสมบัติบางประเภท อย่างไรก็ตาม ในบางกรณีสามารถใช้เพื่อระบุ Schema ที่คาดไว้สำหรับเรกคอร์ด เมื่อระบุเรกคอร์ดเริ่มต้น ระบบจะสร้างชนิดของเรกคอร์ดเป็น Schema ที่คาดไว้

ตัวอย่างเช่น คุณสมบัติของ การดำเนินการ ที่ชื่อ AddRecord ยอมรับเรกคอร์ดที่จะเพิ่มลงในคอลเลกชันภายในเครื่อง ในการระบุ Schema ของเรกคอร์ดที่คาดไว้ ผู้สร้างต้องเพิ่มค่าเริ่มต้นสำหรับอาร์กิวเมนต์ของคุณสมบัติ AddRecord นี้