# Spotlight Card

Kartu dengan sorotan radial lembut yang mengikuti kursor dan border yang menyala di dekatnya. Ikut menyala saat fokus keyboard.

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

## Kapan dipakai

Kartu fitur, harga, atau status di landing page yang bereaksi terhadap kursor.

- Tambahkan padding di isi kartu, bukan di komponen
- Pakai beberapa spotlight card per bagian; Card biasa lebih cocok untuk daftar padat
- Blade butuh Alpine.js

## Kode

### Blade

Simpan di `resources/views/components/markas/spotlight-card.blade.php`. Dependensi: alpinejs.

```blade
@props([
    'color' => 'primary',
])

@php
    $root = 'group/spotlight relative isolate rounded-xl bg-line p-px [--spot-x:50%] [--spot-y:50%]';
    $glow = 'pointer-events-none absolute inset-0 rounded-[inherit] bg-[radial-gradient(240px_circle_at_var(--spot-x)_var(--spot-y),var(--spot-color),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none';
    $inner = 'relative h-full overflow-hidden rounded-[11px] bg-surface';
    $light = 'pointer-events-none absolute inset-0 bg-[radial-gradient(320px_circle_at_var(--spot-x)_var(--spot-y),color-mix(in_oklab,var(--spot-color)_12%,transparent),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none';
    $content = 'relative';
    $colors = [
        'primary' => '[--spot-color:var(--color-primary)]',
        'success' => '[--spot-color:var(--color-success)]',
        'warning' => '[--spot-color:var(--color-warning)]',
        'danger' => '[--spot-color:var(--color-danger)]',
    ];
@endphp

{{-- Simpan posisi kursor relatif terhadap kartu sebagai CSS custom property. --}}
<div
    x-data
    @pointermove="
        const rect = $el.getBoundingClientRect();
        $el.style.setProperty('--spot-x', ($event.clientX - rect.left) + 'px');
        $el.style.setProperty('--spot-y', ($event.clientY - rect.top) + 'px');
    "
    {{ $attributes->class([$root, $colors[$color]]) }}
>
    <div aria-hidden="true" class="{{ $glow }}"></div>
    <div class="{{ $inner }}">
        <div aria-hidden="true" class="{{ $light }}"></div>
        <div class="{{ $content }}">{{ $slot }}</div>
    </div>
</div>
```

```blade
<x-markas.spotlight-card>
    <div class="p-6">
        <h3 class="font-semibold">Pratinjau instan</h3>
        <p class="text-sm text-muted">Setiap pull request punya tautannya sendiri.</p>
    </div>
</x-markas.spotlight-card>

<x-markas.spotlight-card color="success">...</x-markas.spotlight-card>
```

### React

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

```tsx
"use client";

import type { ComponentProps, PointerEvent } from "react";

const root =
  "group/spotlight relative isolate rounded-xl bg-line p-px [--spot-x:50%] [--spot-y:50%]";
const glow =
  "pointer-events-none absolute inset-0 rounded-[inherit] bg-[radial-gradient(240px_circle_at_var(--spot-x)_var(--spot-y),var(--spot-color),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
const inner = "relative h-full overflow-hidden rounded-[11px] bg-surface";
const light =
  "pointer-events-none absolute inset-0 bg-[radial-gradient(320px_circle_at_var(--spot-x)_var(--spot-y),color-mix(in_oklab,var(--spot-color)_12%,transparent),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
const content = "relative";
const colors = {
  primary: "[--spot-color:var(--color-primary)]",
  success: "[--spot-color:var(--color-success)]",
  warning: "[--spot-color:var(--color-warning)]",
  danger: "[--spot-color:var(--color-danger)]",
};

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

/** Simpan posisi kursor relatif terhadap kartu sebagai CSS custom property. */
function follow(event: PointerEvent<HTMLDivElement>) {
  const card = event.currentTarget;
  const rect = card.getBoundingClientRect();
  card.style.setProperty("--spot-x", `${event.clientX - rect.left}px`);
  card.style.setProperty("--spot-y", `${event.clientY - rect.top}px`);
}

export type SpotlightCardProps = ComponentProps<"div"> & {
  color?: keyof typeof colors;
};

export function SpotlightCard({
  color = "primary",
  className,
  children,
  onPointerMove,
  ...props
}: SpotlightCardProps) {
  return (
    <div
      {...props}
      className={cx(root, colors[color], className)}
      onPointerMove={(event) => {
        follow(event);
        onPointerMove?.(event);
      }}
    >
      <div aria-hidden="true" className={glow} />
      <div className={inner}>
        <div aria-hidden="true" className={light} />
        <div className={content}>{children}</div>
      </div>
    </div>
  );
}
```

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

