Contoh Laporan Perbaikan Aksesibilitas. Harbor & Pine adalah toko fiktif yang kami buat dengan cacat aksesibilitas yang umum, lalu diuji dengan mesin yang sama yang memindai website Anda.
Pindai website Anda gratisContoh Laporan Perbaikan Aksesibilitas
harborandpine.example
- Platform:
- Shopify
- Dibuat:
- 24 Sep 2026
- Halaman yang diuji:
- 9
- Mesin:
- axe-core 4.13.0
Ringkasan
- Kami menguji 9 halaman dari harborandpine.example (4 dari sitemap Anda) pada 24 Sep 2026 dengan axe-core 4.13.0 terhadap WCAG 2.2 A dan AA, ditambah uji belanja khusus keyboard.
- 8 jenis masalah gagal dalam uji WCAG otomatis (131 kemunculan). 8 ditandai Perbaiki dulu.
- Perjalanan terhambatPembeli yang hanya memakai keyboard terhambat di: Memilih opsi dan jumlah.
- 4 item perlu dicek manusia: pengujian otomatis menandainya tetapi tidak dapat memutuskan.
- Mulailah dengan: Fokus keyboard terjebak di banner cookie; Opsi produk tidak dapat dipilih dengan keyboard; Tombol harus memiliki teks yang dapat dikenali.
Pengujian otomatis hanya menemukan sebagian masalah aksesibilitas di sebuah situs, tidak semuanya. Laporan ini menjelaskan apa yang ditemukan pengujian kami dan cara memperbaikinya. Laporan ini bukan nasihat hukum dan tidak menyatakan kepatuhan terhadap ADA, European Accessibility Act, atau undang-undang mana pun.
Gambaran umum
- P1 · Perbaiki duluMenghalangi pengunjung di halaman penting
- 8
- P2 · Perbaiki berikutnyaHambatan serius atau sedang
- 0
- P3 · TingkatkanMasalah ringan dan praktik terbaik
- 2
Kemunculan menurut tingkat keparahan
- Kritis
- 73
- Serius
- 58
- Sedang
- 25
- Ringan
- 0
- Kegagalan terverifikasiJenis masalah yang gagal dalam uji otomatis
- 10
- Perlu ditinjauDitandai, tetapi perlu diputuskan oleh manusia
- 4
- Pemeriksaan yang lolosAturan otomatis tanpa kegagalan
- 32
- Tidak diujiLangkah perjalanan dan pemeriksaan manual
- 7
Kami menguji 9 halaman, 4 di antaranya diambil dari sitemap Anda. Tanggal target adalah saran berdasarkan tingkat keparahan; sepakati tanggal akhirnya dengan developer Anda.
Gambaran umum website
Dideteksi dari bukti publik di halaman yang diuji. Label bisa saja keliru; label hanya menentukan pemeriksaan tambahan mana yang dijalankan.
Jenis website
- Toko onlineKeyakinan tinggi
- Berjalan di Shopify, platform toko online
- Tautan ke keranjang
- Tautan produk atau toko
- Landing pageKeyakinan sedang
- Hanya 6 halaman internal yang ditautkan
Teknologi yang terdeteksi
- ShopifyKeyakinan tinggi
Aset atau skrip Shopify di halaman
Pemeriksaan untuk situs ini
- Pemeriksaan universal: aksesibilitas, SEO, kecepatan, keamanan, dan email
- Modul e-commerce: halaman koleksi, produk, dan keranjang, serta perjalanan belanja dengan keyboard sampai tombol checkout
- Catatan Shopify: langkah perbaikan di tema dan admin; header dan cookie yang dikelola platform ditampilkan sebagai referensi
Perjalanan belanja dengan keyboard
Kami mencoba berbelanja hanya dengan keyboard (Tab, Shift+Tab, Enter, Space, Escape), seperti yang dilakukan orang yang tidak bisa memakai mouse. Kami menambahkan satu barang ke keranjang dalam sesi sekali pakai dan berhenti di tombol checkout: kami tidak pernah masuk ke checkout atau mengetik data pribadi maupun data pembayaran. Tujuan: Berpindah dari halaman beranda ke tombol checkout hanya dengan keyboard.
01Menjangkau navigasi utama
LolosFokus mencapai “Shop” di navigasi setelah 21 kali menekan Tab.
Diharapkan: Menekan Tab dari bagian atas halaman beranda akan menjangkau tautan di navigasi utama.
- Catatan: Banner cookie menahan fokus keyboard sampai kami menekan Enter pada “Accept all”.
Cara mereproduksi
https://harborandpine.example/
- Buka halaman beranda.
- Klik bilah alamat browser, lalu tekan Tab berulang kali (Shift+Tab untuk kembali).
Urutan fokus yang kami amati
“Shop”
02Membuka produk dari halaman koleksi
LolosFokus mencapai “Trail Daypack 22L” setelah 9 kali menekan Tab, dan Enter membuka /products/trail-daypack.
Diharapkan: Tab menjangkau produk di grid koleksi, dan Enter membuka halamannya.
Cara mereproduksi
https://harborandpine.example/collections/all
- Buka /collections/all.
- Tekan Tab sampai sebuah produk di grid tersorot, lalu tekan Enter.
Urutan fokus yang kami amati
“Harbor & Pine” → “Shop” → “New arrivals” → “Our story” → body > header.site > div.icons > button → “Account” → body > header.site > div.icons > a → “FeaturedPrice, low to highPrice, high to low” → “Trail Daypack 22L”
03Memilih opsi dan jumlah
Gagal3 opsi produk tidak dapat menerima fokus keyboard: “S”, “M”, “L”. Opsi tersebut merespons mouse, tetapi pengguna keyboard tidak dapat memilihnya.
Diharapkan: Setiap opsi produk (ukuran, warna, varian) dan kolom jumlah dapat dijangkau dengan Tab.
2.1.1 Keyboard · Keyakinan: tinggi

Memilih opsi dan jumlah: elemen yang gagal, diberi garis penanda Cara mereproduksi
https://harborandpine.example/products/trail-daypack
- Buka /products/trail-daypack.
- Tekan Tab dari bagian atas halaman dan catat kontrol mana saja yang menerima fokus sebelum Tambah ke keranjang.
Urutan fokus yang kami amati
“Harbor & Pine” → “Shop” → “New arrivals” → “Our story” → … 5 lainnya … → body > header.site > div.icons > a → div.page.product > div.gallery > div.thumbs > button → div.page.product > div.gallery > div.thumbs > button → div.page.product > div.gallery > div.thumbs > button → div.page.product > div > div.swatches > button → div.page.product > div > div.swatches > button → div.page.product > div > div.swatches > button → “1” → “Add to cart”
Elemen <div class="size-option" data-fr="opt-1">S</div>04Menambahkan ke keranjang dengan keyboard
Perlu ditinjauEnter pada Tambah ke keranjang berhasil (jumlah item keranjang di header berubah, pesan “ditambahkan ke keranjang” muncul), tetapi kami tidak menemukan pesan status atau dialog yang menerima fokus, sehingga pengguna pembaca layar mungkin tidak mendengar bahwa barang telah ditambahkan.
Diharapkan: Enter pada Tambah ke keranjang menambahkan barang, dan konfirmasinya diumumkan: pesan status, dialog yang menerima fokus, atau halaman keranjang.
4.1.3 Status Messages · Keyakinan: sedang

