Manipulasi Combobox dengan Ajax-JQuery: Studi Kasus Data Propinsi & Kabupaten

Cukup banyak pengunjung situs Achmatim.Net yang bertanya seputar manipulasi ComboBox secara dinamis. Yang dimaksud dinamis di sini, selain data diambil dari database, juga terkait dengan isi dari Combobox yang menyesuaikan pada kondisi tertentu. Hal itulah yang melatarbelakangi saya menulis tutorial ini, walaupun jika mau sedikit berusaha, tutorial di Google terkait hal tersebut sudah cukup banyak.

Pada tutorial kali ini, kita akan mengambil studi kasus berupa data inputan Propinsi dan Kabupaten/Kota di Indonesia. Jika kita menggunakan jenis inputan combobox, tentunya kita akan menampilkan semua data Propinsi dan Kabupaten/Kota dalam dua combobox yang berbeda. Tentunya hal tersebut tidak efektif karena ada ratusan kabupaten yang ada di seluruh propinsi di Indonesia. Selain itu, rentan juga terhadap kesalahan input, misalnya pada inputan Propinsi diisi “DKI Jakarta”, tapi di inputan Kabupaten diisi dengan kabupaten “Banyumas” yang tidak terletak di propinsi DKI Jakarta.

Solusi yang akan disampaikan di tutorial ini adalah dengan membuat kedua combobox Propinsi dan Kabupaten saling terkait. Saat dipilih Propinsi tertentu, maka pada combobox Kabupaten akan otomatis berisi nama-nama kabupaten/kota sesuai dengan propinsi yang dipilih tersebut. tutorial ini akan menggunakan konsep Ajax dengan library JQuery. Misalnya jika dipilih propinsi DKI Jakarta, maka otomatis combobox kabupaten hanya berisi Jakarta Selatan, Jakarta Utara, Jakarta Barat, Jakarta Timur, Jakarta Pusat dan Kepulauan Seribu.

Data Propinsi & Kabupaten

Seperti sudah dinyatakan di atas, kita akan menggunakan contoh kasus data propinsi dan kabupaten/kota di Indonesia. Untuk menyederhanakan kasus, hanya field kode dan nama saja yang akan dibuat. Berikut ini class diagram (struktur data) penyimpanan data propinsi dan kabupaten:

Struktur database Propinsi-Kabupaten

Buatlah dua buah tabel di atas di MySQL dengan menggunakan MySQL Client favorit Anda. Setelah itu, isilah data kedua tabel tersebut. Tapi daripada repot, silahkan download file SQL dari kedua tabel tersebut, lengkap dengan isi datanya, lalu import dengan PHPMyAdmin, MySQL Front atau mysql client lainnya. Catatan: file SQL juga sudah dilengkapi dengan perintah membuat database (nama db: demo), jadi tidak perlu bikin database dulu sebelum import.

Menampilkan Data di Combobox dengan PHP

Untuk menampilkan data dari database ke combobox, pada dasarnya sama seperti menampilkan data seperti biasanya. Proses menampilkan data ke combobox dapat dilihat pada program 1 berikut ini. Pertama-tama kita lakukan koneksi ke database mysql, kali ini kita menggunakan fungsi mysqli_* yang merupakan pengembangan dari fungsi mysql_*. Konon fungsi ini performanya lebih baik dibanding fungsi mysql_*, dan juga dapat ditulis dengan gaya prosedural maupun object-oriented. Untuk lebih mempermudah, pada contoh-contoh program di bawah ini, kita akan gunakan gaya prosedural.

Perhatikan baris ke-3 program 1 di bawah ini. Untuk melakukan koneksi ke mysql menggunakan fungsi mysqli_connect() yang memiliki 6 (enam) parameter terkait dengan server MySQL yaitu hostname, username, password, nama database, port dan socket. Pada model object-oriented, fungsi ini merupakan alias dari mysqli::__construct(). Setelah melakukan koneksi, selanjutnya pada baris 6-12 dilakukan pengambilan data propinsi dari tabel propinsi dan ditampung dalam variabel array $arrpropinsi. Kita menggunakan fungsi mysqli_query() untuk meng-eksekusi perintah query dan fungsi mysqli_fetch_assoc() untuk mengambil hasil perintah query-nya.

