@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.
158 lines (156 loc) • 5.16 kB
JavaScript
'use client';
import * as React from 'react';
import { useEventCallback } from '@base-ui-components/utils/useEventCallback';
import { useIsoLayoutEffect } from '@base-ui-components/utils/useIsoLayoutEffect';
import { CompositeRoot } from "../../composite/root/CompositeRoot.js";
import { tabsStyleHookMapping } from "../root/styleHooks.js";
import { useTabsRootContext } from "../root/TabsRootContext.js";
import { TabsListContext } from "./TabsListContext.js";
import { jsx as _jsx } from "react/jsx-runtime";
const EMPTY_ARRAY = [];
/**
* Groups the individual tab buttons.
* Renders a `<div>` element.
*
* Documentation: [Base UI Tabs](https://base-ui.com/react/components/tabs)
*/
export const TabsList = /*#__PURE__*/React.forwardRef(function TabsList(componentProps, forwardedRef) {
const {
activateOnFocus = true,
className,
loop = true,
render,
...elementProps
} = componentProps;
const {
getTabElementBySelectedValue,
onValueChange,
orientation,
value,
setTabMap,
tabActivationDirection
} = useTabsRootContext();
const [highlightedTabIndex, setHighlightedTabIndex] = React.useState(0);
const tabsListRef = React.useRef(null);
const detectActivationDirection = useActivationDirectionDetector(value,
// the old value
orientation, tabsListRef, getTabElementBySelectedValue);
const onTabActivation = useEventCallback((newValue, event) => {
if (newValue !== value) {
const activationDirection = detectActivationDirection(newValue);
onValueChange(newValue, activationDirection, event);
}
});
const state = React.useMemo(() => ({
orientation,
tabActivationDirection
}), [orientation, tabActivationDirection]);
const defaultProps = {
'aria-orientation': orientation === 'vertical' ? 'vertical' : undefined,
role: 'tablist'
};
const tabsListContextValue = React.useMemo(() => ({
activateOnFocus,
highlightedTabIndex,
onTabActivation,
setHighlightedTabIndex,
tabsListRef,
value
}), [activateOnFocus, highlightedTabIndex, onTabActivation, setHighlightedTabIndex, tabsListRef, value]);
return /*#__PURE__*/_jsx(TabsListContext.Provider, {
value: tabsListContextValue,
children: /*#__PURE__*/_jsx(CompositeRoot, {
render: render,
className: className,
state: state,
refs: [forwardedRef, tabsListRef],
props: [defaultProps, elementProps],
customStyleHookMapping: tabsStyleHookMapping,
highlightedIndex: highlightedTabIndex,
enableHomeAndEndKeys: true,
loop: loop,
orientation: orientation,
onHighlightedIndexChange: setHighlightedTabIndex,
onMapChange: setTabMap,
disabledIndices: EMPTY_ARRAY
})
});
});
if (process.env.NODE_ENV !== "production") TabsList.displayName = "TabsList";
function getInset(tab, tabsList) {
const {
left: tabLeft,
top: tabTop
} = tab.getBoundingClientRect();
const {
left: listLeft,
top: listTop
} = tabsList.getBoundingClientRect();
const left = tabLeft - listLeft;
const top = tabTop - listTop;
return {
left,
top
};
}
function useActivationDirectionDetector(
// the old value
selectedTabValue, orientation, tabsListRef, getTabElement) {
const previousTabEdge = React.useRef(null);
useIsoLayoutEffect(() => {
// Whenever orientation changes, reset the state.
if (selectedTabValue == null || tabsListRef.current == null) {
previousTabEdge.current = null;
return;
}
const activeTab = getTabElement(selectedTabValue);
if (activeTab == null) {
previousTabEdge.current = null;
return;
}
const {
left,
top
} = getInset(activeTab, tabsListRef.current);
previousTabEdge.current = orientation === 'horizontal' ? left : top;
}, [orientation, getTabElement, tabsListRef, selectedTabValue]);
return React.useCallback(newValue => {
if (newValue === selectedTabValue) {
return 'none';
}
if (newValue == null) {
previousTabEdge.current = null;
return 'none';
}
if (newValue != null && tabsListRef.current != null) {
const selectedTabElement = getTabElement(newValue);
if (selectedTabElement != null) {
const {
left,
top
} = getInset(selectedTabElement, tabsListRef.current);
if (previousTabEdge.current == null) {
previousTabEdge.current = orientation === 'horizontal' ? left : top;
return 'none';
}
if (orientation === 'horizontal') {
if (left < previousTabEdge.current) {
previousTabEdge.current = left;
return 'left';
}
if (left > previousTabEdge.current) {
previousTabEdge.current = left;
return 'right';
}
} else if (top < previousTabEdge.current) {
previousTabEdge.current = top;
return 'up';
} else if (top > previousTabEdge.current) {
previousTabEdge.current = top;
return 'down';
}
}
}
return 'none';
}, [getTabElement, orientation, previousTabEdge, tabsListRef, selectedTabValue]);
}