Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Toggle Group

    Grup tombol toggle bersegmen dengan pilihan tunggal atau ganda dan navigasi tombol panah antar item.

    <div class="flex justify-center">
        <x-markas.toggle-group
            label="Calendar view"
            value="week"
            :items="[
                ['value' => 'day', 'label' => 'Day'],
                ['value' => 'week', 'label' => 'Week'],
                ['value' => 'month', 'label' => 'Month'],
            ]"
        />
    </div>
    import { ToggleGroup } from "@/components/markas/ToggleGroup";
    
    export default function ToggleGroupExample() {
      return (
        <div className="flex justify-center">
          <ToggleGroup
            label="Calendar view"
            defaultValue="week"
            items={[
              { value: "day", label: "Day" },
              { value: "week", label: "Week" },
              { value: "month", label: "Month" },
            ]}
          />
        </div>
      );
    }
    <script setup lang="ts">
    import ToggleGroup from "@/components/markas/ToggleGroup.vue";
    </script>
    
    <template>
      <div class="flex justify-center">
        <ToggleGroup
          label="Calendar view"
          default-value="week"
          :items="[
            { value: 'day', label: 'Day' },
            { value: 'week', label: 'Week' },
            { value: 'month', label: 'Month' },
          ]"
        />
      </div>
    </template>
    <script lang="ts">
      import ToggleGroup from "$lib/components/markas/ToggleGroup.svelte";
    </script>
    
    <div class="flex justify-center">
      <ToggleGroup
        label="Calendar view"
        value="week"
        items={[
          { value: "day", label: "Day" },
          { value: "week", label: "Week" },
          { value: "month", label: "Month" },
        ]}
      />
    </div>
    ---
    import ToggleGroup from "@/components/markas/ToggleGroup.astro";
    ---
    
    <div class="flex justify-center">
      <ToggleGroup
        label="Calendar view"
        value="week"
        items={[
          { value: "day", label: "Day" },
          { value: "week", label: "Week" },
          { value: "month", label: "Month" },
        ]}
      />
    </div>
    import { Component } from "@angular/core";
    import { ToggleGroup } from "./markas/toggle-group.component";
    
    @Component({
      selector: "markas-example",
      imports: [ToggleGroup],
      template: `
        <div class="flex justify-center">
          <markas-toggle-group label="Calendar view" value="week" [items]="items" />
        </div>
      `,
    })
    export default class ToggleGroupFixture {
      protected readonly items = [
        { value: "day", label: "Day" },
        { value: "week", label: "Week" },
        { value: "month", label: "Month" },
      ];
    }

    Contoh

    Pilihan ganda

    Hanya ikon

    Ikon dengan teks

    Instalasi

    npx markasui@latest add toggle-group

    Pemakaian

    <x-markas.toggle-group
        label="Tampilan kalender"
        value="minggu"
        :items="[
            ['value' => 'hari', 'label' => 'Hari'],
            ['value' => 'minggu', 'label' => 'Minggu'],
            ['value' => 'bulan', 'label' => 'Bulan'],
        ]"
    />

    Butuh Alpine.js. Ganti label dengan ikon lewat slot bernama sesuai value, misalnya <x-slot:kiri>, dan isi ariaLabel di item tersebut.

    Livewire

    <x-markas.toggle-group label="View" wire:model.live="view" :items="$views" />

    wire:model terhubung ke string (atau null) untuk type="single" dan array untuk type="multiple".

    import { ToggleGroup } from "@/components/markas/ToggleGroup";
    
    <ToggleGroup
      label="Tampilan kalender"
      defaultValue="minggu"
      onValueChange={(value) => console.log(value)}
      items={[
        { value: "hari", label: "Hari" },
        { value: "minggu", label: "Minggu" },
        { value: "bulan", label: "Bulan" },
      ]}
    />;
    
    <ToggleGroup
      type="multiple"
      label="Gaya teks"
      defaultValue={["tebal"]}
      items={[
        {
          value: "tebal",
          label: <BoldIcon aria-hidden="true" />,
          ariaLabel: "Tebal",
        },
        {
          value: "miring",
          label: <ItalicIcon aria-hidden="true" />,
          ariaLabel: "Miring",
        },
      ]}
    />;
    <script setup lang="ts">
    import { ref } from "vue";
    import ToggleGroup from "@/components/markas/ToggleGroup.vue";
    
    const tampilan = ref("minggu");
    </script>
    
    <template>
      <ToggleGroup
        v-model="tampilan"
        label="Tampilan kalender"
        :items="[
          { value: 'hari', label: 'Hari' },
          { value: 'minggu', label: 'Minggu' },
          { value: 'bulan', label: 'Bulan' },
        ]"
      />
    </template>
    <script lang="ts">
      import ToggleGroup from "$lib/components/markas/ToggleGroup.svelte";
    
      let view = $state("week");
    </script>
    
    {#snippet leftIcon()}
      <svg
        viewBox="0 0 24 24"
        fill="none"
        stroke="currentColor"
        stroke-width="1.5"
        aria-hidden="true"><path d="M4 6h16M4 12h10M4 18h14" /></svg
      >
    {/snippet}
    
    <ToggleGroup
      bind:value={view}
      label="Tampilan kalender"
      items={[
        { value: "day", label: "Hari" },
        { value: "week", label: "Minggu" },
        { value: "month", label: "Bulan" },
      ]}
    />
    
    <ToggleGroup
      label="Perataan teks"
      value="left"
      items={[{ value: "left", label: leftIcon, ariaLabel: "Rata kiri" }]}
    />
    ---
    import ToggleGroup from "@/components/markas/ToggleGroup.astro";
    ---
    
    <ToggleGroup
      label="Tampilan kalender"
      value="week"
      items={[
        { value: "day", label: "Hari" },
        { value: "week", label: "Minggu" },
        { value: "month", label: "Bulan" },
      ]}
    />

    Ganti label dengan ikon lewat slot bernama sesuai value, misalnya <Fragment slot="left">. Script kecil di halaman menangani klik dan tombol panah.

    import { Component, signal } from "@angular/core";
    import {
      ToggleGroup,
      ToggleGroupItemTemplate,
    } from "./markas/toggle-group.component";
    
    @Component({
      selector: "app-kalender",
      imports: [ToggleGroup, ToggleGroupItemTemplate],
      template: `
        <markas-toggle-group
          [(value)]="view"
          label="Tampilan kalender"
          [items]="views"
        />
        <markas-toggle-group label="Perataan teks" value="left" [items]="align">
          <ng-template markasToggleGroupItem="left">
            <svg viewBox="0 0 24 24" aria-hidden="true">...</svg>
          </ng-template>
        </markas-toggle-group>
      `,
    })
    export class Kalender {
      readonly view = signal<string | string[]>("week");
      readonly views = [
        { value: "day", label: "Hari" },
        { value: "week", label: "Minggu" },
        { value: "month", label: "Bulan" },
      ];
      readonly align = [{ value: "left", label: "Kiri", ariaLabel: "Rata kiri" }];
    }
    • Single menghasilkan string, kosong kalau item yang ditekan diklik lagi. Multiple menghasilkan array urut sesuai item.
    • Value menjadi nama slot di Blade, Vue, dan Astro, jadi pakai hanya huruf kecil, angka, atau garis bawah.
    • Komponen ini tidak punya teks bawaan. Isi label dan label item dalam Bahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    items{ value, label, ariaLabel? }[][]Tombol di dalam grup. ariaLabel wajib kalau label hanya ikon. Blade, Vue, dan Astro bisa mengganti label lewat slot bernama sesuai value, Svelte menerima snippet sebagai label, Angular memakai ng-template dengan markasToggleGroupItem berisi value.
    type'single' | 'multiple''single'Single mengizinkan satu item ditekan, atau tidak ada. Multiple mengizinkan berapa pun.
    value / defaultValue / v-model / bind:valuestring | string[]-Item yang ditekan. String untuk single (kosong kalau tidak ada) dan array untuk multiple. Blade dan Astro memakai value, React value atau defaultValue, Vue v-model atau defaultValue, Svelte bind:value, Angular value atau [(value)].
    onValueChange(value: string | string[]) => void-Khusus React. Dipanggil dengan nilai baru setiap kali berubah, urut sesuai item untuk multiple.
    labelstring-Nama aksesibel grup, dipasang sebagai aria-label.

    Aksesibilitas

    • Wadah memiliki role group dan aria-label dari label, setiap item adalah button dengan aria-pressed.
    • Tab masuk ke grup sekali. Panah kiri dan kanan memindah fokus antar item (roving tabindex), Spasi dan Enter menekan item yang difokus.
    • Item berisi ikon saja wajib diberi ariaLabel agar setiap tombol punya nama.

    Komponen terkait

    Komponen form lain dengan class yang sama di setiap framework.