PetAcademy - Documentação

Explicação detalhada 💡

Neste arquivo, estamos criando um componente que utiliza o Radix UI para implementar um HoverCard. Este componente exibe um conteúdo extra (geralmente uma dica ou descrição) quando o usuário passa o mouse sobre um elemento. Vamos analisar a estrutura do código:

Código: Importação dos módulos necessários 🧩

import * as React from "react"
import * as HoverCardPrimitive from "@radix-ui/react-hover-card"
import { cn } from "@/lib/utils"

Aqui estamos importando as dependências necessárias:

React é importado para poder criar componentes React.
HoverCardPrimitive é o módulo do Radix UI que contém a implementação do HoverCard.
A função cn é uma função de utilitário que provavelmente junta classes CSS de maneira condicional.

Componente HoverCard 🖱️

const HoverCard = HoverCardPrimitive.Root

Aqui estamos definindo o componente principal HoverCard, que é o ponto de entrada para o comportamento de exibição do cartão de dicas. Ele é envolto pelo HoverCardPrimitive.Root, que gerencia o estado do componente, como quando ele deve ser exibido.

Componente HoverCardTrigger 🔑

const HoverCardTrigger = HoverCardPrimitive.Trigger

Este é o componente que "dispara" a exibição do conteúdo ao passar o mouse sobre ele. O Trigger é responsável por definir o elemento que o usuário irá interagir.

Componente HoverCardContent 💬

const HoverCardContent = React.forwardRef(({ className, align = "center", sideOffset = 4, ...props }, ref) => (
  <HoverCardPrimitive.Content
    ref={ref}
    align={align}
    sideOffset={sideOffset}
    className={cn(
      "z-50 w-64 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
      className
    )}
    {...props}
  />
))

Aqui, criamos o componente HoverCardContent, que renderiza o conteúdo do cartão. Esse conteúdo é exibido quando o usuário interage com o HoverCardTrigger. Algumas características desse componente:

align: alinha o conteúdo do cartão. O valor padrão é "center", mas pode ser alterado para outras opções (como "top", "left", etc.).
sideOffset: define o deslocamento do cartão em relação ao trigger.
className: permite adicionar classes CSS adicionais, fornecendo personalização ao estilo do componente.

O código usa o cn para combinar várias classes CSS, que gerenciam animações, sombras, transições e o estilo geral do cartão. As animações garantem que o cartão apareça e desapareça suavemente.

Exemplo de uso 💻

Aqui está um exemplo de como você pode usar o componente HoverCard em um aplicativo React:

<HoverCard>
  <HoverCardTrigger>
    Passa o mouse aqui! ✨
  </HoverCardTrigger>
  <HoverCardContent>
    Aqui está o conteúdo que aparece quando o mouse está sobre o trigger! 📝
  </HoverCardContent>
</HoverCard>

Código Completo 📄

"use client"
 
import * as React from "react"
import * as HoverCardPrimitive from "@radix-ui/react-hover-card"
 
import { cn } from "@/lib/utils"
 
const HoverCard = HoverCardPrimitive.Root
 
const HoverCardTrigger = HoverCardPrimitive.Trigger
 
const HoverCardContent = React.forwardRef(({ className, align = "center", sideOffset = 4, ...props }, ref) => (
  <HoverCardPrimitive.Content
    ref={ref}
    align={align}
    sideOffset={sideOffset}
    className={cn(
      "z-50 w-64 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
      className
    )}
    {...props} />
))
HoverCardContent.displayName = HoverCardPrimitive.Content.displayName
 
export { HoverCard, HoverCardTrigger, HoverCardContent }

Form.jsx Input.jsx