CSS Tutorial

BAB 27: Overflow CSS

Cara overflow memotong atau menggulir isi yang lebih besar dari kotaknya, termasuk pengaruhnya pada sticky, scrollbar, dan teks ellipsis.

Kotak selebar 200 piksel yang berisi elemen selebar 400 piksel punya 2 pilihan: membiarkan isinya keluar, atau memotongnya. overflow menentukan pilihan itu, dan nilai yang dipilih mengubah lebih dari sekadar tampilan, karena beberapa nilai mengubah elemen menjadi wadah gulir.

Pada pengukuran di Chromium 140, kotak dengan width: 200px mencatat clientWidth 200 dan scrollWidth 402. Selisih itu adalah isi yang tidak muat. Bab ini membahas 5 nilai overflow, pengaruhnya pada scrollbar dan sticky, serta syarat agar teks ellipsis benar-benar muncul.

5 nilai overflow

NilaiMemotong isiBisa digulirWadah gulir
visibletidaktidaktidak
hiddenyaya, lewat scriptya
clipyatidaktidak
scrollyayaya, scrollbar selalu tampil
autoyayaya, scrollbar muncul saat perlu

visible adalah nilai bawaan. Isi yang lebih besar dibiarkan keluar dari kotak, dan elemen di sekitarnya tidak terpengaruh.

CSSCSS
.kotak {
  overflow: visible;  /* bawaan: isi keluar dari kotak */
}

visible membiarkan isi keluar

Pada uji saya, kotak 200 piksel berisi elemen 400 piksel, dan elemen itu terlihat sampai 419 piksel, jauh melewati tepi kanan kotak di 218 piksel. Tidak ada pemotongan, tidak ada scrollbar, dan tata letak di sekitarnya tidak berubah.

Masalahnya muncul saat isi yang keluar menutupi elemen lain atau memaksa halaman melebar. Di layar ponsel, satu elemen selebar 400 piksel di dalam wadah 200 piksel bisa membuat seluruh halaman bisa digeser ke samping, dan penyebabnya sering sulit ditemukan karena elemen sumbernya terlihat normal.

hidden memotong, tetapi tetap wadah gulir

hidden memotong isi pada batas padding kotak. Yang perlu diketahui: elemen dengan overflow: hidden tetap bisa digulir lewat script. Saya memasang scrollLeft = 120 pada kotak itu, dan nilainya bertahan di 120, bukan kembali ke 0.

CSSCSS
.kotak {
  overflow: hidden;
}
JavaScriptJS
// masih bekerja, walaupun tidak ada scrollbar
document.querySelector('.kotak').scrollLeft = 120

Sifat ini dipakai untuk animasi geser dan carousel yang digerakkan tombol: isinya dipotong secara visual, tetapi posisinya masih bisa diatur lewat JavaScript. Kalau pemotongan tanpa kemungkinan digulir yang diinginkan, nilai yang tepat adalah clip.

clip memotong dan tidak bisa digulir

overflow: clip memotong isi dan tidak menjadikan elemen sebagai wadah gulir. Pada uji yang sama, scrollLeft tetap 0 setelah dipaksa ke 120, dan clientWidth tetap 160 tanpa ruang scrollbar.

CSSCSS
.kotak {
  overflow: clip;
  /* memotong, tanpa wadah gulir, tanpa scrollbar */
}

Nilai ini lebih murah untuk browser karena tidak perlu menghitung area gulir, dan lebih tepat untuk dekorasi yang memang tidak boleh digeser. Bedanya dengan hidden: hidden tetap membuat area gulir yang bisa diprogram, clip tidak.

auto dan scroll menentukan kapan scrollbar muncul

scroll selalu menyediakan scrollbar, walaupun isinya muat. auto hanya menampilkan scrollbar ketika isi melebihi kotak. Untuk kolom yang isinya berubah-ubah, auto lebih baik karena tidak menyisakan jalur scrollbar kosong.

CSSCSS
.daftar {
  max-height: 320px;
  overflow: auto;
  /* scrollbar muncul hanya kalau isi lebih dari 320 piksel */
}

Satu catatan dari pengukuran: scrollbar di Chromium pada Linux memakai model overlay, sehingga clientWidth tidak berkurang saat scrollbar muncul. Pada Windows dengan scrollbar klasik, clientWidth bisa berkurang sekitar 15 piksel, dan tata letak yang bergantung pada lebar itu akan bergeser sedikit. Karena itu jangan menghitung lebar elemen dari clientWidth untuk menentukan tata letak.

Satu sumbu saja

overflow adalah singkatan dari overflow-x dan overflow-y. Kalau hanya 1 sumbu yang diberikan nilai selain visible, sumbu lainnya ikut berubah menjadi auto. Saya menguji overflow-x: hidden dengan overflow-y: visible, dan nilai terhitung untuk sumbu vertikal menjadi auto, dengan clientWidth turun dari 160 menjadi 145 karena ruang scrollbar.

CSSCSS
.geser-mendatar {
  overflow-x: auto;
  overflow-y: hidden;
}

