Skip to content

ZRktty/ngx-category-selector

 
 

Repository files navigation

NgxCategorySelector npm version

This project was generated with Angular CLI version 10.1.6.

NgxCategorySelector Demo

Installation

npm i @rzdesign/ngx-category-selector

How to use it

Import NgxCategorySelectorModule in your module.

import {NgxCategorySelectorModule} from '@rzdesign/ngx-category-selector';
Selector: lib-ngx-category-selector
<lib-ngx-category-selector [data]="categoryData"
                           (selection)="onCategorySelect($event)"></lib-ngx-category-selector>

Data source example:

  categoryData: CategoryNode[] = [
    {
      id: 1, name: 'Fruits', children: [
        {
          id: 3, name: 'Tropical', children: [
            {
              id: 9, name: 'Subtropical', children: []
            }
          ]
        },
        {id: 4, name: 'Melons', children: []},
        {id: 5, name: 'Berries', children: []},
        {id: 6, name: 'Citrus', children: []}
      ]
    },
    {
      id: 2, name: 'Vegetables', children: [
        {id: 7, name: 'Leaves', children: []},
        {id: 8, name: 'Root', children: []},
      ]
    },
  ];

@Inputs()

Input Type Required Description
data CategoryNode[ ] YES Array of CategoryNodes
select CategoryNode optional Preselects a category

@Outputs()

Output Type Required Description
selection CategoryNode YES Emits the selected category node

Planned features

  • add unit tests
  • implement ControlValueAccessor's setDisabledState => add ability to disable the control, add styling according to form state
  • implement ControlValueAccessor => add ability to use the component as a form control

Examples

Check examples by running the app.

  1. clone repo git clone https://github.com/zr87/ngx-category-selector
  2. cd to repo folder and install dependencies npm install
  3. start application: ng serve

Examples are under src/app/app.component.ts

📬 License & Postcardware

The package is completely free (MIT license) to use, however the package is licensed as Postcardware. This means that if it makes it to your production environment, we would very much appreciate receiving a postcard from your hometown.

RZdesign, Becsi way 225 8/45, 1032 Budapest, Hungary