Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/namitoyokota/ngx-notation-reveal

Angular component to add rough notation animation when element is visible.
https://github.com/namitoyokota/ngx-notation-reveal

angular npm rough-notation

Last synced: 2 months ago
JSON representation

Angular component to add rough notation animation when element is visible.

Awesome Lists containing this project

README

        



Notation Reveal



GitHub License


NPM Version


NPM Downloads


Notation Reveal is an Angular component to add the Rough Notation animation when element scrolls into view.

## Demo

![Demo Gif](https://raw.githubusercontent.com/namitoyokota/ngx-notation-reveal/master/src/assets/demo.gif)

View the [live demo](https://notation-reveal.namitoyokota.com/) or [CodeSandbox](https://codesandbox.io/p/devbox/ngx-notation-reveal-demo-mf875r)!

## Installation

Install using a package manager:

```shell
npm i ngx-notation-reveal
```

or

```shell
yarn add ngx-notation-reveal
```

## Usage

First, import the module.

```typescript
import { NotationRevealModule } from 'ngx-notation-reveal';

@NgModule({
imports: [NotationRevealModule],
})
export class AppModule {}
```

Next, set up a config property. You can read all annotation types on Rough Notation's official documentation.

```typescript
import { RoughAnnotationConfig } from 'ngx-notation-reveal';

readonly underline = {
type: 'underline',
color: '#F38181',
} as RoughAnnotationConfig;
```

Lastly, add component in the HTML.

```html
This sentence will be underlined.
```

## API

This readonly component takes in the following properties as inputs:

| Name | Type | Default | Description |
| -------- | -------------------------------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------- |
| `config` | [RoughAnnotationConfig](https://github.com/rough-stuff/rough-notation?tab=readme-ov-file#configuring-the-annotation) | | Styling of the annotation. |
| `reset` | boolean | true | Whether to re-animate annotation each time element enters viewport. |
| `delay` | number | 1000 | Time before animation after element enters viewport (in ms). |

## License

[MIT](https://github.com/namitoyokota/ngx-notation-reveal/blob/master/LICENSE) © [Namito Yokota](https://www.namitoyokota.com)