<SpotlightCard>
  <div className="p-6">
    <h3 className="font-semibold">Pratinjau instan</h3>
    <p className="text-sm text-muted">Setiap pull request punya tautannya sendiri.</p>
  </div>
</SpotlightCard>

<SpotlightCard color="success">...</SpotlightCard>
```

### Vue

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

```vue
<script setup lang="ts">
const props = withDefaults(
  defineProps<{
    color?: "primary" | "success" | "warning" | "danger";
  }>(),
  { color: "primary" },
);

const root =
  "group/spotlight relative isolate rounded-xl bg-line p-px [--spot-x:50%] [--spot-y:50%]";
const glow =
  "pointer-events-none absolute inset-0 rounded-[inherit] bg-[radial-gradient(240px_circle_at_var(--spot-x)_var(--spot-y),var(--spot-color),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
const inner = "relative h-full overflow-hidden rounded-[11px] bg-surface";
const light =
  "pointer-events-none absolute inset-0 bg-[radial-gradient(320px_circle_at_var(--spot-x)_var(--spot-y),color-mix(in_oklab,var(--spot-color)_12%,transparent),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
const content = "relative";
const colors = {
  primary: "[--spot-color:var(--color-primary)]",
  success: "[--spot-color:var(--color-success)]",
  warning: "[--spot-color:var(--color-warning)]",
  danger: "[--spot-color:var(--color-danger)]",
};

/** Simpan posisi kursor relatif terhadap kartu sebagai CSS custom property. */
function follow(event: PointerEvent) {
  const card = event.currentTarget as HTMLElement;
  const rect = card.getBoundingClientRect();
  card.style.setProperty("--spot-x", `${event.clientX - rect.left}px`);
  card.style.setProperty("--spot-y", `${event.clientY - rect.top}px`);
}
</script>

<template>
  <div :class="[root, colors[props.color]]" @pointermove="follow">
    <div aria-hidden="true" :class="glow"></div>
    <div :class="inner">
      <div aria-hidden="true" :class="light"></div>
      <div :class="content"><slot /></div>
    </div>
  </div>
</template>
```

```vue
<template>
  <SpotlightCard>
    <div class="p-6">
      <h3 class="font-semibold">Pratinjau instan</h3>
      <p class="text-sm text-muted">
        Setiap pull request punya tautannya sendiri.
      </p>
    </div>
  </SpotlightCard>

  <SpotlightCard color="success">...</SpotlightCard>
