npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@youssseeef/auto-complete-dropdown-categories

v0.0.2

Published

Angular Input Autocomplete with drop-down and categories

Downloads

3

Readme

auto-complete with drop-down and categories

This project is a fork of ng2-ui/auto-complete

This will only add a feature of having a fixed-size drop-down menu and have them sorted by category

Below are plunks for different scenarios:

Template Driven Forms

ngModel http://plnkr.co/edit/3pB1Gx?p=preview

Reactive Forms

FormGroup http://plnkr.co/edit/2osUq6?p=preview issue #49

FormControl http://plnkr.co/edit/A5CW2e?p=preview issue #100

Material Design

http://plnkr.co/edit/2YLDjX?p=preview&open=app/app.component.ts

Obervable Source

http://plnkr.co/edit/ExzNSh?p=preview

List Formatter Example

http://plnkr.co/edit/F9nrWp?p=preview
http://plnkr.co/edit/0QFYFHMmCAFmhbYAGQl7?p=preview (With custom css)

Install

  1. install @youssseeef/auto-complete-dropdown-categories

     $ npm install @youssseeef/auto-complete-dropdown-categories --save
  2. add map and packages to your systemjs.config.js unless you are using webpack

     map['@youssseeef/auto-complete-dropdown-categories'] = 'node_modules/@youssseeef/auto-complete-dropdown-categories/dist/auto-complete.umd.js';
  3. import NguiAutoCompleteModule to your AppModule

     import { NguiAutoCompleteModule } from '@youssseeef/auto-complete-dropdown-categories';
    
     @NgModule({
       imports: [BrowserModule, FormsModule, NguiAutoCompleteModule],
       declarations: [AppComponent],
       providers: [HTTP_PROVIDERS],
       bootstrap: [ AppComponent ]
     })
     export class AppModule { }

Usage it in your code

    <input auto-complete [(ngModel)]="myData" [source]="mySource" />

For full example, please check test directory to see the example of;

  • systemjs.config.js
  • app.module.ts
  • and app.component.ts.

Contributors are welcomed

This module is only improved and maintained by contributors like you;

As a contributor, it's NOT required to be skilled in Javascript nor Angular. You can contribute to the following;

  • Updating README.md
  • Making more and clearer comments
  • Answering issues and building FAQ
  • Documentation
  • Translation

In result of your active contribution, you will be listed as a core contributor on https://ng2-ui.github.io, and a member of ng2-ui too.

If you are interested in becoming a contributor and/or a member of ng-ui, please send me email to allenhwkim AT gmail.com with your github id.

attributes

All options are optional except ngModel and source

  • ngModel, any, variable that autocomplete result is assigned to

  • source, array or string, required. data source for dropdown list

  • auto-complete-placeholder, string, autocomplete input guide text

  • value-formatter, string or function variable name, custom value formatting function. e.g. '(id) value', 'myValueFormatter'.

       myValueFormatter(data: any): string {
          return `(${data[id]}) ${data[value]}`;
        }
  • list-formatter, string or function variable name, custom list formatting function. e.g. '(key) name', 'myListFormatter'.

       myListFormatter(data: any): string {
          return `(${data[key]}) ${data[name]}`;
        }
  • path-to-data, string, e.g., data.myList, path to array data in http response

  • min-chars, number, when source is remote data, the number of character to see drop-down list

  • display-property-name, string, key name of text to show. default is value

  • select-value-of, string, when selected, return the value of this key as a selected item

  • blank-option-text, string, guide text to allow empty value to be selected as in empty value of option tag.

  • no-match-found-text, string, guide text to show no result found.

  • valueChanged / ngModelChange, callback function that is executed when a new drop-down is selected. e.g. (valueChanged)="myCallback($event)"

  • customSelected callback function that is executed when a value selected not included in drop-down, so it will return the keyword used. e.g. (customSelected)="customCallback($event)"

  • loading-text, text to be displayed when loading. Default, "Loading"

  • loading-template, html markup that is to be rendered when loading. Default, null

  • accept-user-input boolean, if false and does not match to source given, it goes back to the original value selected., If you don't event want user to type any, please use readonly="readonly" to force user to select only from list. Default is true

  • max-num-list number, maximum number of drop down list items. Default, unlimited

  • tab-to-select boolean, if true, pressing Tab will set the value from the selected item before focus leaves the control. Default is true

  • select-on-blur boolean, if true, blur event will set the value from the selected item before focus leaves the control. Default is false

  • match-formatted boolean, if true, keyword will be matched against list values formatted with list-formatter, instead of raw objects. Default is false

  • auto-select-first-item, boolean, if true, the first item of the list is automatically selected, if false, user must select manually an item. Default is false

  • open-on-focus, boolean, if false drop down won't open on a focus event, . Default is true

  • close-on-focus, boolean, if false drop down will close on a focusout event, . Default is true

  • re-focus-after-select property, boolean, if false an auto focus behavior after select (example: custom value on blur event or issue #276) is disabled . Default is true

  • autocomplete, boolean, default false, if true remove the attribute autocomplete="off" of the input.

For Developers

To start

$ git clone https://github.com/youssseeef/auto-complete.git
$ cd auto-complete
$ npm install
$ npm start

List of available npm tasks

  • npm run : List all available tasks
  • npm start: Run app directory for development using webpack-dev-server with port 9001
  • npm run clean: Remove dist folder
  • npm run lint: Lint TypeScript code
  • npm run build:ngc: build ES module
  • npm run build:umd: Build UMD module ng2-map.umd.js
  • npm run build:app: Build app/build/app.js for runnable examples
  • npm run build: Build all(clean, build:ngc, build:umc, and build:app)