CSS Tutorial

BAB 15: Outline CSS

Memakai outline tanpa menggeser tata letak: bedanya dengan border, outline-offset, sudut membulat, dan cincin fokus yang tetap terbaca.

Setiap kali sebuah tombol atau tautan menerima fokus keyboard, browser menggambar garis tipis di sekelilingnya. Garis itu dibuat oleh properti outline, bukan border, dan alasannya teknis: garis fokus tidak boleh mengubah ukuran atau posisi elemen apa pun. Kalau memakai border, setiap kali pengguna menekan Tab, tata letak halaman akan bergeser beberapa piksel.

Bab ini membahas outline dari sisi yang paling sering menimbulkan kesalahan: hubungannya dengan ruang, jarak garis lewat outline-offset, perilakunya pada sudut membulat, dan cara memakainya untuk cincin fokus yang tetap terlihat. Setelah bab ini selesai, kamu bisa mengganti garis fokus bawaan browser tanpa merusak aksesibilitas dan tanpa menggeser tata letak.

Outline adalah garis di luar kotak

Empat bab sebelumnya membahas kotak elemen dari dalam ke luar: padding, border, lalu margin. Outline berada di luar semua itu, dan tidak masuk hitungan tata letak sama sekali.

Perbedaan paling penting ada di 2 hal:

Halborderoutline
Menambah ukuran elemenyatidak
Menggeser elemen lainyatidak
Bisa diatur per sisiya, border-top dan seterusnyatidak, selalu 4 sisi
Mengikuti border-radiusyaya di browser modern
Muncul di model kotak DevToolsyatidak

Karena tidak menambah ukuran, outline bisa menimpa elemen di sebelahnya. Ini bukan cacat, melainkan konsekuensi yang memang dipilih: garis fokus harus muncul tanpa memindahkan apa pun, termasuk saat halaman sedang dihitung ulang oleh browser.

Perbedaan ruang itu bisa diukur. Dua kotak berukuran sama diberi garis merah 4px, satu memakai border, satu memakai outline.

Dua panel berisi kotak 220px yang sama dengan garis merah 4px: panel border menghasilkan lebar 228px dan kotak tetangga mulai di 113px, panel outline dengan offset 6px tetap selebar 220px dan kotak tetangga mulai di 105px

Hasil ukur di browser: border menambah lebar menjadi 228px dan mendorong tetangga 8px lebih jauh, outline tidak mengubah keduanya.

Anatomi properti outline

outline punya 3 sub-properti, sama seperti border, ditambah 1 properti terpisah untuk jarak:

CSSCSS
.tombol {
  outline-width: 3px;
  outline-style: solid;
  outline-color: #2563eb;
}

Bentuk singkatnya menulis ketiganya dalam satu baris:

CSSCSS
.tombol {
  outline: 3px solid #2563eb;
}

Urutan nilainya bebas, karena solid dikenali sebagai style, 3px sebagai width, dan #2563eb sebagai color. Yang tidak boleh ditukar adalah posisi outline-offset, karena properti itu berdiri sendiri dan tidak ikut diatur oleh shorthand:

CSSCSS
.tombol {
  outline: 3px solid #2563eb;
  outline-offset: 2px;
}

Nilai bawaan outline-style adalah none, jadi menulis outline-width: 4px tanpa style tidak menampilkan garis apa pun. Ini penyebab kasus "outline tidak muncul" yang paling sering: width sudah diatur, style lupa.

Sama seperti border, outline tidak punya outline-top atau outline-left. Kalau butuh garis di satu sisi saja, yang dipakai adalah border atau box-shadow, bukan outline.

Nilai outline-style

Ada 9 nilai yang dikenali browser, dan semuanya bisa dicoba langsung:

