rc-scrollbars

rejuvenated project of react-custom-scrollbars

• frictionless native browser scrolling
• native scrollbars for mobile devices
• fully customizable
• auto hide
• auto height
• universal (runs on client & server)
• requestAnimationFrame for 60fps
• no extra stylesheets
• well tested, 100% code coverage

Documentation · Demos

Installation

1npm install rc-scrollbars --save
2
3# OR
4
5yarn add rc-scrollbars

This assumes that you’re using npm package manager with a module bundler like Webpack or Browserify to consume CommonJS modules.

Usage

This is the minimal configuration. Check out the Documentation for advanced usage.

1import { Scrollbars } from 'rc-scrollbars';
2
3class App extends Component {
4  render() {
5    return (
6      <Scrollbars style={{ width: 500, height: 300 }}>
7        <p>Some great content...</p>
8      </Scrollbars>
9    );
10  }
11}

The <Scrollbars> component is completely customizable. Check out the following code:

1import { Scrollbars } from 'rc-scrollbars';
2
3class CustomScrollbars extends Component {
4  render() {
5    return (
6      <Scrollbars
7        onScroll={this.handleScroll}
8        onScrollFrame={this.handleScrollFrame}
9        onScrollStart={this.handleScrollStart}
10        onScrollStop={this.handleScrollStop}
11        onUpdate={this.handleUpdate}
12        renderView={this.renderView}
13        renderTrackHorizontal={this.renderTrackHorizontal}
14        renderTrackVertical={this.renderTrackVertical}
15        renderThumbHorizontal={this.renderThumbHorizontal}
16        renderThumbVertical={this.renderThumbVertical}
17        autoHide
18        autoHideTimeout={1000}
19        autoHideDuration={200}
20        autoHeight
21        autoHeightMin={0}
22        autoHeightMax={200}
23        thumbMinSize={30}
24        universal={true}
25        {...this.props} />
26    );
27  }
28}

All properties are documented in the API docs

Run project locally

Run the simple example:

1# Make sure that you've installed the dependencies
2yarn
3# Run tsc of Scrollbars in watch mode and the documentation project in dev env
4yarn dev

License

MIT