vue-accessible-color-picker
Advanced tools
A color picker component for Vue.js 3.
This package’s files are distributed in the ES module format and have not been transpiled.
Links:
npm install vue-accessible-color-picker
In a Vue single file component, import the ColorPicker component.
When using Vue’s composition API, you can directly use the component in the file’s template section.
<template>
<ColorPicker />
</template>
<script setup>
import { ColorPicker } from 'vue-accessible-color-picker'
</script>
When using Vue’s options API, the component must first be registered using the components property on the Vue instance.
<template>
<ColorPicker />
</template>
<script>
import { ColorPicker } from 'vue-accessible-color-picker'
export default {
components: {
ColorPicker,
},
}
</script>
Unstyled component:
If you want to use the unstyled variant of the component, you need to adjust the import statement to use the module specifier “vue-accessible-color-picker/unstyled”:
import { ColorPicker } from 'vue-accessible-color-picker/unstyled'
colorDescription: Sets the color of the color picker. You can pass any valid CSS color string or an object matching the internal color representation for an HSL, HSV, HWB, or RGB color.
Type: string, ColorHsl, ColorHsv, ColorHwb, or ColorRgb
Required: false
Default: null
Usage:
<ColorPicker color="hsl(270 100% 50% / 0.8)" />
<ColorPicker color="#f80b" />
<ColorPicker :color="{ h: 0.75, s: 1, l: 0.5, a: 0.8 }" />
<template>
<ColorPicker
:color="color"
@color-change="updateColor"
/>
</template>
<script setup>
import { ref } from 'vue'
import { ColorPicker } from 'vue-accessible-color-picker'
const color = ref('hsl(270 100% 50% / 0.8)')
function updateColor (eventData) {
color.value = eventData.cssColor
}
</script>
visibleFormatsDescription: A list of visible color formats. Controls for which formats the color input elements are shown and in which order the formats will be cycled through when activating the format switch button.
Type: VisibleColorFormat[]
Required: false
Default: ['hex', 'hsl', 'hwb', 'rgb']
Usage:
<ColorPicker :visible-formats="['hsl', 'hwb']" />
defaultFormatDescription: The color format to show by default when rendering the color picker. Must be one of the formats specified in visibleFormats.
Type: VisibleColorFormat
Required: false
Default: 'rgb'
Usage:
<ColorPicker default-format="hwb" />
alphaChannelDescription: Whether to show input controls for a color’s alpha channel. If set to 'hide', the alpha range input and the alpha channel input are hidden, the “Copy color” button will copy a CSS color value without alpha channel, and the object emitted in a color-change event will have a cssColor property value without alpha channel.
Type: 'show' or 'hide'
Required: false
Default: 'show'
Usage:
<ColorPicker alpha-channel="hide" />
idDescription: The ID value will be used to prefix all input elements’ id and label elements’ for attribute values. Set this prop if you use multiple instances of the color-picker component on one page.
Type: string
Required: false
Default: 'color-picker'
Usage:
<ColorPicker id="color-picker-1" />
color-changeDescription: An input event is emitted each time the internal colors object is updated.
Data: The event emits an object containing both the internal colors object and a CSS color value as a string based on the currently active format. The cssColor property will respect alphaChannel.
{
colors: {
hex: string
hsl: ColorHsl
hsv: ColorHsv
hwb: ColorHwb
rgb: ColorRgb
}
cssColor: string
}
Usage:
<template>
<ColorPicker
color="hsl(270 100% 50% / 0.8)"
@color-change="updateColor"
/>
</template>
<script setup>
import { ColorPicker } from 'vue-accessible-color-picker'
function updateColor (eventData) {
console.log(eventData)
}
</script>
Description: Overrides the content of the hue range input’s label element. The slot content is placed inside a span element.
Default content:
Hue
Description: Overrides the content of the alpha range input’s label element. The slot content is placed inside a span element.
Default content:
Alpha
Description: Overrides the content of the copy button element.
Default content:
Copy color
Description: Overrides the content of the format switch button element.
Default content:
Switch format
| Edge (Chromium) | Firefox | Chrome | Safari |
|---|---|---|---|
| 79 | 63 | 73 | 12.2 |
The browser support is derived from the use of Object.fromEntries() and CSS custom properties.
This package uses semantic versioning.
The color picker consists of the following main elements:
Color space:
For fine-tuning the saturation and lightness/value, a slice of the HSV cylinder for the currently selected hue is shown.
The HSV cylinder is more convenient for this task as it shows a color at 100% saturation and 100% value in the top right corner (i.e. one can drag the color space thumb into the corner as a quasi shortcut). The HSL cylinder’s slice has this color at the halfway point of the Y axis (i.e. at 50% lightness) which isn’t easy to select.
Hue slider:
A slider for selecting the current hue. This rotates the HSV cylinder; thus, it changes the slice of the HSV cylinder that’s shown in the color space.
Alpha slider:
A slider for selecting the current alpha value.
Copy button:
Copies the color formatted as a CSS color string in the active format.
Color inputs:
A set of text fields which allow you to enter the individual components of each color. The text fields are shown based on the active format.
Switch format button:
Cycles through the available color formats (currently HEX, HSL, HWB, and RGB).
FAQs
Color picker component for Vue.js
The npm package vue-accessible-color-picker receives a total of 1,660 weekly downloads. As such, vue-accessible-color-picker popularity was classified as popular.
We found that vue-accessible-color-picker demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PEP 770 proposes adding SBOM support to Python packages to improve transparency and catch hidden non-Python dependencies that security tools often miss.
Security News
Socket CEO Feross Aboukhadijeh discusses open source security challenges, including zero-day attacks and supply chain risks, on the Cyber Security Council podcast.
Security News
Research
Socket researchers uncover how threat actors weaponize Out-of-Band Application Security Testing (OAST) techniques across the npm, PyPI, and RubyGems ecosystems to exfiltrate sensitive data.