# @cloud-ru/ds-input-private 中文文档

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

版本：1\.0\.16
npm 元数据更新时间：2026-11-11T15:01:58.610Z
中文译文更新时间：2026-11-11T15:36:47.737Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：279 kB，77 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-08-18T12:39:43.061Z
- 最新版本发布：2026-11-11T15:01:58.350Z
- 近 30 天下载量：11655（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：63（近 12 个月 63 个）

## 中文简介

Базовая `<input>` \\\\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\.

## 安装

```sh
npm install @cloud-ru/ds-input-private
```

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

## README

# 私人输入

`@cloud-ru/ds-input-private` {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `<input>` \\\\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\.

`@cloud-ru/ds-input-private` . . . . . QQQ:QQQ(焦点/被禁用/只读/出错),QQQ,前缀/后缀,QQQQQQ. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎样`@cloud-ru/ds-search`,"доменные","которые".

## Когда

-   {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你说什么.
-   {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `Search`。 。 。 .

В **не** {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得怎么样.

## Установка

```bash
pnpm add @cloud-ru/ds-input-private
```

```ts
import { InputPrivate, useClearButton, useButtonNavigation } from '@cloud-ru/ds-input-private'
```

## 道具

### 私人输入

**输入私有程序**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `autoComplete` | `string | boolean` | `false` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `autoFocus` | `boolean` | `false` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `className` | `string` | —— 说 | 支助科 |
| `data-test-id` | `string` | —— 说 |  |
| `disabled` | `boolean` | `false` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `id` | `string` | —— 说 | 页面存档备份,存于互联网档案馆 互联网档案馆的存檔,存档日期2013-12-02 |
| `inputMode` | `"decimal"` | `"email"` | `"none"` | `"numeric"` | `"search"` | `"tel"` | `"text"` | `"url"` | `text` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `max` | `number` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `maxLength` | `number` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `min` | `number` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `name` | `string` | —— 说 | Html- 名称 |
| `onBlur` | `FocusEventHandler<HTMLInputElement>` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `onChange` | `((value: string, e?: ChangeEvent<HTMLInputElement>) => void)` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `onClick` | `MouseEventHandler<HTMLInputElement>` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `onFocus` | `FocusEventHandler<HTMLInputElement>` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `onKeyDown` | `KeyboardEventHandler<HTMLInputElement>` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `onMouseDown` | `MouseEventHandler<HTMLInputElement>` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `onPaste` | `ClipboardEventHandler<HTMLInputElement>` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `pattern` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `placeholder` | `string` | —— 说 | Значение |
| `readonly` | `boolean` | `false` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `spellCheck` | `boolean` | `true` | 拼写检查(проверка) |
| `step` | `string | number` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 |
| `tabIndex` | `number` | `0` | QQ 标签索引 |
| `type` | `"email"` | `"number"` | `"password"` | `"tel"` | `"text"` | `"url"` | `text` | Тип |
| `value` | `string` | \`\` | QQ 输入 |

#### 相关类型

-   `InputMode` =: `"decimal"` | `"email"` | `"none"` | `"numeric"` | `"search"` | `"tel"` | `"text"` | `"url"`
    
-   `Type` =: `"email"` | `"number"` | `"password"` | `"tel"` | `"text"` | `"url"`
    

### 使用按钮导航

**使用按钮导航**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `inputRef` | `RefObject<T | null>` | —— 说 |  |
| `onButtonKeyDown` | `KeyboardEventHandler<HTMLButtonElement>` | `() => {}` |  |
| `postfixButtons` | `ActiveItem` | `ButtonProps` | `InactiveItem` | —— 说 |  |
| `prefixButtons` | `ActiveItem` | `ButtonProps` | `InactiveItem` | `[]` |  |
| `readonly` | `boolean` | —— 说 |  |
| `setInputFocus` | `(() => void)` | `() => focusWithoutScroll(inputRef.current)` |  |
| `submitKeys` | `string[]` | —— 说 |  |

#### 相关类型

**活动项目**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `active` | `true` | —— 说 |  |
| `id` | `string` | —— 说 |  |
| `ref` | `ButtonRef` | —— 说 |  |
| `render` | `(props: RenderActiveButtonProps) => ReactElement` | —— 说 |  |
| `show` | `boolean` | —— 说 |  |

-   `ButtonProps` =: `InactiveItem | ActiveItem`
    
-   `ButtonRef` =: `RefObject<HTMLButtonElement | null>`
    

**非活动项目**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `active` | `false` | —— 说 |  |
| `id` | `string` | —— 说 |  |
| `render` | `(props: RenderInactiveButtonProps) => ReactElement` | —— 说 |  |
| `show` | `boolean` | —— 说 |  |

### 使用 Clear 按钮

**使用 Clear 按钮Props**

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `clearButtonRef` | `RefObject<HTMLButtonElement | null>` | —— 说 |  |
| `dataTestId` | `string` | `button-clear-value` | (原始内容存档于2018-09-29). data-test-id QQ. (原始内容存档于2018-10-29). QQ, когда D. |
| `disabled` | `boolean` | —— 说 |  |
| `onClear` | `MouseEventHandler<HTMLButtonElement>` | —— 说 |  |
| `onDown` | `MouseEventHandler<HTMLButtonElement>` | —— 说 |  |
| `showClearButton` | `boolean` | —— 说 |  |
| `size` | `"l"` | `"m"` | `"s"` | —— 说 |  |

#### 相关类型

-   `Size` =: `"l"` | `"m"` | `"s"`

## Смотри

-   **搜索**, (中文(简体) ), **私人搜索** ——публичные.

## 常见问题

### @cloud-ru/ds-input-private 是什么？

Базовая \<input\> \\\\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\\.

### 如何安装 @cloud-ru/ds-input-private？

在项目目录运行 npm install @cloud-ru/ds-input-private，或使用 pnpm add / yarn add / bun add。

### @cloud-ru/ds-input-private 支持 TypeScript 吗？

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

### @cloud-ru/ds-input-private 支持 ESM 还是 CommonJS？

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

### @cloud-ru/ds-input-private 可以商用吗？

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

### @cloud-ru/ds-input-private 的下载量有多少？

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

### @cloud-ru/ds-input-private 还在维护吗？

最新版本 1\.0\.16 发布于 2026/11/11（今天）；至今共发布 63 个版本，其中过去 12 个月发布了 63 个；首次发布于 2026/08/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。