Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
B

BlossomColorPicker

> 编程语言
Open source

A beautiful, blooming color picker for Web, built with pure CSS and compatible with JS, React, Vue, Svelte, and Angular.

387 stars0 likes1 views
WebsiteGitHub

About

A beautiful, blooming color picker for Web, built with pure CSS and compatible with JS, React, Vue, Svelte, and Angular.

Blossom Color Picker

A beautiful, blooming color picker for Web. Available as a standalone vanilla JS class, or as a thin React / Vue / Svelte / Angular wrapper.

https://github.com/user-attachments/assets/553ee0ff-1f52-497f-bc8f-cee9a7b91d66

Packages

Package Description Version
@dayflow/blossom-color-picker Vanilla JS core (zero dependencies) 2.0.0
@dayflow/blossom-color-picker-react React wrapper 1.0.0
@dayflow/blossom-color-picker-vue Vue 3 wrapper 1.0.0
@dayflow/blossom-color-picker-svelte Svelte wrapper 1.0.0
@dayflow/blossom-color-picker-angular Angular wrapper 1.0.0

Installation

bash
# Vanilla JS (core)
npm install @dayflow/blossom-color-picker

# React
npm install @dayflow/blossom-color-picker-react

# Vue 3
npm install @dayflow/blossom-color-picker-vue

# Svelte
npm install @dayflow/blossom-color-picker-svelte

# Angular
npm install @dayflow/blossom-color-picker-angular

Usage

Vanilla JS

javascript
import { BlossomColorPicker } from '@dayflow/blossom-color-picker';
import '@dayflow/blossom-color-picker/styles.css'; //  console.log(color.hex),
});

// Programmatic control
picker.expand();
picker.collapse();
picker.toggle();
picker.setValue({ hue: 200, saturation: 50, alpha: 100, layer: 'outer' });
picker.setOptions({ disabled: true });
picker.destroy();

React

typescript
import { BlossomColorPicker } from '@dayflow/blossom-color-picker-react';

function App() {
  const [color, setColor] = useState({
    hue: 330,
    saturation: 70,
    alpha: 100,
    layer: 'outer' as const,
  });

  return  setColor(c)} />;
}

Vue 3

xml

  

Svelte

svelte

Angular

The current Angular wrapper requires Angular 22.

typescript
import { Component } from '@angular/core';
import {
  BlossomColorPickerComponent,
  type BlossomColorPickerColor,
} from '@dayflow/blossom-color-picker-angular';

@Component({
  selector: 'app-root',
  imports: [BlossomColorPickerComponent],
  template: `
    
  `,
})
export class App {
  color = { hue: 330, saturation: 70, alpha: 100, layer: 'outer' as const };

  onColorChange(c: BlossomColorPickerColor) {
    this.color = c;
  }
}

Options / Props

All packages share the same set of options. In React they are passed as JSX props; in Vue as component props (with events via @change / @collapse); in Svelte as callback props (onchange / oncollapse); in Angular as @Input() bindings (with events via (colorChange) / (colorCollapse)).

Option Type Default Description
value BlossomColorPickerValue - Controlled value of the picker.
defaultValue BlossomColorPickerValue { hue: 330, saturation: 70, alpha: 50, layer: 'outer' } Initial value for uncontrolled mode.
colors ColorInput[] (Default 18-color set) Color list, automatically sorted and distributed into layers.
onChange (color: BlossomColorPickerColor) => void - Called when color changes. Vue: @change. Svelte: onchange. Angular: (colorChange).
onCollapse (color: BlossomColorPickerColor) => void - Called when the picker collapses. Vue: @collapse. Svelte: oncollapse. Angular: (colorCollapse).
disabled boolean false Whether the picker is disabled.
openOnHover boolean false If true, opens the picker on hover instead of click.
initialExpanded boolean false Whether the picker starts expanded.
animationDuration number 300 Duration of the blooming animation in ms.
showAlphaSlider boolean true Whether to show the saturation arc slider.
coreSize number 32 Diameter of the central circle in px.
petalSize number 32 Diameter of individual color petals in px.
showCoreColor boolean true When true, the core shows the selected color while expanded.
sliderPosition 'top' | 'bottom' | 'left' | 'right' 'right' Fixed position for the arc slider.
adaptivePositioning boolean true Smart Shifter: Automatically shifts the picker to stay within viewport and repositions the slider for best visibility.
circularBarWidth number 12 Thickness of the circular color bar in px.
sliderWidth number 12 Thickness of the arc slider track and handle in px.
sliderOffset number 30 Distance between the outermost petals and the arc slider in px.
className / class string "" Additional CSS class (React: className, Svelte: class).

Vanilla JS Methods

The core class exposes these additional methods:

Method Description
setValue(value) Set the current color value.
getValue() Get the current color as a BlossomColorPickerColor.
expand() Open the picker.
collapse() Close the picker.
toggle() Toggle open/close.
setOptions(opts) Update any options at runtime.
destroy() Remove all DOM elements and event listeners.

Type Reference

BlossomColorPickerValue

The value object used for controlled / uncontrolled state.

Field Type Description
hue number Hue angle (0-360).
saturation number Slider position (0-100). 0 = bright, 100 = dark.
lightness number? HSL lightness (auto-computed from slider if omitted).
originalSaturation number? Base saturation of the selected petal.
alpha number Alpha value (0-100).
layer 'inner' | 'outer' Which layer the selected petal belongs to.

BlossomColorPickerColor

Extends BlossomColorPickerValue — returned by onChange and onCollapse.

Field Type Description
hex string Hex color string, e.g. "#6586E5".
hsl string HSL string, e.g. "hsl(225, 71%, 65%)".
hsla string HSLA string with alpha.

ColorInput

typescript
type ColorInput = string | { h: number; s: number; l: number };

Color Formats

The colors option accepts any of the following formats, and they can be mixed:

javascript
// Vanilla JS
const picker = new BlossomColorPicker(el, {
  colors: [
    '#FF6B6B', // hex
    'rgb(107, 203, 119)', // rgb()
    'rgba(65, 105, 225, 0.9)', // rgba()
    'hsl(280, 70%, 55%)', // hsl()
    'hsl(200 80% 60%)', // hsl() space-separated
    { h: 45, s: 90, l: 65 }, // HSL object
  ],
});
typescript
// React

Project Structure

For local development, use Node.js 24 (see .nvmrc) and install dependencies with pnpm install --frozen-lockfile. From the repository root, run npm run dev to build the required component packages and start the full website at http://localhost:5177, including /docs/introduction.

Use npm run dev:demo for the standalone component demo instead. Run pnpm dev:packages in a separate terminal to watch component package changes.

This is a monorepo with five packages:

packages/
  core/      @dayflow/blossom-color-picker          — standalone vanilla JS class
  react/     @dayflow/blossom-color-picker-react     — thin React wrapper
  vue/       @dayflow/blossom-color-picker-vue       — thin Vue 3 wrapper
  svelte/    @dayflow/blossom-color-picker-svelte    — thin Svelte 5 wrapper
  angular/   @dayflow/blossom-color-picker-angular   — thin Angular wrapper

Made by Jayce Li, idea from @lichinlin.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

TypeScriptblossom-uicolor-picker

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言