Menambahkan ke keranjang dengan keyboard: halaman pada langkah ini Cara mereproduksi
https://harborandpine.example/products/trail-daypack
- Buka /products/trail-daypack.
- Tekan Tab sampai Tambah ke keranjang terfokus, lalu tekan Enter.
- Dengarkan konfirmasi dengan pembaca layar (VoiceOver: Cmd+F5).
05Mengubah keranjang dan mencapai checkout
LolosSemua 4 kontrol keranjang dan tombol checkout (“Check out”) tercapai dalam 12 kali menekan Tab. Kami tidak menekannya.
Diharapkan: Kolom jumlah, tombol hapus, dan tombol checkout semuanya dapat dijangkau dengan Tab.
Cara mereproduksi
https://harborandpine.example/cart
- Tambahkan produk apa saja ke keranjang dan buka halaman keranjang.
- Tekan Tab dan pastikan kolom jumlah, tombol hapus, dan tombol checkout semuanya menerima fokus.
Urutan fokus yang kami amati
“Harbor & Pine” → “Shop” → “New arrivals” → “Our story” → body > header.site > div.icons > button → “Account” → body > header.site > div.icons > a → “1” → tbody > tr > td > button.remove → “2” → tbody > tr > td > button.remove → “Check out”
06Checkout
Tidak diujiKami berhenti di tombol checkout: kami tidak pernah masuk ke checkout, membuat pesanan, atau mengetik detail pembayaran. Di Shopify, halaman checkout dijalankan oleh Shopify, bukan oleh tema Anda. Periksa checkout secara manual (lihat Pemeriksaan manual).
Peta klaim surat
Setiap klaim dalam surat, dicocokkan dengan bukti pemindaian. Ini perbandingan faktual, bukan nasihat hukum.
- Tereproduksi
“Images lack alternative text, so product photos are not described.”
Gambar tanpa alternatif teks. 10 kemunculan di 3 dari 5 halaman yang diuji.
image-alt
- Tereproduksi
“Text has insufficient color contrast against its background, including sale badges and prices.”
Kontras warna rendah. 16 kemunculan di 5 dari 5 halaman yang diuji.
color-contrast
- Tereproduksi
“The website cannot be navigated using a keyboard alone.”
Akses keyboard dan fokus. Fokus keyboard terjebak di banner cookie.
- Tereproduksi
“Form fields do not have labels, including the newsletter sign-up and the quantity fields in the cart.”
Kolom formulir tanpa label. 4 kemunculan di 3 dari 5 halaman yang diuji.
select-name, label
- Cek manual
“Product videos do not have captions.”
Teks keterangan video dan audio. Pemindaian otomatis tidak dapat menilai teks keterangan (caption). Periksa setiap video produk atau merek untuk memastikan caption yang akurat dan transkrip.
- Cek manual
“Our client is legally blind and uses screen reader software.”
Masalah lainnya. Ini adalah pernyataan umum. Uji alur penting (pencarian, halaman produk, tambah ke keranjang, checkout) dengan pembaca layar seperti VoiceOver atau NVDA.
Rencana perbaikan
| Prioritas | Masalah | Status | WCAG | Kemunculan | Penanggung jawab | Tanggal target |
|---|---|---|---|---|---|---|
| P1 | Fokus keyboard terjebak di banner cookie | Terverifikasi | 2.1.2 | 1 | vendor aplikasi | 2026-10-08 |
| P1 | Opsi produk tidak dapat dipilih dengan keyboard | Terverifikasi | 2.1.1 | 1 | developer tema | 2026-10-08 |
| P1 | Tombol harus memiliki teks yang dapat dikenali | Terverifikasi | 4.1.2 | 41 | developer tema | 2026-10-08 |
| P1 | Gambar harus memiliki teks alternatif | Terverifikasi | 1.1.1 | 22 | editor konten | 2026-10-08 |
| P1 | Elemen formulir harus memiliki label | Terverifikasi | 4.1.2 | 7 | developer tema | 2026-10-08 |
| P1 | Elemen select harus memiliki nama aksesibel | Terverifikasi | 4.1.2 | 1 | developer tema | 2026-10-08 |
| P1 | Tautan harus memiliki teks yang dapat dikenali | Terverifikasi | 2.4.4, 4.1.2 | 36 | developer tema | 2026-10-08 |
| P1 | Elemen harus memenuhi ambang batas minimum rasio kontras warna | Terverifikasi | 1.4.3 | 22 | pemilik toko (pengaturan admin) | 2026-10-08 |
| P3 | Semua konten halaman sebaiknya berada di dalam landmark | Terverifikasi | Praktik terbaik | 18 | developer tema | 2026-11-23 |
| P3 | Level heading sebaiknya hanya naik satu tingkat | Terverifikasi | Praktik terbaik | 7 | developer tema | 2026-11-23 |
Cara memperbaiki setiap masalah
Fokus keyboard terjebak di banner cookie
upaya: sedang · penanggung jawab: vendor aplikasi · 2.1.2 No Keyboard Trap
Saat pengguna keyboard menekan Tab, fokus berputar di antara beberapa elemen dan tidak pernah mencapai bagian halaman lainnya.
Pengguna yang hanya memakai keyboard dan pengguna pembaca layar sama sekali tidak bisa berbelanja jika fokus terjebak (WCAG 2.1.2 No Keyboard Trap).
Bukti
- Ditemukan oleh
- Uji keyboard (Tab di sepanjang halaman beranda)
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 1 kemunculan di 1 halaman
Diharapkan: Menekan Tab berpindah melalui setiap elemen interaktif di halaman dan terus ke bagian halaman lainnya.
Teramati: Setelah 40 kali menekan Tab, fokus terus berputar di antara: Settings, Accept all.
Cara mereproduksi
- Buka halaman beranda.
- Klik bilah alamat, lalu tekan Tab berulang kali.
- Fokus terus kembali ke beberapa elemen yang sama.
Elemen yang gagal (6 ditampilkan)
SettingsAccept allSettingsAccept allSettingsAccept allHalaman terdampak (1)
- https://harborandpine.example/
Cara memperbaikinya
Panduan umum- Periksa pengaturan aplikasi banner cookie atau persetujuan Anda untuk opsi aksesibilitas atau jebakan fokus, atau minta vendornya memperbaikinya.
- Modal hanya boleh menahan fokus di dalamnya selama terbuka, dan harus dapat ditutup dengan tombol Escape serta mengembalikan fokus ke tempat asalnya.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya. Masalah: Fokus keyboard terjebak di banner cookie (WCAG 2.1.2). Lokasi: 1 kemunculan di 1 halaman, misalnya /. Satu elemen yang gagal, seperti yang dirender browser: ```html Settings ``` Mengapa ini penting: Pengguna yang hanya memakai keyboard dan pengguna pembaca layar sama sekali tidak bisa berbelanja jika fokus terjebak (WCAG 2.1.2 No Keyboard Trap). Yang perlu diubah: - Periksa pengaturan aplikasi banner cookie atau persetujuan Anda untuk opsi aksesibilitas atau jebakan fokus, atau minta vendornya memperbaikinya. - Modal hanya boleh menahan fokus di dalamnya selama terbuka, dan harus dapat ditutup dengan tombol Escape serta mengembalikan fokus ke tempat asalnya. Aturan untuk jawaban Anda: - Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya. - Pertahankan desain visual dan semua perilaku yang ada tetap sama. - Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi. - Akhiri dengan cara saya dapat mengecek perbaikannya sendiri. - Sertakan cara memastikannya dengan keyboard dan pembaca layar.
Cek perbaikan Anda
- Muat halaman beranda, tekan Tab berulang kali, dan pastikan fokus mencapai navigasi utama dan konten.
Terdeteksi oleh pengujian keyboard otomatis; pastikan secara manual.
Opsi produk tidak dapat dipilih dengan keyboard
upaya: sedang · penanggung jawab: developer tema · 2.1.1 Keyboard
Opsi ukuran, warna, atau varian merespons mouse tetapi tidak dapat menerima fokus keyboard, sehingga pengguna keyboard tidak dapat memilih varian.
Pembeli yang hanya memakai keyboard, termasuk banyak pengguna pembaca layar, tidak dapat melewati langkah ini (WCAG 2.1.1).
Bukti
- Ditemukan oleh
- Perjalanan keyboard
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 1 kemunculan di 1 halaman
Diharapkan: Setiap opsi produk (ukuran, warna, varian) dan kolom jumlah dapat dijangkau dengan Tab.
Teramati: 3 opsi produk tidak dapat menerima fokus keyboard: “S”, “M”, “L”. Opsi tersebut merespons mouse, tetapi pengguna keyboard tidak dapat memilihnya.

