# Flip Button

Tombol yang berputar seperti kartu saat hover dan fokus keyboard untuk menampilkan teks kedua di sisi belakang.

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

## Kapan dipakai

Ajakan bertindak yang sisi belakangnya menambah detail meyakinkan, seperti ukuran file, harga, atau waktu yang dibutuhkan.

- Taruh aksi di depan, sisi belakang hanya menambah detail
- Jangan sembunyikan informasi penting di belakang, pengguna sentuh mungkin tidak pernah melihatnya
- Buat kedua sisi kurang lebih sama panjang

## Kode

### Blade

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

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

@php
    $base = 'group inline-grid font-medium whitespace-nowrap perspective-normal focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50';
    $sizes = [
        'sm' => 'h-8 rounded-md text-sm',
        'md' => 'h-10 rounded-lg text-sm',
        'lg' => 'h-12 rounded-lg text-base',
    ];
    $inner = 'grid rounded-[inherit] transition-transform duration-500 ease-out transform-3d group-hover:rotate-x-180 group-focus-visible:rotate-x-180 motion-reduce:transition-none';
    $face = 'col-start-1 row-start-1 inline-flex items-center justify-center gap-2 rounded-[inherit] backface-hidden';
    $facePadding = [
        'sm' => 'px-3',
        'md' => 'px-4',
        'lg' => 'px-6',
    ];
    $variants = [
        'primary' => 'bg-primary text-on-primary',
        'secondary' => 'border border-line bg-surface text-ink',
        'ghost' => 'text-ink',
        'danger' => 'bg-danger text-on-primary',
    ];
    $backVariants = [
        'primary' => 'rotate-x-180 bg-primary-strong text-on-primary',
        'secondary' => 'rotate-x-180 border border-primary-line bg-primary-soft text-ink',
        'ghost' => 'rotate-x-180 bg-subtle text-ink',
        'danger' => 'rotate-x-180 bg-danger text-on-primary',
    ];

    // Back face: the back slot wins, then back-label, then the main label.
    $back = $__laravel_slots['back'] ?? null;
@endphp

<button {{ $attributes->merge(['type' => 'button'])->class([$base, $sizes[$size]]) }}>
    <span class="{{ $inner }}">
        <span class="{{ $face }} {{ $facePadding[$size] }} {{ $variants[$variant] }}">{{ $slot }}</span>
        <span class="{{ $face }} {{ $facePadding[$size] }} {{ $backVariants[$variant] }}" aria-hidden="true">{{ $back ?? ($backLabel !== '' ? $backLabel : $slot) }}</span>
    </span>
</button>
```

```blade
<x-markas.flip-button back-label="Hanya 2 menit">Buat akun</x-markas.flip-button>

<x-markas.flip-button size="lg">
    Unduh laporan
    <x-slot:back>PDF, 2.4 MB</x-slot:back>
</x-markas.flip-button>
```

### React

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

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

const base =
  "group inline-grid font-medium whitespace-nowrap perspective-normal focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50";
const sizes = {
  sm: "h-8 rounded-md text-sm",
  md: "h-10 rounded-lg text-sm",
  lg: "h-12 rounded-lg text-base",
};
const inner =
  "grid rounded-[inherit] transition-transform duration-500 ease-out transform-3d group-hover:rotate-x-180 group-focus-visible:rotate-x-180 motion-reduce:transition-none";
const face =
  "col-start-1 row-start-1 inline-flex items-center justify-center gap-2 rounded-[inherit] backface-hidden";
const facePadding = {
  sm: "px-3",
  md: "px-4",
  lg: "px-6",
};
const variants = {
  primary: "bg-primary text-on-primary",
  secondary: "border border-line bg-surface text-ink",
  ghost: "text-ink",
  danger: "bg-danger text-on-primary",
};
const backVariants = {
  primary: "rotate-x-180 bg-primary-strong text-on-primary",
  secondary: "rotate-x-180 border border-primary-line bg-primary-soft text-ink",
  ghost: "rotate-x-180 bg-subtle text-ink",
  danger: "rotate-x-180 bg-danger text-on-primary",
};

const cx = (...c: (string | false | null | undefined)[]) =>
  c.filter(Boolean).join(" ");

export type FlipButtonProps = ComponentProps<"button"> & {
  variant?: keyof typeof variants;
  size?: keyof typeof sizes;
  /** Text on the back face, shown on hover and focus. Falls back to the label. */
  backLabel?: ReactNode;
};

export function FlipButton({
  variant = "primary",
  size = "md",
  backLabel,
  type = "button",
  className,
  children,
  ...props
}: FlipButtonProps) {
  return (
    <button type={type} className={cx(base, sizes[size], className)} {...props}>
      <span className={inner}>
        <span className={cx(face, facePadding[size], variants[variant])}>
          {children}
        </span>
        <span
          className={cx(face, facePadding[size], backVariants[variant])}
          aria-hidden="true"
        >
          {backLabel || children}
        </span>
      </span>
    </button>
  );
}
```

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

