Pengumpulan kontrol (referensi API Klien)

controls Gunakan koleksi untuk mengakses kontrol yang terkait dengan kolom.

Saat Anda melakukan tindakan pada kontrol yang terkait dengan kolom, pertimbangkan bahwa kontrol mungkin muncul di halaman lebih dari sekali. Umumnya, Anda harus melakukan tindakan yang sama untuk setiap kontrol untuk kolom. Anda dapat mengulang koleksi kontrol kolom dan melakukan tindakan pada setiap kontrol.

Misalnya, untuk menambahkan pemberitahuan ke setiap kontrol yang terikat ke name kolom, gunakan kode berikut:

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

Karena setiap kolom dapat muncul lebih dari sekali di halaman, koleksi kontrol menyediakan akses ke semua kontrol yang mewakili kolom tersebut. Jika kolom hanya diwakili oleh satu kontrol pada halaman, panjang koleksi ini adalah 1.

Saat Anda menggunakan metode control getName , nama kontrol pertama cocok dengan nama kolom. Instans kedua kontrol untuk kolom tersebut adalah <columnName>1. Pola <columnName>+N berlanjut untuk setiap kontrol tambahan yang ditambahkan ke formulir untuk kolom tertentu.

Saat formulir menampilkan kontrol alur proses bisnis di header, formulir menambahkan kontrol untuk setiap kolom yang muncul dalam alur proses bisnis. Kontrol ini memiliki nama unik seperti berikut ini: header_process_<column name>.

Artikel terkait

Kolom (referensi API Klien)