@cloud-ru/ds-color-picker

中文文档
1.0.24发布于 2026/11/12Apache-2.0TypeScriptESM + CJS近 30 天下载 5561

=================================================================================================== ===========================================================================================================================================================.

中文使用文档
文档目录15 节
  1. Когда
  2. Анатомия
  3. 大小( 默认) m (中文(简体) )
  4. 阿尔法( 默认) true (中文(简体) )
  5. 可用模式( 默认 —— —— )
  6. 应用模式( 默认) false (中文(简体) )
  7. Установка
  8. Примеры
  9. Базовое
  10. Размеры
  11. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF…
  12. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF…
  13. 道具
  14. Адаптивность
  15. Компактный(机动)

颜色选择器

@cloud-ru/ds-color-picker -=YTET -伊甸园字幕组=- 翻译:.

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}======================================================================================================================================================================================================================================= {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 RawColor-объектом(объектом)hex, (中文(简体) ), rgb, (中文(简体) ), rgba, (中文(简体) ), hsl, (中文(简体) ), hsla, (中文(简体) ), hsv, (中文(简体) ), hsva)————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————.

Когда

  • Когда(一作брендинг.
  • Когда.
  • {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.

Когда не нужен ColorPicker数字 :

  • Выбор:палитры也 Tag编号 :Chip。 。 。 .
  • {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 Toggle编号 :Switch。 。 。 .

Анатомия

大小( 默认) m(中文(简体) )

校对:Soup s 编号 : m 编号 : l。 。 。 .

阿尔法( 默认) true(中文(简体) )

withAlpha -=YTET -伊甸园字幕组=- 翻译:.

可用模式( 默认 —— —— )

availableModes . . . . . ColorMode[]。 。 。 。 。 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢hex, (中文(简体) ), rgb, (中文(简体) ), hsv) (中文(简体) ).

应用模式( 默认) false(中文(简体) )

  • autoApply: true —— 说 onChange {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得怎么样.
  • autoApply: false - накапливаются локально; onChange {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 Apply。 。 。 . Cancel {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 value (или:из也;если也.

Установка

pnpm add @cloud-ru/ds-color-picker

Примеры

Базовое

控制状态 {}

import { ColorPicker } from '@cloud-ru/ds-color-picker';
import { useState } from 'react';

export function Basic() {
  const [color, setColor] = useState<string>('#389f74');

  return <ColorPicker value={color} onChange={raw => setColor(raw.hex)} />;
}

Размеры

缩略语 :

import { ColorPicker } from '@cloud-ru/ds-color-picker';
import { useState } from 'react';

export function Sizes() {
  const [color, setColor] = useState<string>('#389f74');
  const handleChange = (raw: { hex: string }) => setColor(raw.hex);

  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      <ColorPicker size='s' value={color} onChange={handleChange} autoApply />
      <ColorPicker size='m' value={color} onChange={handleChange} autoApply />
      <ColorPicker size='l' value={color} onChange={handleChange} autoApply />
    </div>
  );
}

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢

自动页脚

import { ColorPicker } from '@cloud-ru/ds-color-picker';
import { useState } from 'react';

export function AutoApply() {
  const [color, setColor] = useState<string>('#4387e2');

  return <ColorPicker value={color} autoApply onChange={raw => setColor(raw.hex)} />;
}

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢

与阿尔法=假

import { ColorPicker } from '@cloud-ru/ds-color-picker';
import { useState } from 'react';

export function WithoutAlpha() {
  const [color, setColor] = useState<string>('#d52e33');

  return <ColorPicker value={color} withAlpha={false} autoApply onChange={raw => setColor(raw.hex)} />;
}

道具

颜色选择

Prop类型默认说明
autoApplybooleantrueПрименять. Если false ——取消/取消.
По true —— +++ (++===figma colorPicker,++++取消/+++).
availableModesColorMode['hex', 'hsv', 'rgb']{\fn华文仿宋\fs16\1cHD1D1D1}好.
classNamestring—— 说CSS - класс.
data-test-idstring—— 说
onChange((rawColor: RawColor) => void)—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 autoApply, 翻译 : 应用.
size"l" | "m" | "s"mРазмер.
valueAlpha | Color | HslColor | HsvColor | RgbColor—— 说Текущее. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得怎么样.
withAlphabooleantrue阿尔法 阿尔法 阿尔法.
withColorAreabooleantrue2D−(饱和/值−). false - только и и
(раскладка:узких也.

阿尔法

Prop类型默认说明
anumber—— 说
  • Color =: string | RgbColor | HslColor | HsvColor | RgbaColor | HslaColor | HsvaColor

  • ColorMode =: "hex" | "hsv" | "rgb"

Hsl 颜色

Prop类型默认说明
hnumber—— 说
lnumber—— 说
snumber—— 说

Hsv 颜色

Prop类型默认说明
hnumber—— 说
snumber—— 说
vnumber—— 说

Rgb 颜色

Prop类型默认说明
bnumber—— 说
gnumber—— 说
rnumber—— 说
  • Size =: "l" | "m" | "s"

Адаптивность

ColorPicker - презентационная,управляемая:сам. {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}♪ {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}♪ {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}♪♪ {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪♪FieldColor? ? ? ? ? ? ? ? ? ? ? ? ? ? AdaptiveProvider (单位:千美元)@cloud-ru/ds-adaptive) # # # # 手机 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # BottomSheet qQ, QQ桌面—— 停止弹出. Пропа layoutType у ColorPicker нет.

桌面一号. Поставьте <AdaptiveProvider> [永久失效連結] 腾讯动漫.

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得怎么样 ColorPicker 说吧

Проп桌面移动 (BottomSheet)
withColorArea2D-QQ 饱和度/ 值 (true(中文(简体) ){\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢false(中文(简体) )
autoApply{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢true(中文(简体) )qQ 应用( Q)false(中文(简体) )

Компактный(机动)

withColorArea={false} ——"2D-"饱和度/值","только".

import { ColorPicker } from '@cloud-ru/ds-color-picker';
import { useState } from 'react';

export function Compact() {
  const [color, setColor] = useState<string>('#389f74');

  return <ColorPicker value={color} withColorArea={false} autoApply={false} onChange={raw => setColor(raw.hex)} />;
}

Подробнее модели- Адаптивность-паттерн。 。 。 .

版本与发布记录

@cloud-ru/ds-color-picker 共发布 95 个版本,首次发布于 2026/08/18;过去 12 个月发布了 95 个版本。

版本发布日期距今
1.0.24latest2026/11/12今天
1.0.232026/11/11今天
1.0.23-preview-e8fe6b56.0preview2026/11/111 天前
1.0.23-preview-c0e895ed.02026/11/111 天前
1.0.23-preview-90b10112.02026/11/111 天前
1.0.23-preview-fd7dd437.02026/11/101 天前

关于 @cloud-ru/ds-color-picker 的常见问题

@cloud-ru/ds-color-picker 是什么?

=================================================================================================== ===========================================================================================================================================================.

如何安装 @cloud-ru/ds-color-picker?

在项目目录运行 npm install @cloud-ru/ds-color-picker,或使用 pnpm add / yarn add / bun add。

@cloud-ru/ds-color-picker 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cloud-ru/ds-color-picker 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cloud-ru/ds-color-picker 可以商用吗?

@cloud-ru/ds-color-picker 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@cloud-ru/ds-color-picker 的下载量有多少?

根据 npm 官方下载统计,@cloud-ru/ds-color-picker 在 2026/10/10 – 2026/11/08 这 30 天内被下载 5,561 次,日均约 185 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cloud-ru/ds-color-picker 还在维护吗?

最新版本 1.0.24 发布于 2026/11/12(今天);至今共发布 95 个版本,其中过去 12 个月发布了 95 个;首次发布于 2026/08/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。