# @cloud-ru/ds-color-picker 中文文档

规范地址：https://npmcn.com/package/%40cloud-ru/ds-color-picker/

版本：1\.0\.24
npm 元数据更新时间：2026-11-12T10:57:43.231Z
中文译文更新时间：2026-11-12T12:05:52.560Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cloud-ru/ds-color-picker
原文对照：https://npmcn.com/package/%40cloud-ru/ds-color-picker/?lang=original
项目主页：https://github.com/cloud-ru-tech/snack-v2/tree/master/packages/color-picker
源码仓库：https://github.com/cloud-ru-tech/snack-v2

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：484 kB，123 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：7 个
- 首次发布：2026-08-18T12:41:25.228Z
- 最新版本发布：2026-11-12T10:57:42.562Z
- 近 30 天下载量：5561（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：95（近 12 个月 95 个）

## 中文简介

\=================================================================================================== ===========================================================================================================================================================.

## 安装

```sh
npm install @cloud-ru/ds-color-picker
```

也可以使用：`pnpm add @cloud-ru/ds-color-picker`、`yarn add @cloud-ru/ds-color-picker`、`bun add @cloud-ru/ds-color-picker`

## README

# 颜色选择器

`@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` (или:из也;если也.

## Установка

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

## Примеры

### Базовое

控制状态 {}

```tsx
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)} />;
}
```

### Размеры

缩略语 :

```tsx
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}你觉得呢

自动页脚

```tsx
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}你觉得呢

与阿尔法=假

```tsx
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 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `autoApply` | `boolean` | `true` | Применять. Если `false` ——取消/取消.  
По `true` —— +++ (++===figma colorPicker,++++取消/+++). |
| `availableModes` | `ColorMode` | `['hex', 'hsv', 'rgb']` | {\\fn华文仿宋\\fs16\\1cHD1D1D1}好. |
| `className` | `string` | —— 说 | CSS - класс. |
| `data-test-id` | `string` | —— 说 |  |
| `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` | Размер. |
| `value` | `Alpha` | `Color` | `HslColor` | `HsvColor` | `RgbColor` | —— 说 | Текущее. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎么样. |
| `withAlpha` | `boolean` | `true` | 阿尔法 阿尔法 阿尔法. |
| `withColorArea` | `boolean` | `true` | 2D−(饱和/值−). `false` - только и и  
(раскладка:узких也. |

#### 相关类型

**阿尔法**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `a` | `number` | —— 说 |  |

-   `Color` =: `string | RgbColor | HslColor | HsvColor | RgbaColor | HslaColor | HsvaColor`
    
-   `ColorMode` =: `"hex"` | `"hsv"` | `"rgb"`
    

**Hsl 颜色**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `h` | `number` | —— 说 |  |
| `l` | `number` | —— 说 |  |
| `s` | `number` | —— 说 |  |

**Hsv 颜色**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `h` | `number` | —— 说 |  |
| `s` | `number` | —— 说 |  |
| `v` | `number` | —— 说 |  |

**Rgb 颜色**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `b` | `number` | —— 说 |  |
| `g` | `number` | —— 说 |  |
| `r` | `number` | —— 说 |  |

-   `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) |
| --- | --- | --- |
| `withColorArea` | 2D-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-"饱和度/值","только".

```tsx
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)} />;
}
```

Подробнее модели- [Адаптивность-паттерн](https://npmcn.com/patterns/adaptive)。 。 。 .

## 常见问题

### @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 和提交记录判断。