Aturan ini menjelaskan kejutan yang sering terjadi: menulis overflow-x: hidden saja pada elemen yang isinya tinggi akan memunculkan scrollbar vertikal, walaupun overflow-y tidak pernah ditulis. Kalau ingin benar-benar memotong kedua arah, tulis overflow: hidden atau overflow: clip.

Syarat teks ellipsis

text-overflow: ellipsis tidak bekerja sendirian. Dokumentasi MDN menyebutkan bahwa properti ini hanya memengaruhi isi yang meluap pada arah inline, dan untuk membuat teks meluap perlu mengatur overflow serta white-space. Tanpa keduanya, teks hanya terpotong tanpa tanda titik-titik.

CSSCSS
.judul {
  width: 160px;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}

3 syarat yang harus lengkap:

  1. white-space: nowrap supaya teks tidak turun ke baris berikutnya.
  2. overflow: hidden atau clip supaya teks benar-benar dipotong pada batas kotak.
  3. Lebar kotak yang terbatas, karena tanpa batas tidak ada yang perlu dipotong.

Pada uji saya, elemen dengan width: 160px dan white-space: nowrap mencatat scrollWidth 290, sehingga ada 130 piksel teks yang tidak terlihat dan digantikan tanda ellipsis.

overflow hidden memutus sticky

Ini efek samping yang paling sering mengejutkan. Elemen sticky hanya bisa menempel pada wadah gulir terdekat, dan overflow: hidden membuat wadah itu. Kalau wadahnya tidak pernah digulir, elemen tidak pernah menempel.

Saya menguji 2 wadah bersaudara, masing-masing berisi elemen sticky dengan top: 10px. Wadah pertama overflow: visible, wadah kedua overflow: hidden.

Gulir halamanSticky di wadah visibleSticky di wadah hidden
017 piksel27 piksel
30010 piksel, menempel-273 piksel, ikut naik
600-215 piksel, keluar batas induk-573 piksel, ikut naik

Angka pada kolom kedua berhenti tepat di 10 piksel, yaitu nilai top yang ditulis. Angka pada kolom ketiga terus berkurang mengikuti halaman, tanda elemen tidak pernah menempel. Memperbaiki kasus ini berarti menghapus overflow: hidden dari leluhurnya, atau memindahkan elemen sticky keluar dari wadah itu.

overflow dan posisi elemen di dalamnya

Wadah gulir mengubah patokan bagi elemen di dalamnya. Elemen sticky menempel pada wadah gulir itu, bukan pada jendela. Elemen fixed tetap memakai jendela, tetapi elemen absolute dengan induk ber-overflow akan dipotong bila melewati batas wadah.

Karena itu lencana dengan posisi negatif, seperti top: -8px pada bab sebelumnya, bisa terpotong separuh kalau induknya ber-overflow: hidden. Gejalanya terlihat seperti posisi yang salah, padahal yang terjadi adalah pemotongan.

Mencari elemen yang meluap

Gejala paling umum dari overflow yang salah adalah halaman bisa digeser ke samping di ponsel. Menemukan elemen penyebabnya dengan mata sulit, karena elemen itu bisa berada jauh di dalam struktur. Satu potongan JavaScript berikut mencetak semua elemen yang lebih lebar dari kotaknya.

JavaScriptJS
// jalankan di console, hasilnya daftar elemen yang meluap mendatar
;[...document.querySelectorAll('*')]
  .filter((el) => el.scrollWidth > el.clientWidth + 1 && getComputedStyle(el).overflowX === 'visible')
  .forEach((el) => console.log(el.tagName, el.className, el.scrollWidth, el.clientWidth))

Elemen yang muncul di daftar itu adalah kandidat penyebab. Pemeriksaan overflowX === 'visible' penting supaya elemen yang memang memotong isinya tidak ikut dilaporkan, karena pemotongan itu disengaja.

hidden atau clip

Memilih antara keduanya bergantung pada 1 pertanyaan: apakah isi perlu bisa digeser lewat JavaScript.

CSSCSS
/* perlu digeser lewat tombol atau animasi */
.perlu-geser {
  overflow: hidden;
}

/* hanya perlu dipotong, tidak akan pernah digeser */
.hanya-potong {
  overflow: clip;
}

hidden lebih aman untuk komponen yang sudah terlanjur memakai pengukuran scrollWidth, karena area gulirnya tetap ada dan nilainya bisa dibaca. clip lebih tepat untuk dekorasi, dan lebih murah karena tidak perlu menghitung area gulir.

Ringkasan

overflow menentukan apakah isi yang lebih besar dipotong, digulir, atau dibiarkan keluar. hidden dan clip sama-sama memotong, tetapi hidden tetap menjadi wadah gulir yang bisa diprogram sedangkan clip tidak. auto menampilkan scrollbar hanya saat perlu, dan memberi nilai pada 1 sumbu membuat sumbu lainnya menjadi auto.

Teks ellipsis menuntut 3 hal sekaligus: white-space: nowrap, overflow selain visible, dan lebar yang terbatas. overflow: hidden pada leluhur memutus sticky, karena elemen itu menempel pada wadah gulir yang tidak pernah digulir.

Referensi

  1. MDN Web Docs. overflow CSS property.
  2. MDN Web Docs. text-overflow CSS property.
  3. W3C. CSS Overflow Module Level 3.