Tooltip
Tooltip memberi nama kontrol berisi ikon saja saat di-hover atau difokus.
Kapan dipakai
Section titled “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.
Lakukan dan jangan
Section titled “Lakukan dan jangan”Anatomi
Section titled “Anatomi”- 1Tooltip di foreground
- 2Pemicu berupa ikon saja
Label kecil berwarna terbalik (isi foreground, teks background) dengan radius-md, dan panah yang menunjuk ke kontrolnya.
Varian
Section titled “Varian”Hanya ada satu gaya. Tooltip bisa muncul di sisi mana pun dari kontrolnya.
| 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. |
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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/tooltip.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/tooltip.jsonAksesibilitas
Section titled “Aksesibilitas”- Muncul saat fokus keyboard, bukan hanya saat hover.
- Kontrolnya tetap butuh
aria-label. Tooltip membantu yang melihat layar, label membantu pengguna screen reader.