<FlipButton backLabel="Hanya 2 menit">Buat akun</FlipButton>
<FlipButton size="lg" backLabel={<>PDF, 2.4 MB</>}>Unduh laporan</FlipButton>
```

### Vue

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

```vue
<script setup lang="ts">
const sizes = {
  sm: "h-8 rounded-md text-sm",
  md: "h-10 rounded-lg text-sm",
  lg: "h-12 rounded-lg text-base",
};
const facePadding = {
  sm: "px-3",
  md: "px-4",
  lg: "px-6",
};
const variants = {
  primary: "bg-primary text-on-primary",
  secondary: "border border-line bg-surface text-ink",
  ghost: "text-ink",
  danger: "bg-danger text-on-primary",
};
const backVariants = {
  primary: "rotate-x-180 bg-primary-strong text-on-primary",
  secondary: "rotate-x-180 border border-primary-line bg-primary-soft text-ink",
  ghost: "rotate-x-180 bg-subtle text-ink",
  danger: "rotate-x-180 bg-danger text-on-primary",
};

const props = withDefaults(
  defineProps<{
    variant?: keyof typeof variants;
    size?: keyof typeof sizes;
    /** Text on the back face, shown on hover and focus. The back slot wins, the label is the fallback. */
    backLabel?: string;
  }>(),
  { variant: "primary", size: "md", backLabel: "" },
);

const base =
  "group inline-grid font-medium whitespace-nowrap perspective-normal focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50";
const inner =
  "grid rounded-[inherit] transition-transform duration-500 ease-out transform-3d group-hover:rotate-x-180 group-focus-visible:rotate-x-180 motion-reduce:transition-none";
const face =
  "col-start-1 row-start-1 inline-flex items-center justify-center gap-2 rounded-[inherit] backface-hidden";
</script>

<template>
  <button type="button" :class="[base, sizes[props.size]]">
    <span :class="inner">
      <span :class="[face, facePadding[props.size], variants[props.variant]]">
        <slot />
      </span>
      <span
        :class="[face, facePadding[props.size], backVariants[props.variant]]"
        aria-hidden="true"
      >
        <slot v-if="$slots.back" name="back" />
        <template v-else-if="props.backLabel">{{ props.backLabel }}</template>
        <slot v-else />
      </span>
    </span>
  </button>
</template>
```

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

<template>
  <FlipButton back-label="Hanya 2 menit">Buat akun</FlipButton>
  <FlipButton size="lg">
    Unduh laporan
    <template #back>PDF, 2.4 MB</template>
  </FlipButton>
</template>
```

### Svelte

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

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

  const base =
    "group inline-grid font-medium whitespace-nowrap perspective-normal focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50";
  const sizes = {
    sm: "h-8 rounded-md text-sm",
    md: "h-10 rounded-lg text-sm",
    lg: "h-12 rounded-lg text-base",
  };
  const inner =
    "grid rounded-[inherit] transition-transform duration-500 ease-out transform-3d group-hover:rotate-x-180 group-focus-visible:rotate-x-180 motion-reduce:transition-none";
  const face =
    "col-start-1 row-start-1 inline-flex items-center justify-center gap-2 rounded-[inherit] backface-hidden";
  const facePadding = {
    sm: "px-3",
    md: "px-4",
    lg: "px-6",
  };
  const variants = {
    primary: "bg-primary text-on-primary",
    secondary: "border border-line bg-surface text-ink",
    ghost: "text-ink",
    danger: "bg-danger text-on-primary",
  };
  const backVariants = {
    primary: "rotate-x-180 bg-primary-strong text-on-primary",
    secondary:
      "rotate-x-180 border border-primary-line bg-primary-soft text-ink",
    ghost: "rotate-x-180 bg-subtle text-ink",
    danger: "rotate-x-180 bg-danger text-on-primary",
  };

  type Props = HTMLButtonAttributes & {
    variant?: keyof typeof variants;
    size?: keyof typeof sizes;
    /** Text on the back face, shown on hover and focus. The back snippet wins, the label is the fallback. */
    backLabel?: string;
    back?: Snippet;
    children?: Snippet;
  };

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

