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 @@
-
+
@@ -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