mirror of
https://github.com/tenrok/vue-tribute.git
synced 2026-06-11 19:22:26 +03:00
Collin Henderson
60 lines
1.4 KiB
Markdown
60 lines
1.4 KiB
Markdown
# vue-tribute
|
|
|
|
[](https://travis-ci.org/syropian/vue-tribute)
|
|
|
|
> A Vue.js wrapper for Zurb's [Tribute](https://github.com/zurb/tribute) library for native @mentions.
|
|
|
|
## Install
|
|
|
|
```
|
|
$ yarn add vue-tribute
|
|
```
|
|
|
|
or
|
|
|
|
```
|
|
$ npm install vue-tribute --save
|
|
```
|
|
|
|
**or** include the UMD build, hosted by [unpkg](https://unpkg.com) in a `<script>` tag. You will also need to include the main Zurb Tribute library:
|
|
|
|
```js
|
|
<script src="js/tribute.js"></script>
|
|
<script src="//unpkg.com/vue-tribute"></script>
|
|
```
|
|
|
|
## Usage
|
|
|
|
Import and register the component.
|
|
|
|
```js
|
|
import VueTribute from 'vue-tribute'
|
|
|
|
export default {
|
|
...
|
|
components: {
|
|
VueTribute
|
|
}
|
|
}
|
|
```
|
|
|
|
In your template, wrap an `input`, `textarea` or `contenteditable` element in the `vue-tribute` component, and pass your Tribute options in.
|
|
|
|
```html
|
|
<div>
|
|
<vue-tribute :options="tributeOptions">
|
|
<input type="text" placeholder="@..." />
|
|
</vue-tribute>
|
|
</div>
|
|
```
|
|
|
|
See the available Tribute options [here](https://github.com/zurb/tribute#a-collection).
|
|
|
|
## Events
|
|
|
|
Tribute broadcasts two events — a `tribute-replaced` event, and a `tribute-no-match` event (see docs [here](https://github.com/zurb/tribute#replace-event)). For your convenience, whenever Tribute triggers these events, the vue-tribute component also [emits](http://vuejs.org/api/#vm-emit) these events.
|
|
|
|
## License
|
|
|
|
MIT © [Collin Henderson](https://github.com/syropian)
|