# Tooltip

> Memberi nama kontrol berisi ikon saja saat di-hover atau difokus.

Tooltip memberi nama kontrol berisi ikon saja saat di-hover atau difokus.

## Kapan dipakai

- Pakai untuk memberi label tombol ikon, misalnya unduh atau ubah.
- Cukup beberapa kata. Bantuan yang lebih panjang ditaruh di halaman.
- Jangan menaruh apa pun yang perlu diklik di dalam tooltip.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/tooltip/_

### Lakukan dan jangan

- **Lakukan:** Pakai tooltip untuk menamai tombol ikon dengan satu-dua kata.
- **Jangan:** Jangan sembunyikan instruksi atau kebijakan di tooltip.

## Anatomi

1. Tooltip di foreground
2. Pemicu berupa ikon saja

Label kecil berwarna terbalik (isi `foreground`, teks `background`) dengan `radius-md`, dan panah yang menunjuk ke kontrolnya.

## Varian

Hanya ada satu gaya. Tooltip bisa muncul di sisi mana pun dari kontrolnya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `TooltipProvider delay` | `TooltipProvider :delay-duration` | tidak ada | angka (ms) | bawaan provider | Jeda sebelum muncul. |
| `TooltipContent side` | `TooltipContent side` | `anchor` | `top` \| `right` \| `bottom` \| `left` | `top` | Posisi munculnya. |
| `TooltipTrigger render` | `TooltipTrigger as-child` | `child` | elemen | button | Kontrol yang diberi nama. |

## Kode

**React**
```tsx
import { DownloadIcon } from "lucide-react"
import { Button } from "@/components/ui/button"
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/ui/tooltip"

export default function TooltipDemo() {
  return (
    <TooltipProvider delay={0}>
      <Tooltip>
        <TooltipTrigger render={<Button variant="outline" size="icon" aria-label="Unduh laporan" />}>
          <DownloadIcon />
        </TooltipTrigger>
        <TooltipContent>Unduh laporan</TooltipContent>
      </Tooltip>
    </TooltipProvider>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Download } from "@lucide/vue"
import { Button } from "@/components/ui/button"
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/ui/tooltip"
</script>

<template>
  <TooltipProvider :delay-duration="0">
    <Tooltip>
      <TooltipTrigger as-child>
        <Button variant="outline" size="icon" aria-label="Unduh laporan"><Download /></Button>
      </TooltipTrigger>
      <TooltipContent>Unduh laporan</TooltipContent>
    </Tooltip>
  </TooltipProvider>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class TooltipDemo extends StatelessWidget {
  const TooltipDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadTooltip(
      builder: (context) => const Text('Unduh laporan'),
      child: ShadIconButton.outline(icon: const Icon(LucideIcons.download), onPressed: () {}),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/tooltip.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/tooltip.json
```

## Aksesibilitas

- Muncul saat fokus keyboard, bukan hanya saat hover.
- Kontrolnya tetap butuh `aria-label`. Tooltip membantu yang melihat layar, label membantu pengguna screen reader.
