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

ParameterTipeWajib?Contoh NilaiKeterangan
kode_provinsistring | undefinedOpsional"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); // 27
Kasus 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"
  }
]