Outline
Daftar "Di halaman ini" berisi heading dari satu halaman panjang, dengan garis tinta yang mengikuti bagian yang sedang terlihat. Daftar di sebelah kanan halaman ini adalah salah satunya.
Penggunaan
Pakai saat
- Halaman panjang dengan empat bagian atau lebih yang sering dilompati: dokumentasi, panduan layanan, peraturan, laporan panjang.
- Layar lebar yang punya ruang untuk kolom ketiga di samping konten.
Pakai yang lain saat
- Berpindah antarhalaman aplikasi: pakai App shell.
- Daftar bagian yang masing-masing mengganti konten: pakai Sidebar.
- Bagian sejajar yang hanya tampil satu per satu: pakai Tabs.
- Halaman pendek dengan dua atau tiga bagian: pakai Sections. Cukup andalkan heading.
Letaknya. Kolom sticky di kanan konten pada layar lebar (sekitar 200 sampai 220 px), dimulai sejajar dengan judul halaman. Sembunyikan di bawah sekitar 1100 px; di ponsel heading halaman sudah cukup, atau taruh tautan yang sama di atas halaman.
Contoh
Pendahuluan
Izin usaha mikro mencakup pendaftaran, verifikasi dokumen, survei lokasi, dan penerbitan izin dalam empat belas hari kerja.
Persyaratan
KTP pemilik, surat keterangan domisili usaha, dan foto tempat usaha. Berkas yang kurang dikembalikan dalam 2 hari kerja.
Jam layanan
Selasa 13.00 sampai 15.00 di loket 2, lantai dasar, atau dengan janji temu.
Ketentuan
Satu permohonan untuk satu tempat usaha, kecuali panduan menyebutkan lain.
<nav class="toc" data-lds-toc aria-label="Di halaman ini"> <span class="toc__ink" aria-hidden="true"></span> <a href="#intro">Pendahuluan</a> <a href="#grading">Persyaratan</a> <a href="#office-hours">Jam layanan</a> </nav> <!-- later in the page --> <h2 id="intro">Pendahuluan</h2> …
<nav class="toc" aria-label="Di halaman ini" style="width: 200px;"> <a href="#ol2" aria-current="true">Penggunaan</a> <a href="#ol2">Contoh</a> <a href="#ol2">Aksesibilitas</a> </nav>
Anatomi
| Bagian | Fungsinya |
|---|---|
nav.toc[data-lds-toc] | Wajib. Daftar dengan aria-label="On this page" (dalam bahasa halaman, misalnya "Di halaman ini"); rel 1,5 px di sisi kirinya. |
.toc__ink | Garis tegas 1,5 px di rel yang bergeser ke tautan aktif; anak pertama, aria-hidden. |
a[href="#id"] | Wajib. Satu tautan per id heading bagian. aria-current="true" menandai bagian yang sedang terlihat. |
Status
| Status | Caranya |
|---|---|
aria-current="true" | Teks tegas dengan ketebalan 500; tinta berada di sampingnya. |
hover | Teks menggelap menjadi tegas selama --d-fast. |
Gerak dan mikrointeraksi
- Tinta: bergeser dan berubah ukuran ke tautan aktif dengan
--spring-smoothselama--d-smooth(560 ms), sehingga gulir cepat melewati beberapa bagian terbaca sebagai satu luncuran. - Hanya satu hal yang bergerak; tautan berganti warna, tidak bergeser atau membesar.
- Reduced motion: tinta bergerak dalam 120 ms linear. Pakai
scroll-behavior: smoothdi halaman hanya di bawahprefers-reduced-motion: no-preference.
Aksesibilitas
<nav aria-label="On this page">(dalam bahasa halaman) dengan tautan biasa ke id heading, sesuai urutan dokumen.aria-current="true"(bukanpage) menandai bagian yang terlihat, karena halamannya sendiri tidak berganti.- Beri heading
scroll-margin-topsetinggi header sticky agar lompatan tidak menutupi heading.
Lakukan dan hindari
Lakukan
- Tautkan hanya tingkat
<h2>, atau paling banyak<h2>dan<h3>. - Pakai teks heading yang persis sama sebagai teks tautan.
Hindari
- Memakai outline sebagai navigasi utama.
- Menampilkannya di ponsel sebagai kolom tetap; ia merebut lebar yang dibutuhkan teks.
Perilaku dan kode
HTML biasa. data-lds-toc pada .toc mengamati elemen yang dituju tautan a[href^="#"] (dicari berdasarkan id di dokumen) dengan IntersectionObserver yang margin bawahnya -60 % tinggi jendela, menandai bagian terlihat paling atas dengan aria-current="true", lalu menggeser dan mengatur ukuran .toc__ink. Bagian pertama ditandai saat inisialisasi.