คอลเลกชันตัวควบคุม (การอ้างอิง Client API)

controlsใช้คอลเลกชันเพื่อเข้าถึงตัวควบคุมที่เกี่ยวข้องกับคอลัมน์

เมื่อคุณดําเนินการกับตัวควบคุมที่เชื่อมโยงกับคอลัมน์ ให้พิจารณาว่าตัวควบคุมอาจปรากฏบนหน้ามากกว่าหนึ่งครั้ง โดยทั่วไปแล้ว คุณควรดําเนินการเหมือนกันสําหรับแต่ละตัวควบคุมสําหรับคอลัมน์ คุณสามารถวนรอบผ่านคอลเลกชันตัวควบคุมคอลัมน์และดําเนินการกับตัวควบคุมแต่ละตัวได้

ตัวอย่างเช่น เมื่อต้องการเพิ่มการแจ้งเตือนไปยังตัวควบคุมแต่ละตัวที่ name ผูกกับคอลัมน์ ให้ใช้โค้ดต่อไปนี้:

const notification = {
    messages: ['Sample Notification on Name Controls'],
    notificationLevel: 'RECOMMENDATION',
    uniqueId: 'my_unique_id'
 };
 
formContext.getAttribute("name").controls.forEach(control =>
    control.addNotification(notification)
 );

เนื่องจากแต่ละคอลัมน์สามารถปรากฏมากกว่าหนึ่งครั้งบนหน้า คอลเลกชันตัวควบคุมมีการเข้าถึงตัวควบคุมทั้งหมดที่แสดงคอลัมน์นั้น ถ้าคอลัมน์ถูกแสดงด้วยตัวควบคุมเดียวบนหน้าเท่านั้น ความยาวของคอลเลกชันนี้คือ 1

เมื่อคุณใช้เมธอด getName ของตัวควบคุมแรกจะตรงกับชื่อของคอลัมน์ อินสแตนซ์ที่สองของตัวควบคุมสําหรับคอลัมน์นั้นคือ<columnName>1 รูปแบบ <columnName>+N จะดําเนินการต่อสําหรับแต่ละตัวควบคุมเพิ่มเติมที่เพิ่มลงในฟอร์มสําหรับคอลัมน์ที่ระบุ

เมื่อฟอร์มแสดงตัวควบคุมโฟลว์กระบวนการทางธุรกิจในส่วนหัว แบบฟอร์มจะเพิ่มตัวควบคุมสําหรับแต่ละคอลัมน์ที่ปรากฏในโฟลว์กระบวนการทางธุรกิจ ตัวควบคุมเหล่านี้มีชื่อที่ไม่ซ้ํากันดังต่อไปนี้: header_process_<column name>

บทความที่เกี่ยวข้อง

คอลัมน์ (การอ้างอิง Client API)