mirror of
https://github.com/tenrok/OverlayScrollbars.git
synced 2026-06-22 21:30:37 +03:00
finishing touches
This commit is contained in:
@@ -18,8 +18,6 @@
|
|||||||
|
|
||||||
> OverlayScrollbars is a javascript scrollbar plugin that hides native scrollbars, provides custom styleable overlay scrollbars and keeps the native functionality and feeling.
|
> OverlayScrollbars is a javascript scrollbar plugin that hides native scrollbars, provides custom styleable overlay scrollbars and keeps the native functionality and feeling.
|
||||||
|
|
||||||
> This is the documentation for version `2.x`. which is currently in beta. You can read the version `1.x` docs [here](https://github.com/KingSora/OverlayScrollbars/tree/v1.x) or on the [website](https://kingsora.github.io/OverlayScrollbars/#!overview).
|
|
||||||
|
|
||||||
## Why
|
## Why
|
||||||
|
|
||||||
I created this plugin because I hate ugly and space consuming scrollbars. Similar plugins haven't met my requirements in terms of features, quality, simplicity, license or browser support.
|
I created this plugin because I hate ugly and space consuming scrollbars. Similar plugins haven't met my requirements in terms of features, quality, simplicity, license or browser support.
|
||||||
@@ -39,7 +37,7 @@ I created this plugin because I hate ugly and space consuming scrollbars. Simila
|
|||||||
- Highly customizable
|
- Highly customizable
|
||||||
- TypeScript support - fully written in TypeScript
|
- TypeScript support - fully written in TypeScript
|
||||||
- Dependency free - 100% self written to ensure small size and best functionality
|
- Dependency free - 100% self written to ensure small size and best functionality
|
||||||
- High quality and fully typed Framework versions for `react`, `vue`, `angular`, `svelte` and `solid`.
|
- High quality and fully typed Framework versions for [`react`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-react), [`vue`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-vue), [`angular`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-ngx), [`svelte`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-svelte) and [`solid`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-solid).
|
||||||
|
|
||||||
## Choose your framework
|
## Choose your framework
|
||||||
|
|
||||||
|
|||||||
@@ -18,8 +18,6 @@
|
|||||||
|
|
||||||
> OverlayScrollbars is a javascript scrollbar plugin that hides native scrollbars, provides custom styleable overlay scrollbars and keeps the native functionality and feeling.
|
> OverlayScrollbars is a javascript scrollbar plugin that hides native scrollbars, provides custom styleable overlay scrollbars and keeps the native functionality and feeling.
|
||||||
|
|
||||||
> This is the documentation for version `2.x`. which is currently in beta. You can read the version `1.x` docs [here](https://github.com/KingSora/OverlayScrollbars/tree/v1.x) or on the [website](https://kingsora.github.io/OverlayScrollbars/#!overview).
|
|
||||||
|
|
||||||
## Why
|
## Why
|
||||||
|
|
||||||
I created this plugin because I hate ugly and space consuming scrollbars. Similar plugins haven't met my requirements in terms of features, quality, simplicity, license or browser support.
|
I created this plugin because I hate ugly and space consuming scrollbars. Similar plugins haven't met my requirements in terms of features, quality, simplicity, license or browser support.
|
||||||
@@ -39,7 +37,7 @@ I created this plugin because I hate ugly and space consuming scrollbars. Simila
|
|||||||
- Highly customizable
|
- Highly customizable
|
||||||
- TypeScript support - fully written in TypeScript
|
- TypeScript support - fully written in TypeScript
|
||||||
- Dependency free - 100% self written to ensure small size and best functionality
|
- Dependency free - 100% self written to ensure small size and best functionality
|
||||||
- High quality and fully typed Framework versions for `react`, `vue`, `angular`, `svelte` and `solid`.
|
- High quality and fully typed Framework versions for [`react`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-react), [`vue`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-vue), [`angular`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-ngx), [`svelte`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-svelte) and [`solid`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-solid).
|
||||||
|
|
||||||
## Choose your framework
|
## Choose your framework
|
||||||
|
|
||||||
|
|||||||
@@ -17,22 +17,18 @@ I created this plugin because I hate ugly and space consuming scrollbars. Simila
|
|||||||
- Highly customizable
|
- Highly customizable
|
||||||
- TypeScript support - fully written in TypeScript
|
- TypeScript support - fully written in TypeScript
|
||||||
- Dependency free - 100% self written to ensure small size and best functionality
|
- Dependency free - 100% self written to ensure small size and best functionality
|
||||||
- High quality and fully typed Framework versions for `react`, `vue` and `angular`
|
- High quality and fully typed Framework versions for [`react`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-react), [`vue`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-vue), [`angular`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-ngx), [`svelte`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-svelte) and [`solid`](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-solid).
|
||||||
|
|
||||||
## Choose your framework
|
## Choose your framework
|
||||||
|
|
||||||
Additionally to the vanilla JavaScript version you can use the official framework components & utilities:
|
Additionally to the vanilla JavaScript version you can use the official framework components & utilities:
|
||||||
|
|
||||||
<div className="flex not-prose">
|
<div className="flex">
|
||||||
<a href="https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-react">
|
<a href="https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-react"><img className="h-[80px] mx-1" src="https://raw.githubusercontent.com/KingSora/OverlayScrollbars/master/packages/overlayscrollbars-react/logo.svg" width="80" height="80" alt="React" /></a>
|
||||||
<img src="https://raw.githubusercontent.com/KingSora/OverlayScrollbars/master/packages/overlayscrollbars-react/logo.svg" width="80" height="80" alt="React" className="h-[80px] mx-1" />
|
<a href="https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-vue"><img className="h-[80px] mx-1" src="https://raw.githubusercontent.com/KingSora/OverlayScrollbars/master/packages/overlayscrollbars-vue/logo.svg" width="80" height="80" alt="Vue" /></a>
|
||||||
</a>
|
<a href="https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-ngx"><img className="h-[80px] mx-1" src="https://raw.githubusercontent.com/KingSora/OverlayScrollbars/master/packages/overlayscrollbars-ngx/logo.svg" width="80" height="80" alt="Angular" /></a>
|
||||||
<a href="https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-vue">
|
<a href="https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-svelte"><img className="h-[80px] mx-1" src="https://raw.githubusercontent.com/KingSora/OverlayScrollbars/master/packages/overlayscrollbars-svelte/logo.svg" width="80" height="80" alt="Svelte" /></a>
|
||||||
<img src="https://raw.githubusercontent.com/KingSora/OverlayScrollbars/master/packages/overlayscrollbars-vue/logo.svg" width="80" height="80" alt="Vue" className="h-[80px] mx-1" />
|
<a href="https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-solid"><img className="h-[80px] mx-1" src="https://raw.githubusercontent.com/KingSora/OverlayScrollbars/master/packages/overlayscrollbars-solid/logo.svg" width="80" height="80" alt="Solid" /></a>
|
||||||
</a>
|
|
||||||
<a href="https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-ngx">
|
|
||||||
<img src="https://raw.githubusercontent.com/KingSora/OverlayScrollbars/master/packages/overlayscrollbars-ngx/logo.svg" width="80" height="80" alt="Angular" className="h-[80px] mx-1" />
|
|
||||||
</a>
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
## Getting started
|
## Getting started
|
||||||
@@ -89,7 +85,7 @@ const osInstance = OverlayScrollbars(document.querySelector('#myElement'), {});
|
|||||||
If you initialize OverlayScrollbars it needs a few milliseconds to create and append all the elements to the DOM.
|
If you initialize OverlayScrollbars it needs a few milliseconds to create and append all the elements to the DOM.
|
||||||
While this period the native scrollbars are still visible and are switched out after the initialization is finished. This is perceived as flickering.
|
While this period the native scrollbars are still visible and are switched out after the initialization is finished. This is perceived as flickering.
|
||||||
|
|
||||||
To fix this behavior apply the `data-overlayscrollbars=""` attribute to the target element (and `html` element if the target element is `body`).
|
To fix this behavior apply the `data-overlayscrollbars-initialize` attribute to the target element (and `html` element if the target element is `body`).
|
||||||
|
|
||||||
### Initialization with an Object
|
### Initialization with an Object
|
||||||
<details>
|
<details>
|
||||||
|
|||||||
Reference in New Issue
Block a user