BAB 55: Drag and Drop API
Membuat elemen yang bisa diseret dan dijatuhkan menggunakan Drag and Drop API.
Geolocation API di bab sebelumnya memungkinkan halaman mengetahui posisi pengguna di dunia nyata. Kali ini kita beralih ke interaksi yang lebih visual, memungkinkan pengguna menyeret elemen di halaman dan menjatuhkannya di tempat lain. Ini adalah pola interaksi yang sudah familiar: menyeret file ke folder, memindahkan kartu di papan Trello, atau mengatur urutan item di daftar.
Drag and Drop API adalah Web API bawaan browser yang membuat interaksi seret-dan-jatuh bisa diterapkan tanpa library tambahan. API ini bekerja melalui atribut HTML draggable dan serangkaian event JavaScript.
Konsep Dasar
Drag and drop melibatkan dua pihak:
- Elemen yang diseret (drag source), elemen yang pengguna klik dan gerakkan
- Area penjatuhan (drop target), elemen tempat drag source dijatuhkan
Proses seret-jatuh mengikuti alur event berikut:
[dragstart] --> [drag] --> [dragenter] --> [dragover] --> [drop] --> [dragend]
mulai terus masuk ke di atas dijatuh- selesai
menyeret bergerak area drop area drop kan
Tidak semua event ini harus ditangani. Untuk kasus dasar, kamu hanya perlu: dragstart pada sumber, dan dragover + drop pada target.
Elemen Draggable
Membuat elemen bisa diseret sangat sederhana, cukup tambahkan atribut draggable="true":
<!-- drag-dasar.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Drag Dasar</title>
<style>
.kotak {
width: 100px;
height: 100px;
background-color: #3b82f6;
color: white;
display: flex;
align-items: center;
justify-content: center;
cursor: grab;
border-radius: 8px;
font-family: sans-serif;
}
.area-drop {
width: 300px;
height: 200px;
border: 2px dashed #94a3b8;
border-radius: 8px;
margin-top: 20px;
display: flex;
align-items: center;
justify-content: center;
font-family: sans-serif;
color: #94a3b8;
}
.area-drop.aktif {
border-color: #3b82f6;
background-color: #eff6ff;
}
</style>
</head>
<body>
<h1>Drag and Drop Dasar</h1>
<div class="kotak" draggable="true" id="kotak-biru">Seret saya</div>
<div class="area-drop" id="area-tujuan">Jatuhkan di sini</div>
<script>
var kotak = document.getElementById("kotak-biru");
var areaTujuan = document.getElementById("area-tujuan");
kotak.addEventListener("dragstart", function(e) {
e.dataTransfer.setData("text/plain", e.target.id);
});
areaTujuan.addEventListener("dragover", function(e) {
e.preventDefault();
areaTujuan.classList.add("aktif");
});
areaTujuan.addEventListener("dragleave", function() {
areaTujuan.classList.remove("aktif");
});
areaTujuan.addEventListener("drop", function(e) {
e.preventDefault();
areaTujuan.classList.remove("aktif");
var idElemen = e.dataTransfer.getData("text/plain");
var elemen = document.getElementById(idElemen);
areaTujuan.textContent = "";
areaTujuan.appendChild(elemen);
});
</script>
</body>
</html>
Ada beberapa hal penting di sini:
e.dataTransfer.setData()didragstartmenyimpan data yang akan dibawa selama proses drag. Di sini kita menyimpan ID elemen agar bisa diambil kembali saat drop.e.preventDefault()didragoveritu wajib. Secara default, browser tidak mengizinkan elemen dijatuhkan di sembarang tempat.preventDefault()memberi tahu browser bahwa area ini menerima drop.e.dataTransfer.getData()didropmengambil kembali data yang disimpan saat dragstart.
Lupa memanggil e.preventDefault() di event dragover adalah kesalahan paling umum saat implementasi drag and drop. Tanpanya, event drop tidak akan pernah terpicu, elemen terlihat bisa diseret, tapi tidak bisa dijatuhkan.
Memindahkan Antar Wadah
Contoh yang lebih praktis, memindahkan item antar dua daftar, seperti mengategorikan tugas:
<!-- pindah-item.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Pindah Item</title>
<style>
.kontainer {
display: flex;
gap: 20px;
font-family: sans-serif;
}
.kolom {
width: 200px;
min-height: 250px;
border: 2px solid #e2e8f0;
border-radius: 8px;
padding: 10px;
}
.kolom h3 {
margin-top: 0;
padding-bottom: 8px;
border-bottom: 1px solid #e2e8f0;
}
.item {
padding: 8px 12px;
margin: 6px 0;
background-color: #f1f5f9;
border-radius: 4px;
cursor: grab;
}
.item:active {
cursor: grabbing;
}
.kolom.sorot {
background-color: #f0fdf4;
border-color: #22c55e;
}
</style>
</head>
<body>
<h1>Kategori Tugas</h1>
<div class="kontainer">
<div class="kolom" id="belum">
<h3>Belum Dikerjakan</h3>
<div class="item" draggable="true" id="tugas-1">Buat halaman kontak</div>
<div class="item" draggable="true" id="tugas-2">Perbaiki navigasi</div>
<div class="item" draggable="true" id="tugas-3">Tambah gambar profil</div>
</div>
<div class="kolom" id="selesai">
<h3>Selesai</h3>
</div>
</div>
<script>
var semuaItem = document.querySelectorAll(".item");
var semuaKolom = document.querySelectorAll(".kolom");
for (var i = 0; i < semuaItem.length; i++) {
semuaItem[i].addEventListener("dragstart", function(e) {
e.dataTransfer.setData("text/plain", e.target.id);
});
}
for (var j = 0; j < semuaKolom.length; j++) {
semuaKolom[j].addEventListener("dragover", function(e) {
e.preventDefault();
this.classList.add("sorot");
});
semuaKolom[j].addEventListener("dragleave", function() {
this.classList.remove("sorot");
});
semuaKolom[j].addEventListener("drop", function(e) {
e.preventDefault();
this.classList.remove("sorot");
var idItem = e.dataTransfer.getData("text/plain");
var item = document.getElementById(idItem);
this.appendChild(item);
});
}
</script>
</body>
</html>
Sekarang setiap item bisa diseret dari kolom "Belum Dikerjakan" ke "Selesai", dan juga sebaliknya. Kode ini menggunakan querySelectorAll dan loop for untuk mendaftarkan event listener ke semua item dan kolom sekaligus, pola yang efisien untuk banyak elemen.
Objek DataTransfer
Objek dataTransfer yang tersedia di event drag-drop bukan hanya untuk menyimpan ID. Ia bisa membawa berbagai jenis data dan bahkan mengontrol tampilan visual saat proses drag berlangsung.
Menyimpan Beberapa Tipe Data
<!-- data-transfer.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>DataTransfer</title>
<style>
.sumber {
padding: 15px;
background-color: #fef3c7;
border: 1px solid #f59e0b;
border-radius: 8px;
cursor: grab;
font-family: sans-serif;
display: inline-block;
margin-bottom: 15px;
}
.target {
width: 400px;
min-height: 120px;
border: 2px dashed #94a3b8;
border-radius: 8px;
padding: 15px;
font-family: sans-serif;
}
</style>
</head>
<body>
<h1>DataTransfer Multi-Tipe</h1>
<div class="sumber" draggable="true" id="kartu-profil"
data-nama="Budi Santoso" data-peran="Web Developer">
Kartu Profil Budi
</div>
<div class="target" id="area-info">Jatuhkan kartu di sini untuk melihat data</div>
<script>
var kartu = document.getElementById("kartu-profil");
var areaInfo = document.getElementById("area-info");
kartu.addEventListener("dragstart", function(e) {
e.dataTransfer.setData("text/plain", this.dataset.nama);
e.dataTransfer.setData("application/json",
JSON.stringify({
nama: this.dataset.nama,
peran: this.dataset.peran
})
);
e.dataTransfer.effectAllowed = "copy";
});
areaInfo.addEventListener("dragover", function(e) {
e.preventDefault();
e.dataTransfer.dropEffect = "copy";
});
areaInfo.addEventListener("drop", function(e) {
e.preventDefault();
var dataJson = e.dataTransfer.getData("application/json");
var data = JSON.parse(dataJson);
areaInfo.innerHTML =
"<strong>" + data.nama + "</strong><br>" +
"Peran: " + data.peran;
});
</script>
</body>
</html>
dataTransfer.setData() bisa dipanggil beberapa kali dengan tipe MIME yang berbeda. Di contoh ini, data disimpan dalam dua format: text/plain (untuk kompatibilitas jika dijatuhkan ke luar browser) dan application/json (untuk data terstruktur di dalam halaman).
Properti effectAllowed dan dropEffect mengontrol kursor dan perilaku visual:
| Nilai | Arti |
|---|---|
copy | Data akan disalin ke target |
move | Data akan dipindahkan ke target |
link | Membuat tautan ke data sumber |
none | Drop tidak diizinkan |
Drag and Drop Gambar
Contoh yang relevan untuk portofolio, menyeret gambar ke area yang ditentukan:
<!-- drag-gambar.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Drag Gambar</title>
<style>
.galeri {
display: flex;
gap: 10px;
margin-bottom: 20px;
}
.galeri img {
width: 100px;
height: 100px;
object-fit: cover;
border-radius: 8px;
cursor: grab;
border: 2px solid transparent;
}
.galeri img:hover {
border-color: #3b82f6;
}
.bingkai {
width: 300px;
height: 200px;
border: 3px dashed #cbd5e1;
border-radius: 12px;
display: flex;
align-items: center;
justify-content: center;
font-family: sans-serif;
color: #94a3b8;
overflow: hidden;
}
.bingkai img {
width: 100%;
height: 100%;
object-fit: cover;
}
.bingkai.sorot {
border-color: #3b82f6;
background-color: #eff6ff;
}
</style>
</head>
<body>
<h1>Pilih Foto Profil</h1>
<p>Seret salah satu gambar ke bingkai di bawah:</p>
<div class="galeri">
<img src="https://picsum.photos/id/1/200" draggable="true" id="foto-1" alt="Foto 1">
<img src="https://picsum.photos/id/10/200" draggable="true" id="foto-2" alt="Foto 2">
<img src="https://picsum.photos/id/20/200" draggable="true" id="foto-3" alt="Foto 3">
</div>
<div class="bingkai" id="bingkai-profil">Jatuhkan foto di sini</div>
<script>
var semuaFoto = document.querySelectorAll(".galeri img");
var bingkai = document.getElementById("bingkai-profil");
for (var i = 0; i < semuaFoto.length; i++) {
semuaFoto[i].addEventListener("dragstart", function(e) {
e.dataTransfer.setData("text/plain", e.target.src);
});
}
bingkai.addEventListener("dragover", function(e) {
e.preventDefault();
bingkai.classList.add("sorot");
});
bingkai.addEventListener("dragleave", function() {
bingkai.classList.remove("sorot");
});
bingkai.addEventListener("drop", function(e) {
e.preventDefault();
bingkai.classList.remove("sorot");
var srcGambar = e.dataTransfer.getData("text/plain");
bingkai.innerHTML = "<img src='" + srcGambar + "' alt='Foto profil terpilih'>";
});
</script>
</body>
</html>
Di sini, dataTransfer membawa URL gambar (dari atribut src). Saat dijatuhkan, URL itu digunakan untuk membuat elemen <img> baru di dalam bingkai.
Mengurutkan Daftar dengan Drag
Salah satu penggunaan drag-and-drop yang paling praktis adalah mengurutkan ulang item dalam daftar:
<!-- urutkan.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Urutkan Daftar</title>
<style>
.daftar {
list-style: none;
padding: 0;
width: 300px;
font-family: sans-serif;
}
.daftar li {
padding: 10px 14px;
margin: 4px 0;
background-color: #f8fafc;
border: 1px solid #e2e8f0;
border-radius: 6px;
cursor: grab;
}
.daftar li:active {
cursor: grabbing;
}
.daftar li.sedang-diseret {
opacity: 0.4;
}
.daftar li.posisi-drop {
border-top: 2px solid #3b82f6;
}
</style>
</head>
<body>
<h1>Urutkan Keahlian</h1>
<p>Seret untuk mengurutkan dari yang paling dikuasai:</p>
<ul class="daftar" id="daftar-keahlian">
<li draggable="true">HTML</li>
<li draggable="true">CSS</li>
<li draggable="true">JavaScript</li>
<li draggable="true">React</li>
<li draggable="true">Node.js</li>
</ul>
<script>
var daftar = document.getElementById("daftar-keahlian");
var itemYangDiseret = null;
daftar.addEventListener("dragstart", function(e) {
itemYangDiseret = e.target;
e.target.classList.add("sedang-diseret");
});
daftar.addEventListener("dragend", function(e) {
e.target.classList.remove("sedang-diseret");
var semuaItem = daftar.querySelectorAll("li");
for (var i = 0; i < semuaItem.length; i++) {
semuaItem[i].classList.remove("posisi-drop");
}
});
daftar.addEventListener("dragover", function(e) {
e.preventDefault();
var target = e.target;
if (target.tagName === "LI" && target !== itemYangDiseret) {
var semuaItem = daftar.querySelectorAll("li");
for (var i = 0; i < semuaItem.length; i++) {
semuaItem[i].classList.remove("posisi-drop");
}
target.classList.add("posisi-drop");
}
});
daftar.addEventListener("drop", function(e) {
e.preventDefault();
var target = e.target;
if (target.tagName === "LI" && target !== itemYangDiseret) {
daftar.insertBefore(itemYangDiseret, target);
}
});
</script>
</body>
</html>
Teknik kunci di sini adalah insertBefore(), method DOM yang memindahkan elemen ke posisi sebelum elemen lain. Karena itemYangDiseret sudah ada di DOM, insertBefore() otomatis memindahkannya (bukan menduplikasi).
Event listener didaftarkan di elemen <ul> (parent), bukan di setiap <li>. Ini memanfaatkan event delegation: event yang terjadi di elemen anak naik ke parent, dan kita mengecek e.target untuk menentukan elemen mana yang terlibat. Pendekatan ini lebih efisien daripada mendaftarkan listener di setiap item satu per satu.
Latihan
-
Modifikasi
pindah-item.htmldengan menambahkan kolom ketiga bernama "Sedang Dikerjakan" sehingga tugas bisa dipindahkan ke tiga status berbeda. -
Buat halaman dengan empat kotak berwarna berbeda (merah, biru, hijau, kuning) yang bisa diseret ke area "Warna Favorit". Area tersebut hanya bisa menampung satu kotak, jika kotak baru dijatuhkan, kotak sebelumnya kembali ke posisi awal.
-
Kembangkan
urutkan.htmlagar di bawah daftar ada teks yang otomatis menampilkan urutan terbaru setiap kali ada perubahan posisi (misalnya: "Urutan: 1. CSS, 2. HTML, 3. JavaScript...").
Drag and Drop API memberi pengguna cara berinteraksi secara fisik dengan elemen di layar. Tapi data yang dipindahkan lewat drag-and-drop itu hanya ada selama sesi drag berlangsung, begitu halaman di-refresh, semuanya hilang. Bagaimana kalau kita ingin data tetap tersimpan meskipun halaman ditutup? Di bab berikutnya, kita akan mempelajari Web Storage API yang memungkinkan halaman menyimpan data langsung di browser pengguna.