</template>
```

### Svelte

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

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

  const root =
    "group/spotlight relative isolate rounded-xl bg-line p-px [--spot-x:50%] [--spot-y:50%]";
  const glow =
    "pointer-events-none absolute inset-0 rounded-[inherit] bg-[radial-gradient(240px_circle_at_var(--spot-x)_var(--spot-y),var(--spot-color),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
  const inner = "relative h-full overflow-hidden rounded-[11px] bg-surface";
  const light =
    "pointer-events-none absolute inset-0 bg-[radial-gradient(320px_circle_at_var(--spot-x)_var(--spot-y),color-mix(in_oklab,var(--spot-color)_12%,transparent),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
  const content = "relative";
  const colors = {
    primary: "[--spot-color:var(--color-primary)]",
    success: "[--spot-color:var(--color-success)]",
    warning: "[--spot-color:var(--color-warning)]",
    danger: "[--spot-color:var(--color-danger)]",
  };

  /** Stores the pointer position relative to the card as CSS custom properties. */
  function follow(event: PointerEvent & { currentTarget: HTMLDivElement }) {
    const card = event.currentTarget;
    const rect = card.getBoundingClientRect();
    card.style.setProperty("--spot-x", `${event.clientX - rect.left}px`);
    card.style.setProperty("--spot-y", `${event.clientY - rect.top}px`);
  }

  type Props = HTMLAttributes<HTMLDivElement> & {
    color?: keyof typeof colors;
    children?: Snippet;
  };

  let {
    color = "primary",
    class: className,
    children,
    onpointermove,
    ...rest
  }: Props = $props();

  function handlePointerMove(
    event: PointerEvent & { currentTarget: EventTarget & HTMLDivElement },
  ) {
    follow(event);
    onpointermove?.(event);
  }
</script>

<div
  {...rest}
  class={[root, colors[color], className]}
  onpointermove={handlePointerMove}
>
  <div aria-hidden="true" class={glow}></div>
  <div class={inner}>
    <div aria-hidden="true" class={light}></div>
    <div class={content}>{@render children?.()}</div>
  </div>
</div>
```

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

<SpotlightCard>
  <div class="p-6">
    <h3 class="font-semibold">Instant previews</h3>
    <p class="text-sm text-muted">Every pull request gets its own link.</p>
  </div>
</SpotlightCard>
```

### Astro

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

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

const root =
  "group/spotlight relative isolate rounded-xl bg-line p-px [--spot-x:50%] [--spot-y:50%]";
const glow =
  "pointer-events-none absolute inset-0 rounded-[inherit] bg-[radial-gradient(240px_circle_at_var(--spot-x)_var(--spot-y),var(--spot-color),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
const inner = "relative h-full overflow-hidden rounded-[11px] bg-surface";
const light =
  "pointer-events-none absolute inset-0 bg-[radial-gradient(320px_circle_at_var(--spot-x)_var(--spot-y),color-mix(in_oklab,var(--spot-color)_12%,transparent),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
const content = "relative";
const colors = {
  primary: "[--spot-color:var(--color-primary)]",
  success: "[--spot-color:var(--color-success)]",
  warning: "[--spot-color:var(--color-warning)]",
  danger: "[--spot-color:var(--color-danger)]",
};

type Props = HTMLAttributes<"div"> & {
  color?: keyof typeof colors;
};

const { color = "primary", class: className, ...rest } = Astro.props;
---

<div data-markas-spotlight-card {...rest} class:list={[root, colors[color], className]}>
  <div aria-hidden="true" class={glow}></div>
  <div class={inner}>
    <div aria-hidden="true" class={light}></div>
    <div class={content}><slot /></div>
  </div>
</div>

<script>
  // One listener per page serves every card, including markup added later and pages
  // reached through view transitions. Stores the pointer position relative to the card.
  document.addEventListener(
    "pointermove",
    (event) => {
      const card = (event.target as Element | null)?.closest?.<HTMLElement>(
        "[data-markas-spotlight-card]",
      );
      if (!card) return;
      const rect = card.getBoundingClientRect();
      card.style.setProperty("--spot-x", `${event.clientX - rect.left}px`);
      card.style.setProperty("--spot-y", `${event.clientY - rect.top}px`);
    },
    { passive: true },
  );
</script>
```

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

<SpotlightCard color="success">
  <div class="p-6">
    <h3 class="font-semibold">Instant previews</h3>
    <p class="text-sm text-muted">Every pull request gets its own link.</p>
  </div>
