PENAWARAN Langkah besar dimulai dari sini. Lihat promo
JAGOWEB INSIGHT

Tutorial Menghitung Kontras Warna Teks Website dengan Node.js dan Rumus WCAG

Hitung rasio kontras dua warna sRGB dengan Node.js, uji pasangan dekat ambang 4,5:1, dan pisahkan hasil angka dari pemeriksaan aksesibilitas halaman lengkap.

Dua warna yang tampak mirip dapat memberi hasil berbeda

Teks pada website bisnis perlu terbaca pada latarnya, termasuk ketika dipakai untuk keterangan produk atau petunjuk layanan. Menilai hanya dari kesan layar dapat menyulitkan diskusi: satu orang merasa warna sudah cukup gelap, sementara orang lain masih kesulitan membacanya. Tutorial ini membuat alat hitung lokal untuk membandingkan dua warna secara konsisten. Anda akan melihat angka rasio dan keputusan terhadap ambang tertentu, kemudian memahami batas informasi yang dapat diberikan perhitungan tersebut.

Latihan memakai pasangan warna rekaan, bukan pengukuran halaman JagoWeb atau penilaian kepatuhan sebuah situs. Hasilnya dapat menjadi bahan awal saat meninjau desain bersama pengembang. Pemilihan warna aktual tetap perlu dihubungkan dengan teks, latar, ukuran, dan keadaan tampilan yang benar-benar digunakan. Satu pasangan yang memenuhi ambang tidak membuat seluruh halaman otomatis selesai diperiksa. Sebaliknya, angka yang belum memenuhi memberi petunjuk konkret untuk memperbaiki pasangan tersebut lalu menguji ulang hasil perubahan.

Dua pasangan teks abu-abu pada latar putih menunjukkan rasio di bawah dan di atas ambang 4,5 tanpa pembulatan keputusan.
Nilai tampil dibulatkan untuk dibaca; keputusan ambang tetap memakai hasil perhitungan penuh.

Prasyarat dan batas warna yang diterima

Siapkan editor teks, terminal, serta Node.js pada komputer latihan. Periksa keberadaannya melalui node --version, lalu buat folder baru untuk menyimpan latihan-kontras.mjs. Tidak ada paket tambahan maupun koneksi jaringan yang dibutuhkan oleh kode. Fungsi menerima warna sRGB dalam bentuk tanda pagar dan enam digit heksadesimal. Batas masukan ini sengaja dibuat sederhana agar peninjauan mudah diulang. Bentuk singkat tiga digit, nama warna, transparansi, gradien, dan ruang warna lain berada di luar kontrak latihan.

Sediakan catatan pasangan teks dan latar yang ingin dibahas. Untuk permulaan, gunakan daftar yang sudah ada dalam kode tanpa mengubahnya. Warna latar diperlakukan sebagai warna padat yang langsung berada di belakang teks. Bila desain nyata memakai foto atau lapisan transparan, Anda perlu menentukan pasangan efektif pada keadaan yang diperiksa terlebih dahulu. Jangan memasukkan warna mentah sebuah lapisan lalu menganggap hasilnya sudah mewakili seluruh komposisi yang terlihat setelah beberapa lapisan digabungkan.

Alur dua warna sRGB dari pemeriksaan format, luminans relatif, hingga rasio dan keputusan ambang.
Latihan membatasi warna ke enam digit tanpa transparansi; hasil tidak menilai seluruh aksesibilitas situs.

Langkah 1: pahami angka dan ambang yang dipakai

Definisi WCAG menjelaskan luminans relatif serta rasio kontras dari warna yang lebih terang dan lebih gelap. Untuk sRGB, kanal warna perlu dinormalisasi dan diubah melalui fungsi yang sesuai sebelum digabung menjadi luminans. Rasio kemudian dihitung dengan menambahkan konstanta yang ditetapkan pada kedua luminans. Anda tidak perlu menebak rumus dari tangkapan layar; kode di bawah mengikuti definisi tersebut sehingga prosesnya dapat dibaca dan diperiksa oleh rekan yang menjalankan latihan sama.

