BAB 26: Z Index CSS
Urutan tumpukan elemen: kapan z-index bekerja, kenapa angka besar bisa kalah, dan bagaimana konteks tumpukan mengurung anak-anaknya.
Anak dengan z-index: 999 di dalam induk ber-z-index: 1 tetap kalah oleh kotak lain yang z-index-nya 2. Saya menguji kasus itu dengan menaruh 2 induk yang bertumpuk, lalu membaca elemen mana yang berada di titik potong memakai document.elementFromPoint. Yang terbaca adalah induk ber-z-index 2, walaupun anak di induk lain punya angka 999.
Angka pada z-index tidak menentukan urutan global. Ia hanya berlaku di dalam konteks tumpukan tempat elemen itu berada, dan bab ini menunjukkan 5 aturan yang menentukan hasil akhirnya, semuanya dengan angka hasil pengukuran di Chromium 140.
z-index hanya bekerja pada elemen berposisi
Elemen dengan position: static mengabaikan z-index. Pada uji saya, kotak static dengan z-index: 9 kalah oleh kotak berposisi dengan z-index: 1, dan yang terbaca di titik potong adalah kotak berposisi itu.
/* diabaikan: position masih static */
.kotak-statis {
z-index: 9;
}
/* bekerja: position bukan static */
.kotak-berposisi {
position: relative;
z-index: 1;
}
Pengecualiannya adalah anak flex dan grid. Keduanya menerima z-index tanpa perlu position, karena z-index pada anak flex dan grid sudah dihitung sebagai bagian dari tata letak mereka.
Angka lebih besar menang, selama berada di konteks yang sama
Dalam satu konteks tumpukan, elemen dengan z-index lebih besar dicat di atas. Urutannya di HTML tidak lagi berpengaruh. Pada uji saya, kotak merah dengan z-index: 2 yang muncul lebih dulu di HTML tetap berada di atas kotak biru dengan z-index: 1.
.merah { position: absolute; z-index: 2; }
.biru { position: absolute; z-index: 1; }
Nilai sama, urutan HTML yang menentukan
Kalau z-index kedua elemen sama, elemen yang ditulis belakangan di HTML dicat terakhir, sehingga terlihat di atas. Pada uji dengan 2 kotak ber-z-index: 1, yang terbaca di titik potong adalah kotak kedua, bukan yang pertama.
.pertama { position: absolute; z-index: 1; }
.kedua { position: absolute; z-index: 1; } /* tampil di atas */
Aturan yang sama berlaku untuk z-index: auto, yang merupakan nilai bawaan. Karena itu elemen yang ditambahkan lewat JavaScript di akhir dokumen sering muncul di atas elemen lain tanpa satu baris z-index.
Konteks tumpukan mengurung anak-anaknya
Inilah bagian yang membuat z-index besar tidak berdaya. Elemen yang membentuk konteks tumpukan baru menjadi semacam kotak tertutup: semua anaknya diurutkan di dalam kotak itu, lalu kotak itu sendiri yang diurutkan terhadap tetangganya. Anak tidak bisa keluar dari urutan induknya, berapa pun nilai z-index-nya.
induk A (z-index 1) berisi anak (z-index 999)
induk B (z-index 2)
titik potong A dan B -> yang terbaca induk B
/* anak tidak bisa naik di atas induk B */
.induk-a { position: relative; z-index: 1; }
.induk-a .anak { position: absolute; z-index: 999; }
.induk-b { position: relative; z-index: 2; }
Karena itu menaikkan z-index anak dari 999 ke 9999 tidak mengubah apa pun. Yang perlu diubah adalah z-index induknya, atau menghapus sifat yang membuat induk menjadi konteks tumpukan.
Apa saja yang membentuk konteks tumpukan
Selain z-index, ada beberapa properti yang tanpa disadari menciptakan konteks tumpukan. Daftar berikut diambil dari dokumentasi MDN tentang stacking context.
| Pemicu | Catatan |
|---|---|
elemen akar html | semua elemen berada di dalamnya |
position selain static dengan z-index bukan auto | kasus yang paling umum |
position: fixed atau sticky | membentuk konteks tanpa perlu z-index |
anak flex atau grid dengan z-index bukan auto | bekerja tanpa position |
opacity kurang dari 1 | angka 0,99 sudah cukup |
transform, filter, perspective, clip-path, mask | nilainya bukan none |
isolation: isolate | cara eksplisit tanpa efek visual |
will-change yang menyebut properti pemicu | misalnya will-change: transform |
contain: layout atau contain: paint | memisahkan tata letak atau lukisan |
transform adalah pemicu yang paling sering tidak disadari. Animasi yang memakai transform untuk menggeser elemen akan membuat elemen itu menjadi konteks tumpukan, sehingga tooltip di dalamnya bisa tiba-tiba tertutup elemen lain yang z-index-nya lebih rendah dari 999 tetapi berada di konteks induk yang lebih tinggi.
z-index negatif dicat di belakang isi induk
Nilai z-index boleh negatif. Elemen dengan z-index: -1 dicat di belakang isi induknya, tetapi masih di atas latar induk. Pada uji saya, kotak hijau ber-z-index: -1 tertutup oleh kotak biru ber-z-index: 0 di titik potongnya, sehingga yang terbaca adalah kotak biru.
.latar {
position: absolute;
z-index: -1;
/* di belakang teks induk, tetapi di atas warna latar induk */
}
Pola ini dipakai untuk latar dekoratif yang tidak boleh menutupi teks, misalnya bentuk atau gradasi di belakang kartu. Syaratnya, induk harus membentuk konteks tumpukan. Kalau tidak, elemen negatif bisa jatuh ke belakang latar halaman dan tidak terlihat sama sekali.
Urutan lukisan di dalam satu konteks
CSS 2.2 menetapkan urutan lukisan di dalam satu konteks tumpukan. Urutan itu menjelaskan mengapa elemen inline bisa menutupi elemen block, dan mengapa z-index negatif berakhir di belakang isi induk.
- latar dan border elemen yang membentuk konteks
- anak dengan
z-indexnegatif - elemen block dalam alur normal
- elemen float
- elemen inline dalam alur normal
- anak dengan
z-index: 0atauautoyang berposisi - anak dengan
z-indexpositif, dari kecil ke besar
Urutan ini dipakai browser saat memutuskan hasil akhir, dan z-index hanya menggeser elemen di antara lapisan-lapisan tersebut.
z-index pada anak flex bekerja tanpa position
Anak flex dan grid adalah pengecualian dari aturan "harus berposisi". Saya menguji 2 kotak di dalam wadah flex, keduanya position: static, dengan z-index: 2 dan z-index: 1, lalu memberi margin-left: -60px pada kotak kedua supaya bertumpuk. Di titik potong, yang terbaca adalah kotak ber-z-index: 2, yaitu kotak yang ditulis lebih dulu.
.baris {
display: flex;
}
.pertama {
z-index: 2; /* bekerja tanpa position */
}
.kedua {
z-index: 1;
margin-left: -60px;
}
Tanpa z-index, kotak kedua akan menutupi kotak pertama karena urutan HTML. Dengan z-index, urutannya berbalik. Kemampuan ini dipakai pada tata letak yang saling menumpuk sedikit, misalnya deretan kartu yang saling menindih di sisi kiri.
Mengurung tumpukan dengan isolation
isolation: isolate membentuk konteks tumpukan tanpa mengubah tampilan apa pun. Properti ini berguna ketika sebuah komponen harus punya urutan tumpukan sendiri yang tidak boleh bercampur dengan elemen di luarnya.
.komponen {
isolation: isolate;
/* anak-anak komponen tidak bisa keluar dari urutan di dalamnya */
}
Kegunaan praktisnya: komponen yang dipakai berulang, misalnya kartu dengan label dan tombol, bisa memakai angka z-index kecil di dalamnya tanpa takut bertabrakan dengan komponen lain di halaman. Setiap komponen punya ruang tumpukannya sendiri, dan angka 1 di dalamnya tidak bersaing dengan angka 1 di komponen sebelah.
Nilai ini juga menjelaskan kenapa opacity kurang dari 1 berbahaya untuk tata letak: elemen dengan opacity: 0.99 sudah menjadi konteks tumpukan, sehingga seluruh perhitungan z-index di dalamnya berubah, walaupun perbedaan tampilannya hampir tidak terlihat.
Kesalahan yang paling sering terjadi
3 pola yang saya temui saat memperbaiki tumpukan elemen:
- Menaikkan
z-indexberulang kali tanpa memeriksaposition. Kalaupositionmasihstatic, angka apa pun tidak berpengaruh. - Memberi
z-index: 9999pada anak, padahal induknya ber-z-index: 1dan bersaing dengan induk lain. Yang perlu dinaikkan adalah angka induknya. - Menambahkan
transformuntuk animasi pada elemen yang berisi tooltip, tanpa menyadari bahwatransformmembentuk konteks tumpukan baru.
Cara memeriksa tumpukan yang bermasalah
Langkah yang saya pakai ketika ada elemen yang tidak mau muncul di atas:
// 1. elemen apa yang sebenarnya berada di titik itu
document.elementFromPoint(400, 300)
// 2. apakah elemen ini membentuk konteks tumpukan
getComputedStyle(el).transform // "none" berarti tidak
getComputedStyle(el).opacity // "1" berarti tidak
getComputedStyle(el).zIndex // "auto" berarti tidak (dengan position static)
Kunci DevTools juga berguna: panel Elements menampilkan badge stacking context pada elemen yang membentuk konteks, dan panel Layers memperlihatkan urutan lapisan secara visual. Dengan 2 alat itu, penyebabnya biasanya ditemukan tanpa menebak.
Ringkasan
z-index hanya bekerja pada elemen berposisi dan pada anak flex atau grid. Angka lebih besar menang, dan bila angkanya sama, elemen yang ditulis belakangan di HTML dicat di atas.
Elemen yang membentuk konteks tumpukan mengurung semua anaknya, sehingga z-index besar pada anak tidak bisa mengalahkan elemen di konteks lain. Konteks tumpukan bisa muncul dari z-index pada elemen berposisi, opacity di bawah 1, transform, filter, isolation, dan beberapa properti lain.
Referensi
- MDN Web Docs. z-index CSS property.
- MDN Web Docs. Stacking context.
- W3C. Cascading Style Sheets Level 2 Revision 2, Visual formatting model, bagian z-index.