简体中文
FxColorPicker
约 502 字大约 2 分钟
2025-12-16
用于颜色选择,支持多种格式。
Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| value / v-model | 绑定值 | string | — | — |
| disabled | 是否禁用 | boolean | — | false |
| size | 尺寸 | string | — | medium / small / mini |
| show-alpha | 是否支持透明度选择 | boolean | — | false |
| color-format | 写入 v-model 的颜色的格式 | string | hsl / hsv / hex / rgb | hex(show-alpha 为 false)/ rgb(show-alpha 为 true) |
| popper-class | ColorPicker 下拉框的类名 | string | — | — |
| predefine | 预定义颜色 | array | — | — |
| hide-color-panel | 隐藏颜色选择面板 | boolean | — | — |
| hide-footer | 隐藏底部操作区域 | boolean | — | — |
Events
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| change | 当绑定值变化时触发 | 当前值 |
| active-change | 面板中当前显示的颜色发生改变时触发 | 当前显示的颜色值 |
Slot
| name | 说明 |
|---|---|
| footer | 按钮操作区的内容 |
基础用法
<div class="block">
<span class="demonstration">有默认值</span>
<fx-color-picker v-model="color1" >
<!-- <div slot="footer">aaa</div> -->
</fx-color-picker>
</div>
<div class="block">
<span class="demonstration">无默认值</span>
<fx-color-picker v-model="color2"></fx-color-picker>
</div>
<script>
export default {
data() {
return {
color1: '#409EFF',
color2: null
}
}
};
</script>选择透明度
<fx-color-picker v-model="color" show-alpha ></fx-color-picker>
<script>
export default {
data() {
return {
color: 'rgba(19, 206, 102, 0.8)'
}
}
};
</script>预定义颜色
<fx-color-picker
v-model="color"
show-alpha
hideFooter
hide-color-panel
:predefine="predefineColors">
</fx-color-picker>
<script>
export default {
data() {
return {
color: 'rgba(255, 69, 0, 0.68)',
predefineColors: [
'#ff4500',
'#ff8c00',
'#ffd700',
'#90ee90',
'#00ced1',
'#1e90ff',
'#c71585',
'rgba(255, 69, 0, 0.68)',
'rgb(255, 120, 0)',
'hsv(51, 100, 98)',
'hsva(120, 40, 94, 0.5)',
'hsl(181, 100%, 37%)',
'hsla(209, 100%, 56%, 0.73)',
'#c7158577'
]
}
}
};
</script>不同尺寸
<fx-color-picker v-model="color"></fx-color-picker>
<fx-color-picker v-model="color" size="medium"></fx-color-picker>
<fx-color-picker v-model="color" size="small"></fx-color-picker>
<fx-color-picker v-model="color" size="mini"></fx-color-picker>
<script>
export default {
data() {
return {
color: '#409EFF'
}
}
};
</script>