Grid dan subgrid dalam aplikasi dipacu model (rujukan API klien)

Grid dan subgrid mempersembahkan data dalam format jadual dalam aplikasi berasaskan model. Gunakan acara dan objek API Klien dalam artikel ini untuk bekerja dengan grid baca sahaja dan boleh sunting. Grid boleh merangkumi keseluruhan borang atau boleh menjadi salah satu item pada borang; yang terakhir dipanggil subgrid.

Jenis grid

Terdapat dua jenis grid dalam apl dipacu model:

• Grid baca sahaja: Paparkan data dalam format jadual. Untuk mengedit data yang dipaparkan dalam grid baca sahaja, anda perlu memilih rekod dalam grid untuk membuka borang, mengedit data dan kemudian menyimpan.
• Grid boleh sunting: Selain memaparkan data dalam format jadual, menyediakan keupayaan penyuntingan dalam talian yang kaya pada klien web dan mudah alih termasuk keupayaan untuk mengelompokkan, mengisih, dan menapis data dalam grid yang sama supaya anda tidak perlu menukar rekod atau paparan. Grid boleh diedit ialah kawalan tersuai dan disokong dalam grid utama dan subgrid pada borang dalam klien web dan dalam papan pemuka dan pada grid borang pada klien mudah alih. Walaupun kawalan grid boleh diedit menyediakan keupayaan penyuntingan, ia menghormati metadata grid baca sahaja dan tetapan keselamatan peringkat medan.

Dapatkan konteks grid

Konteks grid ialah tika grid atau subgrid pada borang yang anda mahu menjalankan kod anda. Untuk maklumat lanjut tentang mendapatkan konteks grid untuk melaksanakan kod JavaScript anda, lihat Konteks grid API Klien.

Acara grid

Nama	Keterangan	Berkenaan untuk
Acara OnLoad Subgrid	Berlaku setiap kali subgrid disegarkan. Peristiwa ini termasuk apabila pengguna menyusun nilai dalam subgrid dengan mengklik tajuk lajur.	Grid baca sahaja
Grid OnChange	Berlaku apabila nilai ditukar dalam sel dalam grid boleh diedit dan sel kehilangan fokus	Grid boleh edit
Grid OnRecordSelect	Berlaku apabila satu baris (rekod) dipilih dalam grid boleh edit	Grid boleh edit
Grid OnSave	Berlaku sebelum menghantar maklumat yang dikemas kini ke pelayan, dan apabila mana-mana perkara berikut berlaku: terdapat perubahan dalam pemilihan rekod, pengguna secara eksplisit mencetuskan operasi simpan dengan menggunakan butang simpan grid boleh sunting, atau pengguna menggunakan operasi penyusunan, penapis, kumpulan, penpaginahan, atau navigasi dari grid boleh suntingan semasa terdapat perubahan tertunda.	Grid boleh edit

Nota

Anda boleh mendaftar untuk acara OnChange, OnRecordSelect, dan OnSave dengan menggunakan tab Acara pada halaman aplikasi berasaskan model yang anda gunakan untuk mengaktifkan grid boleh suntingan bagi jadual atau grid baca sahaja.

Objek grid

Gunakan objek berikut untuk berinteraksi dengan grid. Objek ini membentuk hierarki seperti yang ditunjukkan dalam gambar rajah berikut:

Nama	Keterangan	Tersedia untuk
Kawalan Grid	Menyediakan kaedah untuk bekerja dengan kawalan grid atau subgrid.	Grid boleh baca sahaja dan boleh diedit
Grid	Menyediakan kaedah untuk mengakses maklumat tentang data dalam grid.	Grid boleh baca sahaja dan boleh diedit
Baris Grid	Menyediakan kaedah untuk bekerja dengan baris atau baris terpilih dalam grid.	Grid boleh baca sahaja dan boleh diedit
GridRowData	Menyediakan kaedah untuk bekerja dengan baris atau baris terpilih dalam grid.	Grid boleh baca sahaja dan boleh diedit
Entiti Grid	Menyediakan kaedah untuk mengakses data tentang rekod tertentu dalam baris.	Grid boleh baca sahaja dan boleh diedit
Atribut Grid	Menyediakan kaedah untuk mengakses data dalam sel grid boleh diedit.	Grid boleh edit
Sel Grid	Menyediakan kaedah untuk mengakses data yang berkaitan dengan kawalan pada borang yang terikat pada lajur dalam grid boleh diedit.	Grid boleh edit
ViewSelector	Menyediakan kaedah untuk mendapatkan atau menetapkan maklumat tentang pemilih pandangan kawalan subgrid.	Grid baca sahaja

Artikel berkaitan

Konteks grid API pelanggan
Gunakan grid yang boleh diedit
Rujukan API Pelanggan untuk apl dipacu model
Panduan pembangun aplikasi berasaskan model