@base-ui-components/react
Version:
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.
99 lines (97 loc) • 3.55 kB
JavaScript
'use client';
import * as React from 'react';
import PropTypes from 'prop-types';
import { useComponentRenderer } from '../../utils/useComponentRenderer.js';
import { useScrollAreaRootContext } from '../root/ScrollAreaRootContext.js';
import { useForkRef } from '../../utils/useForkRef.js';
import { ScrollAreaScrollbarContext } from './ScrollAreaScrollbarContext.js';
import { useScrollAreaScrollbar } from './useScrollAreaScrollbar.js';
/**
* A vertical or horizontal scrollbar for the scroll area.
* Renders a `<div>` element.
*
* Documentation: [Base UI Scroll Area](https://base-ui.com/react/components/scroll-area)
*/
import { jsx as _jsx } from "react/jsx-runtime";
const ScrollAreaScrollbar = /*#__PURE__*/React.forwardRef(function ScrollAreaScrollbar(props, forwardedRef) {
const {
render,
className,
orientation = 'vertical',
keepMounted = false,
...otherProps
} = props;
const {
hovering,
scrolling,
hiddenState,
scrollbarYRef,
scrollbarXRef
} = useScrollAreaRootContext();
const mergedRef = useForkRef(forwardedRef, orientation === 'vertical' ? scrollbarYRef : scrollbarXRef);
const state = React.useMemo(() => ({
hovering,
scrolling,
orientation
}), [hovering, scrolling, orientation]);
const {
getScrollbarProps
} = useScrollAreaScrollbar({
orientation
});
const {
renderElement
} = useComponentRenderer({
propGetter: getScrollbarProps,
render: render ?? 'div',
ref: mergedRef,
className,
state,
extraProps: otherProps
});
const contextValue = React.useMemo(() => ({
orientation
}), [orientation]);
const isHidden = orientation === 'vertical' ? hiddenState.scrollbarYHidden : hiddenState.scrollbarXHidden;
const shouldRender = keepMounted || !isHidden;
if (!shouldRender) {
return null;
}
return /*#__PURE__*/_jsx(ScrollAreaScrollbarContext.Provider, {
value: contextValue,
children: renderElement()
});
});
process.env.NODE_ENV !== "production" ? ScrollAreaScrollbar.propTypes /* remove-proptypes */ = {
// ┌────────────────────────────── Warning ──────────────────────────────┐
// │ These PropTypes are generated from the TypeScript type definitions. │
// │ To update them, edit the TypeScript types and run `pnpm proptypes`. │
// └─────────────────────────────────────────────────────────────────────┘
/**
* @ignore
*/
children: PropTypes.node,
/**
* CSS class applied to the element, or a function that
* returns a class based on the component’s state.
*/
className: PropTypes.oneOfType([PropTypes.func, PropTypes.string]),
/**
* Whether to keep the HTML element in the DOM when the viewport isn’t scrollable.
* @default false
*/
keepMounted: PropTypes.bool,
/**
* Whether the scrollbar controls vertical or horizontal scroll.
* @default 'vertical'
*/
orientation: PropTypes.oneOf(['horizontal', 'vertical']),
/**
* Allows you to replace the component’s HTML element
* with a different tag, or compose it with another component.
*
* Accepts a `ReactElement` or a function that returns the element to render.
*/
render: PropTypes.oneOfType([PropTypes.element, PropTypes.func])
} : void 0;
export { ScrollAreaScrollbar };