aesth-vue-range-input
Advanced tools
Comparing version 0.0.4 to 0.0.5
{ | ||
"name": "aesth-vue-range-input", | ||
"version": "0.0.4", | ||
"version": "0.0.5", | ||
"private": false, | ||
"description": "a completely customizable and aesthetic vue range input component.", | ||
"description": "a completely customizable and aesthetic range input component for vue 2.", | ||
"keywords": [ | ||
@@ -7,0 +7,0 @@ "vue-range-slider", |
142
README.md
# aesthetic-vue-range-input | ||
## Project setup | ||
<br> | ||
<br> | ||
<p align="center"> | ||
<img src="https://user-images.githubusercontent.com/44336070/135869793-6417e5f6-a2d7-4e6b-9df4-eea8b2fb6bb8.png" alt="Screenshot of aesth-vue-range-input"/> | ||
</p> | ||
<br> | ||
<br> | ||
a completely customizable and aesthetic range input component for vue 2. | ||
## Table of Contents | ||
1. [Features](#features) | ||
2. [Installation](#installation) | ||
3. [Usage](#usage) | ||
4. [Range Input Components](#range-input-components) | ||
5. [Props](#props) | ||
6. [License](#license) | ||
## Features | ||
- supports all native range input attributes because it is built on the native HTML range input. | ||
- completely customizable. | ||
- minimal design. | ||
- implements buffered feature (appropriate for media players). | ||
## Installation | ||
### npm | ||
```shell | ||
npm install aesth-vue-range-input | ||
``` | ||
npm install | ||
### CDN | ||
#### jsDelivr | ||
```xml | ||
<script src="https://cdn.jsdelivr.net/npm/aesth-vue-range-input"></script> | ||
``` | ||
### Compiles and hot-reloads for development | ||
#### UNPKG | ||
```xml | ||
<script src="https://unpkg.com/aesth-vue-range-input"></script> | ||
``` | ||
npm run serve | ||
## Usage | ||
If installed through npm, | ||
```vue | ||
<template> | ||
<div id="app"> | ||
<aesth-vue-range-input v-model.number="rangeValue" /> | ||
</div> | ||
</template> | ||
<script> | ||
import AesthVueRangeInput from "aesth-vue-range-input"; | ||
export default { | ||
data() { | ||
return { | ||
rangeValue: 20, | ||
}; | ||
}, | ||
components { | ||
AesthVueRangeInput, | ||
}, | ||
}; | ||
</script> | ||
``` | ||
### Compiles and minifies for production | ||
If installed through CDN, in your HTML file, | ||
```xml | ||
<head> | ||
<script src="https://cdn.jsdelivr.net/npm/vue@2"></script> | ||
<!-- OR --> | ||
<script src="https://unpkg.com/vue@2"></script> | ||
<script src="https://cdn.jsdelivr.net/npm/aesth-vue-range-input"></script> | ||
<!-- OR --> | ||
<script src="https://unpkg.com/aesth-vue-range-input"></script> | ||
</head> | ||
<body> | ||
<div id="app"> | ||
<aesth-vue-range-input v-model.number="rangeValue" /> | ||
</div> | ||
<script> | ||
var app = new Vue({ | ||
el: '#app', | ||
data: { | ||
rangeValue: 20, | ||
} | ||
}); | ||
</script> | ||
</body> | ||
``` | ||
npm run build | ||
``` | ||
### Lints and fixes files | ||
### Demo | ||
A Demo of the aesth-vue-range-input installed through jsDelivr is available [here](https://codepen.io/idorenyinudoh/pen/KKqLbEy). | ||
## Range Input Components | ||
- **progress**: The section to the left of the thumb. This section consists of values lower than the current value as indicated by the thumb. | ||
- **thumb**: The knob that the user can utilize to alter the range input's value. | ||
- **track**: The section that the thumb slides on. | ||
## Props | ||
All the props are optional. | ||
| Prop | Description | Type | Default | | ||
|-------------|-------------|-------------|-------------| | ||
| `max` | the greatest value in the range of permitted values | Number | 100 | | ||
| `value` | the value of the range input (make sure to include the `.number` modifier on the `v-model` directive) | Number | 0 | | ||
| `rangeWidth` | the width of the range input | String | 100% | | ||
| `progressColor` | the color of the range input's progress section (the `v-model` directive has to be present for this to be visible on webkit browsers) | String | #000c | | ||
| `trackColor` | the color of the range input's track | String | #0003 | | ||
| `squaredThumb` | boolean specifying whether the range input's thumb should be in a square or circle shape | Boolean | false | | ||
| `thumbBorderColor` | the color of the thumb's border | String | #000 | | ||
| `thumbSize` | the `width` and `height` CSS properties of the range input's thumb | String | 20px | | ||
| `buffered` | an object containing the `width` and `color` of the buffered section | Object | `undefined` | | ||
<br> | ||
Here's an implementation with the `buffered` prop: | ||
```vue | ||
<aesth-vue-range-input | ||
:buffered="{ | ||
width: '70%', | ||
color: '#0008', | ||
}" | ||
/> | ||
``` | ||
npm run lint | ||
``` | ||
### Customize configuration | ||
See [Configuration Reference](https://cli.vuejs.org/config/). | ||
# License | ||
[MIT](https://opensource.org/licenses/MIT) | ||
© Idorenyin Udoh |
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
Major refactor
Supply chain riskPackage has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.
Found 1 instance in 1 package
21348
143
0