Understanding Contrast Minimum menjelaskan ambang 4,5:1 untuk teks yang tercakup oleh ketentuan umumnya dan 3:1 untuk teks berskala besar. Ada pengecualian serta definisi yang perlu dibaca dalam kriterianya. Agar keputusan latihan tetap jelas, program hanya melaporkan apakah pasangan memenuhi ambang numerik 4,5. Program tidak menebak apakah sebuah teks tergolong besar atau masuk pengecualian. Bila hendak menilai komponen nyata, klasifikasi dan konteks tersebut harus diputuskan berdasarkan tampilan aktual serta ketentuan yang relevan.

Langkah 2: simpan program lengkap

Salin kode ke latihan-kontras.mjs dan simpan dengan encoding UTF-8. Fungsi kanalLinear melakukan perubahan kanal, luminans memeriksa bentuk warna serta menghitung luminans relatif, dan rasioKontras menghasilkan perbandingan dua warna. Fungsi periksa menyimpan hasil penuh beserta keputusan ambang. Daftar pasangan memberi lima contoh awal dari keadaan ekstrem sampai warna abu-abu yang dekat batas. Penamaan fungsi dipisahkan agar kesalahan dapat ditelusuri ke tahap tertentu, alih-alih tersembunyi dalam satu baris perhitungan panjang.

Kode latihan lengkap — simpan sebagai latihan-kontras.mjs: function kanalLinear(angka8bit) {

  const s = angka8bit / 255;
  return s <= 0.04045 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
}

function luminans(hex) {
  if (typeof hex !== 'string' || !/^#[0-9a-f]{6}$/i.test(hex)) {
    throw new TypeError('Gunakan warna sRGB enam digit, misalnya #FFFFFF');
  }
  const kanal = [1, 3, 5].map(i => kanalLinear(parseInt(hex.slice(i, i + 2), 16)));
  return 0.2126 * kanal[0] + 0.7152 * kanal[1] + 0.0722 * kanal[2];
}

function rasioKontras(teks, latar) {
  const a = luminans(teks), b = luminans(latar);
  return (Math.max(a, b) + 0.05) / (Math.min(a, b) + 0.05);
}

function periksa(teks, latar) {
  const rasio = rasioKontras(teks, latar);
  return {teks, latar, rasio, ambang45: rasio >= 4.5};
}

const pasangan = [
  ['#000000', '#FFFFFF'],
  ['#FFFFFF', '#FFFFFF'],
  ['#777777', '#FFFFFF'],
  ['#767676', '#FFFFFF'],
  ['#183754', '#FFFFFF']
];
for (const [teks, latar] of pasangan) {
  const hasil = periksa(teks, latar);
  console.log(teks, latar, hasil.rasio.toFixed(3) + ':1',
    hasil.ambang45 ? 'Memenuhi ambang 4.5' : 'Belum memenuhi ambang 4.5');
}

export {kanalLinear, luminans, rasioKontras, periksa, pasangan};

Perhatikan bahwa pemeriksaan format dilakukan sebelum nilai kanal dipakai. Masukan yang tidak sesuai menimbulkan TypeError agar kesalahan terlihat, bukan diubah diam-diam menjadi warna lain. Ini kebijakan alat latihan, bukan batas seluruh format warna yang tersedia pada CSS. Ketika kelak menghubungkan alat serupa ke proses desain, tetapkan cara memperoleh warna yang akan dihitung. Data yang salah atau tidak lengkap tetap dapat menghasilkan keputusan menyesatkan meskipun rumus perhitungannya sendiri sudah benar.

Langkah 3: jalankan dan periksa pasangan acuan

Buka terminal pada folder latihan dan jalankan node latihan-kontras.mjs. Pasangan hitam dan putih seharusnya menghasilkan rasio 21:1, sedangkan putih pada putih menghasilkan 1:1. Dua keadaan ini memberi pemeriksaan dasar bahwa rentang dan arah perbandingan masuk akal. Bacalah setiap baris bersama dua kode warnanya agar hasil tidak tertukar. Jika keluaran tidak sesuai, pastikan berkas yang dijalankan adalah berkas yang baru disimpan dan rumus tidak berubah saat disalin.

Berikutnya lihat dua abu-abu pada latar putih. Nilai #777777 berada sedikit di bawah ambang 4,5, sedangkan #767676 berada di atasnya. Perbedaan kecil ini menunjukkan manfaat menyimpan hasil penuh untuk keputusan. Anda boleh menampilkan beberapa angka desimal agar laporan ringkas, tetapi jangan membulatkan rasio lebih dahulu lalu membandingkannya dengan ambang. W3C secara khusus menyatakan perbandingan ambang tidak memakai nilai yang dibulatkan. Hindari mengubah keluaran tampilan menjadi sumber keputusan berikutnya.

