# Button

Tombol dengan varian primary, secondary, ghost, dan danger.

- Kategori: Form
- Status: stable
- Registry: https://markas.jenderalcorp.com/r/button.json
- CLI: `npx markasui@latest add button`

## Kapan dipakai

Aksi utama atau sekunder di form dan halaman.

- Satu tombol primary per area
- Gunakan ghost untuk aksi di toolbar
- Gunakan danger hanya untuk aksi yang menghapus atau tidak bisa dibatalkan

## Kode

### Blade

Simpan di `resources/views/components/markas/button.blade.php`. Tanpa dependensi tambahan.

```blade
@props([
    'variant' => 'primary',
    'size' => 'md',
])

@php
    $base = 'inline-flex items-center justify-center gap-2 font-medium whitespace-nowrap transition-colors duration-150 ease-out focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 motion-reduce:transition-none';
    $variants = [
        'primary' => 'bg-primary text-on-primary hover:bg-primary-strong',
        'secondary' => 'border border-line bg-surface text-ink hover:bg-subtle',
        'ghost' => 'text-ink hover:bg-subtle',
        'danger' => 'bg-danger text-on-primary hover:bg-danger/90',
    ];
    $sizes = [
        'sm' => 'h-8 rounded-md px-3 text-sm',
        'md' => 'h-10 rounded-lg px-4 text-sm',
        'lg' => 'h-12 rounded-lg px-6 text-base',
    ];
@endphp

<button {{ $attributes->merge(['type' => 'button'])->class([$base, $variants[$variant], $sizes[$size]]) }}>
    {{ $slot }}
</button>
```

```blade
<x-markas.button>Simpan</x-markas.button>
<x-markas.button variant="secondary" size="sm">Batal</x-markas.button>
<x-markas.button variant="danger" type="submit">Hapus akun</x-markas.button>
```

### React

Simpan di `src/components/markas/Button.tsx`. Tanpa dependensi tambahan.

```tsx
import type { ComponentProps } from "react";

const base =
  "inline-flex items-center justify-center gap-2 font-medium whitespace-nowrap transition-colors duration-150 ease-out focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 motion-reduce:transition-none";
const variants = {
  primary: "bg-primary text-on-primary hover:bg-primary-strong",
  secondary: "border border-line bg-surface text-ink hover:bg-subtle",
  ghost: "text-ink hover:bg-subtle",
  danger: "bg-danger text-on-primary hover:bg-danger/90",
};
const sizes = {
  sm: "h-8 rounded-md px-3 text-sm",
  md: "h-10 rounded-lg px-4 text-sm",
  lg: "h-12 rounded-lg px-6 text-base",
};
const cx = (...c: (string | false | null | undefined)[]) =>
  c.filter(Boolean).join(" ");

export type ButtonProps = ComponentProps<"button"> & {
  variant?: keyof typeof variants;
  size?: keyof typeof sizes;
};

export function Button({
  variant = "primary",
  size = "md",
  type = "button",
  className,
  ...props
}: ButtonProps) {
  return (
    <button
      type={type}
      className={cx(base, variants[variant], sizes[size], className)}
      {...props}
    />
  );
}
```

```tsx
import { Button } from "@/components/markas/Button";

<Button>Simpan</Button>
<Button variant="secondary" size="sm">Batal</Button>
<Button variant="danger" type="submit">Hapus akun</Button>
```

### Vue

Simpan di `src/components/markas/Button.vue`. Tanpa dependensi tambahan.

```vue
<script setup lang="ts">
const props = withDefaults(
  defineProps<{
    variant?: "primary" | "secondary" | "ghost" | "danger";
    size?: "sm" | "md" | "lg";
  }>(),
  { variant: "primary", size: "md" },
);

const base =
  "inline-flex items-center justify-center gap-2 font-medium whitespace-nowrap transition-colors duration-150 ease-out focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 motion-reduce:transition-none";
const variants = {
  primary: "bg-primary text-on-primary hover:bg-primary-strong",
  secondary: "border border-line bg-surface text-ink hover:bg-subtle",
  ghost: "text-ink hover:bg-subtle",
  danger: "bg-danger text-on-primary hover:bg-danger/90",
};
const sizes = {
  sm: "h-8 rounded-md px-3 text-sm",
  md: "h-10 rounded-lg px-4 text-sm",
  lg: "h-12 rounded-lg px-6 text-base",
};
</script>

<template>
  <button
    type="button"
    :class="[base, variants[props.variant], sizes[props.size]]"
  >
    <slot />
  </button>
</template>
```

```vue
<script setup lang="ts">
import Button from "@/components/markas/Button.vue";
</script>

<template>
  <Button>Simpan</Button>
  <Button variant="secondary" size="sm">Batal</Button>
  <Button variant="danger" type="submit">Hapus akun</Button>
</template>
```

### Svelte

Simpan di `src/lib/components/markas/Button.svelte`. Tanpa dependensi tambahan.