Cara mereproduksi
- Buka /products/trail-daypack.
- Tekan Tab dari bagian atas halaman dan catat kontrol mana saja yang menerima fokus sebelum Tambah ke keranjang.
Elemen yang gagal (1 ditampilkan)
<div class="size-option" data-fr="opt-1">S</div>Halaman terdampak (1)
- https://harborandpine.example/products/trail-daypack
Cara memperbaikinya
Panduan umum- Buat pemilih opsi dari tombol radio bawaan (atau <select>) dengan label yang terlihat; beri gaya pada label sebagai swatch.
- Jika Anda tetap memakai elemen kustom, setiap opsi memerlukan tabindex="0", role="radio" dengan aria-checked di dalam role="radiogroup", serta penanganan tombol panah dan Space. Tombol radio bawaan sudah menyediakan semua ini tanpa usaha tambahan.
Kode
Contoh implementasi untuk developer Anda. Kami tidak memiliki kode sumber tema Anda, jadi lokasi file hanyalah petunjuk, bukan path yang pasti.
<div class="size-option" data-fr="opt-1">S</div><fieldset class="variant-picker">
<legend>Size</legend>
<input type="radio" id="size-s" name="Size" value="S" class="visually-hidden">
<label for="size-s" class="size-option">S</label>
<input type="radio" id="size-m" name="Size" value="M" class="visually-hidden">
<label for="size-m" class="size-option">M</label>
</fieldset>Setiap opsi adalah tombol radio sungguhan, dapat dijangkau dengan Tab dan diubah dengan tombol panah; label tetap mempertahankan gaya swatch Anda. Gunakan nama dan nilai opsi Anda.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya. Masalah: Opsi produk tidak dapat dipilih dengan keyboard (WCAG 2.1.1). Lokasi: 1 kemunculan di 1 halaman, misalnya /products/trail-daypack. Satu elemen yang gagal, seperti yang dirender browser: ```html <div class="size-option" data-fr="opt-1">S</div> ``` Mengapa ini penting: Pembeli yang hanya memakai keyboard, termasuk banyak pengguna pembaca layar, tidak dapat melewati langkah ini (WCAG 2.1.1). Yang perlu diubah: - Buat pemilih opsi dari tombol radio bawaan (atau <select>) dengan label yang terlihat; beri gaya pada label sebagai swatch. - Jika Anda tetap memakai elemen kustom, setiap opsi memerlukan tabindex="0", role="radio" dengan aria-checked di dalam role="radiogroup", serta penanganan tombol panah dan Space. Tombol radio bawaan sudah menyediakan semua ini tanpa usaha tambahan. Usulan perubahan (Formulir produk tema Anda (pemilih varian)): ```html <fieldset class="variant-picker"> <legend>Size</legend> <input type="radio" id="size-s" name="Size" value="S" class="visually-hidden"> <label for="size-s" class="size-option">S</label> <input type="radio" id="size-m" name="Size" value="M" class="visually-hidden"> <label for="size-m" class="size-option">M</label> </fieldset> ``` Aturan untuk jawaban Anda: - Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya. - Pertahankan desain visual dan semua perilaku yang ada tetap sama. - Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi. - Akhiri dengan cara saya dapat mengecek perbaikannya sendiri. - Sertakan cara memastikannya dengan keyboard dan pembaca layar.
Cek perbaikan Anda
- Ulangi langkah reproduksi hanya dengan keyboard.
- Minta uji ulang dari laporan ini: perjalanan akan dijalankan lagi.
Gambar harus memiliki teks alternatif
upaya: sedang · penanggung jawab: editor konten · 1.1.1 Non-text Content
Gambar tidak memiliki alternatif teks, sehingga pengguna pembaca layar tidak tahu apa yang ditampilkannya.
WCAG 1.1.1 mensyaratkan alternatif teks untuk gambar yang bermakna. Tanpa itu, pengguna pembaca layar tidak dapat mengetahui produk mana yang ditampilkan sebuah foto.
Bukti
- Ditemukan oleh
- Aturan otomatis axe-core
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 22 kemunculan di 7 halaman
Diharapkan: Gambar harus memiliki teks alternatif
Teramati: Elemen tidak memiliki atribut alt. Atribut aria-label tidak ada atau kosong. Atribut aria-labelledby tidak ada, merujuk ke elemen yang tidak ada, atau merujuk ke elemen yang kosong. Elemen tidak memiliki atribut title. Semantik bawaan elemen tidak ditimpa dengan role="none" atau role="presentation".


Cara mereproduksi
- Buka https://harborandpine.example/ di Chrome atau Edge.
- Buka DevTools (F12) › Elements, tekan Ctrl+F (Cmd+F di Mac), lalu cari: img[src$="hero-photo.jpg"]
- Di panel Accessibility pada DevTools, Name terhitung (computed) elemen tersebut kosong.
- Atau jalankan ekstensi browser axe DevTools gratis di halaman tersebut: ekstensi itu melaporkannya sebagai “image-alt”.
Elemen yang gagal (4 ditampilkan)
<img src="/img/hero-photo.jpg" loading="lazy"><img src="/img/mug.svg"><img src="/img/beanie.svg"><img src="/img/jacket.svg">Halaman terdampak (7)
- https://harborandpine.example/
- https://harborandpine.example/collections/all
- https://harborandpine.example/products/trail-daypack
- https://harborandpine.example/products/pine-wool-beanie
- https://harborandpine.example/products/enamel-camp-mug
- https://harborandpine.example/products/harbor-lantern
- https://harborandpine.example/products/insulated-bottle
Cara memperbaikinya
Kode yang disusun dari markup halaman Anda- Di admin Shopify, buka Produk > [produk] > Media, klik setiap gambar dan isi teks alt ('Alt text'). Untuk gambar section, buka Toko Online > Tema > Sesuaikan dan atur teks alt gambar di pengaturan section.
- Jelaskan apa yang penting bagi pembeli: nama produk, warna, dan sudut yang ditampilkan (misalnya 'Tas tote kanvas warna zaitun, tampak depan').
- Gambar dekoratif sebaiknya memiliki atribut alt kosong (alt="") agar dilewati pembaca layar.
Kode
Contoh implementasi untuk developer Anda. Kami tidak memiliki kode sumber tema Anda, jadi lokasi file hanyalah petunjuk, bukan path yang pasti.
<img src="/img/hero-photo.jpg" loading="lazy"><img src="/img/hero-photo.jpg" loading="lazy" alt="[Describe the image for a shopper]">Jelaskan apa yang ditampilkan gambar (untuk foto produk: produk, warna, sudut). Jika gambar murni dekoratif, gunakan alt="" sebagai gantinya agar dilewati pembaca layar.
<img src="/img/mug.svg"><img src="/img/mug.svg" alt="[Describe the image for a shopper]">Jelaskan apa yang ditampilkan gambar (untuk foto produk: produk, warna, sudut). Jika gambar murni dekoratif, gunakan alt="" sebagai gantinya agar dilewati pembaca layar.
<img src="/img/beanie.svg"><img src="/img/beanie.svg" alt="[Describe the image for a shopper]">Jelaskan apa yang ditampilkan gambar (untuk foto produk: produk, warna, sudut). Jika gambar murni dekoratif, gunakan alt="" sebagai gantinya agar dilewati pembaca layar.
<img src="/img/jacket.svg"><img src="/img/jacket.svg" alt="[Describe the image for a shopper]">Jelaskan apa yang ditampilkan gambar (untuk foto produk: produk, warna, sudut). Jika gambar murni dekoratif, gunakan alt="" sebagai gantinya agar dilewati pembaca layar.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya.
Masalah: Gambar harus memiliki teks alternatif (WCAG 1.1.1).
Lokasi: 22 kemunculan di 7 halaman, misalnya /, /collections/all, /products/trail-daypack, /products/pine-wool-beanie.
Satu elemen yang gagal, seperti yang dirender browser:
```html
<img src="/img/hero-photo.jpg" loading="lazy">
```
Mengapa ini penting: WCAG 1.1.1 mensyaratkan alternatif teks untuk gambar yang bermakna. Tanpa itu, pengguna pembaca layar tidak dapat mengetahui produk mana yang ditampilkan sebuah foto.
Yang perlu diubah:
- Di admin Shopify, buka Produk > [produk] > Media, klik setiap gambar dan isi teks alt ('Alt text'). Untuk gambar section, buka Toko Online > Tema > Sesuaikan dan atur teks alt gambar di pengaturan section.
- Jelaskan apa yang penting bagi pembeli: nama produk, warna, dan sudut yang ditampilkan (misalnya 'Tas tote kanvas warna zaitun, tampak depan').
- Gambar dekoratif sebaiknya memiliki atribut alt kosong (alt="") agar dilewati pembaca layar.
Usulan perubahan (Foto produk: admin Shopify › Produk › Media › teks alt (Alt text). Gambar lain: kode tema Anda):
```html
<img src="/img/hero-photo.jpg" loading="lazy" alt="[Describe the image for a shopper]">
```
Aturan untuk jawaban Anda:
- Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya.
- Pertahankan desain visual dan semua perilaku yang ada tetap sama.
- Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi.
- Akhiri dengan cara saya dapat mengecek perbaikannya sendiri.
- Sertakan cara memastikannya dengan keyboard dan pembaca layar.Cek perbaikan Anda
- Pindai ulang halaman yang terdampak.
- Gunakan pembaca layar (VoiceOver: Cmd+F5 di Mac) untuk mendengar gambar produk dibacakan.
Panduan terperinci: https://dequeuniversity.com/rules/axe/4.13/image-alt?application=playwright
Elemen formulir harus memiliki label
upaya: cepat · penanggung jawab: developer tema · 4.1.2 Name, Role, Value
Sebagian kolom formulir tidak memiliki label, sehingga pengguna pembaca layar tidak tahu apa yang harus diisi.
WCAG 1.3.1, 3.3.2, dan 4.1.2 mensyaratkan kolom formulir memiliki label. Kolom pendaftaran newsletter dan kolom pencarian adalah penyebab yang umum.
Bukti
- Ditemukan oleh
- Aturan otomatis axe-core
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 7 kemunculan di 6 halaman
Diharapkan: Elemen formulir harus memiliki label
Teramati: Elemen tidak memiliki <label> implisit (yang membungkusnya). Elemen tidak memiliki <label> eksplisit. Atribut aria-label tidak ada atau kosong. Atribut aria-labelledby tidak ada, merujuk ke elemen yang tidak ada, atau merujuk ke elemen yang kosong. Elemen tidak memiliki atribut title. Elemen tidak memiliki atribut placeholder. Semantik bawaan elemen tidak ditimpa dengan role="none" atau role="presentation".


