FormCheckbox

Checkbox dengan tampilan W4C, termasuk status setengah tercentang untuk pilihan bertingkat.

Dasar

Checkbox membawa labelnya sendiri, jadi teksnya ada di samping kotak, bukan di atas. Baris description menjelaskan akibat pilihan tanpa memanjangkan label.

Ringkasan tonase dan biaya, setiap tanggal 1.

Nilai: aktif

Beberapa pilihan dalam satu nilai

Beberapa checkbox boleh berbagi satu v-model berupa array; masing-masing menyumbang value-nya. Bungkus dengan <W4cFormField group> supaya judul kelompok menjadi caption, bukan label satu kontrol.

Jenis sampah yang diangkut

Perlu izin khusus dan armada terpisah.

Pilih satu atau lebih.

Terpilih: organik

Pilih semua

Checkbox induk memakai indeterminate saat sebagian anak tercentang. Status ini hanya ada di DOM, bukan nilai ketiga: v-model tetap boolean.

Lokasi penjemputan

Terpilih untuk jadwal minggu ini.

Error, disabled, dan ukuran

Error dan disabled diwarisi dari FormField. Ukuran sm dipakai di dalam baris tabel, lg untuk pilihan yang menjadi aksi utama.

Persetujuan

Centang dulu sebelum lanjut.

Paket terkunci

Dipakai saat checkbox jadi aksi utama di layar.

API

Props

PropTipeDefaultKeterangan
v-modelboolean | (string | number | boolean | null)[]falseBoolean untuk satu checkbox, atau array yang dipakai bersama beberapa checkbox.
valuestring | number | boolean | null—Nilai yang masuk ke array saat checkbox dicentang.
labelstring—Teks di samping kotak. Slot default untuk isi yang lebih kaya.
descriptionstring—Baris penjelas di bawah label, terhubung lewat aria-describedby.
indeterminatebooleanfalseStatus setengah tercentang untuk "pilih semua" yang sebagian aktif.
size'sm' | 'md' | 'lg''md'Ukuran kotak dan teks.
id / disabled / required / invalid——Sama seperti kontrol form lain, termasuk pewarisan dari FormField.

Slots

SlotTipeDefaultKeterangan
default——Isi label.
description——Isi baris penjelas.

Atribut name, value tambahan, dan ARIA diteruskan ke input. class/style diterapkan pada pembungkus. Ref komponen menyediakan focus() dan blur().