Panel pengaturan tampilan
Tombol palet di bilah atas membuka panel pengaturan tampilan. Setiap perubahan langsung berlaku tanpa memuat ulang halaman. Opsi yang sama ada di halaman Pengaturan, pada bagian Tampilan.
| Opsi | Pilihan |
|---|---|
| Mode | Terang, Gelap, atau Sistem. Sistem mengikuti pengaturan sistem operasi, termasuk bila pengaturan itu berubah saat halaman terbuka. Tombol bulan / matahari di bilah atas langsung berganti antara terang dan gelap. |
| Tema | Selaras (toska & nila, bawaan), Azure, Orchid, Ember, dan Graphite. Grafik digambar ulang dengan warna baru. |
| Warna sidebar | Bawaan, Berwarna lembut, Merek, atau Gelap. Warnanya diturunkan dari tema yang aktif. |
| Ukuran sidebar | Lebar atau Ringkas (ikon saja). Berlaku di layar selebar 992 px atau lebih; di layar yang lebih kecil sidebar terbuka sebagai laci. Tombol di bagian atas sidebar juga bisa mengubahnya. |
| Kembalikan ke bawaan | Kembali ke Selaras, mode terang, warna sidebar Bawaan, dan sidebar lebar. |
Halaman tanpa sidebar — halaman masuk, halaman galat, dan toko — membuka panel yang sama tanpa dua opsi sidebar.
Tempat pilihan disimpan
Panel pengaturan tampilan menyimpan setiap pilihan di localStorage browser, jadi pilihan diingat per browser dan dipakai bersama oleh halaman Inggris dan Indonesia:
| Kunci | Nilai | Diterapkan sebagai |
|---|---|---|
sl-theme | selaras, azure, orchid, ember, graphite | data-sl-theme pada <html> |
sl-mode | light, dark, system | data-sl-mode pada <html> — selalu light atau dark; pilihan Sistem diterjemahkan dulu ke salah satunya |
sl-sidebar-color | default, tinted, brand, dark | data-sl-sidebar pada <html> |
sl-collapsed | 1 atau 0 | kelas sl-collapsed pada <html> |
Kalau browser memblokir penyimpanan (sebagian jendela privat melakukannya), panel pengaturan tampilan tetap berfungsi untuk halaman yang sedang dibuka; pilihannya saja yang tidak diingat.
Dipasang sebelum halaman tampil
Skrip kecil sebaris di src/partials/head.html membaca pilihan yang tersimpan dan memasang atributnya pada <html> sebelum stylesheet dimuat. Karena itu halaman tergambar dengan warna yang benar sejak bingkai pertama — tidak ada kilatan tema terang saat mode gelap aktif.
Kalau Anda memindahkan halaman ke backend atau framework sendiri, pertahankan skrip itu sebaris di <head>, sebelum stylesheet. Memuatnya belakangan, atau dari berkas terpisah dengan defer, memunculkan kilatan itu lagi.
Token warna
Semua warna di selaras.css berasal dari CSS custom property yang berawalan --sl-. Nilainya berbeda di mode terang dan gelap serta di setiap tema, jadi apa pun yang memakainya menyesuaikan diri secara otomatis. Yang paling sering Anda pakai:
| Token | Dipakai untuk |
|---|---|
--sl-canvas | Latar halaman di belakang kartu. |
--sl-surface, --sl-surface-2 | Kartu dan panel; permukaan yang sedikit berbeda untuk isian halus. |
--sl-line, --sl-line-strong | Garis tepi dan pemisah; garis tepi yang lebih tegas. |
--sl-ink, --sl-ink-2, --sl-ink-3 | Judul dan teks tebal; teks isi; teks sekunder. |
--sl-primary | Warna merek tema: grafik, ikon, cincin fokus. |
--sl-primary-strong | Latar tombol bertulisan putih. |
--sl-primary-text | Tautan dan teks aksen. |
--sl-primary-50, -100, -200 | Rona muda warna merek, dari yang samar sampai yang lebih kuat. |
--sl-secondary | Warna tema kedua: item menu aktif, seri grafik kedua. |
--sl-data-3, --sl-data-4 | Seri grafik ketiga dan keempat. |
--sl-success, --sl-warning, --sl-danger, --sl-info | Warna teks status, masing-masing dengan latar muda pasangannya, misalnya --sl-danger-50. |
--sl-r, --sl-r-lg, --sl-r-xl, --sl-r-sm | Kelengkungan sudut. |
--sl-shadow-xs, --sl-shadow-md | Bayangan. |
--sl-font | Jenis font. Font-nya sendiri (Plus Jakarta Sans) ada di assets/vendor/plus-jakarta-sans/ dan ditautkan di src/partials/head.html. |
Bootstrap mengikuti token yang sama: --bs-primary diisi --sl-primary-strong, sedangkan warna latar, teks, dan garis tepi body merujuk ke --sl-canvas, --sl-ink-2, dan --sl-line.
Bagian Warna di katalog komponen menampilkan token beserta nilainya pada tema dan mode yang aktif; klik sebuah contoh warna untuk menyalinnya sebagai var(--sl-…).
Mengubah warna merek
Setiap tema ditentukan oleh beberapa warna dasar di bagian atas assets/css/selaras.css; rona dan warna sidebar diracik dari warna-warna itu. Untuk memberi template warna merek Anda, sunting blok tema bawaan, :root, [data-sl-theme="selaras"], dan blok mode gelapnya lebih ke bawah:
| Warna dasar | Peran |
|---|---|
--sl-primary | Warna merek. |
--sl-primary-strong | Warna yang lebih gelap untuk tombol — teks putih di atasnya butuh kontras minimal 4,5:1. |
--sl-primary-hover | Warna tombol saat disorot kursor. Di mode terang, ini juga warna tautan dan teks aksen. |
--sl-rgb-strong | Warna yang sama dengan --sl-primary-strong, ditulis sebagai angka R, G, B untuk --bs-primary-rgb milik Bootstrap. |
--sl-secondary | Warna kedua. |
--sl-data-3, --sl-data-4 | Warna grafik ketiga dan keempat. |
--sl-tint-a, --sl-tint-b | Latar pucat kartu KPI di mode terang (a = keluarga warna kedua, b = keluarga warna utama). |
--sl-side-brand | Latar gelap untuk gaya sidebar Merek dan panel merek halaman masuk. |
Di blok mode gelap, beri --sl-primary, --sl-secondary, dan warna data nilai yang lebih terang agar tetap terbaca di latar gelap; rona untuk mode gelap dihitung otomatis. Tulis setiap warna dasar sebagai nilai hex enam digit (#RRGGBB): grafik dan pemeriksaan kontras membacanya dalam bentuk itu.
Lalu perbarui nama dan keterangan tema di daftar THEMES dalam build.mjs (di panel pengaturan tampilan tertulis “Teal & indigo · default”, di versi Indonesia “Toska & nila · bawaan”), rakit ulang, dan jalankan pemeriksaan kontras.
Menambah tema sendiri
- Di
assets/css/selaras.css, tambahkan blok berisi warna dasar di dekat blok tema lainnya, dan blok mode gelap di dekat blok gelap lainnya. Pakai nama yang hanya terdiri dari huruf kecil. - Tambahkan tema ke
THEMESdibuild.mjs. Langkah ini menambahkan ubinnya, lengkap dengan pratinjau kecil dalam warnanya, ke panel pengaturan tampilan dan halaman Pengaturan. - Tambahkan nama yang sama ke daftar
THEMESdiassets/js/selaras.js. Tanpanya, memilih ubin itu malah kembali ke tema bawaan. - Jalankan
node build.mjs, lalupython tools/check-contrast.py.
/* assets/css/selaras.css — next to the other theme blocks */
[data-sl-theme="forest"] {
--sl-primary: #2E8540; --sl-primary-strong: #23733A; --sl-primary-hover: #1B5E2F;
--sl-secondary: #9C5B12;
--sl-data-3: #2E90FA; --sl-data-4: #E5B22E;
--sl-tint-a: #F6EEE3; --sl-tint-b: #E3F1E6;
--sl-side-brand: #16301F;
--sl-rgb-strong: 35, 115, 58;
}
/* next to the other dark blocks; the second selector colors the preview tile in dark mode */
[data-sl-mode="dark"][data-sl-theme="forest"], [data-sl-mode="dark"] [data-sl-theme="forest"] {
--sl-primary: #5CC274; --sl-primary-hover: #2E8540;
--sl-secondary: #E0A458; --sl-data-3: #62ADFB; --sl-data-4: #EFC556;
} const THEMES = [
{ key: 'selaras', name: 'Selaras', note: 'Teal & indigo · default' },
…
{ key: 'forest', name: 'Forest', note: 'Green & copper' },
]; var THEMES = ['selaras', 'azure', 'orchid', 'ember', 'graphite', 'forest']; Warna contoh di atas lolos pemeriksaan kontras di kedua mode. Nama dan keterangan tema tampil dalam bahasa Inggris di halaman Indonesia sampai Anda menambahkannya ke kamus.
Memeriksa kontras
tools/check-contrast.py membaca warna tema langsung dari selaras.css dan memeriksa setiap pasangan teks dan latar yang penting terhadap tingkat kontras WCAG AA: 4,5:1 untuk teks, 3:1 untuk ikon dan warna grafik, dan 7:1 untuk judul di atas rona KPI. Semua tema diperiksa di mode terang dan gelap, keempat gaya sidebar, dan panel merek halaman masuk. Yang dibutuhkan hanya Python 3, tanpa paket tambahan:
python tools/check-contrast.py Skrip ini mencetak satu baris per tema dan mode (PASS = lolos, FAIL = gagal), mencantumkan setiap pasangan yang gagal beserta rasio terukurnya, dan keluar dengan kode 1 bila ada yang gagal, jadi bisa juga dijalankan di pipeline perakitan.
Teks putih di tombol gagal: gelapkan --sl-primary-strong. Tautan atau teks aksen gagal di mode terang: gelapkan --sl-primary-hover. Teks di sidebar Merek atau panel halaman masuk gagal: gelapkan --sl-side-brand. Sebuah warna gagal di mode gelap: buat lebih terang di blok gelap tema itu.
Mode gelap di komponen buatan sendiri
Beri gaya komponen buatan Anda dengan token, bukan warna tetap, maka komponen itu mengikuti tema dan mode tanpa kerja tambahan. Beri kelas Anda awalan sendiri — sl- khusus untuk template.
.acme-panel {
background: var(--sl-surface);
border: 1px solid var(--sl-line);
border-radius: var(--sl-r-lg);
color: var(--sl-ink-2);
}
.acme-panel h3 { color: var(--sl-ink); }
.acme-panel .acme-tag { background: var(--sl-primary-50); color: var(--sl-primary-text); }
/* only for a value that must differ in dark mode */
[data-sl-mode="dark"] .acme-panel { box-shadow: none; } Kode yang membaca warna lewat JavaScript — untuk canvas, peta, atau pustaka grafik — harus membacanya ulang saat tema atau mode berubah. Pantau dua atribut pada <html>:
var root = document.documentElement;
var paint = function () {
var primary = getComputedStyle(root).getPropertyValue('--sl-primary').trim();
// draw with the current color
};
paint();
new MutationObserver(paint).observe(root, { attributes: true, attributeFilter: ['data-sl-theme', 'data-sl-mode'] }); Untuk ApexCharts di halaman dasbor dan aplikasi, pakai pembantu grafik dari selaras.js. Grafik yang digambar dengan window.slChart.draw() otomatis digambar ulang dengan warna baru; fungsi yang Anda berikan mengembalikan opsi grafik dan dipanggil lagi setiap kali ada perubahan:
window.slChart.draw('#acmeChart', function () {
var C = window.slChart.colors(); // current theme colors
return window.slChart.merge(window.slChart.base(), {
chart: { type: 'area', height: 260 },
colors: [C.primary, C.secondary],
series: [{ name: 'Visits', data: [120, 180, 150, 220, 260] }],
xaxis: { categories: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri'] }
});
}); Mengubah tema bawaan
Bawaan adalah tampilan yang dilihat pengunjung sebelum memilih apa pun, sekaligus tujuan tombol Kembalikan ke bawaan. Pilihan yang sudah tersimpan di browser tetap menang, jadi hapus kunci sl- dari localStorage (atau pakai tombol pengembalian itu) untuk melihat bawaan yang baru. Untuk memulai dengan tema lain, misalnya azure:
| Berkas | Yang diubah |
|---|---|
src/layout*.html | data-sl-theme="selaras" pada tag <html> di keempat kerangka halaman. |
assets/js/selaras.js | Nilai cadangan 'selaras' di applyTheme dan di panggilan markTheme(…) di bawahnya, serta applyTheme('selaras') di penangan [data-theme-reset]. |
build.mjs | t.key === 'selaras' di themeHtml, agar ubin yang benar sudah ditandai sebelum skrip berjalan. |
Untuk memulai dalam mode gelap atau mengikuti sistem, ganti nilai cadangan 'light' di src/partials/head.html (localStorage.getItem('sl-mode') || 'light'), di modePref dalam selaras.js, dan setMode('light') di penangan reset menjadi 'dark' atau 'system'. Warna sidebar diatur dengan cara yang sama: data-sl-sidebar di kerangka halaman, nilai cadangan 'default' di sekitar setSidebarColor, dan setSidebarColor('default') di penangan reset.
Rakit ulang sesudah mengubah kerangka halaman, potongan bersama, atau build.mjs.