Dice UI

Composition

A collection of utility functions for composing event handlers and refs in React components.

API

Installation

pnpm dlx shadcn@latest add @diceui/composition

Usage

composeRefs

Merges multiple refs into a single ref callback.

import { composeRefs } from "@/lib/compose-refs"
 
function MyComponent() {
  const localRef = useRef(null)
  const forwardedRef = useForwardedRef()
  
  return <div ref={composeRefs(localRef, forwardedRef)} />
}

useComposedRefs

React hook version of composeRefs.

import { useComposedRefs } from "@/lib/compose-refs"
 
function MyComponent({ ref }: { ref: React.Ref<HTMLDivElement> }) {
  const localRef = useRef(null)
  const composedRef = useComposedRefs(ref, localRef)
  
  return <div ref={composedRef} />
}

API Reference

composeRefs

Prop

Type

useComposedRefs

Prop

Type

On this page