Documentation
Selamat datang di dokumentasi Uji Lengkap. Halaman ini menjelaskan cara memasang, mengonfigurasi, dan memakai Uji Lengkap untuk membangun antarmuka modern langsung dari HTML. Gunakan daftar isi di samping untuk melompat ke bagian yang Anda butuhkan.
Installing
Cara termudah memakai Uji Lengkap adalah menyertakan satu file skrip melalui CDN. Tidak ada langkah build yang diperlukan dan tidak ada dependensi tambahan.
<script src="https://cdn.example.com/uji-lengkap.min.js"></script>Letakkan tag skrip di dalam <head> halaman Anda. Setelah dimuat, semua atribut hx-* pada elemen HTML akan otomatis diproses.
Ajax
Inti dari Uji Lengkap adalah kemampuan mengirim request Ajax langsung dari elemen HTML mana pun. Cukup tambahkan atribut hx-get atau hx-post untuk menentukan URL tujuan.
<button hx-get="/hello" hx-target="#output">
Klik Saya
</button>
<div id="output"></div>Ketika tombol diklik, Uji Lengkap mengirim request ke /hello dan menempatkan respons HTML ke dalam elemen target.
Attributes
Perilaku Uji Lengkap dikendalikan melalui atribut HTML. Atribut utama meliputi hx-get, hx-post, hx-target, dan hx-swap. Semua atribut bersifat deklaratif dan dapat dikombinasikan.
<div hx-get="/items" hx-trigger="load" hx-swap="innerHTML">
Memuat...
</div>Responses
Uji Lengkap mengharapkan respons berupa fragmen HTML. Fragmen ini akan disisipkan ke halaman sesuai strategi swap yang ditentukan. Respons non-HTML dapat diabaikan atau ditangani lewat header khusus.
<div hx-get="/fragment" hx-swap="outerHTML">
Konten lama
</div>Events
Uji Lengkap memancarkan event pada berbagai tahap siklus request, seperti hx:beforeRequest dan hx:afterRequest. Anda dapat mendengarkan event ini untuk menambahkan perilaku kustom.
document.body.addEventListener("hx:afterRequest", (event) => {
console.log("Request selesai", event.detail);
});Extensions
Fungsionalitas tambahan dapat ditambahkan melalui ekstensi. Ekstensi diaktifkan dengan atribut hx-ext dan menyediakan atribut-atribut baru sesuai kebutuhan.
<div hx-ext="contoh-ekstensi" hx-get="/data">
...
</div>History
Uji Lengkap mendukung integrasi dengan history browser melalui atribut hx-push-url. Dengan ini, URL dapat diperbarui tanpa memuat ulang halaman penuh.
<a hx-get="/halaman-baru" hx-push-url="true">
Buka Halaman
</a>Requests
Anda dapat mengatur method, header, dan parameter request melalui atribut seperti hx-headers dan hx-vals. Semua opsi bersifat opsional dan memiliki nilai default yang wajar.
<button hx-post="/simpan" hx-vals='{"id": 42}'>
Simpan
</button>Misc
Bagian ini mencakup topik tambahan seperti konfigurasi global, indikator loading, dan penanganan error. Untuk daftar atribut lengkap, lihat halaman referensi.
ujiLengkap.config({
defaultSwapStyle: "innerHTML",
indicatorClass: "loading",
});