• Stars
    star
    240
  • Rank 167,644 (Top 4 %)
  • Language
    TypeScript
  • License
    MIT License
  • Created over 5 years ago
  • Updated about 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A lightweight, configurable and reactive breadcrumbs for Angular 2+

xng-breadcrumb

A lightweight, declarative and dynamic breadcrumbs solution for Angular 6 and beyond. https://www.npmjs.com/package/xng-breadcrumb

CircleCI npm version bundle size license

npm downloads Twitter follow

About

  • In applications with deep navigation hierarchy, it is essential to have breadcrumbs.
  • Breadcrumbs easily allow going back to states higher up in the hierarchy.

Documentation

A step by step guide to integrate xng-breadcrumb into your Angular application

Demo

Demo App - A demo app showcasing xng-breadcrumb library usage in an Angular app. Navigate through different links to see breadcrumbs behavior.

xng-breadcrumb usage

Features

  • βœ… Zero configuration: Just add <xng-breadcrumb></xng-breadcrumb> anywhere in the app. Breadcrumb labels are auto-generated by analyzing Angular Route configuration in your App.

  • βœ… Custom labels: Each route can have a custom label defined via Angular Route Config. These labels are used automatically while generating breadcrumbs.

  • βœ… Update labels dynamically: Change breadcrumb labels dynamically using BreadcrumbService.set(). You can either use route path or route path alias to update label.

  • βœ… Skip breadcrumb: Skip specific routes from displaying in breadcrumbs, conditionally.

  • βœ… Disable breadcrumb: Disable specific routes so that navigation is disbaled to intermediate routes.

  • βœ… Customization: Customize breadcrumb template to show icons with label, use pipes on text, add i18n with ngx-translate, etc.

  • βœ… Styling: Separator and Styles can be customized with ease.

  • βœ… QueryParams and Fragment: Preserves QueryParams and Fragemnet while navigating via breadcrumbs

  • βœ… SSR: Supports server side rendering with nguniversal

❀️ Become a Sponsor!

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Uday Vunnam

πŸ’» πŸ“– 🚧

anthonythiry

πŸ’»

dedrazer

πŸ’»

Danny Feliz

πŸ“–

Kapsky

πŸ’»

Andrei Cojea

πŸ“–

Jonathan

πŸ’»

Pavan Kumar Jadda

πŸ’» 🚧

Leon Fretter

πŸ’»

This project follows the all-contributors specification. Contributions of any kind welcome!

To add new contributor username, who made a contribution of type contribution:

pnpm all-contributors add <username> <contribution> Example: pnpm all-contributors add jfmengels code,doc