Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/nigrosimone/ng-let

Angular structural directive for sharing data as local variable into html component template.
https://github.com/nigrosimone/ng-let

angular angular2

Last synced: 3 months ago
JSON representation

Angular structural directive for sharing data as local variable into html component template.

Awesome Lists containing this project

README

        

# NgLet [![Build Status](https://app.travis-ci.com/nigrosimone/ng-let.svg?branch=main)](https://app.travis-ci.com/nigrosimone/ng-let) [![Coverage Status](https://coveralls.io/repos/github/nigrosimone/ng-let/badge.svg?branch=main)](https://coveralls.io/github/nigrosimone/ng-let?branch=main) [![NPM version](https://img.shields.io/npm/v/ng-let.svg)](https://www.npmjs.com/package/ng-let) [![Maintainability](https://api.codeclimate.com/v1/badges/de3eb5e33fa6f4359721/maintainability)](https://codeclimate.com/github/nigrosimone/ng-let/maintainability)

Angular structural directive for sharing data as local variable into html component template.

## Description

Sometime there is a need to share data into component template as local variable.
This structural directive create local context of variable that can be used into html template.

See the [stackblitz demo](https://stackblitz.com/edit/demo-ng-let?file=src%2Fapp%2Fapp.component.ts).

## Features

✅ Observable support

✅ Async pipe support

✅ NgModel support

✅ Type casting

## Get Started

*Step 1*: install `ng-let`

```bash
npm i ng-let
```

*Step 2*: Import `NgLetModule` into your app module or imports of standalone component, eg.:

```ts
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';

import { NgLetModule } from 'ng-let';

@NgModule({
declarations: [AppComponent],
imports: [
BrowserModule,
NgLetModule,
],
providers: [],
bootstrap: [AppComponent],
],
})
export class AppModule { }
```

*Step 3*: usage, eg.:

```ts
import { Component } from '@angular/core';

@Component({
selector: 'app-root',
template: `


1: {{ total }}


2: {{ total }}


`,
})
export class AppComponent {
num1: number = 1;
num2: number = 2;
}
```

or with the implicit syntax:

```ts
import { Component } from '@angular/core';

@Component({
selector: 'app-root',
template: `


1: {{ total }}


2: {{ total }}


`,
})
export class AppComponent {
num1: number = 1;
num2: number = 2;
}
```

## Examples

Below there are some examples of use case.

### Example: observable

Example of use with observable, eg.:

```ts
import { Component } from '@angular/core';
import { defer, Observable, timer } from 'rxjs';

@Component({
selector: 'app-root',
template: `


1: {{ time }}


2: {{ time }}


`,
})
export class AppComponent {
timer$: Observable = defer(() => timer(3000, 1000));
}
```

or with the implicit syntax:

```ts
import { Component } from '@angular/core';
import { defer, Observable, timer } from 'rxjs';

@Component({
selector: 'app-root',
template: `


1: {{ time }}


2: {{ time }}


`,
})
export class AppComponent {
timer$: Observable = defer(() => timer(3000, 1000));
}
```

### Example: signal

Example of use with signal, eg.:

```ts
import { Component, signal } from '@angular/core';

@Component({
selector: 'app-root',
template: `


1: {{ time }}


2: {{ time }}


`,
})
export class AppComponent {
mySignal = signal(1);

constructor() {
setInterval(() => this.mySignal.update(value => value + 1), 1000)
}
}
```

or with the implicit syntax:

```ts
import { Component, signal } from '@angular/core';

@Component({
selector: 'app-root',
template: `


1: {{ time }}


2: {{ time }}


`,
})
export class AppComponent {
mySignal = signal(1);

constructor() {
setInterval(() => this.mySignal.update(value => value + 1), 1000)
}
}
```

## Support

This is an open-source project. Star this [repository](https://github.com/nigrosimone/ng-let), if you like it, or even [donate](https://www.paypal.com/paypalme/snwp). Thank you so much!

## My other libraries

I have published some other Angular libraries, take a look:

- [NgSimpleState: Simple state management in Angular with only Services and RxJS](https://www.npmjs.com/package/ng-simple-state)
- [NgHttpCaching: Cache for HTTP requests in Angular application](https://www.npmjs.com/package/ng-http-caching)
- [NgGenericPipe: Generic pipe for Angular application for use a component method into component template.](https://www.npmjs.com/package/ng-generic-pipe)
- [NgForTrackByProperty: Angular global trackBy property directive with strict type checking](https://www.npmjs.com/package/ng-for-track-by-property)