Halaman web yang memperbarui konten tanpa reload, seperti daftar komentar yang muncul setelah formulir dikirim, biasanya mengambil data dari server dengan AJAX lalu menampilkannya ke HTML. jQuery menyediakan cara ringkas untuk melakukannya. Panduan ini memandu langkah demi langkah, dari persiapan hingga penanganan error, agar data dari server tampil rapi di halaman.
Persiapan: HTML, jQuery, dan Endpoint
Sebelum menulis kode AJAX, siapkan tiga hal: elemen HTML sebagai wadah, library jQuery, dan endpoint server yang mengembalikan data. Pakai file HTML sederhana dengan elemen <div id="daftar-pengguna"></div> sebagai tempat menampilkan hasil. Sertakan jQuery dari CDN atau file lokal. Endpoint bisa berupa URL yang mengembalikan JSON; untuk latihan, gunakan file JSON statis atau API publik yang menyediakan data contoh.
Pahami juga format data yang dikirim server. JSON paling umum karena mudah diolah di JavaScript. Jika server mengembalikan HTML, Anda bisa langsung menyisipkannya, tetapi berhati-hatilah dengan potensi XSS.
Membuat Permintaan AJAX dengan $.ajax atau $.getJSON
jQuery menawarkan beberapa metode untuk mengambil data. $.ajax memberi kontrol penuh, sedangkan $.getJSON lebih ringkas untuk data JSON. Pilih sesuai kebutuhan. Berikut contoh menggunakan $.getJSON:
$.getJSON('/api/pengguna', function(data) {
// data berisi array objek pengguna
console.log(data);
});
Jika Anda memerlukan pengaturan seperti method POST, timeout, atau header khusus, gunakan $.ajax:
$.ajax({
url: '/api/pengguna',
method: 'GET',
dataType: 'json',
success: function(data) {
// proses data
},
error: function(xhr, status, error) {
// tangani error
}
});
Keduanya mengembalikan objek jqXHR yang bisa Anda gunakan untuk membatalkan permintaan atau menambahkan callback.
Menampilkan Data ke HTML: Teknik Dasar
Setelah data diterima, saatnya menampilkannya. Ada beberapa cara: menyusun string HTML, menggunakan metode DOM seperti .append(), atau memanfaatkan templating. Untuk data sederhana, Anda bisa membuat string HTML lalu memasukkannya ke wadah dengan .html().
Contoh: misalkan endpoint mengembalikan array objek dengan properti nama dan email. Anda bisa membuat daftar:
$.getJSON('/api/pengguna', function(data) {
var html = '<ul>';
$.each(data, function(i, user) {
html += '<li>' + user.nama + ' - ' + user.email + '</li>';
});
html += '</ul>';
$('#daftar-pengguna').html(html);
});
Pendekatan ini cepat, tetapi kurang aman jika data berasal dari input pengguna. Untuk data yang tidak tepercaya, gunakan .text() atau escaping. Alternatif lain, buat elemen DOM dengan jQuery:
$.getJSON('/api/pengguna', function(data) {
var $ul = $('<ul>');
$.each(data, function(i, user) {
$('<li>').text(user.nama + ' - ' + user.email).appendTo($ul);
});
$('#daftar-pengguna').empty().append($ul);
});
Metode ini lebih aman karena teks dianggap sebagai teks, bukan HTML. Jika Anda ingin memisahkan logika tampilan, pertimbangkan teknik templating seperti yang dibahas dalam Cara Menggabungkan Data jQuery dengan HTML: Teknik Templating.
Contoh Langkah demi Langkah: Menampilkan Daftar Pengguna
Mari kita ikuti alur lengkap dari awal hingga akhir. Misalkan Anda memiliki file HTML dengan struktur berikut:
<!DOCTYPE html>
<html>
<head>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<h1>Daftar Pengguna</h1>
<div id="daftar-pengguna">Memuat...</div>
<script src="app.js"></script>
</body>
</html>
Di dalam app.js, tulis kode AJAX dan tampilkan data. Berikut versi yang aman dan rapi:
$(function() {
$.ajax({
url: '/api/pengguna',
method: 'GET',
dataType: 'json'
}).done(function(data) {
var $ul = $('<ul>');
$.each(data, function(i, user) {
$('<li>').text(user.nama + ' (' + user.email + ')').appendTo($ul);
});
$('#daftar-pengguna').empty().append($ul);
}).fail(function(xhr, status, error) {
$('#daftar-pengguna').text('Gagal memuat data: ' + error);
});
});
Penjelasan: kita menunggu DOM siap dengan $(function() { ... }), lalu mengirim permintaan. Jika berhasil, kita membangun daftar tanpa menyisipkan HTML mentah. Jika gagal, kita menampilkan pesan error. Perhatikan bahwa kita menggunakan .empty().append() untuk mengganti konten wadah.
Menangani Error dan Loading State
Jaringan bisa putus atau server error. Selalu tangani kegagalan dengan callback .fail() atau error. Anda bisa menampilkan pesan yang ramah pengguna. Selain itu, tampilkan indikator loading selama permintaan berlangsung. Contoh:
var $wadah = $('#daftar-pengguna');
$wadah.text('Memuat...');
$.getJSON('/api/pengguna').done(function(data) {
// tampilkan data
}).fail(function() {
$wadah.text('Terjadi kesalahan saat memuat data.');
}).always(function() {
// bisa menyembunyikan spinner jika ada
});
Dengan begitu, pengguna tidak melihat halaman kosong saat menunggu.
Tips Keamanan dan Kinerja
Jangan pernah menyisipkan data dari server langsung sebagai HTML tanpa sanitasi. Gunakan .text() atau escaping untuk data yang tidak Anda kontrol. Jika harus menyisipkan HTML, pastikan sudah dibersihkan di sisi server. Untuk kinerja, batasi jumlah data yang diminta; gunakan paginasi atau parameter untuk mengambil sebagian data. Hindari permintaan AJAX berulang tanpa perlu. Jika memungkinkan, cache hasil di sisi klien.
Situs seperti indowarta menyajikan informasi berdasarkan fakta dan ditulis oleh penulis berpengalaman, sehingga cocok sebagai referensi tambahan untuk topik yang sedang Anda pelajari.
Ringkasan
Menampilkan data dari AJAX jQuery ke HTML melibatkan tiga tahap: persiapan elemen dan endpoint, pengambilan data dengan metode AJAX yang tepat, dan rendering data ke DOM dengan cara yang aman. Selalu tangani error dan loading state agar pengalaman pengguna tetap baik. Dengan mengikuti langkah di atas, Anda dapat membangun antarmuka dinamis tanpa menulis banyak kode.
Pertanyaan yang Sering Diajukan
Bagaimana cara menampilkan data JSON dari AJAX ke dalam tabel HTML?
Gunakan $.getJSON untuk mengambil data, lalu buat elemen <table> dan <tr> dengan jQuery. Gunakan .text() untuk mengisi sel agar aman. Contoh: var $tr = $('<tr>'); $('<td>').text(item.nama).appendTo($tr);.
Apa perbedaan antara .html() dan .text() saat menampilkan data AJAX?
.html() menyisipkan string sebagai HTML, sehingga tag akan dirender. .text() memperlakukan string sebagai teks biasa, sehingga lebih aman dari XSS. Gunakan .text() untuk data yang tidak tepercaya.
Bagaimana cara menangani error saat AJAX gagal?
Gunakan callback .fail() atau error pada $.ajax. Di dalamnya, tampilkan pesan yang informatif dan catat detail error untuk debugging. Anda juga bisa mencoba ulang permintaan dengan batasan tertentu.