Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Pinned List

    Daftar yang barisnya bisa disematkan. Baris tersemat meluncur ke grup Pinned di atas dengan animasi FLIP dan kembali saat dilepas.

    Pinned1

    • Onboarding checklistPeople, 23 itemsMon

    All4

    • Q4 roadmapProduct, 14 pages2h
    • Client invoicesFinance, 8 filesYesterday
    • Brand guidelinesDesign, 31 pagesOct 28
    • Standup notesEngineering, dailyOct 27

    Pinned1

    • Onboarding checklistPeople, 23 itemsMon

    All4

    • Q4 roadmapProduct, 14 pages2h
    • Client invoicesFinance, 8 filesYesterday
    • Brand guidelinesDesign, 31 pagesOct 28
    • Standup notesEngineering, dailyOct 27

    Pinned1

    • Onboarding checklist People, 23 items Mon

    All4

    • Q4 roadmap Product, 14 pages 2h
    • Client invoices Finance, 8 files Yesterday
    • Brand guidelines Design, 31 pages Oct 28
    • Standup notes Engineering, daily Oct 27

    Pinned1

    • Onboarding checklistPeople, 23 itemsMon

    All4

    • Q4 roadmapProduct, 14 pages2h
    • Client invoicesFinance, 8 filesYesterday
    • Brand guidelinesDesign, 31 pagesOct 28
    • Standup notesEngineering, dailyOct 27

    @php
        $items = [
            ['value' => 'roadmap', 'label' => 'Q4 roadmap', 'description' => 'Product, 14 pages', 'meta' => '2h', 'icon' => 'M9 4 3 6v14l6-2 6 2 6-2V4l-6 2zM9 4v14M15 6v14'],
            ['value' => 'invoices', 'label' => 'Client invoices', 'description' => 'Finance, 8 files', 'meta' => 'Yesterday', 'icon' => 'M5 3h14v18l-3-2-2 2-2-2-2 2-2-2-3 2zM9 8h6M9 12h6'],
            ['value' => 'onboarding', 'label' => 'Onboarding checklist', 'description' => 'People, 23 items', 'meta' => 'Mon', 'icon' => 'M9 6h11M9 12h11M9 18h11M4 6l1 1 2-2M4 12l1 1 2-2M4 18l1 1 2-2'],
            ['value' => 'brand', 'label' => 'Brand guidelines', 'description' => 'Design, 31 pages', 'meta' => 'Oct 28', 'icon' => 'M12 20h9M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z'],
            ['value' => 'standup', 'label' => 'Standup notes', 'description' => 'Engineering, daily', 'meta' => 'Oct 27', 'icon' => 'M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z'],
        ];
    @endphp
    
    <x-markas.pinned-list :items="$items" :default-pinned="['onboarding']" />
    import { PinnedList } from "@/components/markas/PinnedList";
    
    const items = [
      {
        value: "roadmap",
        label: "Q4 roadmap",
        description: "Product, 14 pages",
        meta: "2h",
        icon: "M9 4 3 6v14l6-2 6 2 6-2V4l-6 2zM9 4v14M15 6v14",
      },
      {
        value: "invoices",
        label: "Client invoices",
        description: "Finance, 8 files",
        meta: "Yesterday",
        icon: "M5 3h14v18l-3-2-2 2-2-2-2 2-2-2-3 2zM9 8h6M9 12h6",
      },
      {
        value: "onboarding",
        label: "Onboarding checklist",
        description: "People, 23 items",
        meta: "Mon",
        icon: "M9 6h11M9 12h11M9 18h11M4 6l1 1 2-2M4 12l1 1 2-2M4 18l1 1 2-2",
      },
      {
        value: "brand",
        label: "Brand guidelines",
        description: "Design, 31 pages",
        meta: "Oct 28",
        icon: "M12 20h9M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z",
      },
      {
        value: "standup",
        label: "Standup notes",
        description: "Engineering, daily",
        meta: "Oct 27",
        icon: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z",
      },
    ];
    
    export default function PinnedListExample() {
      return <PinnedList items={items} defaultPinned={["onboarding"]} />;
    }
    <script setup lang="ts">
    import PinnedList from "@/components/markas/PinnedList.vue";
    
    const items = [
      {
        value: "roadmap",
        label: "Q4 roadmap",
        description: "Product, 14 pages",
        meta: "2h",
        icon: "M9 4 3 6v14l6-2 6 2 6-2V4l-6 2zM9 4v14M15 6v14",
      },
      {
        value: "invoices",
        label: "Client invoices",
        description: "Finance, 8 files",
        meta: "Yesterday",
        icon: "M5 3h14v18l-3-2-2 2-2-2-2 2-2-2-3 2zM9 8h6M9 12h6",
      },
      {
        value: "onboarding",
        label: "Onboarding checklist",
        description: "People, 23 items",
        meta: "Mon",
        icon: "M9 6h11M9 12h11M9 18h11M4 6l1 1 2-2M4 12l1 1 2-2M4 18l1 1 2-2",
      },
      {
        value: "brand",
        label: "Brand guidelines",
        description: "Design, 31 pages",
        meta: "Oct 28",
        icon: "M12 20h9M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z",
      },
      {
        value: "standup",
        label: "Standup notes",
        description: "Engineering, daily",
        meta: "Oct 27",
        icon: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z",
      },
    ];
    </script>
    
    <template>
      <PinnedList :items="items" :default-pinned="['onboarding']" />
    </template>
    <script lang="ts">
      import PinnedList from "$lib/components/markas/PinnedList.svelte";
    
      const items = [
        {
          value: "roadmap",
          label: "Q4 roadmap",
          description: "Product, 14 pages",
          meta: "2h",
          icon: "M9 4 3 6v14l6-2 6 2 6-2V4l-6 2zM9 4v14M15 6v14",
        },
        {
          value: "invoices",
          label: "Client invoices",
          description: "Finance, 8 files",
          meta: "Yesterday",
          icon: "M5 3h14v18l-3-2-2 2-2-2-2 2-2-2-3 2zM9 8h6M9 12h6",
        },
        {
          value: "onboarding",
          label: "Onboarding checklist",
          description: "People, 23 items",
          meta: "Mon",
          icon: "M9 6h11M9 12h11M9 18h11M4 6l1 1 2-2M4 12l1 1 2-2M4 18l1 1 2-2",
        },
        {
          value: "brand",
          label: "Brand guidelines",
          description: "Design, 31 pages",
          meta: "Oct 28",
          icon: "M12 20h9M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z",
        },
        {
          value: "standup",
          label: "Standup notes",
          description: "Engineering, daily",
          meta: "Oct 27",
          icon: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z",
        },
      ];
    </script>
    
    <PinnedList {items} defaultPinned={["onboarding"]} />
    ---
    import PinnedList from "@/components/markas/PinnedList.astro";
    
    const items = [
      {
        value: "roadmap",
        label: "Q4 roadmap",
        description: "Product, 14 pages",
        meta: "2h",
        icon: "M9 4 3 6v14l6-2 6 2 6-2V4l-6 2zM9 4v14M15 6v14",
      },
      {
        value: "invoices",
        label: "Client invoices",
        description: "Finance, 8 files",
        meta: "Yesterday",
        icon: "M5 3h14v18l-3-2-2 2-2-2-2 2-2-2-3 2zM9 8h6M9 12h6",
      },
      {
        value: "onboarding",
        label: "Onboarding checklist",
        description: "People, 23 items",
        meta: "Mon",
        icon: "M9 6h11M9 12h11M9 18h11M4 6l1 1 2-2M4 12l1 1 2-2M4 18l1 1 2-2",
      },
      {
        value: "brand",
        label: "Brand guidelines",
        description: "Design, 31 pages",
        meta: "Oct 28",
        icon: "M12 20h9M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z",
      },
      {
        value: "standup",
        label: "Standup notes",
        description: "Engineering, daily",
        meta: "Oct 27",
        icon: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z",
      },
    ];
    ---
    
      <PinnedList items={items} defaultPinned={['onboarding']} />
    import { Component } from "@angular/core";
    import { PinnedList } from "./markas/pinned-list.component";
    
    @Component({
      selector: "markas-example",
      imports: [PinnedList],
      template: `
        <markas-pinned-list [items]="items" [defaultPinned]="['onboarding']" />
      `,
    })
    export default class PinnedListExample {
      protected readonly items = [
        {
          value: "roadmap",
          label: "Q4 roadmap",
          description: "Product, 14 pages",
          meta: "2h",
          icon: "M9 4 3 6v14l6-2 6 2 6-2V4l-6 2zM9 4v14M15 6v14",
        },
        {
          value: "invoices",
          label: "Client invoices",
          description: "Finance, 8 files",
          meta: "Yesterday",
          icon: "M5 3h14v18l-3-2-2 2-2-2-2 2-2-2-3 2zM9 8h6M9 12h6",
        },
        {
          value: "onboarding",
          label: "Onboarding checklist",
          description: "People, 23 items",
          meta: "Mon",
          icon: "M9 6h11M9 12h11M9 18h11M4 6l1 1 2-2M4 12l1 1 2-2M4 18l1 1 2-2",
        },
        {
          value: "brand",
          label: "Brand guidelines",
          description: "Design, 31 pages",
          meta: "Oct 28",
          icon: "M12 20h9M16.5 3.5a2.1 2.1 0 0 1 3 3L7 19l-4 1 1-4z",
        },
        {
          value: "standup",
          label: "Standup notes",
          description: "Engineering, daily",
          meta: "Oct 27",
          icon: "M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z",
        },
      ];
    }

    Contoh

    Channel obrolan

    Pinned2

    • design-critWeekly critiques, Thursdays14
    • launch-q4Release checklist and status36

    All2

    • generalCompany-wide announcements128
    • randomCats, lunch, and memes9

    Pinned2

    • design-critWeekly critiques, Thursdays14
    • launch-q4Release checklist and status36

    All2

    • generalCompany-wide announcements128
    • randomCats, lunch, and memes9

    Pinned2

    • design-crit Weekly critiques, Thursdays 14
    • launch-q4 Release checklist and status 36

    All2

    • general Company-wide announcements 128
    • random Cats, lunch, and memes 9

    Pinned2

    • design-critWeekly critiques, Thursdays14
    • launch-q4Release checklist and status36

    All2

    • generalCompany-wide announcements128
    • randomCats, lunch, and memes9

    Baris sederhana

    All4

    • Jakarta31°C
    • Bandung24°C
    • Surabaya33°C
    • Denpasar29°C

    All4

    • Jakarta31°C
    • Bandung24°C
    • Surabaya33°C
    • Denpasar29°C

    All4

    • Jakarta 31°C
    • Bandung 24°C
    • Surabaya 33°C
    • Denpasar 29°C

    All4

    • Jakarta31°C
    • Bandung24°C
    • Surabaya33°C
    • Denpasar29°C

    Pencarian tersimpan dalam kartu

    Quick filters

    Quick filters

    Favorites1

    • Trials ending this weekCustomers, 42 results

    Saved searches2

    • Unpaid over Rp 5.000.000Invoices, 6 results
    • Churned this monthCustomers, 18 results

    Quick filters

    Favorites1

    • Trials ending this weekCustomers, 42 results

    Saved searches2

    • Unpaid over Rp 5.000.000Invoices, 6 results
    • Churned this monthCustomers, 18 results

    Quick filters

    Favorites1

    • Trials ending this week Customers, 42 results

    Saved searches2

    • Unpaid over Rp 5.000.000 Invoices, 6 results
    • Churned this month Customers, 18 results

    Quick filters

    Favorites1

    • Trials ending this weekCustomers, 42 results

    Saved searches2

    • Unpaid over Rp 5.000.000Invoices, 6 results
    • Churned this monthCustomers, 18 results

    Instalasi

    npx markasui@latest add pinned-list

    Pemakaian

    <x-markas.pinned-list
        :default-pinned="$user->pinned_channels"
        pin-label="Sematkan {label}"
        unpin-label="Lepas sematan {label}"
        pinned-label="Disematkan"
        all-label="Semua"
        pinned-message="{label} disematkan"
        unpinned-message="Sematan {label} dilepas"
        x-on:change="fetch('/pins', { method: 'PUT', body: JSON.stringify($event.detail) })"
        :items="[
            ['value' => 'umum', 'label' => 'umum', 'description' => 'Pengumuman perusahaan', 'meta' => '128'],
            ['value' => 'desain', 'label' => 'kritik-desain', 'description' => 'Kritik mingguan', 'meta' => '14'],
            ['value' => 'santai', 'label' => 'santai', 'meta' => '9'],
        ]"
    />
    import { PinnedList } from "@/components/markas/PinnedList";
    
    const [pinned, setPinned] = useState<string[]>(["desain"]);
    
    <PinnedList
      items={channels}
      pinned={pinned}
      onPinnedChange={setPinned}
      pinLabel="Sematkan {label}"
      unpinLabel="Lepas sematan {label}"
      pinnedLabel="Disematkan"
      allLabel="Semua"
      pinnedMessage="{label} disematkan"
      unpinnedMessage="Sematan {label} dilepas"
    />;
    <script setup lang="ts">
    import { ref } from "vue";
    import PinnedList from "@/components/markas/PinnedList.vue";
    
    const pinned = ref(["desain"]);
    </script>
    
    <template>
      <PinnedList
        v-model:pinned="pinned"
        :items="channels"
        pin-label="Sematkan {label}"
        unpin-label="Lepas sematan {label}"
        pinned-label="Disematkan"
        all-label="Semua"
        pinned-message="{label} disematkan"
        unpinned-message="Sematan {label} dilepas"
      />
    </template>
    <script lang="ts">
      import PinnedList from "$lib/components/markas/PinnedList.svelte";
    
      const items = [
        { value: "roadmap", label: "Q4 roadmap", description: "Product, 14 pages" },
        { value: "standup", label: "Standup notes", description: "Team, daily" },
      ];
      let pinned = $state(["roadmap"]);
    </script>
    
    <PinnedList {items} bind:pinned />
    ---
    import PinnedList from "@/components/markas/PinnedList.astro";
    
    const items = [
      { value: "roadmap", label: "Q4 roadmap", description: "Product, 14 pages" },
      { value: "standup", label: "Standup notes", description: "Team, daily" },
    ];
    ---
    
    <PinnedList items={items} defaultPinned={["roadmap"]} />

    Satu script kecil yang dibundel memindahkan baris dan memancarkan change dengan nilai yang disematkan.

    import { Component, signal } from "@angular/core";
    import { PinnedList } from "./markas/pinned-list.component";
    
    @Component({
      selector: "app-docs",
      imports: [PinnedList],
      template: `<markas-pinned-list [items]="items" [(pinned)]="pinned" />`,
    })
    export class Docs {
      readonly items = [
        { value: "roadmap", label: "Q4 roadmap", description: "Product, 14 pages" },
        { value: "standup", label: "Standup notes", description: "Team, daily" },
      ];
      readonly pinned = signal(["roadmap"]);
    }
    • Baris tersemat mengikuti urutan items, jadi melepas sematan mengembalikan baris ke tempat asalnya.
    • Perpindahan memakai FLIP: setiap baris diukur sebelum dan sesudah perubahan lalu dianimasikan dari posisi lama dengan Web Animations API. Tidak perlu library tata letak.
    • {label} di pinLabel, unpinLabel, pinnedMessage, dan unpinnedMessage diganti label baris.
    • Blade merender baris dengan Alpine x-for dan butuh Alpine.js.

    Props

    NamaTipeDefaultKeterangan
    items{ value: string; label: string; description?: string; meta?: string; icon?: string }[][]Baris dalam urutan aslinya. icon adalah atribut d path SVG 24x24 bergaris, meta teks pendek di kanan.
    pinned / v-model:pinnedstring[]-Nilai tersemat yang dikendalikan di React (dengan onPinnedChange) dan Vue (v-model:pinned).
    defaultPinnedstring[][]Nilai yang tersemat saat render pertama.
    onPinnedChange / x-on:change(pinned: string[]) => void-Dipicu setelah sematkan atau lepas dengan daftar baru. Blade mengirim event DOM change dengan daftar sebagai detail.
    pinLabelstringPin {label}Nama aksesibel tiap tombol pin. Tetap sama saat tersemat, aria-pressed membawa keadaannya.
    unpinLabelstringUnpin {label}Petunjuk hover (title) tombol pin saat baris tersemat.
    pinnedLabelstringPinnedJudul dan nama daftar grup tersemat.
    allLabelstringAllJudul dan nama daftar baris lainnya.
    pinnedMessagestring{label} pinnedDiumumkan di live region setelah menyematkan.
    unpinnedMessagestring{label} unpinnedDiumumkan di live region setelah melepas sematan.
    pinnedChangeoutput<string[]>-Khusus Angular. Memancarkan nilai yang disematkan setiap kali berubah; mendukung [(pinned)]. Svelte memakai bind:pinned atau onPinnedChange, Astro memancarkan change.

    Aksesibilitas

    • Setiap tombol pin adalah toggle button dengan aria-pressed dan nama tetap dari pinLabel.
    • Kedua grup adalah list bernama pinnedLabel dan allLabel. Grup kosong disembunyikan.
    • Fokus mengikuti baris yang pindah ke tombol pin-nya, dan live region status mengumumkan pinnedMessage atau unpinnedMessage.
    • Dengan reduced motion, baris langsung pindah tanpa luncuran FLIP.

    Komponen terkait

    Komponen markasui lain dengan class yang sama di setiap framework.