# ngx-dynamic-breadcrumb

> ## Installation

Latest version **2.0.0** (published 2022-04-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install ngx-dynamic-breadcrumb
pnpm add ngx-dynamic-breadcrumb
yarn add ngx-dynamic-breadcrumb
bun add ngx-dynamic-breadcrumb
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2022-04-24 |
| First published | 2021-03-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 161.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Maintainers | akshay.mahajan |
| Keywords | breadcrumbs, angular, ngx-dynamic-breadcrumb, angular-9+, dynamic-breadcrumb |

## Links

- npm: https://www.npmjs.com/package/ngx-dynamic-breadcrumb
- Repository: https://github.com/androizer/ngx-dynamic-breadcrumb
- Homepage: https://github.com/androizer/ngx-dynamic-breadcrumb/tree/master/projects/ngx-breadcrumb#readme
- Issues: https://github.com/androizer/ngx-dynamic-breadcrumb/issues
- npm.io page: https://npm.io/package/ngx-dynamic-breadcrumb

## Dependencies (1)

- [tslib](https://npm.io/package/tslib.md) ^2.2.0

## Recent versions

- 2.0.0 (latest) — 2022-04-24
- 1.0.11 — 2022-03-24
- 1.0.10 — 2021-08-08
- 1.0.9 — 2021-04-23
- 1.0.8 — 2021-04-21
- 1.0.7 — 2021-04-05
- 1.0.6 — 2021-03-24
- 1.0.5 — 2021-03-23
- 1.0.4 — 2021-03-23
- 1.0.3 — 2021-03-16
- 1.0.2 — 2021-03-16
- 1.0.1 — 2021-03-15
- 1.0.0 — 2021-03-15

## README

# Angular Dynamic Breadcrumb

## Installation

**npm**

```shell
npm install ngx-dynamic-breadcrumb
```

**yarn**

```shell
yarn add ngx-dynamic-breadcrumb
```

### Platform Version

> For Angular version >= v12

```shell
npm install ngx-dynamic-breadcrumb@latest
```

> For Angular version >= 9 & < 12

```shell
npm install ngx-dynamic-breadcrumb@1.x.x
```

### 1. Import the `NgxBreadcrumbModule`

Import `NgxBreadcrumbModule` in the `NgModule` of your application's root module.

```typescript
import { BrowserModule } from "@angular/platform-browser";
import { NgModule } from "@angular/core";
import { NgxBreadcrumbModule } from "ngx-dynamic-breadcrumb";

@NgModule({
  imports: [BrowserModule, NgxBreadcrumbModule.forRoot()],
  bootstrap: [AppComponent],
})
export class AppModule {}
```

### 2. Set breadcrumbs in `app.routes`

```typescript
export const routes: Routes = [
    {path: '', redirectTo: 'login', pathMatch: 'full'},
    {path: 'login', ..., data: { breadcrumb: 'Login'}},
    {path: 'profile', ..., data: { breadcrumb: {key: 'profile', label: 'Profile'}}},
    {path: 'roles', ..., data: { breadcrumb: 'Roles'}},
    {path: 'vendors', ..., data: {breadcrumb: {key: 'vendors', label: 'Vendors', tooltip: 'All Vendors'}}},
        children: [
            {path: ':org', ..., data: { breadcrumb: 'Repo List'}},
            {path: ':repo', ..., data: { breadcrumb: 'Repo'}},
        }],
    },
];
```

> Note: If breadcrumb is supplied as string, then the string value acts as `key` & `label` for that particular breadcrumb.

### 3. Add `<ngx-breadcrumb></ngx-breadcrumb>` tag in template of your application component.

# Customization

## Template Customization

### You can BYO template using the breadcrumb's ng-template projection.

```typescript
<ngx-breadcrumb [breadcrumbTemplate]="template" class="ngx-dynamic-breadcrumb"></ngx-breadcrumb>

<!-- Content Projection -->
<ng-template #template let-breadcrumb="breadcrumb" let-isLast="isLast let-breadcrumbs="breadcrumbArr">
  <a
  href="typescript:void(0)"
  *ngIf="!isLast && breadcrumb.isClickable"
  (click)="navigateTo(breadcrumb.url)"
  title="{{breadcrumb.tooltip}}"
  >
    {{ breadcrumb.label }}
  </a>
  <span
    *ngIf="isLast || !breadcrumb.isClickable"
    [ngClass]="{'breadcrumb-item-last': isLast && breadcrumbs.length > 1}"
    title="{{breadcrumb.tooltip}}"
    >
    {{ breadcrumb.label }}
  </span>
</ng-template>
```

## Dynamic Breadcrumbs

Use `NgxBreadcrumbService` to edit/replace the breadcrumb per route object dynamically

#### 1. Edit/replace the breadcrumb

```typescript
ngOnInit(): void {
  ...
  this.getServiceDetails(this.serviceId).subscribe(repoDetails => {
        ...
        this.breadcrumbService.editBreadcrumbs([{
          key: 'keyToObject',
          newLabel: 'New Label',
          newUrl: 'New URL value (optional)', // Provide this option only when needs to update url.
        }]);
  });
  ...
}
```

### 2. Restrict a particular breadcrumb to render onto the UI by providing `newLabel` as `null` value.

```typescript
ngOnInit(): void {
  ...
  this.getServiceDetails(this.serviceId).subscribe(repoDetails => {
        ...
        this.breadcrumbService.editBreadcrumbs([{
          key: 'keyToObject',
          newLabel: null, // this will remove breadcrumb from UI.
        }]);

  });
  ...
}
```

# Miscellaneous

## Subscribing to breadcrumb changes (optional)

```typescript
constructor(private readonly breadcrumbService: NgxBreadcrumbService) {}

ngOnInit(): void {
  ...
  this.breadcrumbService.breadcrumbChanges.subscribe((crumbs: IBreadcrumb[]) => {
        ...
        this.breadcrumbs = crumbs;
        ...
  });
  ...
}
```

## Get current breadcrumbs

```typescript
constructor(private readonly breadcrumbService: NgxBreadcrumbService) {}

breadcrumbs: IBreadcrumb[] = [];

ngOnInit(): void {
  ...
  this.breadcrumbs = this.breadcrumbService.getBreadcrumbs();
  ...
}
```

# License

[MIT](/projects/ngx-breadcrumb/LICENSE)

---
_Source: https://npm.io/package/ngx-dynamic-breadcrumb · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
