Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Popover

    Panel mengambang non-modal berbasis Popover API untuk form kecil dan detail tambahan, menempel pada tombol pemicu.

    <x-markas.popover label="Share">
        <div class="grid gap-3">
            <div class="grid gap-1">
                <p class="font-medium text-ink">Share project</p>
                <p class="text-muted">Anyone with the link can view this project.</p>
            </div>
            <x-markas.button size="sm">Copy link</x-markas.button>
        </div>
    </x-markas.popover>
    import { Button } from "@/components/markas/Button";
    import { Popover } from "@/components/markas/Popover";
    
    export default function PopoverExample() {
      return (
        <Popover label="Share">
          <div className="grid gap-3">
            <div className="grid gap-1">
              <p className="font-medium text-ink">Share project</p>
              <p className="text-muted">
                Anyone with the link can view this project.
              </p>
            </div>
            <Button size="sm">Copy link</Button>
          </div>
        </Popover>
      );
    }
    <script setup lang="ts">
    import Button from "@/components/markas/Button.vue";
    import Popover from "@/components/markas/Popover.vue";
    </script>
    
    <template>
      <Popover label="Share">
        <div class="grid gap-3">
          <div class="grid gap-1">
            <p class="font-medium text-ink">Share project</p>
            <p class="text-muted">Anyone with the link can view this project.</p>
          </div>
          <Button size="sm">Copy link</Button>
        </div>
      </Popover>
    </template>
    <script lang="ts">
      import Button from "$lib/components/markas/Button.svelte";
      import Popover from "$lib/components/markas/Popover.svelte";
    </script>
    
    <Popover label="Share">
      <div class="grid gap-3">
        <div class="grid gap-1">
          <p class="font-medium text-ink">Share project</p>
          <p class="text-muted">Anyone with the link can view this project.</p>
        </div>
        <Button size="sm">Copy link</Button>
      </div>
    </Popover>
    ---
    import Button from "@/components/markas/Button.astro";
    import Popover from "@/components/markas/Popover.astro";
    ---
    
    <Popover label="Share">
      <div class="grid gap-3">
        <div class="grid gap-1">
          <p class="font-medium text-ink">Share project</p>
          <p class="text-muted">Anyone with the link can view this project.</p>
        </div>
        <Button size="sm">Copy link</Button>
      </div>
    </Popover>
    import { Component } from "@angular/core";
    import { Button } from "./markas/button.component";
    import { Popover } from "./markas/popover.component";
    
    @Component({
      selector: "markas-example",
      imports: [Button, Popover],
      template: `
        <markas-popover label="Share">
          <div class="grid gap-3">
            <div class="grid gap-1">
              <p class="font-medium text-ink">Share project</p>
              <p class="text-muted">Anyone with the link can view this project.</p>
            </div>
            <button markas-button size="sm">Copy link</button>
          </div>
        </markas-popover>
      `,
    })
    export default class PopoverExample {}

    Contoh

    Dengan form

    Pemicu ikon rata kanan

    Inbox

    Inbox

    Inbox

    Inbox

    Inbox

    Di atas pemicu

    Instalasi

    npx markasui@latest add popover

    Pemakaian

    <x-markas.popover label="Bagikan">
        <div class="grid gap-3">
            <p class="text-muted">Siapa pun yang punya link bisa melihat proyek ini.</p>
            <x-markas.button size="sm">Salin link</x-markas.button>
        </div>
    </x-markas.popover>

    Butuh Alpine.js.

    import { Button } from "@/components/markas/Button";
    import { Popover } from "@/components/markas/Popover";
    
    <Popover label="Bagikan" align="end">
      <div className="grid gap-3">
        <p className="text-muted">
          Siapa pun yang punya link bisa melihat proyek ini.
        </p>
        <Button size="sm">Salin link</Button>
      </div>
    </Popover>;
    <template>
      <Popover label="Bagikan" side="top">
        <div class="grid gap-3">
          <p class="text-muted">
            Siapa pun yang punya link bisa melihat proyek ini.
          </p>
          <Button size="sm">Salin link</Button>
        </div>
      </Popover>
    </template>
    <script lang="ts">
      import Button from "$lib/components/markas/Button.svelte";
      import Popover from "$lib/components/markas/Popover.svelte";
    </script>
    
    <Popover label="Bagikan" align="end">
      <div class="grid gap-3">
        <p class="text-muted">Siapa pun yang punya link bisa melihat proyek ini.</p>
        <Button size="sm">Salin link</Button>
      </div>
    </Popover>
    ---
    import Button from "@/components/markas/Button.astro";
    import Popover from "@/components/markas/Popover.astro";
    ---
    
    <Popover label="Bagikan" align="end">
      <div class="grid gap-3">
        <p class="text-muted">Siapa pun yang punya link bisa melihat proyek ini.</p>
        <Button size="sm">Salin link</Button>
      </div>
    </Popover>

    Satu script kecil yang dibundel menempatkan semua popover di halaman. Tetap jalan setelah view transition.

    import { Component } from "@angular/core";
    import { Button } from "./markas/button.component";
    import { Popover } from "./markas/popover.component";
    
    @Component({
      selector: "app-share",
      imports: [Button, Popover],
      template: `
        <markas-popover label="Bagikan" align="end">
          <div class="grid gap-3">
            <p class="text-muted">
              Siapa pun yang punya link bisa melihat proyek ini.
            </p>
            <button markas-button size="sm">Salin link</button>
          </div>
        </markas-popover>
      `,
    })
    export class Share {}

    Untuk pemicu ikon, taruh ikon dan teks sr-only di elemen dengan atribut trigger, misalnya <ng-container trigger>.

    • Panel muncul di bawah pemicu, rata dengan tepi awalnya. Ubah lewat side (top, bottom) dan align (start, center, end).
    • Pakai slot trigger untuk pemicu ikon dan sertakan teks sr-only, misalnya <span class="sr-only">Pengaturan notifikasi</span>.
    • Teks pemicu default dalam bahasa Inggris (“Open”). Isi label dalam bahasa situs Anda, misalnya “Buka” atau “Bagikan”.

    Props

    NamaTipeDefaultKeterangan
    labelstringOpenTeks tombol pemicu. Default "Open", isi misalnya "Bagikan" untuk situs berbahasa Indonesia.
    triggerslot / ReactNode / snippet-Isi tombol pemicu kustom, menggantikan label. Tambahkan teks sr-only bila isinya hanya ikon. Angular: elemen dengan atribut trigger (ng-container bisa).
    children / slotslot / ReactNode-Isi panel, misalnya form singkat atau detail.
    sidetop | bottombottomSisi pemicu tempat panel muncul. Pindah ke sisi lain bila tidak muat di layar.
    alignstart | center | endstartPerataan horizontal panel terhadap pemicu.
    idstringautoId panel. Tombol pemicu memakai id ini dengan akhiran -trigger.

    Aksesibilitas

    • Tombol pemicu memakai aria-haspopup=dialog, aria-expanded, dan aria-controls ke panel role=dialog yang diberi nama dari pemicu.
    • Enter atau Spasi pada pemicu membuka panel dan memindahkan fokus ke elemen fokus pertama di dalamnya.
    • Escape menutup panel dan mengembalikan fokus ke pemicu.
    • Klik di luar menutup panel (light dismiss Popover API). Fokus kembali ke pemicu kecuali sudah pindah ke elemen lain.

    Komponen terkait

    Komponen overlay lain dengan class yang sama di setiap framework.