ColorPicker 取色器
WebH5
颜色选择器。触发器显示色块与 hex 文本,下拉含预设色板、hex 手输与原生取色器自定义。
何时使用
需要用户挑选颜色:主题色、标签色、画板取色。
何时不使用
只需从少量固定色中选一个时,直接用 RadioGroup + 色块更轻。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "\"\"" | 绑定值(v-model),hex '#rrggbb' 格式 |
presets | string[] | "12 个常用色" | 预设色板,hex 数组 |
disabled | boolean | false | 禁用 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 选中预设、手输合法 hex 或取色器选色时触发 |
change | string | 颜色提交时触发 |
示例
基础
示例加载中…
自定义预设
示例加载中…
禁用态 + 选中值回显
示例加载中…
Playground
加载中…
md
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 ColorPicker 文档(含手机预览)。