Cara mereproduksi
- Buka https://harborandpine.example/products/trail-daypack di Chrome atau Edge.
- Buka DevTools (F12) › Elements, tekan Ctrl+F (Cmd+F di Mac), lalu cari: input
- Di panel Accessibility pada DevTools, Name terhitung (computed) elemen tersebut kosong.
- Atau jalankan ekstensi browser axe DevTools gratis di halaman tersebut: ekstensi itu melaporkannya sebagai “label”.
Elemen yang gagal (2 ditampilkan)
<input type="number" value="1" min="1"><input type="number" value="2" min="1">Halaman terdampak (6)
- https://harborandpine.example/products/trail-daypack
- https://harborandpine.example/cart
- https://harborandpine.example/products/pine-wool-beanie
- https://harborandpine.example/products/enamel-camp-mug
- https://harborandpine.example/products/harbor-lantern
- https://harborandpine.example/products/insulated-bottle
Cara memperbaikinya
Kode yang disusun dari markup halaman Anda- Berikan setiap kolom elemen <label for="field-id">, atau setidaknya aria-label.
- Teks placeholder saja tidak dihitung sebagai label.
Kode
Contoh implementasi untuk developer Anda. Kami tidak memiliki kode sumber tema Anda, jadi lokasi file hanyalah petunjuk, bukan path yang pasti.
<input type="number" value="1" min="1"><input type="number" value="1" min="1" aria-label="Quantity">Kolom tidak memiliki id, jadi perbaikan tercepat adalah aria-label. <label> yang terlihat lebih baik bagi semua orang. Teks label “Quantity” ditebak dari kolomnya; sesuaikan jika perlu.
<input type="number" value="2" min="1"><input type="number" value="2" min="1" aria-label="Quantity">Kolom tidak memiliki id, jadi perbaikan tercepat adalah aria-label. <label> yang terlihat lebih baik bagi semua orang. Teks label “Quantity” ditebak dari kolomnya; sesuaikan jika perlu.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya. Masalah: Elemen formulir harus memiliki label (WCAG 4.1.2). Lokasi: 7 kemunculan di 6 halaman, misalnya /products/trail-daypack, /cart, /products/pine-wool-beanie, /products/enamel-camp-mug. Satu elemen yang gagal, seperti yang dirender browser: ```html <input type="number" value="1" min="1"> ``` Mengapa ini penting: WCAG 1.3.1, 3.3.2, dan 4.1.2 mensyaratkan kolom formulir memiliki label. Kolom pendaftaran newsletter dan kolom pencarian adalah penyebab yang umum. Yang perlu diubah: - Berikan setiap kolom elemen <label for="field-id">, atau setidaknya aria-label. - Teks placeholder saja tidak dihitung sebagai label. Usulan perubahan (Kode tema Anda (cari markup yang ditampilkan di dalamnya)): ```html <input type="number" value="1" min="1" aria-label="Quantity"> ``` Aturan untuk jawaban Anda: - Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya. - Pertahankan desain visual dan semua perilaku yang ada tetap sama. - Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi. - Akhiri dengan cara saya dapat mengecek perbaikannya sendiri. - Sertakan cara memastikannya dengan keyboard dan pembaca layar.
Cek perbaikan Anda
- Pindai ulang dan pastikan aturan label tidak gagal lagi.
- Klik setiap label dan pastikan label itu memfokuskan kolomnya.
Panduan terperinci: https://dequeuniversity.com/rules/axe/4.13/label?application=playwright
Elemen select harus memiliki nama aksesibel
upaya: cepat · penanggung jawab: developer tema · 4.1.2 Name, Role, Value
Sebuah dropdown (sering kali pemilih urutan atau varian) tidak memiliki label.
WCAG 4.1.2 mensyaratkan menu pilihan (select) memiliki nama aksesibel.
Bukti
- Ditemukan oleh
- Aturan otomatis axe-core
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 1 kemunculan di 1 halaman
Diharapkan: Elemen select harus memiliki nama aksesibel
Teramati: Elemen tidak memiliki <label> implisit (yang membungkusnya). Elemen tidak memiliki <label> eksplisit. Atribut aria-label tidak ada atau kosong. Atribut aria-labelledby tidak ada, merujuk ke elemen yang tidak ada, atau merujuk ke elemen yang kosong. Elemen tidak memiliki atribut title. Semantik bawaan elemen tidak ditimpa dengan role="none" atau role="presentation".

