BAB 25: Iframe
Menyematkan halaman atau konten eksternal di dalam halaman menggunakan iframe.
Tombol yang kita buat di bab sebelumnya membuat halaman portofolio bisa berinteraksi (toggle konten kartu, scroll kembali ke atas. Tapi semua itu masih terbatas pada konten yang ada di dalam portofolio.html sendiri. Bagaimana kalau kita ingin menampilkan halaman atau dokumen lain) misalnya embed peta, player video, atau halaman preview, langsung di dalam halaman yang sama tanpa berpindah URL?
<iframe> adalah jawabannya. Secara harfiah, iframe adalah inline frame: sebuah kotak di dalam halaman yang menampilkan dokumen terpisah dengan browsing context-nya sendiri.
Sintaks Dasar
Menulis iframe sesederhana menyebutkan URL yang ingin ditampilkan:
<!-- portofolio.html -->
<iframe src="tentang-saya.html" title="Profil singkat penulis"></iframe>
Dua hal yang tidak boleh absen: src yang menunjuk ke konten yang ingin ditampilkan, dan title yang mendeskripsikan isi iframe. Atribut title bukan formalitas, pembaca layar (screen reader) menggunakannya untuk memberitahu pengguna tunanetra apa yang ada di dalam kotak tersebut.
Browser akan menampilkan tentang-saya.html di dalam kotak iframe dengan ukuran default 300x150 piksel. Ukuran ini hampir selalu perlu disesuaikan.
Ukuran dan Tampilan
Ada dua cara mengatur ukuran iframe:
<!-- portofolio.html -->
<!-- cara 1: atribut langsung -->
<iframe
src="tentang-saya.html"
width="600"
height="400"
title="Profil singkat penulis"
></iframe>
<!-- cara 2: CSS, lebih fleksibel -->
<iframe
src="tentang-saya.html"
style="width: 100%; height: 400px;"
title="Profil singkat penulis"
></iframe>
Nilai atribut width dan height selalu dalam piksel. Untuk ukuran yang responsif (misalnya mengikuti lebar container) gunakan CSS.
Secara default, iframe memiliki border tipis di sekelilingnya. Kalau desainmu tidak memerlukannya:
<!-- portofolio.html -->
<iframe
src="tentang-saya.html"
style="width: 100%; height: 400px; border: none;"
title="Profil singkat penulis"
></iframe>
Dan kalau justru ingin border yang lebih tegas:
<iframe
src="tentang-saya.html"
style="width: 100%; height: 400px; border: 2px solid #e2e8f0; border-radius: 8px;"
title="Profil singkat penulis"
></iframe>
Iframe sebagai Target Link
Ini salah satu fitur iframe yang jarang diketahui pemula: iframe bisa menjadi "layar" tempat link terbuka. Caranya dengan memberi name pada iframe, lalu menjadikan nama itu sebagai nilai target di elemen <a>.
Bayangkan di halaman portofolio ada menu navigasi proyek, dan setiap link membuka detail proyek di panel preview tanpa meninggalkan halaman:
<!-- portofolio.html -->
<nav>
<a href="proyek-smt.html" target="panel-preview">Sistem Manajemen Tugas</a>
<a href="proyek-katalog.html" target="panel-preview">Katalog Buku Digital</a>
<a href="proyek-jadwal.html" target="panel-preview">Penjadwal Otomatis</a>
</nav>
<iframe
name="panel-preview"
src="proyek-smt.html"
style="width: 100%; height: 500px; border: 1px solid #e2e8f0;"
title="Preview detail proyek"
></iframe>
Saat link "Katalog Buku Digital" diklik, proyek-katalog.html dimuat di dalam iframe, bukan di tab baru, bukan menggantikan seluruh halaman. Nilai target di elemen <a> harus persis sama dengan nilai name di iframe.
link target="panel-preview" ──► iframe name="panel-preview"
|
konten dimuat di sini
Atribut Loading
Satu atribut yang sering diabaikan tapi berdampak nyata pada performa: loading.
<!-- portofolio.html -->
<!-- lazy: iframe baru dimuat saat mendekati viewport -->
<iframe
src="peta-lokasi.html"
loading="lazy"
style="width: 100%; height: 300px; border: none;"
title="Peta lokasi kantor"
></iframe>
Nilai default adalah eager, iframe langsung dimuat bersama seluruh halaman, bahkan jika letaknya jauh di bawah layar. Dengan loading="lazy", browser menunggu sampai iframe mendekati area yang terlihat sebelum mulai mengunduh kontennya. Ini sangat berguna jika kamu menyematkan beberapa iframe sekaligus.
Keamanan: Atribut Sandbox
Ini bagian yang paling penting untuk dipahami ketika menyematkan konten dari sumber yang tidak sepenuhnya kamu kendalikan.
Atribut sandbox membatasi apa yang boleh dilakukan konten di dalam iframe. Tanpa sandbox, konten iframe bisa menjalankan JavaScript, membuka popup, mengirim form, dan bahkan mencoba navigasi ke halaman induk. Dengan sandbox kosong, semua itu diblokir:
<!-- portofolio.html, menyematkan widget dari pihak ketiga -->
<iframe
src="https://widget-cuaca.contoh.com/embed"
sandbox
style="width: 300px; height: 200px; border: none;"
title="Widget cuaca hari ini"
></iframe>
Tapi kadang konten yang disematkan memang perlu menjalankan JavaScript, misalnya form interaktif atau peta yang bisa di-zoom. Gunakan token yang lebih spesifik untuk membuka izin yang diperlukan saja:
<!-- portofolio.html -->
<!-- izinkan hanya script, blokir semua yang lain -->
<iframe
src="https://widget-interaktif.contoh.com"
sandbox="allow-scripts"
style="width: 100%; height: 400px; border: none;"
title="Demo interaktif proyek"
></iframe>
Token-token yang bisa dikombinasikan di sandbox:
| Token | Izin yang dibuka |
|---|---|
allow-scripts | Menjalankan JavaScript |
allow-forms | Mengirim form |
allow-popups | Membuka jendela baru |
allow-same-origin | Akses storage dan cookie sama-origin |
allow-top-navigation | Navigasi halaman induk |
allow-downloads | Mengunduh file |
Jangan pernah menggabungkan allow-scripts dan allow-same-origin sekaligus. Kombinasi ini memungkinkan konten iframe menghapus sandbox-nya sendiri via JavaScript dan mendapatkan akses penuh ke halaman induk.
Izin Tambahan dengan Allow
Untuk fitur browser yang lebih modern (fullscreen, akses kamera, atau geolocation) gunakan atribut allow:
<!-- portofolio.html, menyematkan player video -->
<iframe
src="https://player-video.contoh.com/embed/abc123"
allow="fullscreen"
style="width: 100%; height: 400px; border: none;"
title="Demo aplikasi manajemen tugas"
></iframe>
Beberapa izin yang umum digunakan: fullscreen untuk mode layar penuh, camera untuk akses kamera pengguna, microphone untuk akses mikrofon, dan geolocation untuk akses lokasi. Pisahkan beberapa izin dengan titik koma: allow="fullscreen; camera".
Konten Inline dengan Srcdoc
Selain menunjuk ke URL eksternal, iframe juga bisa memuat HTML yang ditulis langsung sebagai nilai atribut menggunakan srcdoc:
<!-- portofolio.html -->
<iframe
srcdoc="<h2>Preview Sederhana</h2><p>Ini konten langsung dari atribut srcdoc.</p>"
style="width: 100%; height: 150px; border: 1px solid #e2e8f0;"
title="Contoh preview konten"
></iframe>
srcdoc berguna untuk menampilkan konten kecil yang sudah kamu kendalikan sepenuhnya, misalnya preview cuplikan HTML dari suatu proses. Jika srcdoc dan src keduanya hadir, srcdoc yang menang.
Latihan
Buka portofolio.html:
-
Tambahkan section "Lokasi" di bagian bawah halaman. Di dalamnya, buat iframe yang menampilkan
peta.html(buat file dengan teks "Halaman peta" di dalamnya). Atur ukurannya 100% lebar dan 350px tinggi, tanpa border, denganloading="lazy". -
Buat navigasi berisi tiga link yang mengarah ke tiga halaman HTML berbeda. Tambahkan iframe di bawahnya dengan atribut
nameyang cocok, sehingga setiap link membuka halamannya di dalam iframe tersebut tanpa berpindah halaman. -
Coba buat dua iframe: satu dengan
sandboxkosong dan satu dengansandbox="allow-scripts". Isi keduanya dengansrcdocyang mengandung tag<script>kecil. Amati browser mana yang menjalankan script-nya dan mana yang tidak.
Setelah memahami iframe, kita akan masuk ke topik yang sering membingungkan developer baru: cara menyisipkan JavaScript ke HTML dengan elemen <script>, dan mengapa posisi penempatannya di dokumen bisa memengaruhi hasil eksekusi kode.