README
Vue Rate
Rate component for Vue - Demo
Installation and usage
Once, install rate component for your project
npm install vue-rate --save
Import Vue Rate into your app
import rate from 'vue-rate'
import 'vue-rate/dist/vue-rate.css'
Vue.use(rate)
Use HTML template
<rate :length="5" />
Options from props
length {number}
: Star size
<rate :length="5" />
value {number}
: Default value
<rate :length="5" :value="2" />
showcount {boolean}
: Shows rate number when mouseover the star.
<rate :length="5" :value="2" :showcount="true" />
ratedesc {object}
: Rate star description array.
<rate :length="5" :value="2" :ratedesc="['Very bad', 'bad', 'Normal', 'Good', 'Very good']" />
disabled {boolean}
: Disable rate.
<rate :length="5" :value="2" :disabled="true" />
readonly {boolean}
: Read-only rate.
<rate :length="5" :value="2" :readonly="true" />
iconref {string}
: ID of symbol icon
Insert symbol icon into your codebase
<symbol id="icon-heart" class="icon" viewBox="0 0 32 32">
<path d="M23.6 2c-3.363 0-6.258 2.736-7.599 5.594-1.342-2.858-4.237-5.594-7.601-5.594-4.637 0-8.4 3.764-8.4 8.401 0 9.433 9.516 11.906 16.001 21.232 6.13-9.268 15.999-12.1 15.999-21.232 0-4.637-3.763-8.401-8.4-8.401z"></path>
</symbol>
Then add Rate component. iconref
must be symbol's id
<rate :length="5" iconref="icon-heart" />
v-model
new Vue({
...
data: {
return () {
myRate: 0
}
}
...
})
<rate :length="5" v-model="myRate" />
Events
new Vue({
...
methods: {
onBeforeRate (rate) {
alert(rate)
},
onAfterRate (rate) {
alert(rate)
}
}
...
})
<rate :length="5" :value="2" @before-rate="onBeforeRate" @after-rate="onAftereRate" />
Development
- Fork the project
- Install all dependencies
- Make your changes on
src/Rate.vue
- Build the package
yarn build
# or npm run build
- Commit and create PR
License
MIT.