Cara mereproduksi
- Buka https://harborandpine.example/collections/all di Chrome atau Edge.
- Buka DevTools (F12) › Elements, tekan Ctrl+F (Cmd+F di Mac), lalu cari: select
- Di panel Accessibility pada DevTools, Name terhitung (computed) elemen tersebut kosong.
- Atau jalankan ekstensi browser axe DevTools gratis di halaman tersebut: ekstensi itu melaporkannya sebagai “select-name”.
Elemen yang gagal (1 ditampilkan)
<select><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select>Halaman terdampak (1)
- https://harborandpine.example/collections/all
Cara memperbaikinya
Kode yang disusun dari markup halaman Anda- Tambahkan <label> yang terhubung ke select, atau aria-label seperti aria-label="Sort by".
Kode
Contoh implementasi untuk developer Anda. Kami tidak memiliki kode sumber tema Anda, jadi lokasi file hanyalah petunjuk, bukan path yang pasti.
<select><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select><select aria-label="[Field label]"><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select>Kolom tidak memiliki id, jadi perbaikan tercepat adalah aria-label. <label> yang terlihat lebih baik bagi semua orang. Ganti teks dalam tanda kurung dengan label kolom tersebut.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya. Masalah: Elemen select harus memiliki nama aksesibel (WCAG 4.1.2). Lokasi: 1 kemunculan di 1 halaman, misalnya /collections/all. Satu elemen yang gagal, seperti yang dirender browser: ```html <select><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select> ``` Mengapa ini penting: WCAG 4.1.2 mensyaratkan menu pilihan (select) memiliki nama aksesibel. Yang perlu diubah: - Tambahkan <label> yang terhubung ke select, atau aria-label seperti aria-label="Sort by". Usulan perubahan (Kode tema Anda (cari markup yang ditampilkan di dalamnya)): ```html <select aria-label="[Field label]"><option>Featured</option><option>Price, low to high</option><option>Price, high to low</option></select> ``` Aturan untuk jawaban Anda: - Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya. - Pertahankan desain visual dan semua perilaku yang ada tetap sama. - Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi. - Akhiri dengan cara saya dapat mengecek perbaikannya sendiri. - Sertakan cara memastikannya dengan keyboard dan pembaca layar.
Cek perbaikan Anda
- Pindai ulang halaman koleksi dan halaman produk.
Panduan terperinci: https://dequeuniversity.com/rules/axe/4.13/select-name?application=playwright
Tautan harus memiliki teks yang dapat dikenali
upaya: cepat · penanggung jawab: developer tema · 2.4.4 Link Purpose (In Context), 4.1.2 Name, Role, Value
Sebagian tautan tidak memiliki teks yang dapat dibacakan pembaca layar, sering kali tautan berupa ikon saja seperti ikon media sosial atau ikon keranjang.
WCAG 2.4.4 dan 4.1.2 mensyaratkan tautan memiliki nama aksesibel yang menjelaskan tujuannya.
Bukti
- Ditemukan oleh
- Aturan otomatis axe-core
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 36 kemunculan di 9 halaman
Diharapkan: Tautan harus memiliki teks yang dapat dikenali
Teramati: Elemen berada dalam urutan tab dan tidak memiliki teks aksesibel. Selain itu: Elemen tidak memiliki teks yang dapat dibaca oleh pembaca layar. Atribut aria-label tidak ada atau kosong. Atribut aria-labelledby tidak ada, merujuk ke elemen yang tidak ada, atau merujuk ke elemen yang kosong. Elemen tidak memiliki atribut title.