```svelte
<script lang="ts">
  import type { Snippet } from "svelte";
  import type { HTMLButtonAttributes } from "svelte/elements";

  const base =
    "inline-flex items-center justify-center gap-2 font-medium whitespace-nowrap transition-colors duration-150 ease-out focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 motion-reduce:transition-none";
  const variants = {
    primary: "bg-primary text-on-primary hover:bg-primary-strong",
    secondary: "border border-line bg-surface text-ink hover:bg-subtle",
    ghost: "text-ink hover:bg-subtle",
    danger: "bg-danger text-on-primary hover:bg-danger/90",
  };
  const sizes = {
    sm: "h-8 rounded-md px-3 text-sm",
    md: "h-10 rounded-lg px-4 text-sm",
    lg: "h-12 rounded-lg px-6 text-base",
  };

  type Props = HTMLButtonAttributes & {
    variant?: keyof typeof variants;
    size?: keyof typeof sizes;
    children?: Snippet;
  };

  let {
    variant = "primary",
    size = "md",
    type = "button",
    class: className,
    children,
    ...rest
  }: Props = $props();
</script>

<button
  {type}
  class={[base, variants[variant], sizes[size], className]}
  {...rest}
>
  {@render children?.()}
</button>
```

```svelte
<script lang="ts">
  import Button from "$lib/components/markas/Button.svelte";
</script>

<Button>Simpan</Button>
<Button variant="secondary" size="sm">Batal</Button>
<Button variant="danger" type="submit">Hapus akun</Button>
```

### Astro

Simpan di `src/components/markas/Button.astro`. Tanpa dependensi tambahan.

```astro
---
import type { HTMLAttributes } from "astro/types";

const base =
  "inline-flex items-center justify-center gap-2 font-medium whitespace-nowrap transition-colors duration-150 ease-out focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 motion-reduce:transition-none";
const variants = {
  primary: "bg-primary text-on-primary hover:bg-primary-strong",
  secondary: "border border-line bg-surface text-ink hover:bg-subtle",
  ghost: "text-ink hover:bg-subtle",
  danger: "bg-danger text-on-primary hover:bg-danger/90",
};
const sizes = {
  sm: "h-8 rounded-md px-3 text-sm",
  md: "h-10 rounded-lg px-4 text-sm",
  lg: "h-12 rounded-lg px-6 text-base",
};

type Props = HTMLAttributes<"button"> & {
  variant?: keyof typeof variants;
  size?: keyof typeof sizes;
};

const {
  variant = "primary",
  size = "md",
  type = "button",
  class: className,
  ...rest
} = Astro.props;
---

<button
  type={type}
  class:list={[base, variants[variant], sizes[size], className]}
  {...rest}
>
  <slot />
</button>
```

```astro
---
import Button from "@/components/markas/Button.astro";
---

<Button>Simpan</Button>
<Button variant="secondary" size="sm">Batal</Button>
<Button variant="danger" type="submit">Hapus akun</Button>
```

### Angular

Simpan di `src/app/markas/button.component.ts`. Tanpa dependensi tambahan.

```ts
import {
  ChangeDetectionStrategy,
  Component,
  computed,
  input,
} from "@angular/core";

const base =
  "inline-flex items-center justify-center gap-2 font-medium whitespace-nowrap transition-colors duration-150 ease-out focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 motion-reduce:transition-none";
const variants = {
  primary: "bg-primary text-on-primary hover:bg-primary-strong",
  secondary: "border border-line bg-surface text-ink hover:bg-subtle",
  ghost: "text-ink hover:bg-subtle",
  danger: "bg-danger text-on-primary hover:bg-danger/90",
};
const sizes = {
  sm: "h-8 rounded-md px-3 text-sm",
  md: "h-10 rounded-lg px-4 text-sm",
  lg: "h-12 rounded-lg px-6 text-base",
};

export type ButtonVariant = keyof typeof variants;
export type ButtonSize = keyof typeof sizes;

/**
 * Attribute selector on the native button: disabled, aria-*, name, value, and the user's
 * class stay on the button itself, so nothing has to be forwarded.
 */
@Component({
  selector: "button[markas-button]",
  changeDetection: ChangeDetectionStrategy.OnPush,
  host: { "[attr.type]": "type()", "[class]": "classes()" },
  template: `<ng-content />`,
})
export class Button {
  readonly variant = input<ButtonVariant>("primary");
  readonly size = input<ButtonSize>("md");
  readonly type = input<"button" | "submit" | "reset">("button");

  protected readonly classes = computed(
    () => `${base} ${variants[this.variant()]} ${sizes[this.size()]}`,
  );
}
```

```ts
import { Component } from "@angular/core";
import { Button } from "./markas/button.component";

@Component({
  selector: "app-aksi",
  imports: [Button],
  template: `
    <button markas-button>Simpan</button>
    <button markas-button variant="secondary" size="sm">Batal</button>
    <button markas-button variant="danger" type="submit">Hapus akun</button>
  `,
})
export class Aksi {}
```

Angular memakai attribute selector pada button native, jadi `disabled`, `aria-*`, dan `class` tetap di button.

## Props

| Nama | Tipe | Default | Keterangan |
| --- | --- | --- | --- |
| `variant` | `'primary' \| 'secondary' \| 'ghost' \| 'danger'` | primary | Gaya visual tombol. |
| `size` | `'sm' \| 'md' \| 'lg'` | md | Tinggi dan padding tombol. |
| `type` | `'button' \| 'submit' \| 'reset'` | button | Atribut type native. Default button agar tidak submit form tanpa sengaja. |

## Aksesibilitas

- Memakai elemen button native, jadi Enter dan Spasi langsung berfungsi.
- Fokus terlihat lewat outline 2px warna primary saat navigasi keyboard.
- Tombol yang hanya berisi ikon wajib diberi aria-label.

## Catatan

- Default `type="button"`. Isi `type="submit"` untuk tombol kirim form.
- Class tambahan digabung di akhir. Karena tanpa `tailwind-merge`, class yang bentrok (misalnya dua warna latar) bergantung pada urutan CSS Tailwind, jadi utamakan prop `variant` dan `size`.
