Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Tabs

    Tab untuk berpindah antar panel konten dengan navigasi keyboard sesuai WAI-ARIA.

    Change your account name and email.
    Change your account name and email.
    Change your account name and email.
    Change your account name and email.
    Change your account name and email.
    <x-markas.tabs :items="['account' => 'Account', 'password' => 'Password', 'notifications' => 'Notifications']" default-value="account">
        <x-slot:account>Change your account name and email.</x-slot:account>
        <x-slot:password>Change your password regularly.</x-slot:password>
        <x-slot:notifications>Choose which emails you want to receive.</x-slot:notifications>
    </x-markas.tabs>
    import { Tabs } from "@/components/markas/Tabs";
    
    const items = [
      {
        value: "account",
        label: "Account",
        content: "Change your account name and email.",
      },
      {
        value: "password",
        label: "Password",
        content: "Change your password regularly.",
      },
      {
        value: "notifications",
        label: "Notifications",
        content: "Choose which emails you want to receive.",
      },
    ];
    
    export default function TabsExample() {
      return <Tabs items={items} defaultValue="account" />;
    }
    <script setup lang="ts">
    import Tabs from "@/components/markas/Tabs.vue";
    
    const items = [
      { value: "account", label: "Account" },
      { value: "password", label: "Password" },
      { value: "notifications", label: "Notifications" },
    ];
    </script>
    
    <template>
      <Tabs :items="items" default-value="account">
        <template #account>Change your account name and email.</template>
        <template #password>Change your password regularly.</template>
        <template #notifications>Choose which emails you want to receive.</template>
      </Tabs>
    </template>
    <script lang="ts">
      import Tabs from "$lib/components/markas/Tabs.svelte";
    
      const items = [
        {
          value: "account",
          label: "Account",
          content: "Change your account name and email.",
        },
        {
          value: "password",
          label: "Password",
          content: "Change your password regularly.",
        },
        {
          value: "notifications",
          label: "Notifications",
          content: "Choose which emails you want to receive.",
        },
      ];
    </script>
    
    <Tabs {items} defaultValue="account" />
    ---
    import Tabs from "@/components/markas/Tabs.astro";
    
    const items = [
      { value: "account", label: "Account" },
      { value: "password", label: "Password" },
      { value: "notifications", label: "Notifications" },
    ];
    ---
    
    <Tabs items={items} defaultValue="account">
      <Fragment slot="account">Change your account name and email.</Fragment>
      <Fragment slot="password">Change your password regularly.</Fragment>
      <Fragment slot="notifications">Choose which emails you want to receive.</Fragment>
    </Tabs>
    import { Component } from "@angular/core";
    import { TabPanel, Tabs } from "./markas/tabs.component";
    
    @Component({
      selector: "markas-example",
      imports: [Tabs, TabPanel],
      template: `
        <markas-tabs [items]="items" defaultValue="account">
          <ng-template markasTabPanel="account"
            >Change your account name and email.</ng-template
          >
          <ng-template markasTabPanel="password"
            >Change your password regularly.</ng-template
          >
          <ng-template markasTabPanel="notifications"
            >Choose which emails you want to receive.</ng-template
          >
        </markas-tabs>
      `,
    })
    export default class TabsExample {
      protected readonly items = [
        { value: "account", label: "Account" },
        { value: "password", label: "Password" },
        { value: "notifications", label: "Notifications" },
      ];
    }

    Contoh

    Dalam card

    Visitors 12,480
    Sign-ups 342
    Conversion 2.7%
    Visitors12,480
    Sign-ups342
    Conversion2.7%
    Visitors12,480
    Sign-ups342
    Conversion2.7%
    Visitors 12,480
    Sign-ups 342
    Conversion 2.7%
    Visitors12,480
    Sign-ups342
    Conversion2.7%

    Dengan form

    Lebar penuh

    $12 per month Billed monthly. Cancel anytime.
    $12 per monthBilled monthly. Cancel anytime.
    $12 per monthBilled monthly. Cancel anytime.
    $12 per month Billed monthly. Cancel anytime.
    $12 per monthBilled monthly. Cancel anytime.

    Keadaan kosong

    No open issues New issues from your team will show up here.
    No open issuesNew issues from your team will show up here.
    No open issuesNew issues from your team will show up here.
    No open issues New issues from your team will show up here.
    No open issuesNew issues from your team will show up here.

    Instalasi

    npx markasui@latest add tabs

    Pemakaian

    <x-markas.tabs :items="['akun' => 'Akun', 'sandi' => 'Kata sandi']" default-value="akun">
        <x-slot:akun>Ubah nama dan email akun Anda.</x-slot:akun>
        <x-slot:sandi>Ganti kata sandi secara berkala.</x-slot:sandi>
    </x-markas.tabs>

    Butuh Alpine.js.

    import { Tabs } from "@/components/markas/Tabs";
    
    <Tabs
      defaultValue="akun"
      items={[
        { value: "akun", label: "Akun", content: "Ubah nama dan email akun Anda." },
        {
          value: "sandi",
          label: "Kata sandi",
          content: "Ganti kata sandi secara berkala.",
        },
      ]}
    />;
    <template>
      <Tabs
        default-value="akun"
        :items="[
          { value: 'akun', label: 'Akun' },
          { value: 'sandi', label: 'Kata sandi' },
        ]"
      >
        <template #akun>Ubah nama dan email akun Anda.</template>
        <template #sandi>Ganti kata sandi secara berkala.</template>
      </Tabs>
    </template>
    <script lang="ts">
      import Tabs from "$lib/components/markas/Tabs.svelte";
    
      let aktif = $state("akun");
      const items = [
        { value: "akun", label: "Akun", content: akun },
        {
          value: "sandi",
          label: "Kata sandi",
          content: "Ganti kata sandi secara berkala.",
        },
      ];
    </script>
    
    {#snippet akun()}
      <p>Ubah nama dan <strong>email</strong> akun Anda.</p>
    {/snippet}
    
    <Tabs {items} bind:value={aktif} />

    content berupa teks biasa atau snippet yang dideklarasikan di tingkat teratas template.

    ---
    import Tabs from "@/components/markas/Tabs.astro";
    
    const items = [
      { value: "akun", label: "Akun" },
      { value: "sandi", label: "Kata sandi" },
    ];
    ---
    
    <Tabs items={items} defaultValue="akun">
      <Fragment slot="akun">Ubah nama dan email akun Anda.</Fragment>
      <Fragment slot="sandi">Ganti kata sandi secara berkala.</Fragment>
    </Tabs>

    Script klien kecil menangani klik dan tombol panah. Tab yang dipilih memancarkan event markas-change (bubbling) dengan value-nya sebagai detail.

    import { Component, signal } from "@angular/core";
    import { TabPanel, Tabs } from "./markas/tabs.component";
    
    @Component({
      selector: "app-pengaturan",
      imports: [Tabs, TabPanel],
      template: `
        <markas-tabs [items]="items" [(value)]="aktif">
          <ng-template markasTabPanel="akun">
            Ubah nama dan email akun Anda.
          </ng-template>
          <ng-template markasTabPanel="sandi">
            Ganti kata sandi secara berkala.
          </ng-template>
        </markas-tabs>
      `,
    })
    export class Pengaturan {
      readonly aktif = signal("akun");
      readonly items = [
        { value: "akun", label: "Akun" },
        { value: "sandi", label: "Kata sandi" },
      ];
    }

    Setiap panel adalah <ng-template markasTabPanel="value">, jadi isinya baru dibuat saat Angular merender panel itu.

    • Key tab dipakai sebagai id dan nama slot, jadi pakai huruf kecil, angka, atau underscore saja.
    • Tabs tidak punya teks bawaan. Label tab berasal dari items, jadi isi langsung dalam Bahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    itemsBlade: array<key, label> · React and Svelte: { value, label, content }[] · Vue, Astro, Angular: { value, label }[][]Daftar tab. Di Blade, Vue, dan Astro, isi panel lewat slot dengan nama sama seperti key/value. Di Angular pakai <ng-template markasTabPanel="value">. Di Svelte, content berupa teks atau snippet.
    defaultValuestringfirst tabTab yang aktif saat pertama dirender.
    v-model / onValueChangestring-Vue memakai v-model, React memakai callback onValueChange.
    bind:valuestring-Khusus Svelte. Binding dua arah untuk tab aktif. Svelte juga menerima onValueChange.
    [(value)] / valueChangemodel<string>-Khusus Angular. Tab aktif dengan binding dua arah; valueChange terpancar setiap kali berubah.
    markas-changeCustomEvent<string>-Khusus Astro. Event yang menggelembung dari tab terpilih dengan value-nya sebagai detail.

    Aksesibilitas

    • Memakai role tablist, tab, dan tabpanel dengan aria-selected, aria-controls, dan aria-labelledby.
    • Panah kiri dan kanan berpindah tab (berputar di ujung), Home dan End ke tab pertama dan terakhir.
    • Hanya tab aktif yang masuk urutan Tab (roving tabindex), lalu Tab berikutnya masuk ke panel.

    Komponen terkait

    Komponen navigasi lain dengan class yang sama di setiap framework.