CSSCSS
.contoh-1 { outline: 3px solid #e03c3c; }
.contoh-2 { outline: 3px dashed #e03c3c; }
.contoh-3 { outline: 3px dotted #e03c3c; }
.contoh-4 { outline: 3px double #e03c3c; }
.contoh-5 { outline: 3px groove #e03c3c; }
.contoh-6 { outline: 3px ridge #e03c3c; }
.contoh-7 { outline: 3px inset #e03c3c; }
.contoh-8 { outline: 3px outset #e03c3c; }
NilaiTampilan
solidgaris utuh, satu warna
dashedpotongan garis lurus
dottedtitik-titik
double2 garis dengan celah di antaranya
groovegaris berkesan tenggelam
ridgegaris berkesan menonjol
insetseluruh kotak terlihat masuk ke dalam
outsetseluruh kotak terlihat keluar
nonetidak ada garis, ini nilai bawaan

Untuk keperluan antarmuka, yang dipakai hampir selalu solid. dashed berguna untuk area yang bisa menerima berkas yang dijatuhkan, karena garis putus-putus terbaca sebagai batas yang belum pasti. Nilai groove, ridge, inset, dan outset berasal dari era antarmuka 3 dimensi dan sekarang jarang dipakai karena hasilnya bergantung pada color dan lebar garis.

outline-offset mengatur jarak garis

outline-offset menerima nilai panjang dan menentukan jarak antara tepi luar border dengan garis outline. Nilainya boleh negatif.

CSSCSS
.dekat   { outline: 2px solid #e03c3c; outline-offset: 0; }
.renggang { outline: 2px solid #e03c3c; outline-offset: 6px; }
.masuk   { outline: 2px solid #e03c3c; outline-offset: -6px; }

Contoh pertama menempelkan garis ke tepi kotak. Contoh kedua menjauhkannya 6px, sehingga muncul celah selebar latar di antara kotak dan garis. Contoh ketiga menarik garis ke dalam, dan hasilnya garis terlihat di dalam kotak, di atas latar elemen itu sendiri.

Nilai negatif berguna saat elemen punya tetangga yang rapat, misalnya ikon di dalam toolbar. Garis fokus di dalam kotak tetap terlihat tanpa menimpa ikon sebelahnya.

Satu hal yang perlu diingat: outline-offset tidak menambah ruang. Garis dengan offset 6px dan lebar 4px menempati 10px di luar kotak, dan area itu bisa menutupi elemen lain atau terpotong kalau induknya memakai overflow: hidden.

CSSCSS
.panel {
  overflow: hidden;
}

.panel .tombol:focus-visible {
  outline: 3px solid #2563eb;
  outline-offset: 4px;
}

Pada contoh di atas, garis fokus bagian atas dan bawah akan terpotong, karena 7px di luar kotak berada di luar area yang digambar induk. Untuk kasus seperti ini, box-shadow lebih aman, atau outline-offset dikurangi sampai 0.

Outline pada sudut membulat

Sampai sekitar 2021, outline selalu digambar sebagai persegi panjang, sementara border-radius membuat kotak melengkung. Hasilnya terlihat seperti kesalahan: kotak membulat dengan garis fokus bersudut.

Browser modern sudah memperbaikinya, dan outline mengikuti border-radius yang dipakai elemen:

BrowserMulai mengikuti border-radius
Chrome dan Edgeversi 94, September 2021
Firefoxversi 88, April 2021
Safariversi 16.4, Maret 2023

Artinya pada browser yang lebih tua, perbedaan itu masih bisa muncul. Kalau tampilan garis fokus harus seragam, box-shadow dengan border-radius yang sama memberi hasil yang lebih konsisten, dengan konsekuensi tidak bisa diatur per sisi juga.

Kenapa browser memakai outline untuk fokus

Saat pengguna berpindah antar elemen dengan tombol Tab, browser menambahkan outline otomatis pada elemen yang sedang fokus. Perilaku ini diatur oleh stylesheet bawaan browser, kurang lebih seperti ini:

CSSCSS
:focus {
  outline: 1px auto -webkit-focus-ring-color;
}

Garis itu satu-satunya petunjuk posisi bagi pengguna keyboard. Menghapusnya tanpa pengganti membuat halaman tidak bisa dipakai tanpa mouse, dan itu melanggar Success Criterion 2.4.7 Focus Visible pada WCAG 2.1 level AA.

Masalahnya, outline bawaan ikut muncul saat elemen diklik dengan mouse, dan banyak pengembang menganggapnya mengganggu. Solusi yang sering dipakai, outline: none pada :focus, justru menghapus petunjuk yang sama untuk pengguna keyboard.

Cara yang benar adalah memisahkan fokus dari klik, memakai :focus-visible. Selektor ini hanya cocok saat browser menilai pengguna memang butuh petunjuk fokus, dan penilaian itu biasanya berarti navigasi keyboard.

CSSCSS
.tombol:focus {
  outline: none;
}

.tombol:focus-visible {
  outline: 3px solid #2563eb;
  outline-offset: 2px;
}

Perilaku praktisnya: klik mouse tidak memunculkan garis, tekan Tab memunculkannya. :focus-visible tersedia sejak Chrome 86, Firefox 85, dan Safari 15.4, jadi pemakaiannya sudah aman untuk halaman publik.

Kalau tetap ingin garis muncul untuk semua cara fokus, cukup hapus aturan :focus dan biarkan :focus-visible yang mengatur. Yang harus dihindari adalah outline: none tanpa pengganti apa pun.

Memilih antara border, outline, dan box-shadow

Ketiganya bisa membuat garis di sekeliling elemen, dan pilihannya ditentukan oleh 1 pertanyaan: apakah garis itu boleh mengubah tata letak.

KebutuhanPilihanAlasan
Garis bagian dari desain kotakborderikut ukuran elemen, ikut perhitungan box-sizing
Garis fokus atau penanda sementaraoutlinetidak menggeser apa pun, tidak perlu menghitung ulang lebar
Garis dengan blur, atau garis gandabox-shadowbisa blur, bisa banyak lapis, mengikuti border-radius
Garis di satu sisi sajaborder-top atau box-shadowoutline selalu 4 sisi

Contoh pemakaian yang sering muncul: kartu produk yang menyala saat kursor berada di atasnya. Kalau memakai border, seluruh isi kartu bergeser 2px setiap kali kursor masuk, dan grid di sebelahnya ikut bergerak. Dengan outline atau box-shadow, tidak ada yang bergeser.

CSSCSS
.kartu {
  transition: outline-color 150ms ease;
  outline: 2px solid transparent;
}

.kartu:hover {
  outline-color: #2563eb;
}

Garis transparan dipasang sejak awal supaya tidak ada elemen yang tiba-tiba muncul dan menghalangi klik. Hanya warnanya yang berubah, dan outline-color memang bisa dianimasikan. Yang tidak bisa dianimasikan adalah outline-style: perubahannya melompat dari satu nilai ke nilai lain.

Memeriksa outline di DevTools

Ada 1 tempat yang bisa dipakai untuk memastikan outline tidak ikut menghitung ruang: diagram box model di panel Computed.

  1. Klik kanan elemen, pilih Inspect.
  2. Buka tab Computed.
  3. Lihat diagram kotak di bagian atas. Angka yang muncul hanya content, padding, border, dan margin.
  4. Gulir daftar properti, cari outline dan outline-offset beserta nilai akhirnya.

Kalau elemen punya outline: 3px solid dan outline-offset: 6px, diagram itu tidak berubah sedikit pun. Sebaliknya, border: 3px akan menambah angka di lapisan border. Perbedaan tampilan inilah bukti paling cepat bahwa outline berada di luar perhitungan tata letak.

Nilai outline-style yang tercatat none juga langsung menjelaskan kenapa garis tidak muncul, tanpa perlu menebak.

Latihan

Latihan 1. Buat tombol dengan padding: 12px 20px, lalu beri garis fokus 3px berwarna biru dengan jarak 3px dari tepi tombol. Pastikan garis hanya muncul saat fokus keyboard, dan ukur lebar tombol sebelum serta sesudah fokus. Lebarnya harus sama.

Latihan 2. Buat 3 kartu berdampingan di dalam display: flex dengan gap: 16px. Beri garis 2px pada kartu yang disorot memakai outline, lalu ganti dengan border. Catat apa yang bergeser pada percobaan kedua, dan jelaskan penyebabnya dengan angka lebar kartu.

Ringkasan

Outline adalah garis di luar kotak yang tidak menambah ukuran elemen dan tidak menggeser apa pun, sehingga cocok untuk penanda sementara dan cincin fokus. Propertinya terdiri dari width, style, color, ditambah outline-offset yang mengatur jarak garis dan bisa bernilai negatif. Untuk fokus keyboard, pasangkan :focus-visible dengan outline yang jelas dan jangan hapus garis bawaan tanpa pengganti, karena garis itu satu-satunya petunjuk posisi bagi pengguna yang tidak memakai mouse.