From c351c4fc9aa45ad1f869cb5cf42343611a2ac548 Mon Sep 17 00:00:00 2001 From: Rene Date: Wed, 16 Dec 2020 12:55:51 +0100 Subject: [PATCH] update readme --- packages/overlayscrollbars-ngx/README.md | 51 ++++++++++++++++++------ 1 file changed, 38 insertions(+), 13 deletions(-) diff --git a/packages/overlayscrollbars-ngx/README.md b/packages/overlayscrollbars-ngx/README.md index 18a724e..68efeed 100644 --- a/packages/overlayscrollbars-ngx/README.md +++ b/packages/overlayscrollbars-ngx/README.md @@ -3,7 +3,7 @@ OverlayScrollbars

- Angular + Angular OverlayScrollbars Downloads License @@ -20,63 +20,82 @@
## Installation + ```sh npm install overlayscrollbars-ngx ``` ## Peer Dependencies + OverlayScrollbars for Angular has the following **peer dependencies**: -- The vanilla JavaScript library: [overlayscrollbars](https://www.npmjs.com/package/overlayscrollbars) + +- The vanilla JavaScript library: [overlayscrollbars](https://www.npmjs.com/package/overlayscrollbars) + ``` npm install overlayscrollbars ``` + - The Angular framework: [@angular/core](https://www.npmjs.com/package/@angular/core) + ``` npm install @angular/core ``` + ## TypeScript + - In case you are using TypeScript, you have to install the [OverlayScrollbars typings](https://www.npmjs.com/package/@types/overlayscrollbars): + ``` npm install @types/overlayscrollbars ``` + Since this wrapper is written in TypeScript it comes with its generated typings.
Check out the [recommended](https://github.com/KingSora/OverlayScrollbars#typescript) **tsconfig.json** options. ## Usage + #### CSS -You have to import the `OverlayScrollbars.css` by yourself.
+ +You have to import the `OverlayScrollbars.css` by yourself.
The component **doesn't** do it for you as the styles are **global styles**!
There are different ways to achieve this, in Angular the most simple way for me was to add [this line](https://github.com/KingSora/OverlayScrollbars/blob/master/packages/overlayscrollbars-ngx/example/src/styles.css#L1) in the `styles` file: + ```css -@import '~overlayscrollbars/css/OverlayScrollbars.css'; +@import "~overlayscrollbars/css/OverlayScrollbars.css"; ``` #### Import + First you need to import the module into your modules file: + ```ts -import { NgModule } from '@angular/core'; -import { OverlayscrollbarsModule } from 'overlayscrollbars-ngx'; +import { NgModule } from "@angular/core"; +import { OverlayscrollbarsModule } from "overlayscrollbars-ngx"; @NgModule({ - imports: [ OverlayscrollbarsModule ] + imports: [OverlayscrollbarsModule], }) -export class AppModule { } +export class AppModule {} ``` + After that you can import the component into your file(s): + ```ts -import { OverlayScrollbarsComponent } from 'overlayscrollbars-ngx'; +import { OverlayScrollbarsComponent } from "overlayscrollbars-ngx"; ``` #### Template + After the import you can use it in templates like: + ```html - - example content - + example content ``` #### Properties + Two properties are accepted: `options` and `extensions`. + - The `options` property accepts a `object` and can be changed at any point in time, and the plugin will adapt. - The `extensions` property accepts a `string`, `string array` or `object` and is only taken into account if the component gets mounted. @@ -87,19 +106,25 @@ Two properties are accepted: `options` and `extensions`. > ``` + You can read more about the `options` object [here](https://kingsora.github.io/OverlayScrollbars/#!documentation/options), `extensions` are documented [here](https://kingsora.github.io/OverlayScrollbars/#!documentation/extensions-basics) and [here](https://kingsora.github.io/OverlayScrollbars/#!documentation/initialization). #### Instance + If you get the component reference, it provides two methods: `osInstance()` and `osTarget()`. + - The `osInstance()` method returns the OverlayScrollbars `instance` of the component, or `null` if the instance isn't initialized yet or already destroyed. - The `osTarget()` method returns the native `html` element to which the plugin was initialized, or `null` if the the component isn't mounted yet or already unmounted. ## Example App + In case you need a example app for reference, you can use the example app in this repo(`example folder`): + - [Live example](https://kingsora.github.io/OverlayScrollbars/frameworks/angular/) - [Source code](https://github.com/KingSora/OverlayScrollbars/tree/master/packages/overlayscrollbars-ngx/example) If you wanna build the example app, run these commands: + ```sh npm run setup npm run build @@ -108,4 +133,4 @@ npm run example ## License -MIT \ No newline at end of file +MIT