Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Currency Input

    Kolom uang yang memformat saat mengetik (Rp 12.500.000), menjaga posisi kursor, dan mengirim angka murni. Opsional chip nominal cepat.

    Current balance Rp 245.000
    Rp

    Minimum Rp10.000, maximum Rp10.000.000

    Current balanceRp 245.000
    Rp

    Minimum Rp10.000, maximum Rp10.000.000

    Current balanceRp 245.000
    Rp

    Minimum Rp10.000, maximum Rp10.000.000

    Current balance Rp 245.000
    Rp

    Minimum Rp10.000, maximum Rp10.000.000

    Current balanceRp 245.000
    Rp

    Minimum Rp10.000, maximum Rp10.000.000

    @php
        $panel = 'grid gap-4 rounded-xl border border-line bg-surface p-5';
        $balance = 'flex items-baseline justify-between';
        $balanceLabel = 'text-sm text-muted';
        $balanceValue = 'text-lg font-semibold text-ink tabular-nums';
    @endphp
    
    <div class="{{ $panel }}">
        <div class="{{ $balance }}">
            <span class="{{ $balanceLabel }}">Current balance</span>
            <span class="{{ $balanceValue }}">Rp 245.000</span>
        </div>
        <x-markas.currency-input
            label="Top-up amount"
            name="amount"
            hint="Minimum Rp10.000, maximum Rp10.000.000"
            :min="10000"
            :max="10000000"
            :value="100000"
            :presets="[50000, 100000, 250000, 500000, 1000000]"
        />
        <x-markas.button>Top up balance</x-markas.button>
    </div>
    import { Button } from "@/components/markas/Button";
    import { CurrencyInput } from "@/components/markas/CurrencyInput";
    
    const panel = "grid gap-4 rounded-xl border border-line bg-surface p-5";
    const balance = "flex items-baseline justify-between";
    const balanceLabel = "text-sm text-muted";
    const balanceValue = "text-lg font-semibold text-ink tabular-nums";
    
    export default function CurrencyInputExample() {
      return (
        <div className={panel}>
          <div className={balance}>
            <span className={balanceLabel}>Current balance</span>
            <span className={balanceValue}>Rp 245.000</span>
          </div>
          <CurrencyInput
            label="Top-up amount"
            name="amount"
            hint="Minimum Rp10.000, maximum Rp10.000.000"
            min={10000}
            max={10000000}
            defaultValue={100000}
            presets={[50000, 100000, 250000, 500000, 1000000]}
          />
          <Button>Top up balance</Button>
        </div>
      );
    }
    <script setup lang="ts">
    import { ref } from "vue";
    import Button from "@/components/markas/Button.vue";
    import CurrencyInput from "@/components/markas/CurrencyInput.vue";
    
    const panel = "grid gap-4 rounded-xl border border-line bg-surface p-5";
    const balance = "flex items-baseline justify-between";
    const balanceLabel = "text-sm text-muted";
    const balanceValue = "text-lg font-semibold text-ink tabular-nums";
    
    const amount = ref<number | null>(100000);
    </script>
    
    <template>
      <div :class="panel">
        <div :class="balance">
          <span :class="balanceLabel">Current balance</span>
          <span :class="balanceValue">Rp 245.000</span>
        </div>
        <CurrencyInput
          v-model="amount"
          label="Top-up amount"
          name="amount"
          hint="Minimum Rp10.000, maximum Rp10.000.000"
          :min="10000"
          :max="10000000"
          :presets="[50000, 100000, 250000, 500000, 1000000]"
        />
        <Button>Top up balance</Button>
      </div>
    </template>
    <script lang="ts">
      import Button from "$lib/components/markas/Button.svelte";
      import CurrencyInput from "$lib/components/markas/CurrencyInput.svelte";
    
      const panel = "grid gap-4 rounded-xl border border-line bg-surface p-5";
      const balance = "flex items-baseline justify-between";
      const balanceLabel = "text-sm text-muted";
      const balanceValue = "text-lg font-semibold text-ink tabular-nums";
    </script>
    
    <div class={panel}>
      <div class={balance}>
        <span class={balanceLabel}>Current balance</span>
        <span class={balanceValue}>Rp 245.000</span>
      </div>
      <CurrencyInput
        label="Top-up amount"
        name="amount"
        hint="Minimum Rp10.000, maximum Rp10.000.000"
        min={10000}
        max={10000000}
        defaultValue={100000}
        presets={[50000, 100000, 250000, 500000, 1000000]}
      />
      <Button>Top up balance</Button>
    </div>
    ---
    import Button from "@/components/markas/Button.astro";
    import CurrencyInput from "@/components/markas/CurrencyInput.astro";
    
    const panel = "grid gap-4 rounded-xl border border-line bg-surface p-5";
    const balance = "flex items-baseline justify-between";
    const balanceLabel = "text-sm text-muted";
    const balanceValue = "text-lg font-semibold text-ink tabular-nums";
    ---
    
    <div class={panel}>
      <div class={balance}>
        <span class={balanceLabel}>Current balance</span>
        <span class={balanceValue}>Rp 245.000</span>
      </div>
      <CurrencyInput
        label="Top-up amount"
        name="amount"
        hint="Minimum Rp10.000, maximum Rp10.000.000"
        min={10000}
        max={10000000}
        defaultValue={100000}
        presets={[50000, 100000, 250000, 500000, 1000000]}
      />
      <Button>Top up balance</Button>
    </div>
    import { Component } from "@angular/core";
    import { Button } from "./markas/button.component";
    import { CurrencyInput } from "./markas/currency-input.component";
    
    @Component({
      selector: "markas-example",
      imports: [Button, CurrencyInput],
      template: `
        <div [class]="panel">
          <div [class]="balance">
            <span [class]="balanceLabel">Current balance</span>
            <span [class]="balanceValue">Rp 245.000</span>
          </div>
          <markas-currency-input
            label="Top-up amount"
            name="amount"
            hint="Minimum Rp10.000, maximum Rp10.000.000"
            [min]="10000"
            [max]="10000000"
            [defaultValue]="100000"
            [presets]="presets"
          />
          <button markas-button>Top up balance</button>
        </div>
      `,
    })
    export default class CurrencyInputExample {
      protected readonly panel =
        "grid gap-4 rounded-xl border border-line bg-surface p-5";
      protected readonly balance = "flex items-baseline justify-between";
      protected readonly balanceLabel = "text-sm text-muted";
      protected readonly balanceValue =
        "text-lg font-semibold text-ink tabular-nums";
      protected readonly presets = [50000, 100000, 250000, 500000, 1000000];
    }

    Contoh

    Dolar AS

    $

    Billed in US dollars at the end of each month

    $

    Billed in US dollars at the end of each month

    $

    Billed in US dollars at the end of each month

    $

    Billed in US dollars at the end of each month

    $

    Billed in US dollars at the end of each month

    Status

    Rp

    Amount exceeds your daily limit of Rp5.000.000

    Rp
    Rp
    Rp

    Amount exceeds your daily limit of Rp5.000.000

    Rp
    Rp
    Rp

    Amount exceeds your daily limit of Rp5.000.000

    Rp
    Rp
    Rp

    Amount exceeds your daily limit of Rp5.000.000

    Rp
    Rp
    Rp

    Amount exceeds your daily limit of Rp5.000.000

    Rp
    Rp

    Donasi dengan nominal saran

    Support the village library

    Every rupiah goes to new books for 300 students.

    Rp

    Minimum Rp5.000

    Support the village library

    Every rupiah goes to new books for 300 students.

    Rp

    Minimum Rp5.000

    Support the village library

    Every rupiah goes to new books for 300 students.

    Rp

    Minimum Rp5.000

    Support the village library

    Every rupiah goes to new books for 300 students.

    Rp

    Minimum Rp5.000

    Support the village library

    Every rupiah goes to new books for 300 students.

    Rp

    Minimum Rp5.000

    Instalasi

    npx markasui@latest add currency-input

    Pemakaian

    <x-markas.currency-input
        label="Nominal top-up"
        name="amount"
        hint="Minimum Rp10.000"
        presets-label="Nominal cepat"
        :min="10000"
        :value="old('amount', 100000)"
        :presets="[50000, 100000, 250000, 500000]"
    />

    Butuh Alpine.js. Form menerima amount=100000, angka murni tanpa pemisah.

    Livewire

    <x-markas.currency-input label="Amount" wire:model.live.debounce.400ms="amount" :presets="[50000, 100000]" />

    wire:model terhubung ke angka polos (misalnya 12500000), bukan teks berformat. Perubahan dari server memformat ulang field. Chip preset juga memperbarui properti.

    import { CurrencyInput } from "@/components/markas/CurrencyInput";
    
    <CurrencyInput
      label="Nominal top-up"
      name="amount"
      hint="Minimum Rp10.000"
      presetsLabel="Nominal cepat"
      min={10000}
      defaultValue={100000}
      presets={[50000, 100000, 250000, 500000]}
      onValueChange={setNominal}
    />;
    <script setup lang="ts">
    import { ref } from "vue";
    import CurrencyInput from "@/components/markas/CurrencyInput.vue";
    
    const nominal = ref<number | null>(100000);
    </script>
    
    <template>
      <CurrencyInput
        v-model="nominal"
        label="Nominal top-up"
        name="amount"
        hint="Minimum Rp10.000"
        presets-label="Nominal cepat"
        :min="10000"
        :presets="[50000, 100000, 250000, 500000]"
      />
    </template>
    <script lang="ts">
      import CurrencyInput from "$lib/components/markas/CurrencyInput.svelte";
    
      let amount = $state<number | null>(100000);
    </script>
    
    <CurrencyInput
      label="Top-up amount"
      name="amount"
      hint="Minimum Rp10.000"
      min={10000}
      bind:value={amount}
      presets={[50000, 100000, 250000, 500000]}
    />
    ---
    import CurrencyInput from "@/components/markas/CurrencyInput.astro";
    ---
    
    <CurrencyInput
      label="Top-up amount"
      name="amount"
      hint="Minimum Rp10.000"
      min={10000}
      defaultValue={100000}
      presets={[50000, 100000, 250000, 500000]}
    />

    Custom element kecil memformat saat mengetik dan mengisi input tersembunyi. Ia mengirim event markas-change yang menggelembung dengan nominal (atau null) sebagai detail.

    import { Component, signal } from "@angular/core";
    import { CurrencyInput } from "./markas/currency-input.component";
    
    @Component({
      selector: "app-top-up",
      imports: [CurrencyInput],
      template: `
        <markas-currency-input
          label="Top-up amount"
          name="amount"
          hint="Minimum Rp10.000"
          [min]="10000"
          [(value)]="amount"
          [presets]="presets"
        />
      `,
    })
    export class TopUp {
      amount = signal<number | null>(100000);
      presets = [50000, 100000, 250000, 500000];
    }

    id, name, placeholder, aria-label, dan class jatuh ke field yang terlihat.

    • IDR adalah default: prefiks Rp, pemisah ribuan titik (12.500.000), tanpa desimal. currency="USD" beralih ke $, pemisah ribuan koma, dan maksimal dua desimal (1,250.50).
    • Pemisah ditambahkan saat mengetik dan kursor tetap di samping angka yang diketik. Backspace atau Delete di samping pemisah menghapus angka di sebelahnya.
    • Kolom yang terlihat tidak punya name. Isi name untuk merender input tersembunyi berisi angka murni, siap untuk form biasa.
    • min dan max membatasi nominal saat blur dan saat chip dipilih. Tetap validasi di server.
    • Chip menghitung angka menuju nominal baru dalam 400ms. Saat reduced motion nominal langsung berubah.
    • Atribut dan class jatuh ke kolom yang terlihat.

    Props

    NamaTipeDefaultKeterangan
    labelstring-Teks label, terhubung ke kolom lewat for dan id.
    hintstring-Petunjuk di bawah kolom. Disembunyikan saat error tampil.
    errorstring-Pesan error. Menyalakan aria-invalid dan border danger.
    currency'IDR' | 'USD'IDRIDR menampilkan Rp dengan pemisah ribuan titik tanpa desimal. USD menampilkan $ dengan pemisah ribuan koma dan maksimal dua desimal.
    minnumber-Nilai terendah. Nominal dibatasi saat blur dan saat chip dipilih.
    maxnumber-Nilai tertinggi. Nominal dibatasi saat blur dan saat chip dipilih.
    value / defaultValue / v-modelnumber | nullnullNominal awal. Blade memakai value, React memakai defaultValue dengan onValueChange, Vue memakai v-model.
    namestring-Nama input tersembunyi yang mengirim angka murni, misalnya 12500000. Kolom yang terlihat tidak punya name.
    presetsnumber[][]Chip nominal cepat di bawah kolom, berlabel singkat (50rb, 1jt, $1K). Memilih chip menghitung angka menuju nominal baru.
    presetsLabelstringQuick amountsNama aksesibel grup chip.
    idstringautoId kolom yang terlihat. Dibuat otomatis bila kosong.
    bind:value / [(value)]number | null-Svelte dan Angular. Binding dua arah untuk nominal. Svelte juga menerima onValueChange; Angular memancarkan valueChange.
    markas-changeCustomEvent<number | null>-Khusus Astro. Event menggelembung dengan nominal baru sebagai detail.

    Aksesibilitas

    • Label terhubung ke kolom, dan simbol mata uang, petunjuk, serta error dibacakan lewat aria-describedby.
    • Kolom memakai inputmode numeric atau decimal sehingga ponsel menampilkan keypad angka.
    • Chip adalah tombol toggle dalam grup berlabel; chip yang cocok dengan nominal punya aria-pressed true.
    • Saat reduced motion memilih chip langsung mengisi nominal tanpa animasi hitung.

    Komponen terkait

    Komponen markasui lain dengan class yang sama di setiap framework.