Langkah 4: tambahkan pasangan dan uji simetri

Tambahkan satu pasangan warna padat dari catatan desain pada daftar pasangan, simpan, dan jalankan kembali. Tulis kode warna serta hasilnya pada catatan yang sama. Setelah itu, tambahkan baris kedua dengan posisi dua warna ditukar. Rasio harus sama karena fungsi menentukan warna lebih terang dan lebih gelap sebelum membagi. Makna desain tentu tetap perlu dibaca sebagai teks di atas latar, tetapi pemeriksaan simetri membantu menemukan kesalahan implementasi ketika urutan argumen tanpa sengaja memengaruhi rasio.

Untuk mencoba penolakan masukan, ganti sementara salah satu warna pada salinan latihan menjadi #FFF atau kata putih. Program harus berhenti dengan pesan yang meminta enam digit sRGB. Pulihkan warna valid setelah pengamatan. Jika alat menerima masukan yang tidak sesuai tanpa penjelasan, periksa kembali kondisi pemeriksaannya. Jangan memperluas dukungan format hanya dengan menghapus validasi; perlu ada proses pembacaan nilai yang benar untuk setiap bentuk tambahan yang hendak Anda dukung.

Langkah 5: pakai hasil untuk memilih perubahan yang terukur

Jika pasangan belum memenuhi ambang yang dituju, coba ubah warna teks atau latarnya pada data latihan, lalu bandingkan hasil sebelum dan sesudah. Catat kedua pasangan agar keputusan desain dapat ditinjau. Jangan langsung mengubah seluruh palet situs hanya berdasarkan satu contoh. Sebuah warna dapat digunakan pada beberapa latar dan keadaan, sehingga setiap penggunaan penting perlu masuk daftar pemeriksaan. Teknik G18 membantu menempatkan pengukuran pada hubungan teks dengan latar yang berada tepat di belakangnya.

Sesudah pasangan dipilih, minta tim memeriksa penerapannya pada komponen yang nyata. Pastikan warna yang dihitung memang warna yang digunakan pada keadaan tersebut. Tinjau juga ukuran dan bentuk huruf, keterbacaan isi, serta keadaan interaksi yang relevan. Pemeriksaan ini melengkapi hasil angka; ia tidak dapat digantikan oleh label lulus pada satu baris terminal. Alat latihan memberi dasar pembicaraan yang konsisten, sementara pengalaman pengguna tetap membutuhkan peninjauan halaman dan alur yang sebenarnya.

Kesalahan umum dan verifikasi ulang sebelum serah-terima

Kesalahan yang perlu dicari ialah menghitung hanya satu kanal, membandingkan angka yang sudah dibulatkan, atau memasukkan kode dengan transparansi ke fungsi enam digit. Hindari pula menganggap rasio yang sama berarti dua desain mempunyai kenyamanan membaca yang identik. Gunakan pasangan acuan hitam-putih, putih-putih, serta abu-abu dekat ambang untuk memeriksa ulang setelah perubahan program. Simpan versi kode, pasangan masukan, dan hasil penuh agar rekan dapat mengulang pengamatan tanpa menebak data yang pernah dipakai.

Untuk membahas desain situs usaha, kunjungi JagoWeb https://www.jagoweb.com/ serta halaman Website Perusahaan https://www.jagoweb.com/website-perusahaan. Bawa daftar pasangan warna dan contoh komponen ketika berkonsultasi. Jelaskan bahwa hasil latihan hanya menghitung kontras dua warna padat dan belum merupakan audit aksesibilitas lengkap. Dengan batas yang jelas, Anda dapat meminta perubahan yang terukur, memeriksa hasilnya kembali, dan menjaga catatan keputusan desain yang mudah dipahami tim berikutnya.

Bacaan terkait

Sumber dan referensi

← Kembali ke semua insight
LANJUT BELAJAR

Bekal untuk ide berikutnya.

LANGKAH BERIKUTNYA UNTUK Jagoweb

Ide Anda punya tempat. Kita mulai bareng.

Mulai dari nama domain, website pertama, atau kebutuhan aplikasi. Ceritakan rencana Anda kepada tim Jagoweb.

Temukan pilihan Anda
Tim Jagoweb siap mendiskusikan kebutuhan Jagoweb