Cara mereproduksi
- Buka https://harborandpine.example/ di Chrome atau Edge.
- Buka DevTools (F12) › Elements, tekan Ctrl+F (Cmd+F di Mac), lalu cari: a[href$="cart"]
- Di panel Accessibility pada DevTools, Name terhitung (computed) elemen tersebut kosong.
- Atau jalankan ekstensi browser axe DevTools gratis di halaman tersebut: ekstensi itu melaporkannya sebagai “link-name”.
Elemen yang gagal (4 ditampilkan)
<a href="/cart"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 4h2l2.4 11h11l2-8H6.5"></path><circle cx="9" cy="20" r="1.5"></circle><circle cx="18" cy="20" r="1.5"></circle></svg></a><a href="https://instagram.example/harborandpine"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="18" rx="5"></rect><circle cx="12" cy="12" r="4"></circle></svg></a><a href="https://facebook.example/harborandpine"><svg viewBox="0 0 24 24" fill="currentColor"><path d="M14 8h3V4h-3c-2.8 0-4 1.8-4 4v2H7v4h3v8h4v-8h3l1-4h-4V8.5c0-.3.2-.5.5-.5z"></path></svg></a><a href="https://x.example/harborandpine"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 4l16 16M20 4L4 20"></path></svg></a>Halaman terdampak (9)
- https://harborandpine.example/
- https://harborandpine.example/collections/all
- https://harborandpine.example/products/trail-daypack
- https://harborandpine.example/cart
- https://harborandpine.example/pages/about
- https://harborandpine.example/products/pine-wool-beanie
- https://harborandpine.example/products/enamel-camp-mug
- https://harborandpine.example/products/harbor-lantern
- https://harborandpine.example/products/insulated-bottle
Cara memperbaikinya
Kode yang disusun dari markup halaman Anda- Temukan tautan dalam contoh di bawah. Sebagian besar berupa ikon atau gambar di dalam tag <a>.
- Tambahkan teks yang tersembunyi secara visual di dalam tautan, atau aria-label seperti aria-label="Instagram" atau aria-label="Cart".
- Jika tautan membungkus gambar, berikan teks alt yang bermakna pada gambar tersebut sebagai gantinya.
Kode
Contoh implementasi untuk developer Anda. Kami tidak memiliki kode sumber tema Anda, jadi lokasi file hanyalah petunjuk, bukan path yang pasti.
<a href="/cart">…</a><a href="/cart" aria-label="Cart">…</a>Memberi tautan nama “Cart”, yang ditebak dari tautan atau class-nya. Pastikan nama itu menyebutkan fungsi tautan.
<a href="https://instagram.example/harborandpine">…</a><a href="https://instagram.example/harborandpine" aria-label="Instagram">…</a>Memberi tautan nama “Instagram”, yang ditebak dari tautan atau class-nya. Pastikan nama itu menyebutkan fungsi tautan.
<a href="https://facebook.example/harborandpine">…</a><a href="https://facebook.example/harborandpine" aria-label="Facebook">…</a>Memberi tautan nama “Facebook”, yang ditebak dari tautan atau class-nya. Pastikan nama itu menyebutkan fungsi tautan.
<a href="https://x.example/harborandpine">…</a><a href="https://x.example/harborandpine" aria-label="X (Twitter)">…</a>Memberi tautan nama “X (Twitter)”, yang ditebak dari tautan atau class-nya. Pastikan nama itu menyebutkan fungsi tautan.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya. Masalah: Tautan harus memiliki teks yang dapat dikenali (WCAG 2.4.4, 4.1.2). Lokasi: 36 kemunculan di 9 halaman, misalnya /, /collections/all, /products/trail-daypack, /cart. Satu elemen yang gagal, seperti yang dirender browser: ```html <a href="/cart"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 4h2l2.4 11h11l2-8H6.5"></path><circle cx="9" cy="20" r="1.5"></circle><circle cx="18" cy="20" r="1.5"></circle></svg></a> ``` Mengapa ini penting: WCAG 2.4.4 dan 4.1.2 mensyaratkan tautan memiliki nama aksesibel yang menjelaskan tujuannya. Yang perlu diubah: - Temukan tautan dalam contoh di bawah. Sebagian besar berupa ikon atau gambar di dalam tag <a>. - Tambahkan teks yang tersembunyi secara visual di dalam tautan, atau aria-label seperti aria-label="Instagram" atau aria-label="Cart". - Jika tautan membungkus gambar, berikan teks alt yang bermakna pada gambar tersebut sebagai gantinya. Usulan perubahan (Kode tema Anda (cari markup yang ditampilkan di dalamnya)): ```html <a href="/cart" aria-label="Cart">…</a> ``` Aturan untuk jawaban Anda: - Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya. - Pertahankan desain visual dan semua perilaku yang ada tetap sama. - Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi. - Akhiri dengan cara saya dapat mengecek perbaikannya sendiri. - Sertakan cara memastikannya dengan keyboard dan pembaca layar.
Cek perbaikan Anda
- Pindai ulang dan pastikan link-name sudah hilang.
- Tekan Tab ke setiap tautan dengan pembaca layar menyala dan dengarkan namanya.
Panduan terperinci: https://dequeuniversity.com/rules/axe/4.13/link-name?application=playwright
Elemen harus memenuhi ambang batas minimum rasio kontras warna
upaya: cepat · penanggung jawab: pemilik toko (pengaturan admin) · 1.4.3 Contrast (Minimum)
Sebagian teks kurang menonjol dari latar belakangnya sehingga sulit dibaca oleh orang dengan penglihatan rendah.
WCAG 1.4.3 mensyaratkan rasio kontras minimal 4,5:1 untuk teks normal dan 3:1 untuk teks besar. Harga, badge, dan banner yang samar sulit dibaca oleh orang dengan penglihatan rendah, dan oleh semua orang di bawah cahaya terang.
Bukti
- Ditemukan oleh
- Aturan otomatis axe-core
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 22 kemunculan di 9 halaman
Diharapkan: Elemen harus memenuhi ambang batas minimum rasio kontras warna
Teramati: Elemen memiliki kontras warna 3.09 yang tidak memadai (warna latar depan: #ffffff, warna latar belakang: #e76f51, ukuran font: 9.8pt (13px), ketebalan font: normal). Rasio kontras yang diharapkan: 4.5:1.


Cara mereproduksi
- Buka https://harborandpine.example/ di Chrome atau Edge.
- Buka DevTools (F12) › Elements, tekan Ctrl+F (Cmd+F di Mac), lalu cari: .announce
- Klik kotak warna di samping warna elemen pada panel Styles untuk melihat rasio kontras yang terukur.
- Atau jalankan ekstensi browser axe DevTools gratis di halaman tersebut: ekstensi itu melaporkannya sebagai “color-contrast”.
Elemen yang gagal (4 ditampilkan)
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div><span class="badge">Sale</span><span class="compare">$72</span><span class="compare">$40</span>Halaman terdampak (9)
- https://harborandpine.example/
- https://harborandpine.example/collections/all
- https://harborandpine.example/products/trail-daypack
- https://harborandpine.example/cart
- https://harborandpine.example/pages/about
- https://harborandpine.example/products/pine-wool-beanie
- https://harborandpine.example/products/enamel-camp-mug
- https://harborandpine.example/products/harbor-lantern
- https://harborandpine.example/products/insulated-bottle
Cara memperbaikinya
Kode yang disusun dari markup halaman Anda- Buka elemen gagal yang tercantum di bawah dan catat warna latar depan dan latar belakangnya di ringkasan kegagalan.
- Di Toko Online > Tema > Sesuaikan > Pengaturan tema > Warna, gelapkan warna teks atau terangkan latar belakang untuk skema warna yang terdampak hingga rasionya minimal 4,5:1.
- Beri perhatian khusus pada badge diskon, teks placeholder, tautan footer, dan tombol di atas gambar.
Kode
Contoh implementasi untuk developer Anda. Kami tidak memiliki kode sumber tema Anda, jadi lokasi file hanyalah petunjuk, bukan path yang pasti.
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div>.announce {
background-color: #b95941; /* was #e76f51: 3.09:1, now 4.59:1 */
}Terukur 3,09:1 untuk teks 13px; WCAG 1.4.3 memerlukan 4,5:1. #b95941 mempertahankan rona yang sama dan lolos. Selector ini adalah yang digunakan pengujian kami; tema Anda mungkin memakai class yang lebih luas untuk gaya yang sama.
<span class="badge">Sale</span>.badge {
background-color: #9f693f; /* was #f4a261: 2.06:1, now 4.59:1 */
}Terukur 2,06:1 untuk teks tebal 12px; WCAG 1.4.3 memerlukan 4,5:1. #9f693f mempertahankan rona yang sama dan lolos. Selector ini adalah yang digunakan pengujian kami; tema Anda mungkin memakai class yang lebih luas untuk gaya yang sama.
<span class="compare">$72</span>.compare {
color: #78736c; /* was #b0a99f: 2.29:1, now 4.62:1 */
}Terukur 2,29:1 untuk teks 14px; WCAG 1.4.3 memerlukan 4,5:1. #78736c mempertahankan rona yang sama dan lolos. Selector ini adalah yang digunakan pengujian kami; tema Anda mungkin memakai class yang lebih luas untuk gaya yang sama.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya.
Masalah: Elemen harus memenuhi ambang batas minimum rasio kontras warna (WCAG 1.4.3).
Lokasi: 22 kemunculan di 9 halaman, misalnya /, /collections/all, /products/trail-daypack, /cart.
Satu elemen yang gagal, seperti yang dirender browser:
```html
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div>
```
Mengapa ini penting: WCAG 1.4.3 mensyaratkan rasio kontras minimal 4,5:1 untuk teks normal dan 3:1 untuk teks besar. Harga, badge, dan banner yang samar sulit dibaca oleh orang dengan penglihatan rendah, dan oleh semua orang di bawah cahaya terang.
Yang perlu diubah:
- Buka elemen gagal yang tercantum di bawah dan catat warna latar depan dan latar belakangnya di ringkasan kegagalan.
- Di Toko Online > Tema > Sesuaikan > Pengaturan tema > Warna, gelapkan warna teks atau terangkan latar belakang untuk skema warna yang terdampak hingga rasionya minimal 4,5:1.
- Beri perhatian khusus pada badge diskon, teks placeholder, tautan footer, dan tombol di atas gambar.
Usulan perubahan (Pengaturan tema › Warna, atau file CSS tema Anda):
```css
.announce {
background-color: #b95941; /* was #e76f51: 3.09:1, now 4.59:1 */
}
```
Aturan untuk jawaban Anda:
- Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya.
- Pertahankan desain visual dan semua perilaku yang ada tetap sama.
- Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi.
- Akhiri dengan cara saya dapat mengecek perbaikannya sendiri.
- Sertakan cara memastikannya dengan keyboard dan pembaca layar.Cek perbaikan Anda
- Jalankan lagi pemindaian dan pastikan color-contrast tidak muncul lagi.
- Cek sampel dengan alat pengecek kontras pada warna yang persis.
Panduan terperinci: https://dequeuniversity.com/rules/axe/4.13/color-contrast?application=playwright
Semua konten halaman sebaiknya berada di dalam landmark
upaya: sedang · penanggung jawab: developer tema
Sebagian konten tidak berada di dalam landmark halaman (header, nav, main, atau footer).
Landmark memungkinkan pengguna pembaca layar melompat ke berbagai bagian halaman. Ini adalah praktik terbaik yang mendukung WCAG 1.3.1 dan 2.4.1.
Bukti
- Ditemukan oleh
- Aturan otomatis axe-core
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 18 kemunculan di 9 halaman
Diharapkan: Semua konten halaman sebaiknya berada di dalam landmark
Teramati: Sebagian konten halaman tidak berada di dalam landmark.


Cara mereproduksi
- Buka https://harborandpine.example/ di Chrome atau Edge.
- Buka DevTools (F12) › Elements, tekan Ctrl+F (Cmd+F di Mac), lalu cari: .announce
- Atau jalankan ekstensi browser axe DevTools gratis di halaman tersebut: ekstensi itu melaporkannya sebagai “region”.
Elemen yang gagal (2 ditampilkan)
<div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div><p>We use cookies to improve your experience and measure traffic.</p>Halaman terdampak (9)
- https://harborandpine.example/
- https://harborandpine.example/collections/all
- https://harborandpine.example/products/trail-daypack
- https://harborandpine.example/cart
- https://harborandpine.example/pages/about
- https://harborandpine.example/products/pine-wool-beanie
- https://harborandpine.example/products/enamel-camp-mug
- https://harborandpine.example/products/harbor-lantern
- https://harborandpine.example/products/insulated-bottle
Cara memperbaikinya
Panduan umum- Bungkus konten yang tercecer (bar pengumuman, pop-up, widget chat) dengan landmark yang sesuai atau letakkan di dalam <main>.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya. Masalah: Semua konten halaman sebaiknya berada di dalam landmark. Lokasi: 18 kemunculan di 9 halaman, misalnya /, /collections/all, /products/trail-daypack, /cart. Satu elemen yang gagal, seperti yang dirender browser: ```html <div class="announce">Free shipping on orders over $75 · Easy 30-day returns</div> ``` Mengapa ini penting: Landmark memungkinkan pengguna pembaca layar melompat ke berbagai bagian halaman. Ini adalah praktik terbaik yang mendukung WCAG 1.3.1 dan 2.4.1. Yang perlu diubah: - Bungkus konten yang tercecer (bar pengumuman, pop-up, widget chat) dengan landmark yang sesuai atau letakkan di dalam <main>. Aturan untuk jawaban Anda: - Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya. - Pertahankan desain visual dan semua perilaku yang ada tetap sama. - Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi. - Akhiri dengan cara saya dapat mengecek perbaikannya sendiri. - Sertakan cara memastikannya dengan keyboard dan pembaca layar.
Cek perbaikan Anda
- Pindai ulang halaman yang terdampak.
Panduan terperinci: https://dequeuniversity.com/rules/axe/4.13/region?application=playwright
Level heading sebaiknya hanya naik satu tingkat
upaya: sedang · penanggung jawab: developer tema
Level heading melompat (misalnya dari H2 ke H4), sehingga struktur halaman membingungkan bagi pengguna pembaca layar.
Pengguna pembaca layar bernavigasi melalui heading. Ini adalah praktik terbaik yang mendukung WCAG 1.3.1.
Bukti
- Ditemukan oleh
- Aturan otomatis axe-core
- Status · keyakinan
- Kegagalan terverifikasi · tinggi
- Terdeteksi
- 24 Sep 2026 (UTC)
- Lokasi
- 7 kemunculan di 7 halaman
Diharapkan: Level heading sebaiknya hanya naik satu tingkat
Teramati: Urutan heading tidak valid.


Cara mereproduksi
- Buka https://harborandpine.example/collections/all di Chrome atau Edge.
- Buka DevTools (F12) › Elements, tekan Ctrl+F (Cmd+F di Mac), lalu cari: article:nth-child(1) > a[href$="trail-daypack"] > h3
- Atau jalankan ekstensi browser axe DevTools gratis di halaman tersebut: ekstensi itu melaporkannya sebagai “heading-order”.
Elemen yang gagal (3 ditampilkan)
<h3>Trail Daypack 22L</h3><h3>Reviews</h3><h3>Started on the trail</h3>Halaman terdampak (7)
- https://harborandpine.example/collections/all
- https://harborandpine.example/products/trail-daypack
- https://harborandpine.example/pages/about
- https://harborandpine.example/products/pine-wool-beanie
- https://harborandpine.example/products/enamel-camp-mug
- https://harborandpine.example/products/harbor-lantern
- https://harborandpine.example/products/insulated-bottle
Cara memperbaikinya
Panduan umum- Sesuaikan level heading di bagian yang terdampak agar berurutan tanpa melompati level.
- Ubah tag-nya saja, bukan gaya visualnya (gunakan class CSS untuk ukuran).
Kode
Contoh implementasi untuk developer Anda. Kami tidak memiliki kode sumber tema Anda, jadi lokasi file hanyalah petunjuk, bukan path yang pasti.
<h3>Trail Daypack 22L</h3><h2 class="h3">Trail Daypack 22L</h2>Gunakan level yang mengikuti heading sebelumnya di halaman (sering kali satu level lebih tinggi), dan pertahankan tampilannya dengan class. Periksa kerangka halaman sebelum mengubahnya.
<h3>Reviews</h3><h2 class="h3">Reviews</h2>Gunakan level yang mengikuti heading sebelumnya di halaman (sering kali satu level lebih tinggi), dan pertahankan tampilannya dengan class. Periksa kerangka halaman sebelum mengubahnya.
<h3>Started on the trail</h3><h2 class="h3">Started on the trail</h2>Gunakan level yang mengikuti heading sebelumnya di halaman (sering kali satu level lebih tinggi), dan pertahankan tampilannya dengan class. Periksa kerangka halaman sebelum mengubahnya.
Perbaiki dengan AITampilkan prompt
Tempelkan ini ke ChatGPT, Claude, Cursor, atau Copilot bersama file tema Anda. Tinjau perubahannya sebelum Anda memublikasikannya.
Saya mengelola toko Shopify (tema Online Store 2.0, template Liquid) di harborandpine.example. Sebuah uji aksesibilitas menemukan masalah ini dan saya ingin memperbaikinya di tema saya. Masalah: Level heading sebaiknya hanya naik satu tingkat. Lokasi: 7 kemunculan di 7 halaman, misalnya /collections/all, /products/trail-daypack, /pages/about, /products/pine-wool-beanie. Satu elemen yang gagal, seperti yang dirender browser: ```html <h3>Trail Daypack 22L</h3> ``` Mengapa ini penting: Pengguna pembaca layar bernavigasi melalui heading. Ini adalah praktik terbaik yang mendukung WCAG 1.3.1. Yang perlu diubah: - Sesuaikan level heading di bagian yang terdampak agar berurutan tanpa melompati level. - Ubah tag-nya saja, bukan gaya visualnya (gunakan class CSS untuk ukuran). Usulan perubahan (Kode tema Anda (cari markup yang ditampilkan di dalamnya)): ```html <h2 class="h3">Trail Daypack 22L</h2> ``` Aturan untuk jawaban Anda: - Tunjukkan perubahan yang tepat dalam bentuk sebelum dan sesudah, dan sebutkan file atau pengaturan tempat perubahan itu dilakukan. Jika Anda perlu melihat file saya lebih dulu, minta saya menempelkannya. - Pertahankan desain visual dan semua perilaku yang ada tetap sama. - Jangan mengarang nama produk, harga, atau teks; gunakan placeholder yang bisa saya isi. - Akhiri dengan cara saya dapat mengecek perbaikannya sendiri. - Sertakan cara memastikannya dengan keyboard dan pembaca layar.
Cek perbaikan Anda
- Pindai ulang dan periksa kerangka heading dengan ekstensi browser seperti HeadingsMap.
Panduan terperinci: https://dequeuniversity.com/rules/axe/4.13/heading-order?application=playwright
Perlu ditinjau manual
Pengujian otomatis menandai hal-hal ini tetapi tidak dapat memutuskannya, misalnya teks di atas gambar atau konten yang mungkin tidak muat di layar ponsel. Hal-hal ini tidak dihitung sebagai kegagalan. Minta developer Anda memeriksa masing-masing.
- Perlu ditinjauWCAG 4.1.3
Perjalanan keyboard: Menambahkan ke keranjang dengan keyboard
Enter pada Tambah ke keranjang berhasil (jumlah item keranjang di header berubah, pesan “ditambahkan ke keranjang” muncul), tetapi kami tidak menemukan pesan status atau dialog yang menerima fokus, sehingga pengguna pembaca layar mungkin tidak mendengar bahwa barang telah ditambahkan.
1 kemunculan di 1 halaman · Cara memeriksanya
- Perlu ditinjauWCAG 1.4.10
Halaman produk mungkin tidak muat di layar sempit tanpa digulir ke samping
Pada lebar 320 piksel CSS (sama dengan zoom 400%), halaman 200px lebih lebar daripada layar. Tabel data dan peta boleh digulir; teks dan kontrol tidak boleh.
2 kemunculan di 1 halaman · Cara memeriksanya
Elemen yang perlu diperiksa (2 ditampilkan)
div.icons <div class="icons"> <button type="button"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"></circle><path d="M20 20l-3.5-3.5"></path></svg></budiv <div> <p style="color:#6a6a60;font-size:14px">Harbor & Pine</p> <h1>Trail Daypack 22L</h1> <p class="price" style="font-size:22px">$128<span class="compare">$150</span></p> <p class="opt-label">Si - Perlu ditinjauWCAG 1.4.10
Halaman beranda mungkin tidak muat di layar sempit tanpa digulir ke samping
Pada lebar 320 piksel CSS (sama dengan zoom 400%), halaman 55px lebih lebar daripada layar. Tabel data dan peta boleh digulir; teks dan kontrol tidak boleh.
3 kemunculan di 1 halaman · Cara memeriksanya
Elemen yang perlu diperiksa (3 ditampilkan)
div.icons <div class="icons"> <button type="button"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"></circle><path d="M20 20l-3.5-3.5"></path></svg></buarticle.card <article class="card"><span class="badge">Sale</span><a href="/products/trail-daypack"><img src="/img/beanie.svg"><h3>Pine Wool Beanie</h3></a><p class="price">$32<span class="compare">$40</span></p><button.btn.light <button class="btn light" type="submit">Subscribe</button> - Perlu ditinjauWCAG 1.4.3
Elemen harus memenuhi ambang batas minimum rasio kontras warna
Warna latar belakang elemen tidak dapat ditentukan karena elemen berisi node gambar.
1 kemunculan di 1 halaman · Cara memeriksanya
Elemen yang perlu diperiksa (1 ditampilkan)
h1 <h1>Gear for the long way home</h1>
Uji ulang perbaikan Anda
Setelah developer Anda melakukan perubahan, jalankan uji ulang. Kami menjalankan lagi pemeriksaan otomatis yang sama di halaman yang sama, uji keyboard, dan perjalanan keyboard, lalu menunjukkan masalah mana yang tidak lagi dapat kami reproduksi. Termasuk 5 uji ulang.
Uji ulang berjalan pada laporan berbayar.
Pemeriksaan manual
Alat otomatis tidak dapat menilai hal-hal ini. Lakukan pemeriksaan ini sebelum Anda menganggap pekerjaannya selesai.
- Selesaikan checkout hanya dengan keyboard: perjalanan otomatis kami berhenti di tombol checkout dan tidak pernah masuk ke checkout.
- Ulangi dengan pembaca layar (VoiceOver di Mac: Cmd+F5; NVDA di Windows) dan pastikan harga, varian, dan pesan error dibacakan.
- Perbesar browser hingga 200% dan pastikan tidak ada yang tumpang-tindih atau hilang.
- Pastikan video produk dan merek memiliki teks keterangan (caption) yang akurat.
- Kirim formulir dengan isian yang salah (newsletter, kontak, checkout) dan pastikan pesan error dijelaskan dalam bentuk teks.
- Pastikan carousel dan pop-up dapat dijeda atau ditutup, termasuk dengan tombol Escape.
Draf pernyataan aksesibilitas
Edit bagian dalam tanda kurung, lalu publikasikan di halaman yang ditautkan dari footer Anda.
Pernyataan aksesibilitas untuk harborandpine.example Kami ingin semua orang dapat berbelanja di harborandpine.example, termasuk orang yang menggunakan pembaca layar, navigasi keyboard, pembesar layar, atau teknologi bantu lainnya. Kami berupaya memenuhi Web Content Accessibility Guidelines (WCAG) 2.2 Level AA. Yang kami lakukan - Kami menguji toko kami dengan alat aksesibilitas otomatis dan memperbaiki masalah yang ditemukannya. - Kami menguji langkah-langkah belanja yang penting (menjelajah, halaman produk, keranjang, dan checkout) dengan keyboard dan pembaca layar. - Kami meninjau aksesibilitas aplikasi dan widget pihak ketiga sebelum menambahkannya. Keterbatasan yang diketahui (per 24 September 2026) - Akses keyboard dan fokus (WCAG 2.1.1). Kami berencana memperbaikinya paling lambat 2026-10-08. - Tautan dan tombol tanpa nama (WCAG 2.4.4, 4.1.2). Kami berencana memperbaikinya paling lambat 2026-10-08. - Gambar tanpa alternatif teks (WCAG 1.1.1). Kami berencana memperbaikinya paling lambat 2026-10-08. - Kolom formulir tanpa label (WCAG 4.1.2). Kami berencana memperbaikinya paling lambat 2026-10-08. - Kontras warna rendah (WCAG 1.4.3). Kami berencana memperbaikinya paling lambat 2026-10-08. Masukan dan bantuan Jika Anda kesulitan menggunakan bagian mana pun dari toko kami, hubungi kami di [email Anda] atau [nomor telepon Anda]. Beri tahu kami halaman dan masalahnya, dan kami akan membantu Anda menyelesaikan pembelian serta menanggapi dalam 5 hari kerja. Pernyataan ini disusun pada 24 September 2026 dan akan ditinjau setidaknya setahun sekali.
Log bukti
Setiap halaman dimuat di Chromium dan diuji dengan axe-core 4.13.0. Hash SHA-256 mengidentifikasi hasil mentah untuk setiap halaman.
| Halaman | Diuji (UTC) | HTTP | Masalah | SHA-256 |
|---|---|---|---|---|
| Halaman berandahttps://harborandpine.example/ | 2026-09-24 14:05:00 | 200 | 15 | da1e5470a57859a864332912dd1e4f62b4c4f64487ba144865b74879519599a3 |
| Halaman koleksihttps://harborandpine.example/collections/all | 2026-09-24 14:05:09 | 200 | 20 | 28d8dfcf5ca953af353264a930a351bea3cf23f98a303874b32e5da355a4c8b0 |
| Halaman produkhttps://harborandpine.example/products/trail-daypack | 2026-09-24 14:05:18 | 200 | 20 | 68a173ddfd16eeeef5e36d6c0fa9d426769f0d96e358c5e35b67608dd84139b4 |
| Keranjanghttps://harborandpine.example/cart | 2026-09-24 14:05:27 | 200 | 12 | 5b7945c2cdf779dcef2bd8975d96eb8f42d8dedbf10e767ec80199dd22ce257c |
| Halaman kontenhttps://harborandpine.example/pages/about | 2026-09-24 14:05:36 | 200 | 9 | daf61ae856358a574e63f9357db0bfd9ae6079065acf3aebd5b3c5a7f460e53f |
| Halaman tambahanhttps://harborandpine.example/products/pine-wool-beanie | 2026-09-24 14:08:00 | 200 | 20 | f708ccd7de34dfb65d59d3716580b6ec15a6420020c8387fa4da4e2ff5bd52d3 |
| Halaman tambahanhttps://harborandpine.example/products/enamel-camp-mug | 2026-09-24 14:08:07 | 200 | 19 | c619bcd29e89d06099d174b9fc19305a42f2fa9bdddb600a750c867fc7477022 |
| Halaman tambahanhttps://harborandpine.example/products/harbor-lantern | 2026-09-24 14:08:14 | 200 | 20 | 5720b7433b75050ba413ac74c2bd726b0620aaa68f7918083052383257d5c418 |
| Halaman tambahanhttps://harborandpine.example/products/insulated-bottle | 2026-09-24 14:08:21 | 200 | 19 | 6f1972c22e477c9a63e2dfde1123ed759718f6a75e1606b23f208848691510fd |
Cakupan dan metode
Yang kami uji
- 9 halaman (halaman beranda, halaman koleksi, halaman produk, keranjang, halaman konten, halaman tambahan) dimuat di Chromium pada 1366×900.
- Aturan axe-core 4.13.0 untuk WCAG 2.0, 2.1, dan 2.2 Level A dan AA, ditambah aturan praktik terbaik (ditampilkan sebagai P3).
- Uji keyboard: 40 kali menekan Tab di halaman beranda, untuk mencari jebakan fokus dan indikator fokus yang tidak ada.
- Perjalanan belanja khusus keyboard dari halaman beranda ke tombol checkout (lihat di atas).
- Pemeriksaan reflow pada lebar 320 piksel CSS di halaman beranda dan halaman produk (WCAG 1.4.10).
Yang tidak kami uji
- Halaman checkout dan pembayaran, pengiriman formulir, halaman akun, dan halaman yang memerlukan login.
- Apa yang benar-benar dibacakan pembaca layar, di luar aturan otomatis.
- Teks keterangan (caption) video dan audiodeskripsi, dokumen PDF, dan konten di dalam frame pihak ketiga.
- Bahasa yang sederhana, aksesibilitas kognitif, dan apa pun yang memerlukan penilaian manusia (lihat Pemeriksaan manual).
Cara membaca hasilnya
- Kegagalan terverifikasi
- Uji otomatis atau perjalanan keyboard gagal, dengan bukti yang ditampilkan.
- Perlu ditinjau
- Pengujian menandai sesuatu yang tidak dapat diputuskannya; seseorang perlu memeriksanya.
- Lolos
- Aturan otomatis tidak menemukan kegagalan di halaman yang diuji.
- Tidak diuji
- Di luar cakupan pengujian otomatis di sini; lihat Pemeriksaan manual.
Dapatkan laporan ini untuk website Anda.
Mulailah dengan pemindaian gratis untuk melihat masalah Anda dan kecocokannya dengan surat Anda. Laporan Perbaikan Aksesibilitas seharga $249, sekali bayar, dan siap dalam sekitar 10 menit.
Pindai website Anda gratisLaporan ini menjelaskan hasil pengujian otomatis dan memberikan panduan perbaikan. Laporan ini bukan nasihat hukum dan tidak menyatakan kepatuhan terhadap ADA, European Accessibility Act, atau undang-undang lain mana pun.

