Desenvolvedores
src_
components_
ui_
ScrollArea.jsx

Explicação detalhada 💡

Este código cria um componente customizado de área de rolagem (scroll area) em React, utilizando a biblioteca @radix-ui/react-scroll-area. Ele permite criar áreas de conteúdo rolável com barras de rolagem verticais ou horizontais, além de personalizar a aparência das barras de rolagem.

Código: Importação de dependências 🧩

import * as React from "react"
import * as ScrollAreaPrimitive from "@radix-ui/react-scroll-area"
import { cn } from "@/lib/utils"
  • React: Importa o React, necessário para criar os componentes React.
  • ScrollAreaPrimitive: Importa os componentes primitivos da biblioteca @radix-ui/react-scroll-area, que fornecem a funcionalidade básica para áreas de rolagem e barras de rolagem.
  • cn: Função utilitária para combinar e gerenciar classes CSS de maneira condicional. Ela ajuda a adicionar ou modificar dinamicamente as classes baseadas em condições.

Componente ScrollArea 📜

const ScrollArea = React.forwardRef(({ className, children, ...props }, ref) => (
  <ScrollAreaPrimitive.Root
    ref={ref}
    className={cn("relative overflow-hidden", className)}
    {...props}>
    <ScrollAreaPrimitive.Viewport className="h-full w-full rounded-[inherit]">
      {children}
    </ScrollAreaPrimitive.Viewport>
    <ScrollBar />
    <ScrollAreaPrimitive.Corner />
  </ScrollAreaPrimitive.Root>
))
ScrollArea.displayName = ScrollAreaPrimitive.Root.displayName
  • ScrollArea: Este componente envolve a área de conteúdo rolável, utilizando o Root da biblioteca Radix. Ele configura a área de rolagem e posiciona a barra de rolagem.
    • className: Permite que o estilo seja customizado via classes CSS.
    • children: O conteúdo dentro da área de rolagem será passado como children e renderizado dentro de Viewport.
    • overflow-hidden: Garante que o conteúdo que excede o limite da área visível seja ocultado.
    • Viewport: A área visível dentro da rolagem.
    • ScrollBar: Chama o componente de barra de rolagem.
    • Corner: A biblioteca também oferece a possibilidade de adicionar um canto, que é um elemento visual opcional.

Componente ScrollBar 🧭

const ScrollBar = React.forwardRef(({ className, orientation = "vertical", ...props }, ref) => (
  <ScrollAreaPrimitive.ScrollAreaScrollbar
    ref={ref}
    orientation={orientation}
    className={cn(
      "flex touch-none select-none transition-colors",
      orientation === "vertical" &&
        "h-full w-2.5 border-l border-l-transparent p-[1px]",
      orientation === "horizontal" &&
        "h-2.5 flex-col border-t border-t-transparent p-[1px]",
      className
    )}
    {...props}>
    <ScrollAreaPrimitive.ScrollAreaThumb className="relative flex-1 rounded-full bg-border" />
  </ScrollAreaPrimitive.ScrollAreaScrollbar>
))
ScrollBar.displayName = ScrollAreaPrimitive.ScrollAreaScrollbar.displayName
  • ScrollBar: Este componente define a barra de rolagem. Ele pode ser vertical ou horizontal, e sua aparência e estilo podem ser customizados.
    • orientation: Define a orientação da barra de rolagem, podendo ser "vertical" ou "horizontal". A orientação é passada como uma propriedade.
    • className: Permite a personalização das classes CSS da barra de rolagem.
    • transition-colors: Aplica uma transição de cores quando a barra de rolagem é manipulada.
    • ScrollAreaThumb: O "polegar" da barra de rolagem, que é a parte que o usuário pode arrastar para rolar o conteúdo. Ele tem uma aparência arredondada e um fundo específico (classe bg-border).

Exemplo de uso 💻

<ScrollArea>
  <div style={{ height: "2000px", padding: "20px" }}>
    Conteúdo rolável aqui
  </div>
</ScrollArea>

Código Completo 📄

"use client"
 
import * as React from "react"
import * as ScrollAreaPrimitive from "@radix-ui/react-scroll-area"
import { cn } from "@/lib/utils"
 
const ScrollArea = React.forwardRef(({ className, children, ...props }, ref) => (
  <ScrollAreaPrimitive.Root
    ref={ref}
    className={cn("relative overflow-hidden", className)}
    {...props}>
    <ScrollAreaPrimitive.Viewport className="h-full w-full rounded-[inherit]">
      {children}
    </ScrollAreaPrimitive.Viewport>
    <ScrollBar />
    <ScrollAreaPrimitive.Corner />
  </ScrollAreaPrimitive.Root>
))
ScrollArea.displayName = ScrollAreaPrimitive.Root.displayName
 
const ScrollBar = React.forwardRef(({ className, orientation = "vertical", ...props }, ref) => (
  <ScrollAreaPrimitive.ScrollAreaScrollbar
    ref={ref}
    orientation={orientation}
    className={cn(
      "flex touch-none select-none transition-colors",
      orientation === "vertical" &&
        "h-full w-2.5 border-l border-l-transparent p-[1px]",
      orientation === "horizontal" &&
        "h-2.5 flex-col border-t border-t-transparent p-[1px]",
      className
    )}
    {...props}>
    <ScrollAreaPrimitive.ScrollAreaThumb className="relative flex-1 rounded-full bg-border" />
  </ScrollAreaPrimitive.ScrollAreaScrollbar>
))
ScrollBar.displayName = ScrollAreaPrimitive.ScrollAreaScrollbar.displayName
 
export { ScrollArea, ScrollBar }
Resizable.jsxSelect.jsx