Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Label

    Label form dengan gaya konsisten serta penanda wajib atau opsional yang dibacakan screen reader dengan benar.

    <div class="grid gap-3">
        <x-markas.label required>Full name</x-markas.label>
        <x-markas.label optional>Company</x-markas.label>
        <x-markas.label>Email</x-markas.label>
    </div>
    import { Label } from "@/components/markas/Label";
    
    export default function LabelExample() {
      return (
        <div className="grid gap-3">
          <Label required>Full name</Label>
          <Label optional>Company</Label>
          <Label>Email</Label>
        </div>
      );
    }
    <script setup lang="ts">
    import Label from "@/components/markas/Label.vue";
    </script>
    
    <template>
      <div class="grid gap-3">
        <Label required>Full name</Label>
        <Label optional>Company</Label>
        <Label>Email</Label>
      </div>
    </template>
    <script lang="ts">
      import Label from "$lib/components/markas/Label.svelte";
    </script>
    
    <div class="grid gap-3">
      <Label required>Full name</Label>
      <Label optional>Company</Label>
      <Label>Email</Label>
    </div>
    ---
    import Label from "@/components/markas/Label.astro";
    ---
    
    <div class="grid gap-3">
      <Label required>Full name</Label>
      <Label optional>Company</Label>
      <Label>Email</Label>
    </div>
    import { Component } from "@angular/core";
    import { Label } from "./markas/label.component";
    
    @Component({
      selector: "markas-example",
      imports: [Label],
      template: `
        <div class="grid gap-3">
          <label markas-label required>Full name</label>
          <label markas-label optional>Company</label>
          <label markas-label>Email</label>
        </div>
      `,
    })
    export default class LabelExample {}

    Contoh

    Membungkus checkbox

    Opsi radio

    Delivery speed
    Delivery speed
    Delivery speed
    Delivery speed
    Delivery speed

    Kartu pilihan

    Instalasi

    npx markasui@latest add label

    Pemakaian

    <x-markas.label for="full_name" required required-label="wajib">Nama lengkap</x-markas.label>
    <input id="full_name" name="full_name" required />
    
    <x-markas.label for="company" optional optional-label="Opsional">Perusahaan</x-markas.label>
    <input id="company" name="company" />
    import { Label } from "@/components/markas/Label";
    
    <Label htmlFor="full_name" required requiredLabel="wajib">Nama lengkap</Label>
    <input id="full_name" name="full_name" required />
    
    <Label htmlFor="company" optional optionalLabel="Opsional">Perusahaan</Label>
    <input id="company" name="company" />
    <script setup lang="ts">
    import Label from "@/components/markas/Label.vue";
    </script>
    
    <template>
      <Label for="full_name" required required-label="wajib">Nama lengkap</Label>
      <input id="full_name" name="full_name" required />
    
      <Label for="company" optional optional-label="Opsional">Perusahaan</Label>
      <input id="company" name="company" />
    </template>
    <script lang="ts">
      import Label from "$lib/components/markas/Label.svelte";
    </script>
    
    <Label for="full_name" required requiredLabel="wajib">Nama lengkap</Label>
    <input id="full_name" name="full_name" required />
    
    <Label for="company" optional optionalLabel="Opsional">Perusahaan</Label>
    <input id="company" name="company" />
    ---
    import Label from "@/components/markas/Label.astro";
    ---
    
    <Label for="full_name" required requiredLabel="wajib">Nama lengkap</Label>
    <input id="full_name" name="full_name" required />
    
    <Label for="company" optional optionalLabel="Opsional">Perusahaan</Label>
    <input id="company" name="company" />
    import { Component } from "@angular/core";
    import { Label } from "./markas/label.component";
    
    @Component({
      selector: "app-profile-form",
      imports: [Label],
      template: `
        <label markas-label for="full_name" required requiredLabel="wajib"
          >Nama lengkap</label
        >
        <input id="full_name" name="full_name" required />
    
        <label markas-label for="company" optional optionalLabel="Opsional"
          >Perusahaan</label
        >
        <input id="company" name="company" />
      `,
    })
    export class ProfileForm {}

    Di Angular, Label adalah atribut pada <label> native, jadi for, id, dan class tetap di elemen itu.

    • Label tidak butuh JavaScript. Atribut tambahan dan class jatuh ke elemen <label>, dan class Anda ditaruh paling akhir.
    • Checkbox atau radio juga bisa dibungkus langsung di dalam label tanpa for: <Label class="flex items-center gap-2"><input type="checkbox" />Ingat saya</Label>.
    • Tanda bintang disembunyikan dari screen reader. Screen reader membacakan “Nama lengkap wajib” dari requiredLabel. Kalau required dan optional sama-sama aktif, required yang dipakai.
    • Teks bawaan berbahasa Inggris: requiredLabel (default “required”) dan optionalLabel (default “Optional”). Isi keduanya untuk situs berbahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    for / htmlForstring-Id kontrol form yang diberi nama oleh label ini. React memakai htmlFor. Di Angular, Label adalah atribut pada label native (<label markas-label for="...">).
    requiredbooleanfalseMenampilkan tanda bintang merah (disembunyikan dari screen reader) dan teks khusus screen reader dari requiredLabel. Lebih diutamakan daripada optional.
    optionalbooleanfalseMenampilkan teks redup dari optionalLabel setelah teks label.
    requiredLabelstringrequiredTeks screen reader untuk kolom wajib. Isi misalnya "wajib".
    optionalLabelstringOptionalTeks terlihat untuk kolom opsional. Isi misalnya "Opsional".

    Aksesibilitas

    • Merender elemen label native, jadi mengekliknya memfokuskan atau mengubah kontrol yang terhubung.
    • Tanda bintang memakai aria-hidden; status wajib dibacakan lewat teks khusus screen reader.
    • Teks opsional adalah bagian label, jadi ikut masuk nama aksesibel kontrol.

    Komponen terkait

    Komponen form lain dengan class yang sama di setiap framework.