<button {type} class={[base, sizes[size], className]} {...rest}>
  <span class={inner}>
    <span class={[face, facePadding[size], variants[variant]]}>
      {@render children?.()}
    </span>
    <span
      class={[face, facePadding[size], backVariants[variant]]}
      aria-hidden="true"
    >
      {#if back}{@render back()}{:else if backLabel}{backLabel}{:else}{@render children?.()}{/if}
    </span>
  </span>
</button>
```

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

<FlipButton backLabel="Hanya 2 menit">Buat akun</FlipButton>
<FlipButton size="lg">
  Unduh laporan
  {#snippet back()}PDF, 2.4 MB{/snippet}
</FlipButton>
```

### Astro

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

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

const base =
  "group inline-grid font-medium whitespace-nowrap perspective-normal focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50";
const sizes = {
  sm: "h-8 rounded-md text-sm",
  md: "h-10 rounded-lg text-sm",
  lg: "h-12 rounded-lg text-base",
};
const inner =
  "grid rounded-[inherit] transition-transform duration-500 ease-out transform-3d group-hover:rotate-x-180 group-focus-visible:rotate-x-180 motion-reduce:transition-none";
const face =
  "col-start-1 row-start-1 inline-flex items-center justify-center gap-2 rounded-[inherit] backface-hidden";
const facePadding = {
  sm: "px-3",
  md: "px-4",
  lg: "px-6",
};
const variants = {
  primary: "bg-primary text-on-primary",
  secondary: "border border-line bg-surface text-ink",
  ghost: "text-ink",
  danger: "bg-danger text-on-primary",
};
const backVariants = {
  primary: "rotate-x-180 bg-primary-strong text-on-primary",
  secondary: "rotate-x-180 border border-primary-line bg-primary-soft text-ink",
  ghost: "rotate-x-180 bg-subtle text-ink",
  danger: "rotate-x-180 bg-danger text-on-primary",
};

type Props = HTMLAttributes<"button"> & {
  variant?: keyof typeof variants;
  size?: keyof typeof sizes;
  /** Text on the back face, shown on hover and focus. The back slot wins, the label is the fallback. */
  backLabel?: string;
};

const {
  variant = "primary",
  size = "md",
  backLabel = "",
  type = "button",
  class: className,
  ...rest
} = Astro.props;
// Back face: the back slot wins, then backLabel, then the main label.
const label = await Astro.slots.render("default");
const back = Astro.slots.has("back")
  ? await Astro.slots.render("back")
  : null;
---

<button type={type} class:list={[base, sizes[size], className]} {...rest}>
  <span class={inner}>
    <span class:list={[face, facePadding[size], variants[variant]]}>
      <Fragment set:html={label} />
    </span>
    <span
      class:list={[face, facePadding[size], backVariants[variant]]}
      aria-hidden="true"
    >
      {back !== null ? <Fragment set:html={back} /> : backLabel || <Fragment set:html={label} />}
    </span>
  </span>
</button>
```

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

<FlipButton backLabel="Hanya 2 menit">Buat akun</FlipButton>
<FlipButton size="lg">
  Unduh laporan
  <Fragment slot="back">PDF, 2.4 MB</Fragment>
</FlipButton>
```

### Angular

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

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

const base =
  "group inline-grid font-medium whitespace-nowrap perspective-normal focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50";
const sizes = {
  sm: "h-8 rounded-md text-sm",
  md: "h-10 rounded-lg text-sm",
  lg: "h-12 rounded-lg text-base",
};
const inner =
  "grid rounded-[inherit] transition-transform duration-500 ease-out transform-3d group-hover:rotate-x-180 group-focus-visible:rotate-x-180 motion-reduce:transition-none";
const face =
  "col-start-1 row-start-1 inline-flex items-center justify-center gap-2 rounded-[inherit] backface-hidden";
const facePadding = {
  sm: "px-3",
  md: "px-4",
  lg: "px-6",
};
const variants = {
  primary: "bg-primary text-on-primary",
  secondary: "border border-line bg-surface text-ink",
  ghost: "text-ink",
  danger: "bg-danger text-on-primary",
};
const backVariants = {
  primary: "rotate-x-180 bg-primary-strong text-on-primary",
  secondary: "rotate-x-180 border border-primary-line bg-primary-soft text-ink",
  ghost: "rotate-x-180 bg-subtle text-ink",
  danger: "rotate-x-180 bg-danger text-on-primary",
};

export type FlipButtonVariant = keyof typeof variants;
export type FlipButtonSize = keyof typeof sizes;

/**
 * Attribute selector on the native button. Back face: an element with the `back` attribute
 * (an ng-container works) wins, then backLabel, then a copy of the main label.
 */
@Component({
  selector: "button[markas-flip-button]",
  changeDetection: ChangeDetectionStrategy.OnPush,
  host: { "[attr.type]": "type()", "[class]": "classes()" },
  template: `
    <span [class]="inner">
      <span #front [class]="frontClasses()"><ng-content /></span>
      <span #back [class]="backClasses()" aria-hidden="true">
        <ng-content select="[back]">{{ backLabel() }}</ng-content>
      </span>
    </span>
  `,
})
export class FlipButton {
  readonly variant = input<FlipButtonVariant>("primary");
  readonly size = input<FlipButtonSize>("md");
  /** Text on the back face, shown on hover and focus. The back slot wins, the label is the fallback. */
  readonly backLabel = input("");
  readonly type = input<"button" | "submit" | "reset">("button");

  protected readonly inner = inner;
  protected readonly classes = computed(() => `${base} ${sizes[this.size()]}`);
  protected readonly frontClasses = computed(
    () => `${face} ${facePadding[this.size()]} ${variants[this.variant()]}`,
  );
  protected readonly backClasses = computed(
    () => `${face} ${facePadding[this.size()]} ${backVariants[this.variant()]}`,
  );
  private readonly front = viewChild.required<ElementRef<HTMLElement>>("front");
  private readonly back = viewChild.required<ElementRef<HTMLElement>>("back");

  constructor() {
    // ng-content projects once, so an empty back face gets a copy of the main label.
    afterNextRender(() => {
      const back = this.back().nativeElement;
      if (back.childElementCount > 0 || back.textContent?.trim()) return;
      back.replaceChildren(
        ...[...this.front().nativeElement.childNodes].map((node) =>
          node.cloneNode(true),
        ),
      );
    });
  }
}
```

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

@Component({
  selector: "app-signup",
  imports: [FlipButton],
  template: `
    <button markas-flip-button backLabel="Hanya 2 menit">Buat akun</button>
    <button markas-flip-button size="lg">
      Unduh laporan
      <ng-container back>PDF, 2.4 MB</ng-container>
    </button>
  `,
})
export class Signup {}
```

Angular memakai attribute selector pada button native. Tanpa `backLabel` atau elemen `back`, sisi belakang mendapat salinan label setelah render pertama.

## Props

| Nama | Tipe | Default | Keterangan |
| --- | --- | --- | --- |
| `variant` | `'primary' \| 'secondary' \| 'ghost' \| 'danger'` | primary | Gaya visual, sama seperti Button. |
| `size` | `'sm' \| 'md' \| 'lg'` | md | Tinggi 32, 40, atau 48px, sama seperti Button. |
| `backLabel` | `string (React: ReactNode)` | - | Teks di sisi belakang. Vue, Blade, dan Astro juga menerima slot back, Svelte snippet back, Angular elemen dengan atribut back. Jika kosong memakai label utama. |
| `type` | `'button' \| 'submit' \| 'reset'` | button | Atribut type native. |

## Aksesibilitas

- Elemen button native, jadi Enter dan Spasi berfungsi dan fokus tampil sebagai outline 2px warna primary.
- Sisi belakang aria-hidden, jadi nama aksesibel selalu label depan.
- Fokus keyboard juga memutar tombol, jadi pengguna keyboard melihat teks belakang yang sama.
- Dengan prefers-reduced-motion sisi berganti tanpa putaran 3D.

## Catatan

- Murni CSS: tanpa JavaScript dan tanpa Alpine.js. Putaran berjalan saat hover dan fokus keyboard.
- Sisi belakang aria-hidden. Screen reader hanya membaca label depan.
- Perangkat sentuh tidak punya hover, jadi jangan taruh informasi penting hanya di sisi belakang.