Perhatikan baris baris 28-23. Pada baris tersebut, dibuat object combobox dengan tag <select> dengan atribut name “propinsi” dan id juga “propinsi”. Dan untuk menampilkan data propinsi di combobox, kita gunakan bentuk perulangan foreach() dengan parameter variabel $arrpropinsi yang berisi data propinsi. Sementara itu, untuk combobox data kabupaten/kota kita cukup membuat object <select>-nya saja (baris ke-39). Untuk datanya akan di-generate saat opsi di combobox propinsi dipilih nantinya.

Program 1: Menampilkan Data di Combobox

<?php
#koneksi
$conn = mysqli_connect("localhost", "root", "qwerty", "demo");
#akhir-koneksi
 
#ambil data propinsi
$query = "SELECT kode, nama FROM propinsi ORDER BY nama";
$sql = mysqli_query($conn, $query);
$arrpropinsi = array();
while ($row = mysqli_fetch_assoc($sql)) {
	$arrpropinsi [ $row['kode'] ] = $row['nama'];
}
 
?>
<html>
	<head>
		<title>Manipulasi Combobox dengan Ajax-JQuery</title>
		<style type="text/css">
		span.inputan { display:block; margin-bottom:5px; }
		span.inputan label { float:left; display:block; width:200px;}
		</style>
	</head>
	<body>
		<h1>Contoh Manipulasi Combobox dengan Ajax-JQuery</h1>
		<form action="" method="post">
		<span class="inputan">
		<label for="propinsi">Propinsi</label>
		: <select id="propinsi" name="propinsi">
			<option value="">-Pilih-</option>
			<?php
			foreach ($arrpropinsi as $kode=>$nama) {
				echo "<option value='$kode'>$nama</option>";
			}
			?>
		</select>
		</span>
		<span class="inputan">
		<label for="kabupaten">Kabupaten</label>
		: <select id="kabupaten" name="kabupaten">
		</select>
		</span>
		</form>
	</body>
</html>

Jika program 1 di atas dicoba maka tampilannya kurang lebih sebagai berikut.

Tampilan Combobox

Isi Combobox Kabupaten berdasarkan Propinsi yang Dipilih

Sesuai dengan tujuan utama dari tutorial ini, sekarang kita akan mengisi combobox kabupaten berdasarkan opsi combobox propinsi yang dipilih. Jadi data kabupaten/kota yang akan muncul di combobox kedua selalu sesuai dengan propinsi yang dipilih. Dan sesuai dengan judul tutorial ini, kita akan menggunakan konsep AJAX dengan library JQuery.

Perhatikan Contoh Program ke-2 berikut ini!

Code block

<?php
#koneksi
$conn = mysqli_connect("localhost", "root", "qwerty", "demo");
#akhir-koneksi
 
#ambil data propinsi
$query = "SELECT kode, nama FROM propinsi ORDER BY nama";
$sql = mysqli_query($conn, $query);
$arrpropinsi = array();
while ($row = mysqli_fetch_assoc($sql)) {
	$arrpropinsi [ $row['kode'] ] = $row['nama'];
}
 
#action get Kabupaten
if(isset($_GET['action']) && $_GET['action'] == "getKab") {
	$kode_prop = $_GET['kode_prop'];
 
	//ambil data kabupaten
	$query = "SELECT kode, nama FROM kabupaten WHERE kode_prop='$kode_prop' ORDER BY nama";
	$sql = mysqli_query($conn, $query);
	$arrkab = array();
	while ($row = mysqli_fetch_assoc($sql)) {
		array_push($arrkab, $row);
	}
	echo json_encode($arrkab);
	exit;
}
?>
<html>
	<head>
		<title>Manipulasi Combobox dengan Ajax-JQuery</title>
		<style type="text/css">
		span.inputan { display:block; margin-bottom:5px; }
		span.inputan label { float:left; display:block; width:200px;}
		</style>
		<script type="text/javascript" src="libs/jquery.min.js"></script>
		<script type="text/javascript">
			$(document).ready(function(){
				$('#propinsi').change(function(){
					$.getJSON('index.php',{action:'getKab', kode_prop:$(this).val()}, function(json){
						$('#kabupaten').html('');
						$.each(json, function(index, row) {
							$('#kabupaten').append('<option value='+row.kode+'>'+row.nama+'</option>');
						});
					});
				});
			});
		</script>
	</head>
	<body>
		<h1>Contoh Manipulasi Combobox dengan Ajax-JQuery</h1>
		<form action="" method="post">
		<span class="inputan">
		<label for="propinsi">Propinsi</label>
		: <select id="propinsi" name="propinsi">
			<option value="">-Pilih-</option>
			<?php
			foreach ($arrpropinsi as $kode=>$nama) {
				echo "<option value='$kode'>$nama</option>";
			}
			?>
		</select>
		</span>
		<span class="inputan">
		<label for="kabupaten">Kabupaten</label>
		: <select id="kabupaten" name="kabupaten">
		</select>
		</span>
		</form>
	</body>
