useDimensionsRef
Aboutβ
Easily grab dimensions of an element with a ref using this hook
Installationβ
npm install rooks
Importing the hookβ
import { useDimensionsRef } from "rooks";
Usageβ
function Demo() {
const [ref, dimensions, node] = useDimensionsRef();
return (
<div className="App">
<h1>useDimensionsRef example</h1>
<div
ref={ref}
style={{
border: "2px solid black",
width: "200px",
height: "200px"
}}
>
dimensions.height: {dimensions.height}px
dimensions.width: {dimensions.width}px
</div>
</div>
);
}
render(<Demo />);
Argumentsβ
Arguments | Type | Description | Default value |
---|---|---|---|
options | { updateOnScroll?: boolean, updateOnResize?: boolean } | Whether to update dimension on window resize and scroll | { updateOnScroll = true, updateOnResize = true } |
Returnsβ
Returns an array of 3 items:
Return item | Type | Description | Default value |
---|---|---|---|
ref | Callback ref | A callback ref function to be used as a ref for the element that needs to be tracked | undefined |
dimensions | UseDimensionsRefReturn | An object with dimensions of the ref element | null |
node | HTMLElement | The element being tracked by ref | null |
Codesandbox Examplesβ
Basic Usageβ
Join Bhargav's discord serverβ
You can click on the floating discord icon at the bottom right of the screen and talk to us in our server.