EN

Tema & tampilan

Mode terang dan gelap, lima tema warna, empat gaya sidebar — serta cara mengubah warnanya atau menambah tema sendiri.

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.

OpsiPilihan
ModeTerang, 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.
TemaSelaras (toska & nila, bawaan), Azure, Orchid, Ember, dan Graphite. Grafik digambar ulang dengan warna baru.
Warna sidebarBawaan, Berwarna lembut, Merek, atau Gelap. Warnanya diturunkan dari tema yang aktif.
Ukuran sidebarLebar 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 bawaanKembali 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:

KunciNilaiDiterapkan sebagai
sl-themeselaras, azure, orchid, ember, graphitedata-sl-theme pada <html>
sl-modelight, dark, systemdata-sl-mode pada <html> — selalu light atau dark; pilihan Sistem diterjemahkan dulu ke salah satunya
sl-sidebar-colordefault, tinted, brand, darkdata-sl-sidebar pada <html>
sl-collapsed1 atau 0kelas 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:

TokenDipakai untuk
--sl-canvasLatar halaman di belakang kartu.
--sl-surface, --sl-surface-2Kartu dan panel; permukaan yang sedikit berbeda untuk isian halus.
--sl-line, --sl-line-strongGaris tepi dan pemisah; garis tepi yang lebih tegas.
--sl-ink, --sl-ink-2, --sl-ink-3Judul dan teks tebal; teks isi; teks sekunder.
--sl-primaryWarna merek tema: grafik, ikon, cincin fokus.
--sl-primary-strongLatar tombol bertulisan putih.
--sl-primary-textTautan dan teks aksen.
--sl-primary-50, -100, -200Rona muda warna merek, dari yang samar sampai yang lebih kuat.
--sl-secondaryWarna tema kedua: item menu aktif, seri grafik kedua.
--sl-data-3, --sl-data-4Seri grafik ketiga dan keempat.
--sl-success, --sl-warning, --sl-danger, --sl-infoWarna teks status, masing-masing dengan latar muda pasangannya, misalnya --sl-danger-50.
--sl-r, --sl-r-lg, --sl-r-xl, --sl-r-smKelengkungan sudut.
--sl-shadow-xs, --sl-shadow-mdBayangan.
--sl-fontJenis 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 dasarPeran
--sl-primaryWarna merek.
--sl-primary-strongWarna yang lebih gelap untuk tombol — teks putih di atasnya butuh kontras minimal 4,5:1.
--sl-primary-hoverWarna tombol saat disorot kursor. Di mode terang, ini juga warna tautan dan teks aksen.
--sl-rgb-strongWarna yang sama dengan --sl-primary-strong, ditulis sebagai angka R, G, B untuk --bs-primary-rgb milik Bootstrap.
--sl-secondaryWarna kedua.
--sl-data-3, --sl-data-4Warna grafik ketiga dan keempat.
--sl-tint-a, --sl-tint-bLatar pucat kartu KPI di mode terang (a = keluarga warna kedua, b = keluarga warna utama).
--sl-side-brandLatar 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

  1. 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.
  2. Tambahkan tema ke THEMES di build.mjs. Langkah ini menambahkan ubinnya, lengkap dengan pratinjau kecil dalam warnanya, ke panel pengaturan tampilan dan halaman Pengaturan.
  3. Tambahkan nama yang sama ke daftar THEMES di assets/js/selaras.js. Tanpanya, memilih ubin itu malah kembali ke tema bawaan.
  4. Jalankan node build.mjs, lalu python tools/check-contrast.py.
CSS
/* 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;
}
build.mjs
const THEMES = [
  { key: 'selaras',  name: 'Selaras',  note: 'Teal & indigo · default' },
  …
  { key: 'forest',   name: 'Forest',   note: 'Green & copper' },
];
assets/js/selaras.js
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:

Terminal
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.

Perbaikan yang lazim

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.

CSS
.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>:

JavaScript
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:

JavaScript
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:

BerkasYang diubah
src/layout*.htmldata-sl-theme="selaras" pada tag <html> di keempat kerangka halaman.
assets/js/selaras.jsNilai cadangan 'selaras' di applyTheme dan di panggilan markTheme(…) di bawahnya, serta applyTheme('selaras') di penangan [data-theme-reset].
build.mjst.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.