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']" />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
@php
$items = [
['value' => 'general', 'label' => 'general', 'description' => 'Company-wide announcements', 'meta' => '128', 'icon' => 'M4 9h16M4 15h16M10 3 8 21M16 3l-2 18'],
['value' => 'design', 'label' => 'design-crit', 'description' => 'Weekly critiques, Thursdays', 'meta' => '14', 'icon' => 'M4 9h16M4 15h16M10 3 8 21M16 3l-2 18'],
['value' => 'launch', 'label' => 'launch-q4', 'description' => 'Release checklist and status', 'meta' => '36', 'icon' => 'M4 9h16M4 15h16M10 3 8 21M16 3l-2 18'],
['value' => 'random', 'label' => 'random', 'description' => 'Cats, lunch, and memes', 'meta' => '9', 'icon' => 'M4 9h16M4 15h16M10 3 8 21M16 3l-2 18'],
];
@endphp
<x-markas.pinned-list :items="$items" :default-pinned="['design', 'launch']" />Baris sederhana
Pinned0
All4
- Jakarta31°C
- Bandung24°C
- Surabaya33°C
- Denpasar29°C
Pinned0
All4
- Jakarta31°C
- Bandung24°C
- Surabaya33°C
- Denpasar29°C
Pinned0
All4
- Jakarta 31°C
- Bandung 24°C
- Surabaya 33°C
- Denpasar 29°C
Pinned0
All4
- Jakarta31°C
- Bandung24°C
- Surabaya33°C
- Denpasar29°C
@php
$items = [
['value' => 'jakarta', 'label' => 'Jakarta', 'meta' => '31°C'],
['value' => 'bandung', 'label' => 'Bandung', 'meta' => '24°C'],
['value' => 'surabaya', 'label' => 'Surabaya', 'meta' => '33°C'],
['value' => 'denpasar', 'label' => 'Denpasar', 'meta' => '29°C'],
];
@endphp
<x-markas.pinned-list :items="$items" />import { PinnedList } from "@/components/markas/PinnedList";
const items = [
{ value: "jakarta", label: "Jakarta", meta: "31°C" },
{ value: "bandung", label: "Bandung", meta: "24°C" },
{ value: "surabaya", label: "Surabaya", meta: "33°C" },
{ value: "denpasar", label: "Denpasar", meta: "29°C" },
];
export default function Example() {
return <PinnedList items={items} />;
}<script lang="ts">
import PinnedList from "$lib/components/markas/PinnedList.svelte";
const items = [
{ value: "jakarta", label: "Jakarta", meta: "31°C" },
{ value: "bandung", label: "Bandung", meta: "24°C" },
{ value: "surabaya", label: "Surabaya", meta: "33°C" },
{ value: "denpasar", label: "Denpasar", meta: "29°C" },
];
</script>
<PinnedList {items} />---
import PinnedList from "@/components/markas/PinnedList.astro";
const items = [
{ value: "jakarta", label: "Jakarta", meta: "31°C" },
{ value: "bandung", label: "Bandung", meta: "24°C" },
{ value: "surabaya", label: "Surabaya", meta: "33°C" },
{ value: "denpasar", label: "Denpasar", meta: "29°C" },
];
---
<PinnedList items={items} />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
@php
$items = [
['value' => 'unpaid', 'label' => 'Unpaid over Rp 5.000.000', 'description' => 'Invoices, 6 results'],
['value' => 'churn', 'label' => 'Churned this month', 'description' => 'Customers, 18 results'],
['value' => 'trial', 'label' => 'Trials ending this week', 'description' => 'Customers, 42 results'],
];
@endphp
<div class="grid gap-4 rounded-xl border border-line bg-surface p-4">
<p class="px-1 text-base font-semibold text-ink">Quick filters</p>
<x-markas.pinned-list :items="$items" :default-pinned="['trial']" pinned-label="Favorites" all-label="Saved searches" />
</div>Instalasi
npx markasui@latest add pinned-listpnpm dlx markasui@latest add pinned-listyarn dlx markasui@latest add pinned-listbunx --bun markasui@latest add pinned-list- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Pasang dependensi:
npm install alpinejs - Salin source komponen di bawah ini ke
resources/views/components/markas/pinned-list.blade.php.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/PinnedList.tsx.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/PinnedList.vue.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/lib/components/markas/PinnedList.svelte.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/PinnedList.astro.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/app/markas/pinned-list.component.ts.
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
| Nama | Tipe | Default | Keterangan |
|---|---|---|---|
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:pinned | string[] | - | Nilai tersemat yang dikendalikan di React (dengan onPinnedChange) dan Vue (v-model:pinned). |
defaultPinned | string[] | [] | 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. |
pinLabel | string | Pin {label} | Nama aksesibel tiap tombol pin. Tetap sama saat tersemat, aria-pressed membawa keadaannya. |
unpinLabel | string | Unpin {label} | Petunjuk hover (title) tombol pin saat baris tersemat. |
pinnedLabel | string | Pinned | Judul dan nama daftar grup tersemat. |
allLabel | string | All | Judul dan nama daftar baris lainnya. |
pinnedMessage | string | {label} pinned | Diumumkan di live region setelah menyematkan. |
unpinnedMessage | string | {label} unpinned | Diumumkan di live region setelah melepas sematan. |
pinnedChange | output<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.
- Bottom NavigationBar bawah gaya aplikasi mobile. Pill meluncur ke item terpilih, labelnya muncul, dan bar bisa menciut jadi ikon saat konten discroll.
- Card StackTumpukan kartu bertingkat. Geser, tombol panah, atau tombol navigasi membuang kartu teratas lalu kartu berikutnya naik. Berputar, dengan indikator posisi.
- Chat MessagePesan dalam percakapan AI. Gelembung user di kanan, balasan asisten dengan avatar, aksi saat hover, indikator mengetik, dan efek streaming token opsional.
- Currency InputKolom uang yang memformat saat mengetik (Rp 12.500.000), menjaga posisi kursor, dan mengirim angka murni. Opsional chip nominal cepat.
- DockDock ala macOS. Ikon membesar halus mengikuti kursor atau fokus, label muncul di atas, item terbuka bertitik, dan memantul saat dibuka.
- Drag ElementsArea kartu atau stiker yang bisa diseret dengan momentum ringan di dalam batasnya. Panah menggeser item yang fokus, Escape mengembalikannya.