@base-ui-components/react/composite/list/useCompositeListItem.d.ts

Base UI is a library of headless ('unstyled') React components and low-level hooks. You gain complete control over your app's CSS and accessibility features.

import * as React from 'react';
export interface UseCompositeListItemParameters<Metadata> {
  index?: number;
  label?: string | null;
  metadata?: Metadata;
  textRef?: React.RefObject<HTMLElement | null>;
  /** Enables guessing the indexes. This avoids a re-render after mount, which is useful for
   * large lists. This should be used for lists that are likely flat and vertical, other cases
   * might trigger a re-render anyway. */
  indexGuessBehavior?: IndexGuessBehavior;
}
interface UseCompositeListItemReturnValue {
  ref: (node: HTMLElement | null) => void;
  index: number;
}
export declare enum IndexGuessBehavior {
  None = 0,
  GuessFromOrder = 1,
}
/**
 * Used to register a list item and its index (DOM position) in the `CompositeList`.
 */
export declare function useCompositeListItem<Metadata>(params?: UseCompositeListItemParameters<Metadata>): UseCompositeListItemReturnValue;
export {};