Tombol dua keadaan dengan aria-pressed untuk opsi seperti tebal atau tandai, dalam varian default dan outline serta tiga ukuran.
<div class="flex items-center justify-center gap-2">
<x-markas.toggle aria-label="Bold" pressed><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M7 5h6a3.5 3.5 0 0 1 0 7H7zm0 7h7a3.5 3.5 0 0 1 0 7H7z" /></svg></x-markas.toggle>
<x-markas.toggle aria-label="Italic"><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 4h9M5 20h9M15 4 9 20" /></svg></x-markas.toggle>
<x-markas.toggle variant="outline"><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6 4h12v16l-6-4-6 4z" /></svg>Bookmark</x-markas.toggle>
</div>Contoh
Varian
<div class="grid gap-4">
<div class="flex items-center justify-center gap-2">
<x-markas.toggle>Wrap lines</x-markas.toggle>
<x-markas.toggle pressed>Show grid</x-markas.toggle>
</div>
<div class="flex items-center justify-center gap-2">
<x-markas.toggle variant="outline">Subscribe</x-markas.toggle>
<x-markas.toggle variant="outline" pressed>Following</x-markas.toggle>
</div>
</div>Ukuran
<div class="flex items-center justify-center gap-2">
<x-markas.toggle variant="outline" size="sm"><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2-5.5-2.9-5.5 2.9 1-6.2L3 9.6l6.2-.9z" /></svg>Small</x-markas.toggle>
<x-markas.toggle variant="outline" size="md" pressed><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2-5.5-2.9-5.5 2.9 1-6.2L3 9.6l6.2-.9z" /></svg>Medium</x-markas.toggle>
<x-markas.toggle variant="outline" size="lg"><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1 6.2-5.5-2.9-5.5 2.9 1-6.2L3 9.6l6.2-.9z" /></svg>Large</x-markas.toggle>
</div>Toolbar format
<div class="flex items-center justify-center">
<div role="group" aria-label="Formatting" class="flex items-center gap-1 rounded-lg border border-line bg-surface p-1">
<x-markas.toggle size="sm" aria-label="Bold" pressed><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M7 5h6a3.5 3.5 0 0 1 0 7H7zm0 7h7a3.5 3.5 0 0 1 0 7H7z" /></svg></x-markas.toggle>
<x-markas.toggle size="sm" aria-label="Italic"><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 4h9M5 20h9M15 4 9 20" /></svg></x-markas.toggle>
<x-markas.toggle size="sm" aria-label="Underline"><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M7 4v7a5 5 0 0 0 10 0V4M5 20h14" /></svg></x-markas.toggle>
<x-markas.toggle size="sm" aria-label="Strikethrough" disabled><svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M5 12h14M16 6.5A4 4 0 0 0 12 5h-1a3.5 3.5 0 0 0 0 7h2a3.5 3.5 0 0 1 0 7h-1a4 4 0 0 1-4-1.5" /></svg></x-markas.toggle>
</div>
</div>Instalasi
npx markasui@latest add togglepnpm dlx markasui@latest add toggleyarn dlx markasui@latest add togglebunx --bun markasui@latest add toggle- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Pasang dependensi:
npm install alpinejs - Salin source komponen di bawah ini ke
resources/views/components/markas/toggle.blade.php.
resources/views/components/markas/toggle.blade.php
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Toggle.tsx.
src/components/markas/Toggle.tsx
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Toggle.vue.
src/components/markas/Toggle.vue
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/lib/components/markas/Toggle.svelte.
src/lib/components/markas/Toggle.svelte
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Toggle.astro.
src/components/markas/Toggle.astro
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/app/markas/toggle.component.ts.
src/app/markas/toggle.component.ts
Pemakaian
<x-markas.toggle aria-label="Tebal" pressed>
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M7 5h6a3.5 3.5 0 0 1 0 7H7zm0 7h7a3.5 3.5 0 0 1 0 7H7z" /></svg>
</x-markas.toggle>
<x-markas.toggle variant="outline">Tandai</x-markas.toggle>Butuh Alpine.js.
Livewire
<x-markas.toggle wire:model.live="bold" aria-label="Bold">B</x-markas.toggle>wire:model terhubung ke status ditekan sebagai boolean.
import { Toggle } from "@/components/markas/Toggle";
<Toggle aria-label="Tebal" defaultPressed onPressedChange={setTebal}>
<BoldIcon aria-hidden="true" />
</Toggle>;
<Toggle variant="outline">Tandai</Toggle>;<script setup lang="ts">
import { ref } from "vue";
import Toggle from "@/components/markas/Toggle.vue";
const tebal = ref(true);
</script>
<template>
<Toggle v-model="tebal" aria-label="Tebal">
<BoldIcon aria-hidden="true" />
</Toggle>
<Toggle variant="outline">Tandai</Toggle>
</template><script lang="ts">
import Toggle from "$lib/components/markas/Toggle.svelte";
let tebal = $state(true);
</script>
<Toggle bind:pressed={tebal} aria-label="Tebal">
<svg
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="1.5"
aria-hidden="true"
><path d="M7 5h6a3.5 3.5 0 0 1 0 7H7zm0 7h7a3.5 3.5 0 0 1 0 7H7z" /></svg
>
</Toggle>
<Toggle variant="outline">Tandai</Toggle>---
import Toggle from "@/components/markas/Toggle.astro";
---
<Toggle variant="outline" pressed>Tandai</Toggle>Script kecil di halaman membalik aria-pressed dan data-state saat diklik.
import { Component, signal } from "@angular/core";
import { Toggle } from "./markas/toggle.component";
@Component({
selector: "app-penyunting",
imports: [Toggle],
template: `
<button markas-toggle [(pressed)]="tebal" aria-label="Tebal">B</button>
<button markas-toggle variant="outline">Tandai</button>
`,
})
export class Penyunting {
readonly tebal = signal(true);
}- Toggle adalah
<button aria-pressed>. Tampilannya mengikutidata-state="on"atau"off". - Ikon di dalamnya otomatis berukuran
size-4. Toggle yang hanya berisi ikon wajib diberiaria-label. - Komponen ini tidak punya teks bawaan. Cukup isi konten dan
aria-labeldalam Bahasa Indonesia.
Props
| Nama | Tipe | Default | Keterangan |
|---|---|---|---|
variant | 'default' | 'outline' | 'default' | Tampilan toggle. Outline menambahkan border dan latar surface. |
size | 'sm' | 'md' | 'lg' | 'md' | Tinggi 32, 36, atau 40px. Lebar minimum sama dengan tinggi untuk toggle berisi ikon saja. |
pressed / defaultPressed / v-model / bind:pressed | boolean | false | Keadaan ditekan. Blade dan Astro memakai pressed, React pressed atau defaultPressed, Vue v-model atau defaultPressed, Svelte bind:pressed, Angular pressed atau [(pressed)]. |
onPressedChange | (pressed: boolean) => void | - | Khusus React. Dipanggil dengan keadaan baru setiap kali diklik. |
pressedChange | output<boolean> | - | Khusus Angular. Memancarkan keadaan baru setiap kali diklik. |
disabled | boolean | false | Menonaktifkan toggle. |
Aksesibilitas
- Button native dengan aria-pressed, sehingga screen reader membacakannya sebagai tombol toggle yang ditekan atau tidak.
- Spasi dan Enter mengubah keadaan secara native.
- Toggle yang hanya berisi ikon wajib diberi aria-label, dan ikonnya aria-hidden.
Komponen terkait
Komponen form lain dengan class yang sama di setiap framework.
- ButtonTombol dengan varian primary, secondary, ghost, dan danger.
- CheckboxKotak centang native dengan label dan deskripsi opsional, tampilan kustom tanpa JavaScript.
- ComboboxInput teks dengan daftar saran terfilter di popover, mengikuti pola WAI-ARIA Combobox dengan autocomplete list.
- InputKolom teks dengan label, petunjuk, dan pesan error yang terhubung lewat ARIA.
- Input OTPInput kode sekali pakai yang dipecah menjadi kotak satu digit, dengan maju otomatis, dukungan tempel, dan satu input tersembunyi untuk submit form.
- LabelLabel form dengan gaya konsisten serta penanda wajib atau opsional yang dibacakan screen reader dengan benar.