Tingkat 2 (Kabupaten & Kota)fungsi: kabupaten(kode_provinsi?)
Fungsi kabupaten()
Mengambil daftar kabupaten dan kota di Indonesia. Dapat difilter berdasarkan provinsi tertentu atau menampilkan seluruh 514 kabupaten/kota se-Indonesia.
1. Spesifikasi Parameter
| Parameter | Tipe | Wajib? | Contoh Nilai | Keterangan |
|---|---|---|---|---|
| kode_provinsi | string | undefined | Opsional | "32", "52", "11" | Kode 2 digit provinsi induk. Jika dikosongkan, akan mengembalikan seluruh kabupaten di Indonesia. |
2. Perilaku Pemanggilan (Behavior)
Kasus A: Dengan Parameter Kode Provinsi (Umum untuk Form Alamat)
Jika Anda mengirimkan kode provinsi (misal: '32' untuk Jawa Barat), fungsi hanya akan mengembalikan kabupaten/kota yang ada di provinsi tersebut (27 kabupaten/kota).
const kabJabar = kabupaten('32');
console.log(kabJabar.length); // 27Kasus B: Tanpa Parameter (Dikosongkan)
Jika dipanggil tanpa argumen apapun, fungsi akan mengembalikan seluruh 514 kabupaten dan kota di Indonesia. Berguna untuk fitur pencarian global atau select kota universal.
const semuaKabupaten = kabupaten(); console.log(semuaKabupaten.length); // 514
Kasus C: Kode Provinsi Salah / Tidak Ditemukan
Jika Anda mengirim kode yang tidak ada (misal: '9999'), fungsi akan dengan aman mengembalikan array kosong [] (tidak error dan tidak mengembalikan seluruh data).
const hasil = kabupaten('9999');
console.log(hasil); // []3. Tipe Data (TypeScript Interface)
export interface Kabupaten {
/** Kode kabupaten tanpa titik (4 digit), contoh: "3204" */
kode: string;
/** Kode resmi Kemendagri dengan titik, contoh: "32.04" */
kode_kemendagri: string;
/** Kode provinsi induk (2 digit), contoh: "32" */
kode_provinsi: string;
/** Nama daerah, contoh: "Kabupaten Bandung" atau "Kota Bandung" */
nama: string;
/** Tipe daerah administratif */
tipe: 'Kabupaten' | 'Kota';
}4. Contoh Penggunaan di React / Next.js
Berikut contoh menghubungkan dropdown provinsi dengan dropdown kabupaten:
import { useState } from 'react';
import { provinsi, kabupaten } from 'daftar-wilayah-indonesia';
export default function ContohPilihKota() {
const [kodeProv, setKodeProv] = useState('');
const [kodeKab, setKodeKab] = useState('');
const listProvinsi = provinsi();
// Kabupaten akan otomatis reaktif saat provinsi dipilih
const listKabupaten = kodeProv ? kabupaten(kodeProv) : [];
return (
<div className="space-y-3">
{/* 1. Pilih Provinsi */}
<select value={kodeProv} onChange={(e) => {
setKodeProv(e.target.value);
setKodeKab(''); // reset kabupaten saat provinsi berubah
}}>
<option value="">Pilih Provinsi</option>
{listProvinsi.map((p) => (
<option key={p.kode} value={p.kode}>{p.nama}</option>
))}
</select>
{/* 2. Pilih Kabupaten */}
<select
value={kodeKab}
disabled={!kodeProv}
onChange={(e) => setKodeKab(e.target.value)}
>
<option value="">Pilih Kabupaten / Kota</option>
{listKabupaten.map((k) => (
<option key={k.kode} value={k.kode}>
[{k.tipe}] {k.nama}
</option>
))}
</select>
</div>
);
}5. Contoh Hasil Respon kabupaten('52') (NTB)
[
{
"kode": "5201",
"kode_kemendagri": "52.01",
"kode_provinsi": "52",
"nama": "Kabupaten Lombok Barat",
"tipe": "Kabupaten"
},
{
"kode": "5202",
"kode_kemendagri": "52.02",
"kode_provinsi": "52",
"nama": "Kabupaten Lombok Tengah",
"tipe": "Kabupaten"
},
{
"kode": "5203",
"kode_kemendagri": "52.03",
"kode_provinsi": "52",
"nama": "Kabupaten Lombok Timur",
"tipe": "Kabupaten"
},
{
"kode": "5271",
"kode_kemendagri": "52.71",
"kode_provinsi": "52",
"nama": "Kota Mataram",
"tipe": "Kota"
},
{
"kode": "5272",
"kode_kemendagri": "52.72",
"kode_provinsi": "52",
"nama": "Kota Bima",
"tipe": "Kota"
}
]