Proyek komunitas. Ini bukan situs resmi pemerintah.

Dikelola sukarelawan. Lampung Design System dibangun oleh komunitas open source. Tidak ada instansi pemerintah yang mengelola atau mendukungnya secara resmi.

Layanan resmi memakai go.id. Situs pemerintah Indonesia berakhiran .go.id. Jangan masukkan NIK di situs yang Anda ragukan.

Switch

Switch

Kontrol nyala dan mati untuk pengaturan yang berlaku saat itu juga ketika diubah, tanpa tombol Simpan. Thumb meregang selama ditahan dan berpindah dengan spring.

Penggunaan

Pakai saat

  • Pengaturan yang langsung berlaku: notifikasi, suara, dark mode, tampilkan timer saat ujian.
  • Daftar pengaturan di ponsel (switch kecil di akhir baris daftar).
  • Menyalakan fitur dengan penjelasan singkat di bawah label (.switch__text dengan small).

Pakai yang lain saat

  • Pilihan yang disimpan nanti bersama formulir: pakai Checkbox. Switch menyiratkan efek langsung.
  • Memilih di antara dua status bernama (Terang, Gelap; Daftar, Grid): pakai Segmented control.
  • Status tertekan pada tombol toolbar (tebal, bisukan): pakai Toggle.
  • Menyetujui syarat: pakai Checkbox.
  • Beberapa filter yang berlaku bersama: pakai Chips.

Letaknya. Di pengaturan: satu per baris dalam kolom, atau di akhir .lrow di list inset pada ponsel (pakai switch--sm di sana). Di layar lebar dekatkan label dengan switch; jangan pernah menaruh switch di ujung kanan baris yang sangat lebar dengan label di ujung kiri.

Contoh

Dengan penjelasanTekan dan tahan: thumb melebar ke arah tujuannya, lalu berpindah dengan spring halus dan meregang sekali saat mendarat.
<div class="stack" style="--gap: 16px;">
  <label class="switch"><input type="checkbox" role="switch" checked><span class="switch__track" aria-hidden="true"><span class="switch__thumb"></span></span><span class="switch__text">Pengingat jadwal layanan<small>15 menit sebelum jadwal kunjungan Anda</small></span></label>
  <label class="switch"><input type="checkbox" role="switch"><span class="switch__track" aria-hidden="true"><span class="switch__thumb"></span></span><span class="switch__text">Tampilkan nomor antrean di layar kunci<small>Sembunyikan jika Anda berbagi ponsel</small></span></label>
  <label class="switch"><input type="checkbox" role="switch" disabled><span class="switch__track" aria-hidden="true"><span class="switch__thumb"></span></span><span class="switch__text">Sinkronkan dengan kalender kantor<small>Minta admin dinas untuk mengaktifkannya</small></span></label>
</div>
Baris pengaturan di ponselBaris daftar adalah labelnya, jadi mengetuk di mana saja pada baris mengubah switch kecil di ujungnya.
<div class="list list--fill" style="max-width: 380px; width: 100%;">
  <label class="lrow lrow--icon"><span class="lrow__icon" style="background: var(--tile-red);"><span class="ic" aria-hidden="true">notifications</span></span><span class="lrow__body"><span class="lrow__title">Pengingat jadwal</span></span><span class="switch switch--sm"><input type="checkbox" role="switch" checked><span class="switch__track" aria-hidden="true"><span class="switch__thumb"></span></span></span></label>
  <label class="lrow lrow--icon"><span class="lrow__icon" style="background: var(--tile-blue);"><span class="ic" aria-hidden="true">touch_app</span></span><span class="lrow__body"><span class="lrow__title">Getar saat disentuh</span></span><span class="switch switch--sm"><input type="checkbox" role="switch"><span class="switch__track" aria-hidden="true"><span class="switch__thumb"></span></span></span></label>
</div>

Anatomi

BagianFungsinya
label.switchWajib. Membungkus input, lintasan, dan teks; seluruh baris mengubahnya. Pakai <span class="switch"> saat barisnya (label.lrow) yang menjadi label.
input[type=checkbox][role=switch]Wajib. Checkbox bawaan yang diumumkan sebagai switch, tak terlihat di atas lintasan.
.switch__trackWajib. 51 kali 31, abu-abu saat mati, aksen saat menyala. aria-hidden.
.switch__thumbWajib. Thumb putih 27 px di dalam lintasan.
.switch__textOpsional. Teks label dengan baris kedua small yang menjelaskan efeknya.

Varian dan ukuran

Kelas atau atributKapan
switch (default)51 kali 31, untuk halaman pengaturan dan formulir.
switch--sm38 kali 23, untuk baris daftar dan panel padat.

Status

StatusCaranya
on (checked)Lintasan aksen (memudar masuk di atas abu-abu), thumb berpindah ke kanan.
:active (held)Thumb melebar 6 px (4 px untuk ukuran kecil) ke arah tujuannya.
.is-flipDitambahkan JS di setiap perubahan: thumb meregang sekali saat mendarat.
focus-visibleFocus ring di sekitar lintasan.
disabledLintasan dengan opasitas 40 %; sebutkan alasannya di baris small.

Gerak dan mikrointeraksi

  • Perpindahan: thumb bergerak dengan transform memakai --spring-smooth (560 ms); lapisan aksen memudar dalam --d-standard (240 ms) dengan --ease-standard, warna lintasan dalam --d-fast.
  • Tahan: lebar bertambah 6 px dengan --spring-snappy (360 ms); melepas di tengah perjalanan mengarahkan ulang dari posisinya saat itu.
  • Mendarat: lds-stretch menskalakan thumb ke 1.16 kali 0.94 lalu kembali dalam 340 ms dengan --ease-standard, apa pun yang mengubahnya (ketuk, tombol keyboard, klik label, kode).
  • Dengan ikon lonceng di dalam label, lonceng berbunyi sekali saat dinyalakan (bell).
  • Reduced motion: transisi menjadi 120 ms linear dan efek regang dilewati.

Aksesibilitas

  • <input type="checkbox" role="switch"> diumumkan sebagai "switch, nyala" atau "mati"; Spasi mengubahnya. Jangan pernah membangun switch dari div.
  • Teks yang terlihat adalah namanya. Di baris daftar, label.lrow adalah label untuk input di dalamnya.
  • Perubahan langsung berlaku; jika bisa gagal (panggilan ke server), kembalikan switch dan jelaskan di toast.

Lakukan dan hindari

Lakukan

  • Labeli pengaturannya, bukan aksinya: "Pengingat jadwal", bukan "Nyalakan pengingat".
  • Terapkan langsung dan tunjukkan hasilnya jika tidak jelas.

Hindari

  • Menaruh switch di formulir yang punya tombol Simpan.
  • Mengubah teks label sesuai status ("Nyala" atau "Mati"); switch sudah menunjukkannya.
  • Memakai switch untuk dua opsi bernama; pakai segmented control.

Perilaku dan kode

HTML biasa. Otomatis untuk setiap .switch input: saat berubah ia menambahkan .is-flip untuk regangan saat mendarat (dan membunyikan .bell di dalamnya saat dinyalakan). Tidak perlu data-lds-*.

React. Dari lampung-design-system/react.

import { Switch } from 'lampung-design-system/react';

<Switch checked={reminders} onChange={setReminders} sub="15 menit sebelum jadwal kunjungan Anda">
  Pengingat jadwal
</Switch>
<Switch size="sm" checked={haptics} onChange={setHaptics}>Getar saat disentuh</Switch>