更新记录
0.0.3(2025-06-27)
- feat: 支持uniappx
0.0.1(2023-05-30)
- 首次上传
平台兼容性
uni-app(4.44)
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | - | 5.1 | √ | √ |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | - | - | - | - | - | - | - | - | - | - |
uni-app x(4.71)
Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
---|---|---|---|---|---|
√ | √ | 5.1 | √ | √ | √ |
lime-color-picker 颜色选择器
- 颜色选择器,选择器不包含弹窗,如果需要弹窗请自行使用第三方弹窗
- 插件依赖
lime-shared
,lime-style
不喜勿下
文档
🚀 color-picker【站点1】 🌍 color-picker【站点2】 🔥 color-picker【站点3】
安装
插件市场导入
代码演示
基础使用
颜色编码格式,支持 HEX
、HSB
、RGB
。
<l-color-picker v-model="color"></l-color-picker>
const color = ref('#FA8C16')
受控模式
<l-color-picker value="#FA8C16" @change="change"></l-color-picker>
const change = (value: UTSJSONObject) => {
const hex = value['hex'] as string;
const rgb = value['rgb'] as string;
const hsb = value['hsb'] as string;
}
预设颜色
<l-color-picker :presets="presets"></l-color-picker>
const presets = [{
label: 'Recommended',
colors: [
'#000000',
'#000000E0',
'#000000A6',
'#00000073',
'#00000040',
'#00000026',
'#0000001A',
'#00000012',
'#0000000A',
'#00000005',
'#F5222D',
'#FA8C16',
'#FADB14',
'#8BBB11',
'#52C41A',
'#13A8A8',
'#1677FF',
'#2F54EB',
'#722ED1',
'#EB2F96',
'#F5222D4D',
'#FA8C164D',
'#FADB144D',
'#8BBB114D',
'#52C41A4D',
'#13A8A84D',
'#1677FF4D',
'#2F54EB4D',
'#722ED14D',
'#EB2F964D',
],
},
{
label: 'Recent',
colors: [],
}]
查看示例
导入后直接使用这个标签查看演示效果,
// 代码位于 uni_modules/lime-color-picker/compoents/lime-color-picker
<lime-color-picker />
关于vue2的使用方式
- 插件使用了
composition-api
, 如果你希望在vue2中使用请按官方的教程vue-composition-api配置 - 关键代码是: 在main.js中 在vue2部分加上这一段即可,官方是把它单独成了一个文件.
// vue2 import Vue from 'vue' import VueCompositionAPI from '@vue/composition-api' Vue.use(VueCompositionAPI)
插件标签
- 默认 l-color-picker 为 component
- 默认 lime-color-picker 为 demo
API
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
value(v-model) | 颜色的值 | string | - |
defaultValue | 颜色的值 | string | - |
presets | 预设的颜色 | { label: string, colors: Array |
- |
disabled | 禁用颜色选择器 | boolean | - |
CSS变量
组件提供了以下CSS变量,可以通过自定义CSS变量来自定义组件样式:
变量名 | 说明 | 默认值 |
---|---|---|
--l-color-picker-palette-height | 调色板高度 | 230px |
--l-color-picker-handle-size | 调色板手柄大小 | 26px |
--l-color-picker-handle-border-width | 手柄边框宽度 | 2px |
--l-color-picker-handle-border-color | 手柄边框颜色 | white |
--l-color-picker-gap | 组件内部间距 | 10px |
--l-color-picker-slider-container-height | 滑块容器高度 | calc(var(--l-color-picker-handle-size) * 2 + 10px) |
--l-color-picker-input-height | 输入框高度 | 40px |
--l-color-picker-format-option-height | 格式选择项高度 | 25px |
--l-color-picker-format-indicator-height | 格式指示器高度 | 25px |
--l-color-picker-format-picker-width | 格式选择器宽度 | 70px |
--l-color-picker-preset-label-line-height | 预设颜色标签行高 | 42px |
--l-color-picker-preset-color-size | 预设颜色块大小 | 28px |
--l-color-picker-preset-color-gap | 预设颜色块间距 | 4px |
--l-color-picker-handle-shadow | 手柄阴影 | inset 0 0 1px 0 rgba(0, 0, 0, 0.25), 0 0 0 1px rgba(0, 0, 0, 0.06) |
--l-color-picker-slider-margin | 滑块外边距 | 16px |
--l-color-picker-handle-border-radius | 手柄边框圆角 | 99px |
--l-color-picker-slider-size | 滑块整体大小 | 28px |
--l-color-picker-slider-handle-size | 滑块手柄大小 | 24px |
--l-color-picker-slider-hue | 色相滑块的基础颜色 | red |
--l-color-picker-slider-active-color | 滑块激活状态的颜色 | red |
使用示例:
/* 自定义颜色选择器样式 */
.l-color-picker {
--l-color-picker-palette-height: 300px;
--l-color-picker-handle-size: 30px;
--l-color-picker-preset-color-size: 32px;
}
打赏
如果你觉得本插件,解决了你的问题,赠人玫瑰,手留余香。