2.10.2 • Published 2 years ago

colorpicker-v3 v2.10.2

Weekly downloads
-
License
ISC
Repository
github
Last release
2 years ago

一款支持vue3 的颜色选择器

使用文档

一款支持vue3 的颜色选择器

特点

  1. 简单易用,UI在原插件基础上优化增加了圆角和过渡动画
  2. 提供以 npm 的形式安装提供全局组件
  3. 在支持 html5 inputtype='color' 的浏览器实现了「更多颜色」的功能

安装

npm i colorpicker-v3

使用

在main中注册组件

main.js 文件中引入插件并注册

import { createApp } from 'vue'
import App from './App.vue'
import ColorPicker from 'colorpicker-v3'  // 注册组件
import 'colorpicker-v3/style.css' // 引入样式文件
const app = createApp(App)
app.use(ColorPicker)
app.mount('#app')

组件中使用

vue3 + js

使用 default-value 设置默认值

  • default-value 设置颜色默认值
<template>
  <color-picker @change="change" :defaultColor="defaultColor" v-model:hex="hex"></color-picker>
</template>

<script setup>
import { ref } from 'vue';
const hex = ref("");
const defaultColor = ref("#6c8198")
const change = (e) => {
  console.log(e); // {hex: '#ddd8c3', rgba: 'rgba(221,216,195,0.5849)'}
}
</script>

<style>
</style>

 

使用 hex 值响应式

hex 本身具有响应式功能,也可以通过 @change 事件获取 改变的值 说明:

  • 如果默认 hex 进行双向数据绑定, 该值如果不是"" 优先级会高于 default-value
  • 优先显示 hex
#### 使用 rgba 值响应式
> *  `rgba` 本身具有响应式功能,也可以通过 `@change` 事件获取 改变的值

```html

<template>
  <color-picker @change="change" v-model:rgba="rgba"></color-picker>
</template>

<script setup>
import { ref } from 'vue';
const rgba = ref("rgba(255,0,255,0.5)");

const change = (e) => {
  console.log(e); // {hex: '#ddd8c3', rgba: 'rgba(221,216,195,0.5849)'}
}
</script>

<style>
</style>

 

使用 rgba 与 hex 值响应式

  • rgbahex 本身具有响应式功能,也可以通过 @change 事件获取 改变的值
  • 注意点:
  • 此时如果 hexrgba 都有值时 此时会优先显示 rgba 的值,优先级高于 hex
#### vue+ts+setup
```html
<template>
  <color-picker @change="change" v-model:hex="hex"></color-picker>
</template>

<script setup>
import { ref } from 'vue';
const hex = ref("#ffffff");
const change = (e) => {
  console.log(e); // {hex: '#ddd8c3', rgba: 'rgba(221,216,195,0.5849)'}
}
</script>

<style>
</style>

Props

参数名描述类型默认值备注
default-color初始化颜色值string#000000使用16进制值
v-model:hex初始化颜色值(双向数据绑定)string#000000使用16进制值
v-model:rgba初始化颜色值(双向数据绑定)stringrgba(255,0,255,0.5)使用RGBA字符串
btnStyle设置颜色块样式Object--
opacity颜色透明度初始值numer10~1 数值越小透明度越低
show-opacity是否显示透明度控制块booleantrue
standard-color标准色初始化配置Array<string>standard-clolor详情使用完整的hex16 进制值
theme-color主题色初始化配置Array<string>theme-clolor详情使用完整的hex16 进制值

注意点:

  • 初始值优先级: default-color < hex < rgba

standard-clolor

const standardClolor = [
  '#c21401',
  '#ff1e02',
  '#ffc12a',
  '#ffff3a',
  '#90cf5b',
  '#00af57',
  '#00afee',
  '#0071be',
  '#00215f',
  '#72349d',
]

standardClolor

主题色theme-clolor

const themeClolor =[
                '#000000',
                '#ffffff',
                '#eeece1',
                '#1e497b',
                '#4e81bb',
                '#e2534d',
                '#9aba60',
                '#8165a0',
                '#47acc5',
                '#f9974c',
            ]

主题色

Events

事件名描述参数返回值
change颜色值改变时触发data: {hex:string,rgba: string}-
finish点击完成按钮data: {hex:string,rgba: string}-
close选色面板关闭data: {hex:string,rgba: string}-

使用示例

<template>
  <color-picker
    :hex="color"
    @change="change"
    :standard-color="bColor"
    @close="close"
    @finish="finish"
  ></color-picker>
</template>
<script lang="ts">
import { defineComponent, reactive, ref } from 'vue'
export default defineComponent({
  name: ''
})
</script>
<script lang="ts" setup>
const color = ref("")
const colorValue = ref({})

//  颜色值改变
const change = (e) => {
  // console.log("e", e)
  colorValue.value = e
}

// 颜色面板关闭
const close = (e) => {
  console.log("关闭了", e)
}

const finish = (e) => {
  console.log("点击完成", e)
}



const bColor = [
  '#c21401',
  '#ff1e02',
  '#ffc12a',
  '#ffff3a',
  '#90cf5b',
  '#00af57',
  '#00afee',
  '#0071be',
  '#00215f',
  '#72349d',
]
</script>
<style lang="less" scoped>
</style>

联系作者

微信

QQ:

1191814251