> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Atribut komponen

> Pelajari cara mendefinisikan atribut komponen kustom di YiDA — tambah, edit, dan hapus atribut untuk memperkaya fungsi, mengonfigurasi tipe data, setter, serta nilai default sesuai kebutuhan bisnis.

## 1. Pengenalan atribut komponen

Komponen kustom mendukung pendefinisian atribut (propTypes) untuk memperkaya komponen pada level atribut. Menambahkan atribut kustom meningkatkan tingkat kustomisasi sekaligus membuat komponen lebih fleksibel dan lebih selaras dengan kebutuhan bisnis. (Lihat Gambar 1.1-1)

Gambar 1.1-1 Titik masuk untuk pendefinisian atribut komponen

Atribut komponen dapat ditambahkan melalui tombol "Tambah item", dikustomisasi melalui tombol "Edit", dan dihapus melalui tombol "Hapus". Klik tombol "Edit" untuk melihat semua item konfigurasi atribut komponen. (Lihat Gambar 1.1-2)

Gambar 1.1-2 Item konfigurasi untuk pendefinisian atribut komponen kustom

Semua pendefinisian atribut komponen kustom dapat dilihat dan dikonfigurasi pada halaman pratinjau komponen (untuk debugging atribut sederhana) atau setelah dipasang ke dalam aplikasi (untuk konfigurasi atribut kompleks, termasuk debugging terkait kode). (Lihat Gambar 1.1-3)

Gambar 1.1-3 Pratinjau dan debugging atribut komponen

Untuk deskripsi rinci setiap item konfigurasi, lihat bagian-bagian di bawah.

### 1.1 Judul atribut

Nama atribut yang dikonfigurasi untuk komponen kustom. Judul default-nya adalah "Judul atribut". Judul yang jelas dan mudah dipahami membantu pengguna memahami makna atribut atau mengenali konten yang perlu diisi.

Ketika komponen digunakan pada halaman, tampilannya seperti berikut:

Gambar 1.1-4 Tampilan atribut komponen di desainer formulir

### 1.2 Nama atribut

Nama atribut sebuah komponen berfungsi sebagai key atribut, mirip dengan props.xxx pada sebuah komponen. Nilai default-nya adalah propName. Anda dapat mengikat variabel dalam desain halaman untuk mengontrol komponen. Misalnya, nilai atribut dari komponen kustom dapat digunakan sebagai judul komponen lain di dalam komponen kustom tersebut. (Lihat Gambar 1.1-5)

Gambar 1.1-5 Menggunakan nama atribut

<Warning>
  **Catatan: Nama atribut sebuah komponen tidak boleh kosong; jika kosong, akan terjadi error saat pemanggilan atau penetapan nilai.**
</Warning>

### 1.3 Tipe atribut

Tipe atribut komponen mirip dengan tipe data umum dan mencakup tujuh tipe: **Teks, Boolean, Angka, Object, Array, Fungsi, dan Elemen**. Setiap tipe data berkorespondensi dengan beberapa setter untuk memenuhi kebutuhan pengguna dalam memproses data pada dimensi yang berbeda. (Lihat Gambar 1.1-6)

Gambar 1.1-6 Definisi tipe atribut

### 1.4 Setter

Komponen dengan tipe atribut yang berbeda memiliki setter atribut yang berbeda, sehingga memungkinkan metode rendering komponen dan pemrosesan data yang berbeda pula. Misalnya, tipe Teks berkorespondensi dengan lima setter. (Lihat Gambar 1.1-7)

Gambar 1.1-7 Setter atribut komponen

### 1.5 Nilai default

Merujuk pada bidang yang ditampilkan secara default pada komponen kustom dalam formulir saat pengguna mengakses formulir. (Lihat Gambar 1.1-8 untuk hasilnya)

Gambar 1.1-8 Nilai default atribut komponen

### 1.6 Apakah mendukung pengikatan variabel

Pengikatan variabel dalam desain halaman.

### 1.7 Apakah disembunyikan

Mengontrol apakah atribut disembunyikan. Jarang digunakan.

### 1.8 Saat berubah

Digunakan untuk membuat keterkaitan antara beberapa atribut. Jarang digunakan.

### 1.9 Tata letak

Dibagi menjadi dua tipe: **block** dan **inline**, digunakan untuk mengatur cara komponen kustom disusun pada halaman.

### 1.10 Deskripsi bantuan

* Tidak digunakan saat ini.

### 1.11 Tautan bantuan

* Tidak digunakan saat ini.