</html>

Library JQuery harus disertakan terlebih dahulu sebelum kita dapat memanipulasi combobox dengan JQuery. Untuk menyertakan library JQuery, kita dapat mengunduhnya dari situs http://jquery.com lalu sertakan seperti pada baris ke-36. Selain itu, kita juga dapat menggunakan online CDN dengan mengarahkan atribut src pada baris ke-36 ke alamat http://code.jquery.com/jquery.min.js, tanpa harus mengunduhnya ke komputer kita.

Selanjutnya perhatikan baris 37-48. Untuk mengatur opsi pada combobox kabupaten berdasarkan nilai yang dipilih pada combobox propinsi, kita tentukan event-nya, yaitu change(). Dengan selector #propinsi kita panggil event change() seperti terlihat pada baris ke-39. Dengan demikian, ketika isi / nilai dari combobox propinsi berubah (change) maka fungsi akan dijalankan. Pada baris ke-40 kita menggunakan fungsi $.getJSON untuk memanggil file “index.php” dengan mengirimkan parameter “action” yang berisi “getKab” dan “kode_prop” yang diisi dengan kode propinsi terpilih ($(this).val()).

Setelah fungsi $.getJSON memanggil file index.php, program akan beralih ke baris 15-27 dimana pada baris tersebut “ditangkap” nilai parameter “kode_prop” dengan menggunakan predefined variabel $_GET. Dan selanjutnya dilakukan query ke database, data kabupaten sesuai dengan kode_prop tersebut. Data dimasukkan ke dalam variabel array $arrkab dan diubah ke dalam format JSON dengan fungsi json_encode() seperti terlihat pada baris ke-25.

Nilai dari JSON akan ditangkap kembali oleh JQuery pada baris ke 40-45. Nilai dari combobox kabupaten dikosongkan dengan perintah $(‘#kabupaten’).html(”). Fungsi $.each() pada baris ke-42 akan melakukan perulangan untuk setiap nilai dari variabel json ditambahkan opsi (dengan fungsi append) ke dalam object combobox $(‘#kabupaten’). Dengan demikian, isi combobox selalu berubah sesuai dengan data yang dipilih pada combobox propinsi.

Berikut ini screenshot hasil akhir dari program 2 di atas.

Tampilan Data di Combobox

Kesimpulan

Secara sederhana, tutorial ini memberikan gambaran bagaimana memanipulasi combobox dengan menggunakan konsep Ajax dan library JQuery, tentu dengan bahasa pemrograman PHP. Contoh di atas menggunakan kasus sederhana propinsi dan kabupaten, namun pada dasarnya dapat dikembangkan dan diterapkan untuk contoh kasus yang lainnya.

Download Tutorial dan Contoh Program

Download tutorial dan contoh program di link berikut ini.

Tutorial Manipulasi Combobox dengan Ajax-JQuery: Studi Kasus Data Propinsi & Kabupaten (261.9 KiB, 3,166 hits)

Contoh Program Manipulasi Combobox dengan Ajax-JQuery (39.6 KiB, 2,041 hits)

Semoga tutorial ini bermanfaat untuk kita semua dan berbagilah hal baik ke sebanyak-banyaknya orang maka kebahagiaan akan menghampiri Anda. Satu Karya untuk Indonesia!

Achmad Solichin
Twitter: @achmatim