Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Drag Elements

    Area kartu atau stiker yang bisa diseret dengan momentum ringan di dalam batasnya. Panah menggeser item yang fokus, Escape mengembalikannya.

    Brand refresh

    Warm, calm, a little playful

    Kopi susu New Batik pattern

    Brand refresh

    Warm, calm, a little playful

    Kopi susuNewBatik pattern

    Brand refresh

    Warm, calm, a little playful

    Kopi susuNewBatik pattern

    Brand refresh

    Warm, calm, a little playful

    Kopi susu New Batik pattern

    Brand refresh

    Warm, calm, a little playful

    Kopi susuNewBatik pattern
    @php
        $board = 'h-80 rounded-xl border border-line bg-subtle';
        $note = 'w-44 rounded-lg bg-surface p-4 shadow-overlay';
        $noteTitle = 'text-sm font-semibold text-ink';
        $noteText = 'mt-1 text-sm text-muted';
        $sticker = 'rounded-full bg-primary px-4 py-2 text-sm font-semibold text-on-primary';
        $round = 'grid size-16 place-items-center rounded-full border-2 border-dashed border-success bg-surface text-sm font-semibold text-ink';
        $swatches = 'flex gap-1.5 rounded-lg bg-surface p-2 shadow-overlay';
        $swatchPrimary = 'size-8 rounded-md bg-primary';
        $swatchSuccess = 'size-8 rounded-md bg-success';
        $swatchWarning = 'size-8 rounded-md bg-warning';
        $tag = 'rounded-md border border-line bg-surface px-3 py-1.5 text-sm font-medium text-ink';
    @endphp
    
        <x-markas.drag-elements :seed="4" :class="$board" role="group" aria-label="Moodboard">
          <div class="{{ $note }}">
            <p class="{{ $noteTitle }}">Brand refresh</p>
            <p class="{{ $noteText }}">Warm, calm, a little playful</p>
          </div>
          <span class="{{ $sticker }}">Kopi susu</span>
          <span class="{{ $round }}">New</span>
          <span class="{{ $tag }}">Batik pattern</span>
          <div class="{{ $swatches }}" aria-label="Palette" role="img">
            <span class="{{ $swatchPrimary }}"></span>
            <span class="{{ $swatchSuccess }}"></span>
            <span class="{{ $swatchWarning }}"></span>
          </div>
        </x-markas.drag-elements>
    import { DragElements } from "@/components/markas/DragElements";
    
    const board = "h-80 rounded-xl border border-line bg-subtle";
    const note = "w-44 rounded-lg bg-surface p-4 shadow-overlay";
    const noteTitle = "text-sm font-semibold text-ink";
    const noteText = "mt-1 text-sm text-muted";
    const sticker =
      "rounded-full bg-primary px-4 py-2 text-sm font-semibold text-on-primary";
    const round =
      "grid size-16 place-items-center rounded-full border-2 border-dashed border-success bg-surface text-sm font-semibold text-ink";
    const swatches = "flex gap-1.5 rounded-lg bg-surface p-2 shadow-overlay";
    const swatchPrimary = "size-8 rounded-md bg-primary";
    const swatchSuccess = "size-8 rounded-md bg-success";
    const swatchWarning = "size-8 rounded-md bg-warning";
    const tag =
      "rounded-md border border-line bg-surface px-3 py-1.5 text-sm font-medium text-ink";
    
    export default function DragElementsExample() {
      return (
        <DragElements
          seed={4}
          className={board}
          role="group"
          aria-label="Moodboard"
        >
          <div className={note}>
            <p className={noteTitle}>Brand refresh</p>
            <p className={noteText}>Warm, calm, a little playful</p>
          </div>
          <span className={sticker}>Kopi susu</span>
          <span className={round}>New</span>
          <span className={tag}>Batik pattern</span>
          <div className={swatches} aria-label="Palette" role="img">
            <span className={swatchPrimary}></span>
            <span className={swatchSuccess}></span>
            <span className={swatchWarning}></span>
          </div>
        </DragElements>
      );
    }
    <script setup lang="ts">
    import DragElements from "@/components/markas/DragElements.vue";
    
    const board = "h-80 rounded-xl border border-line bg-subtle";
    const note = "w-44 rounded-lg bg-surface p-4 shadow-overlay";
    const noteTitle = "text-sm font-semibold text-ink";
    const noteText = "mt-1 text-sm text-muted";
    const sticker =
      "rounded-full bg-primary px-4 py-2 text-sm font-semibold text-on-primary";
    const round =
      "grid size-16 place-items-center rounded-full border-2 border-dashed border-success bg-surface text-sm font-semibold text-ink";
    const swatches = "flex gap-1.5 rounded-lg bg-surface p-2 shadow-overlay";
    const swatchPrimary = "size-8 rounded-md bg-primary";
    const swatchSuccess = "size-8 rounded-md bg-success";
    const swatchWarning = "size-8 rounded-md bg-warning";
    const tag =
      "rounded-md border border-line bg-surface px-3 py-1.5 text-sm font-medium text-ink";
    </script>
    
    <template>
      <DragElements :seed="4" :class="board" role="group" aria-label="Moodboard">
        <div :class="note">
          <p :class="noteTitle">Brand refresh</p>
          <p :class="noteText">Warm, calm, a little playful</p>
        </div>
        <span :class="sticker">Kopi susu</span>
        <span :class="round">New</span>
        <span :class="tag">Batik pattern</span>
        <div :class="swatches" aria-label="Palette" role="img">
          <span :class="swatchPrimary"></span>
          <span :class="swatchSuccess"></span>
          <span :class="swatchWarning"></span>
        </div>
      </DragElements>
    </template>
    <script lang="ts">
      import DragElements from "$lib/components/markas/DragElements.svelte";
    
      const board = "h-80 rounded-xl border border-line bg-subtle";
      const note = "w-44 rounded-lg bg-surface p-4 shadow-overlay";
      const noteTitle = "text-sm font-semibold text-ink";
      const noteText = "mt-1 text-sm text-muted";
      const sticker =
        "rounded-full bg-primary px-4 py-2 text-sm font-semibold text-on-primary";
      const round =
        "grid size-16 place-items-center rounded-full border-2 border-dashed border-success bg-surface text-sm font-semibold text-ink";
      const swatches = "flex gap-1.5 rounded-lg bg-surface p-2 shadow-overlay";
      const swatchPrimary = "size-8 rounded-md bg-primary";
      const swatchSuccess = "size-8 rounded-md bg-success";
      const swatchWarning = "size-8 rounded-md bg-warning";
      const tag =
        "rounded-md border border-line bg-surface px-3 py-1.5 text-sm font-medium text-ink";
    </script>
    
    <DragElements seed={4} class={board} role="group" aria-label="Moodboard">
      <div class={note}>
        <p class={noteTitle}>Brand refresh</p>
        <p class={noteText}>Warm, calm, a little playful</p>
      </div>
      <span class={sticker}>Kopi susu</span>
      <span class={round}>New</span>
      <span class={tag}>Batik pattern</span>
      <div class={swatches} aria-label="Palette" role="img">
        <span class={swatchPrimary}></span>
        <span class={swatchSuccess}></span>
        <span class={swatchWarning}></span>
      </div>
    </DragElements>
    ---
    import DragElements from "@/components/markas/DragElements.astro";
    
    const board = "h-80 rounded-xl border border-line bg-subtle";
    const note = "w-44 rounded-lg bg-surface p-4 shadow-overlay";
    const noteTitle = "text-sm font-semibold text-ink";
    const noteText = "mt-1 text-sm text-muted";
    const sticker =
        "rounded-full bg-primary px-4 py-2 text-sm font-semibold text-on-primary";
    const round =
        "grid size-16 place-items-center rounded-full border-2 border-dashed border-success bg-surface text-sm font-semibold text-ink";
    const swatches = "flex gap-1.5 rounded-lg bg-surface p-2 shadow-overlay";
    const swatchPrimary = "size-8 rounded-md bg-primary";
    const swatchSuccess = "size-8 rounded-md bg-success";
    const swatchWarning = "size-8 rounded-md bg-warning";
    const tag =
        "rounded-md border border-line bg-surface px-3 py-1.5 text-sm font-medium text-ink";
    ---
    
    <DragElements seed={4} class={board} role="group" aria-label="Moodboard">
      <div class={note}>
        <p class={noteTitle}>Brand refresh</p>
        <p class={noteText}>Warm, calm, a little playful</p>
      </div>
      <span class={sticker}>Kopi susu</span>
      <span class={round}>New</span>
      <span class={tag}>Batik pattern</span>
      <div class={swatches} aria-label="Palette" role="img">
        <span class={swatchPrimary}></span>
        <span class={swatchSuccess}></span>
        <span class={swatchWarning}></span>
      </div>
    </DragElements>
    import { Component } from "@angular/core";
    import { DragElements } from "./markas/drag-elements.component";
    
    @Component({
      selector: "markas-example",
      imports: [DragElements],
      template: `
        <markas-drag-elements
          [seed]="4"
          [class]="board"
          role="group"
          aria-label="Moodboard"
        >
          <div [class]="note">
            <p [class]="noteTitle">Brand refresh</p>
            <p [class]="noteText">Warm, calm, a little playful</p>
          </div>
          <span [class]="sticker">Kopi susu</span>
          <span [class]="round">New</span>
          <span [class]="tag">Batik pattern</span>
          <div [class]="swatches" aria-label="Palette" role="img">
            <span [class]="swatchPrimary"></span>
            <span [class]="swatchSuccess"></span>
            <span [class]="swatchWarning"></span>
          </div>
        </markas-drag-elements>
      `,
    })
    export default class DragElementsExample {
      protected readonly board = "h-80 rounded-xl border border-line bg-subtle";
      protected readonly note = "w-44 rounded-lg bg-surface p-4 shadow-overlay";
      protected readonly noteTitle = "text-sm font-semibold text-ink";
      protected readonly noteText = "mt-1 text-sm text-muted";
      protected readonly sticker =
        "rounded-full bg-primary px-4 py-2 text-sm font-semibold text-on-primary";
      protected readonly round =
        "grid size-16 place-items-center rounded-full border-2 border-dashed border-success bg-surface text-sm font-semibold text-ink";
      protected readonly swatches =
        "flex gap-1.5 rounded-lg bg-surface p-2 shadow-overlay";
      protected readonly swatchPrimary = "size-8 rounded-md bg-primary";
      protected readonly swatchSuccess = "size-8 rounded-md bg-success";
      protected readonly swatchWarning = "size-8 rounded-md bg-warning";
      protected readonly tag =
        "rounded-md border border-line bg-surface px-3 py-1.5 text-sm font-medium text-ink";
    }

    Contoh

    Kartu tim dengan posisi dari data-x dan data-y

    Rania PutriDesign lead
    Bima SaputraEngineering
    Sekar AyuProduct
    Dimas PratamaResearch
    Rania PutriDesign lead
    Bima SaputraEngineering
    Sekar AyuProduct
    Dimas PratamaResearch
    Rania PutriDesign lead
    Bima SaputraEngineering
    Sekar AyuProduct
    Dimas PratamaResearch
    Rania Putri Design lead
    Bima Saputra Engineering
    Sekar Ayu Product
    Dimas Pratama Research
    Rania PutriDesign lead
    Bima SaputraEngineering
    Sekar AyuProduct
    Dimas PratamaResearch

    Tag elastis yang kembali memegas

    Stack we love

    Pull a tag, it springs back

    Laravel Vue React Tailwind CSS Alpine.js Figma

    Stack we love

    Pull a tag, it springs back

    LaravelVueReactTailwind CSSAlpine.jsFigma

    Stack we love

    Pull a tag, it springs back

    LaravelVueReactTailwind CSSAlpine.jsFigma

    Stack we love

    Pull a tag, it springs back

    Laravel Vue React Tailwind CSS Alpine.js Figma

    Stack we love

    Pull a tag, it springs back

    LaravelVueReactTailwind CSSAlpine.jsFigma

    Paket dalam Rupiah untuk diseret berdampingan

    Basic

    Rp 49.000

    per month

    Pro

    Rp 99.000

    per month

    Team

    Rp 199.000

    per month

    Basic

    Rp 49.000

    per month

    Pro

    Rp 99.000

    per month

    Team

    Rp 199.000

    per month

    Basic

    Rp 49.000

    per month

    Pro

    Rp 99.000

    per month

    Team

    Rp 199.000

    per month

    Basic

    Rp 49.000

    per month

    Pro

    Rp 99.000

    per month

    Team

    Rp 199.000

    per month

    Basic

    Rp 49.000

    per month

    Pro

    Rp 99.000

    per month

    Team

    Rp 199.000

    per month

    Instalasi

    npx markasui@latest add drag-elements

    Pemakaian

    <x-markas.drag-elements :seed="4" hint-label="Seret untuk memindahkan, atau pakai tombol panah. Escape mengembalikannya" class="h-80 rounded-xl border border-line bg-subtle" role="group" aria-label="Moodboard">
        <div class="w-44 rounded-lg bg-surface p-4">Brand baru</div>
        <span class="rounded-full bg-primary px-4 py-2 text-on-primary">Kopi susu</span>
        <span data-x="90" data-y="10" data-rotate="8" class="rounded-md border border-line bg-surface px-3 py-1.5">Motif batik</span>
    </x-markas.drag-elements>

    Butuh Alpine.js.

    import { DragElements } from "@/components/markas/DragElements";
    
    <DragElements
      release="return"
      hintLabel="Seret untuk memindahkan, atau pakai tombol panah. Escape mengembalikannya"
      className="h-80 rounded-xl border border-line bg-subtle"
      role="group"
      aria-label="Keahlian"
    >
      <span className="rounded-full bg-primary-soft px-3 py-1.5">Laravel</span>
      <span className="rounded-full bg-primary-soft px-3 py-1.5">Vue</span>
    </DragElements>;
    <template>
      <DragElements
        release="stay"
        :rotate="0"
        hint-label="Seret untuk memindahkan, atau pakai tombol panah. Escape mengembalikannya"
        class="h-80 rounded-xl border border-line bg-canvas"
        role="group"
        aria-label="Tim"
      >
        <div data-x="8" data-y="10" class="w-48 rounded-xl bg-surface p-3">
          Rania Putri
        </div>
        <div data-x="92" data-y="30" class="w-48 rounded-xl bg-surface p-3">
          Bima Saputra
        </div>
      </DragElements>
    </template>
    <script lang="ts">
      import DragElements from "$lib/components/markas/DragElements.svelte";
    </script>
    
    <DragElements
      release="return"
      class="h-80 rounded-xl border border-line bg-subtle"
      role="group"
      aria-label="Skills"
    >
      <span class="rounded-full bg-primary-soft px-3 py-1.5">Laravel</span>
      <span class="rounded-full bg-primary-soft px-3 py-1.5">Vue</span>
    </DragElements>
    ---
    import DragElements from "@/components/markas/DragElements.astro";
    ---
    
    <DragElements
      release="return"
      class="h-80 rounded-xl border border-line bg-subtle"
      role="group"
      aria-label="Skills"
    >
      <span class="rounded-full bg-primary-soft px-3 py-1.5">Laravel</span>
      <span class="rounded-full bg-primary-soft px-3 py-1.5">Vue</span>
    </DragElements>

    Setiap area adalah custom element kecil, jadi tetap jalan setelah view transition.

    import { Component } from "@angular/core";
    import { DragElements } from "./markas/drag-elements.component";
    
    @Component({
      selector: "app-skills",
      imports: [DragElements],
      template: `
        <markas-drag-elements
          release="return"
          class="h-80 rounded-xl border border-line bg-subtle"
          role="group"
          aria-label="Skills"
        >
          <span class="rounded-full bg-primary-soft px-3 py-1.5">Laravel</span>
          <span class="rounded-full bg-primary-soft px-3 py-1.5">Vue</span>
        </markas-drag-elements>
      `,
    })
    export class Skills {}

    role, aria-label, dan class pindah dari host ke area.

    • Setiap anak langsung bisa diseret dan ditaruh di posisi seed di dalam area. data-x dan data-y (0 sampai 100) serta data-rotate pada anak mengunci posisi awalnya.
    • release="inertia" meluncur dan memantul di tepi, "stay" berhenti di tempat dilepas, "return" kembali memegas ke posisi awal.
    • Fokuskan item dengan Tab, geser dengan tombol panah (Shift untuk langkah besar), dan tekan Escape untuk mengembalikannya. Item yang disentuh naik ke depan.
    • Beri area tinggi. Item tidak pernah keluar dari area. Posisi tidak disimpan; pakai untuk main-main, bukan untuk mengurutkan sungguhan.
    • Ubah petunjuk screen reader lewat hintLabel.

    Props

    NamaTipeDefaultKeterangan
    release"inertia" | "stay" | "return""inertia"Perilaku item saat dilepas: meluncur dengan gesekan dan memantul di tepi, berhenti di tempat, atau kembali memegas ke posisi awal.
    rotatenumber6Kemiringan acak terbesar dalam derajat untuk item tanpa data-rotate. 0 membuatnya tegak.
    seednumber1Mengubah posisi awal yang tersebar. Seed yang sama selalu menghasilkan tata letak yang sama.
    hintLabelstring"Drag to move, or use the arrow keys. Escape puts it back"Deskripsi yang dibacakan screen reader untuk setiap item.
    children / slotReactNode / slot-Item-itemnya. Setiap anak langsung bisa diseret. data-x dan data-y (0 sampai 100, persen dari area) serta data-rotate (derajat) pada anak menentukan posisi awalnya, bukan seed.

    Aksesibilitas

    • Setiap item mendapat tabindex="0" dan deskripsi dari hintLabel, sehingga pengguna keyboard bisa menjangkau dan menggesernya.
    • Tombol panah menggeser item yang fokus 10px (Shift untuk 50px) dan Escape mengembalikannya ke posisi awal; item juga naik ke depan.
    • Tombol, tautan, dan field di dalam item tetap berfungsi: menekannya tidak memulai seret.
    • Dengan reduced motion item tetap mengikuti pointer dan tombol, tapi tanpa luncuran, pegas, atau easing.

    Komponen terkait

    Komponen markasui lain dengan class yang sama di setiap framework.