0.0.10 • Published 5 years ago

mentions-for-angular v0.0.10

Weekly downloads
3
License
MIT
Repository
github
Last release
5 years ago

Angular Mentions

Simple Angular mentions inspired by Ment.io.

Click here for a Demo

Provides auto-complete suggestions for @mentions in text input fields, text areas, and content editable fields. Not fully browser tested and comes without warranty!

To install and start the demo application:

git clone https://github.com/kylewanderson/mentions-for-angular.git
cd mentions-for-angular
npm install
ng serve

Usage

Add the package as a dependency to your project using:

npm install --save mentions-for-angular

Add the CSS to your index.html:

<link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css">

Add the module to your app.module imports:

import { MentionModule } from 'mentions-for-angular/mention';
...

@NgModule({
    imports: [ MentionModule ],
    ...
})

Add the [mention] directive to your input element:

<input type="text" [mention]="items">

Where items is a string array of the items to suggest. For example:

items: string[] = ["Noah", "Liam", "Mason", "Jacob", ...

Configuration Options

The following optional configuration items can be used.

OptionDefaultDescription
triggerChar@The character that will trigger the menu behavior.
maxItemsLimit the number of items shown in the pop-up menu. The default is no limit.
mentionSelectAn optional function to format the selected item before inserting the text.
labelKeylabelThe field to be used as the item label (when the items are objects).
disableSearchfalseDisable internal filtering (only useful if async search is used).

For Example:

<input type="text" [mention]="items" [mentionConfig]="{triggerChar:'#',maxItems:10,labelKey:'name'}">

Output Events

  • (searchTerm)="" event emitted whenever the search term changes. Can be used to trigger async search.
0.0.10

5 years ago

0.0.9

5 years ago

0.0.8

5 years ago

0.0.7

5 years ago

0.0.6

5 years ago

0.0.5

5 years ago

0.0.4

5 years ago

0.0.3

5 years ago

0.0.2

5 years ago

0.0.1

5 years ago