</SpotlightCard>
```

### Angular

Simpan di `src/app/markas/spotlight-card.component.ts`. Tanpa dependensi tambahan.

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

const root =
  "group/spotlight relative isolate rounded-xl bg-line p-px [--spot-x:50%] [--spot-y:50%]";
const glow =
  "pointer-events-none absolute inset-0 rounded-[inherit] bg-[radial-gradient(240px_circle_at_var(--spot-x)_var(--spot-y),var(--spot-color),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
const inner = "relative h-full overflow-hidden rounded-[11px] bg-surface";
const light =
  "pointer-events-none absolute inset-0 bg-[radial-gradient(320px_circle_at_var(--spot-x)_var(--spot-y),color-mix(in_oklab,var(--spot-color)_12%,transparent),transparent_100%)] opacity-0 transition-opacity duration-300 ease-out group-focus-within/spotlight:opacity-100 group-hover/spotlight:opacity-100 motion-reduce:transition-none";
const content = "relative";
const colors = {
  primary: "[--spot-color:var(--color-primary)]",
  success: "[--spot-color:var(--color-success)]",
  warning: "[--spot-color:var(--color-warning)]",
  danger: "[--spot-color:var(--color-danger)]",
};

export type SpotlightCardColor = keyof typeof colors;

/** Attribute selector on the card div: class and other attributes stay on it. */
@Component({
  selector: "div[markas-spotlight-card]",
  changeDetection: ChangeDetectionStrategy.OnPush,
  host: {
    "[class]": "classes()",
    "(pointermove)": "follow($event)",
  },
  template: `
    <div aria-hidden="true" [class]="glow"></div>
    <div [class]="inner">
      <div aria-hidden="true" [class]="light"></div>
      <div [class]="content"><ng-content /></div>
    </div>
  `,
})
export class SpotlightCard {
  readonly color = input<SpotlightCardColor>("primary");

  protected readonly glow = glow;
  protected readonly inner = inner;
  protected readonly light = light;
  protected readonly content = content;
  protected readonly classes = computed(
    () => `${root} ${colors[this.color()]}`,
  );

  /** Stores the pointer position relative to the card as CSS custom properties. */
  protected follow(event: PointerEvent) {
    const card = event.currentTarget as HTMLElement;
    const rect = card.getBoundingClientRect();
    card.style.setProperty("--spot-x", `${event.clientX - rect.left}px`);
    card.style.setProperty("--spot-y", `${event.clientY - rect.top}px`);
  }
}
```

```ts
import { Component } from "@angular/core";
import { SpotlightCard } from "./markas/spotlight-card.component";

@Component({
  selector: "app-feature",
  imports: [SpotlightCard],
  template: `
    <div markas-spotlight-card color="success">
      <div class="p-6">
        <h3 class="font-semibold">Instant previews</h3>
        <p class="text-sm text-muted">Every pull request gets its own link.</p>
      </div>
    </div>
  `,
})
export class Feature {}
```

## Props

| Nama | Tipe | Default | Keterangan |
| --- | --- | --- | --- |
| `color` | `'primary' \| 'success' \| 'warning' \| 'danger'` | primary | Warna sorotan dan border yang menyala. |
| `children / slot` | `ReactNode / slot` | - | Isi kartu. Tambahkan padding sendiri, misalnya p-6. |

## Aksesibilitas

- Sorotan dan border yang menyala adalah lapisan aria-hidden yang tidak pernah menangkap pointer.
- Saat fokus berpindah ke dalam kartu, cahaya muncul di tengah, jadi pengguna keyboard melihat efek yang sama.
- Dengan reduced motion, cahaya muncul tanpa transisi pudar.

## Catatan

- Posisi kursor disimpan di custom property `--spot-x` dan `--spot-y`; sorotan dan border berupa gradien radial CSS.
- Fokus di dalam kartu menampilkan cahaya di tengah, jadi pengguna keyboard mendapat umpan balik yang sama. Versi Blade butuh Alpine.js.
- Class dan atribut jatuh ke elemen luar. Tambahkan padding di dalam isi kartu.
