Koleksi kawalan (rujukan API Klien)

Gunakan koleksi untuk controls mengakses kawalan yang berkaitan dengan lajur.

Apabila anda melakukan tindakan pada kawalan yang terikat kepada lajur, pertimbangkan bahawa kawalan tersebut mungkin muncul di halaman lebih daripada sekali. Secara amnya, anda harus melakukan tindakan yang sama untuk setiap kawalan bagi lajur. Anda boleh berulang melalui koleksi kawalan lajur dan melakukan tindakan pada setiap kawalan.

Sebagai contoh, untuk menambah pemberitahuan kepada setiap kawalan yang terikat pada name lajur, gunakan kod berikut:

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

Oleh kerana setiap lajur boleh muncul lebih daripada sekali di halaman, koleksi kawalan menyediakan akses kepada semua kawalan yang mewakili lajur tersebut. Jika lajur diwakili oleh hanya satu kawalan pada halaman, panjang koleksi ini ialah 1.

Apabila anda menggunakan kaedah kawalan getName , nama kawalan pertama sepadan dengan nama lajur. Contoh kedua kawalan untuk lajur itu ialah <columnName>1. Corak <columnName>+N diteruskan untuk setiap kawalan tambahan yang ditambah ke borang untuk lajur tertentu.

Apabila borang memaparkan kawalan aliran proses perniagaan dalam pengepala, ia menambah kawalan untuk setiap lajur yang muncul dalam aliran proses perniagaan. Kawalan ini mempunyai nama unik seperti berikut: header_process_<column name>.

Artikel berkaitan

Lajur (Rujukan API Klien)