@mui/x-data-grid
Version:
The Community plan edition of the Data Grid components (MUI X).
148 lines • 5.94 kB
JavaScript
import * as React from 'react';
import { styled } from '@mui/system';
import useEventCallback from '@mui/utils/useEventCallback';
import useForkRef from '@mui/utils/useForkRef';
import composeClasses from '@mui/utils/composeClasses';
import { forwardRef } from '@mui/x-internals/forwardRef';
import { useOnMount } from "../../hooks/utils/useOnMount.js";
import { useGridPrivateApiContext } from "../../hooks/utils/useGridPrivateApiContext.js";
import { gridDimensionsSelector, useGridSelector } from "../../hooks/index.js";
import { useGridRootProps } from "../../hooks/utils/useGridRootProps.js";
import { getDataGridUtilityClass } from "../../constants/gridClasses.js";
import { jsx as _jsx } from "react/jsx-runtime";
const useUtilityClasses = (ownerState, position) => {
const {
classes
} = ownerState;
const slots = {
root: ['scrollbar', `scrollbar--${position}`],
content: ['scrollbarContent']
};
return composeClasses(slots, getDataGridUtilityClass, classes);
};
const Scrollbar = styled('div')({
position: 'absolute',
display: 'inline-block',
zIndex: 60,
'&:hover': {
zIndex: 70
},
// In macOS Safari and Gnome Web, scrollbars are overlaid and don't affect the layout. So we consider
// their size to be 0px throughout all the calculations, but the floating scrollbar container does need
// to appear and have a real size. We set it to 14px because it seems like an acceptable value and we
// don't have a method to find the required size for scrollbars on those platforms.
'--size': 'calc(max(var(--DataGrid-scrollbarSize), 14px))'
});
const ScrollbarVertical = styled(Scrollbar)({
width: 'var(--size)',
height: 'calc(var(--DataGrid-hasScrollY) * (100% - var(--DataGrid-topContainerHeight) - var(--DataGrid-bottomContainerHeight) - var(--DataGrid-hasScrollX) * var(--DataGrid-scrollbarSize)))',
overflowY: 'auto',
overflowX: 'hidden',
// Disable focus-visible style, it's a scrollbar.
outline: 0,
'& > div': {
width: 'var(--size)'
},
top: 'var(--DataGrid-topContainerHeight)',
right: '0px'
});
const ScrollbarHorizontal = styled(Scrollbar)({
width: '100%',
height: 'var(--size)',
overflowY: 'hidden',
overflowX: 'auto',
// Disable focus-visible style, it's a scrollbar.
outline: 0,
'& > div': {
height: 'var(--size)'
},
bottom: '0px'
});
const GridVirtualScrollbar = forwardRef(function GridVirtualScrollbar(props, ref) {
const apiRef = useGridPrivateApiContext();
const rootProps = useGridRootProps();
const isLocked = React.useRef(false);
const lastPosition = React.useRef(0);
const scrollbarRef = React.useRef(null);
const contentRef = React.useRef(null);
const classes = useUtilityClasses(rootProps, props.position);
const dimensions = useGridSelector(apiRef, gridDimensionsSelector);
const propertyDimension = props.position === 'vertical' ? 'height' : 'width';
const propertyScroll = props.position === 'vertical' ? 'scrollTop' : 'scrollLeft';
const propertyScrollPosition = props.position === 'vertical' ? 'top' : 'left';
const hasScroll = props.position === 'vertical' ? dimensions.hasScrollX : dimensions.hasScrollY;
const contentSize = dimensions.minimumSize[propertyDimension] + (hasScroll ? dimensions.scrollbarSize : 0);
const scrollbarSize = props.position === 'vertical' ? dimensions.viewportInnerSize.height : dimensions.viewportOuterSize.width;
const scrollbarInnerSize = scrollbarSize * (contentSize / dimensions.viewportOuterSize[propertyDimension]);
const onScrollerScroll = useEventCallback(() => {
const scrollbar = scrollbarRef.current;
const scrollPosition = props.scrollPosition.current;
if (!scrollbar) {
return;
}
if (scrollPosition[propertyScrollPosition] === lastPosition.current) {
return;
}
lastPosition.current = scrollPosition[propertyScrollPosition];
if (isLocked.current) {
isLocked.current = false;
return;
}
isLocked.current = true;
const value = scrollPosition[propertyScrollPosition] / contentSize;
scrollbar[propertyScroll] = value * scrollbarInnerSize;
});
const onScrollbarScroll = useEventCallback(() => {
const scroller = apiRef.current.virtualScrollerRef.current;
const scrollbar = scrollbarRef.current;
if (!scrollbar) {
return;
}
if (isLocked.current) {
isLocked.current = false;
return;
}
isLocked.current = true;
const value = scrollbar[propertyScroll] / scrollbarInnerSize;
scroller[propertyScroll] = value * contentSize;
});
useOnMount(() => {
const scroller = apiRef.current.virtualScrollerRef.current;
const scrollbar = scrollbarRef.current;
const options = {
passive: true
};
scroller.addEventListener('scroll', onScrollerScroll, options);
scrollbar.addEventListener('scroll', onScrollbarScroll, options);
return () => {
scroller.removeEventListener('scroll', onScrollerScroll, options);
scrollbar.removeEventListener('scroll', onScrollbarScroll, options);
};
});
React.useEffect(() => {
const content = contentRef.current;
content.style.setProperty(propertyDimension, `${scrollbarInnerSize}px`);
}, [scrollbarInnerSize, propertyDimension]);
const Container = props.position === 'vertical' ? ScrollbarVertical : ScrollbarHorizontal;
return /*#__PURE__*/_jsx(Container, {
ref: useForkRef(ref, scrollbarRef),
className: classes.root,
style: props.position === 'vertical' && rootProps.listView ? {
height: '100%',
top: 0
} : undefined,
tabIndex: -1,
"aria-hidden": "true"
// tabIndex does not prevent focus with a mouse click, throwing a console error
// https://github.com/mui/mui-x/issues/16706
,
onFocus: event => {
event.target.blur();
},
children: /*#__PURE__*/_jsx("div", {
ref: contentRef,
className: classes.content
})
});
});
export { GridVirtualScrollbar };