react-scrollbar-size

React-Scrollbar-Size

React-Scrollbar-Size is a React hook designed to calculate the size of the user agent's horizontal and vertical scrollbars. It will also detect when the size of the scrollbars change, such as when the user agent's zoom factor changes.

Installation

React-Scrollbar-Size is available as an npm package:

$ npm install react-scrollbar-size

Usage

The useScrollbarSize custom hook returns an object with two properties:

Name	Description
width	The current width of the vertical scrollbar
height	The current height of the horizontal scrollbar

Examples

To see a live example, follow these instructions.

TypeScript

import { CSSProperties, FunctionComponent } from 'react';
import useScrollbarSize from 'react-scrollbar-size';

const styles: CSSProperties = {
  margin: '1rem',
  textAlign: 'center',
};

const ScrollbarSizeDemo: FunctionComponent = () => {
  const { height, width } = useScrollbarSize();

  return (
    <div style={styles}>
      <h2>React Scrollbar Size Demo</h2>
      <h4>Tip: Change browser zoom level to see scrollbar sizes change.</h4>
      <p>
        The current height of the scrollbar is {height}px.
        <br />
        The current width of the scrollbar is {width}px.
      </p>
    </div>
  );
};

JavaScript

import useScrollbarSize from 'react-scrollbar-size';

const styles = {
  margin: '1rem',
  textAlign: 'center',
};

const ScrollbarSizeDemo = () => {
  const { height, width } = useScrollbarSize();

  return (
    <div style={styles}>
      <h2>React Scrollbar Size Demo</h2>
      <h4>Tip: Change browser zoom level to see scrollbar sizes change.</h4>
      <p>
        The current height of the scrollbar is {height}px.
        <br />
        The current width of the scrollbar is {width}px.
      </p>
    </div>
  );
};

License

This project is licensed under the terms of the MIT license.

Changelog

[5.0.0] - 2022-05-07

Breaking changes

• Browser targets have been changed to the default targets of browserslist (> 0.5%, last 2 versions, Firefox ESR, not dead) plus not ie 11. Browsers outside of that range may be supported, but are not guaranteed. (#705)

Added

• Disable dependabot (#655) and enable renovate (#656)
• Add support for React 18 (#693)
• Improved CHANGELOG format (#704)

Fixed

• Fix use of act in test scripts (#598)
• Bypass babel for example launches to eliminate warnings emitted by parcel (#705)
• Fix launch configuration for vscode debugging (#705)