BAB 27: Path File
Cara menulis path relatif dan absolut untuk menghubungkan file di proyek web.
Di bab sebelumnya kita menghubungkan file JavaScript ke halaman menggunakan <script src="portofolio.js">. Browser berhasil menemukannya, tapi pernah tidak terpikir oleh kamu, bagaimana tepatnya browser tahu di mana file itu berada? Kamu hanya menulis nama file tanpa alamat lengkap, dan browser langsung menemukannya.
Di sinilah konsep path file bekerja. Setiap kali kamu menuliskan src, href, atau atribut lain yang merujuk ke file eksternal, kamu sedang memberi browser sebuah petunjuk lokasi. Petunjuk ini bisa ditulis dalam dua cara yang sangat berbeda.
Struktur Folder Proyek
Sebelum membahas tipe path, mari kita punya gambaran konkret. Sepanjang bab ini kita akan menggunakan struktur folder berikut untuk portofolio.html yang sudah kita bangun:
proyek-portofolio/
├── portofolio.html
├── portofolio.js
├── tema.js
├── css/
│ └── style.css
├── gambar/
│ ├── foto-profil.jpg
│ └── logo.png
└── halaman/
└── tentang.html
Kamu bekerja dari portofolio.html sebagai titik referensi.
Path Absolut
Path absolut adalah alamat lengkap sebuah file, dimulai dari protokol (https://), lalu domain, lalu folder, lalu nama file. Tidak ada ambiguitas: browser bisa langsung menuju ke sana dari titik mana pun.
<!-- portofolio.html -->
<img src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/61/HTML5_logo.svg/240px-HTML5_logo_and_wordmark.svg.png" alt="Logo HTML5">
Path absolut umum digunakan untuk referensi ke sumber daya dari domain lain, gambar dari CDN, font dari Google Fonts, script dari layanan pihak ketiga. Untuk file yang ada di proyek kamu sendiri, hampir tidak pernah menggunakannya.
Path absolut yang menggunakan https:// akan berhenti bekerja jika pengguna membuka file HTML secara langsung dari komputer (protokol file://), karena path itu mencoba terhubung ke server di internet. File yang direferensikan dengan path absolut eksternal membutuhkan koneksi internet untuk dimuat.
Path Relatif
Path relatif menggambarkan lokasi file relatif terhadap posisi file HTML yang sedang aktif. Browser menghitungnya dari situ. Ada tiga variasi yang sering dipakai.
File di Folder yang Sama
Jika file yang dirujuk berada di folder yang sama dengan file HTML, cukup tulis nama filenya langsung:
<!-- portofolio.html -->
<script defer src="portofolio.js"></script>
<script defer src="tema.js"></script>
Kedua file JavaScript berada di proyek-portofolio/, folder yang sama dengan portofolio.html. Browser mencarinya di sana.
File di Subfolder
Jika file berada di dalam subfolder, tulis nama folder diikuti garis miring, lalu nama file:
<!-- portofolio.html -->
<link rel="stylesheet" href="css/style.css">
<img src="gambar/foto-profil.jpg" alt="Foto profil Abd. Asis">
<img src="gambar/logo.png" alt="Logo portofolio">
Browser membaca css/style.css sebagai: dari lokasi portofolio.html sekarang, masuk ke folder css, ambil file style.css.
Kamu juga bisa melanjutkan ke subfolder yang lebih dalam: gambar/proyek/thumbnail.jpg artinya masuk ke gambar, lalu masuk ke proyek, lalu ambil thumbnail.jpg.
File di Folder Lebih Atas
Tanda ../ artinya "naik satu level ke folder induk". Ini berguna ketika file HTML berada di dalam subfolder dan perlu mereferensikan file yang ada di luar foldernya.
Misalkan kita sedang bekerja dari halaman/tentang.html dan ingin mengakses file dari folder induk:
<!-- halaman/tentang.html -->
<link rel="stylesheet" href="../css/style.css">
<img src="../gambar/foto-profil.jpg" alt="Foto profil Abd. Asis">
<a href="../portofolio.html">Kembali ke beranda</a>
Baca ../gambar/foto-profil.jpg sebagai: naik dari folder halaman/ ke proyek-portofolio/, lalu masuk ke folder gambar/, lalu ambil foto-profil.jpg. Kamu bisa menumpuk ../ untuk naik lebih dari satu level: ../../ artinya naik dua level.
Perbandingan Cepat
Ini ringkasan pola yang akan sering kamu temui:
| Penulisan | Arti |
|---|---|
foto.jpg | File di folder yang sama |
gambar/foto.jpg | File di subfolder gambar |
../foto.jpg | File satu level di atas folder saat ini |
../../gambar/foto.jpg | File dua level di atas, lalu masuk subfolder |
/gambar/foto.jpg | File dari root domain (bukan root komputer) |
https://domain.com/foto.jpg | File di server lain, URL lengkap |
Satu yang perlu perhatian khusus: path yang dimulai dengan / (satu garis miring) adalah path dari root domain. Ini bukan relatif terhadap file HTML saat ini, tapi relatif terhadap root server. Jadi /gambar/foto.jpg di https://portofolio.abdasis.dev artinya https://portofolio.abdasis.dev/gambar/foto.jpg, terlepas dari di mana file HTML yang mereferensikannya berada.
Diagram Navigasi Path
Untuk membantu membayangkan bagaimana ../ bekerja:
proyek-portofolio/ <- root proyek
├── portofolio.html <- dari sini: "css/style.css", "gambar/foto-profil.jpg"
├── css/
│ └── style.css
├── gambar/
│ └── foto-profil.jpg
└── halaman/
└── tentang.html <- dari sini: "../css/style.css", "../gambar/foto-profil.jpg"
(../ = naik ke proyek-portofolio/, lalu masuk subfolder)
Path di Atribut yang Berbeda
Konsep path yang sama berlaku di seluruh HTML, bukan hanya di src gambar. Atribut apa pun yang menunjuk ke file eksternal menggunakan aturan yang sama:
<!-- portofolio.html -->
<!-- stylesheet -->
<link rel="stylesheet" href="css/style.css">
<!-- gambar -->
<img src="gambar/foto-profil.jpg" alt="Foto profil">
<!-- script -->
<script defer src="tema.js"></script>
<!-- tautan ke halaman lain di proyek -->
<a href="halaman/tentang.html">Tentang saya</a>
<!-- favicon -->
<link rel="icon" href="gambar/logo.png" type="image/png">
Semua mengikuti pola yang sama: relatif terhadap posisi portofolio.html.
Elemen Base: Mengubah Titik Referensi
Ada satu elemen HTML yang jarang dibahas tapi berguna dalam situasi tertentu: <base>. Elemen ini didefinisikan di dalam <head> dan mengubah titik referensi untuk semua path relatif di dokumen tersebut.
<!-- portofolio.html -->
<head>
<meta charset="UTF-8">
<title>Portofolio Abd. Asis</title>
<base href="/beranda/">
</head>
<body>
<!-- tanpa <base>, ini merujuk ke "gambar/foto-profil.jpg" dari posisi portofolio.html -->
<!-- dengan <base href="/beranda/">, ini merujuk ke "/beranda/gambar/foto-profil.jpg" -->
<img src="gambar/foto-profil.jpg" alt="Foto profil">
</body>
<base> jarang dibutuhkan di proyek biasa dan bisa menjadi sumber kebingungan jika tidak digunakan dengan hati-hati. Satu batasan penting: hanya boleh ada satu <base> per halaman, dan ia harus muncul sebelum elemen lain yang menggunakan URL.
Menggunakan <base> memengaruhi semua path relatif di halaman, termasuk anchor internal (href="#section"). Anchor yang biasanya mengarah ke elemen di halaman yang sama akan berubah perilakunya, ia akan mencoba mengakses URL berdasarkan base yang sudah ditetapkan. Ini sering menjadi sumber bug yang tidak mudah dilacak.
Best Practice
Gunakan path relatif untuk semua file di dalam proyek kamu. Ada dua alasan praktis untuk ini.
Pertama, path relatif berfungsi di mana saja, di komputer lokal saat pengembangan, di server staging, maupun di domain produksi. Tidak ada yang perlu diubah saat deployment.
Kedua, jika proyek kamu dipindahkan ke domain yang berbeda, path relatif tetap valid. Sementara path absolut yang menyertakan nama domain harus diperbarui seluruhnya.
Gunakan path absolut hanya untuk dua kasus: mereferensikan sumber daya dari domain lain, atau ketika kamu secara sengaja ingin mengunci referensi ke URL tertentu.
Latihan
Buka struktur folder proyek-portofolio/ yang sudah kamu buat:
-
Dari
portofolio.html, tambahkan tautan kehalaman/tentang.html. Kemudian bukahalaman/tentang.htmldan tambahkan tautan kembali keportofolio.htmlmenggunakan path relatif yang benar. Verifikasi dengan membuka keduanya di browser dan mengklik tautannya. -
Di
portofolio.html, referensikancss/style.cssmenggunakan<link rel="stylesheet">. Buat filestyle.cssdengan satu aturan sederhana, misalnya mengubah font halaman. Pastikan gaya berhasil diterapkan. -
Bayangkan kamu punya subfolder baru
halaman/proyek/detail.html. Dari file itu, bagaimana cara menuliskan path untuk mengaksesgambar/foto-profil.jpg? Coba buat filenya dan verifikasi jawabannya di browser.
Selain src dan href yang sudah kita bahas, elemen <head> menyimpan lebih banyak informasi penting tentang halaman, metadata, instruksi untuk browser, hingga petunjuk untuk mesin pencari. Semua itu yang akan kita bedah di bab berikutnya.