# @cloud-ru/ds-status 中文文档 规范地址：https://npmcn.com/package/%40cloud-ru/ds-status/ 版本：1\.1\.17 npm 元数据更新时间：2026-11-11T15:02:43.569Z 中文译文更新时间：2026-11-11T16:06:39.720Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cloud-ru/ds-status 原文对照：https://npmcn.com/package/%40cloud-ru/ds-status/?lang=original 项目主页：https://github.com/cloud-ru-tech/snack-v2/tree/master/packages/status 源码仓库：https://github.com/cloud-ru-tech/snack-v2 ## 关键信息（来自 npm 元数据） - 包体积（解压后）：255 kB，50 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：5 个 - 首次发布：2026-08-18T12:39:29.732Z - 最新版本发布：2026-11-11T15:02:43.130Z - 近 30 天下载量：6951（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：71（近 12 个月 71 个） ## 中文简介 \-=YTET -伊甸园字幕组=- 翻译: 装入/进度. ## 安装 ```sh npm install @cloud-ru/ds-status ``` 也可以使用：`pnpm add @cloud-ru/ds-status`、`yarn add @cloud-ru/ds-status`、`bun add @cloud-ru/ds-status` ## README # 状态 `@cloud-ru/ds-status` - ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 装入/进度. Пакет `@cloud-ru/ds-status` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 - ****状态**** - ~~~~~~~~~~~~. Маркер быть точкой спиннером (`loading`{\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}你觉得怎样`progress`) (中文(简体) ). - ****状态指标**** -=ytet -伊甸园字幕组=- 翻译:. ## Установка ```bash pnpm add @cloud-ru/ds-status ``` ```ts import { Status, StatusIndicator } from '@cloud-ru/ds-status' ``` ## 状态 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}加载 - \\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? `loading`{\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}你觉得怎样`progress`) (中文(简体) ). ### Когда - \\\\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ :“ 行动 ” 、“ 暂停 ” 、“ 等待 ” . - {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}你觉得呢`loading`) (中文(简体) ). - Отображение(прогресса)`progress=0..100`{\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}请说. Когда **не** нужен:чип也 `Chip`编号 :`Tag`. . . . . `PromoTag`。 。 。 . ### Анатомия #### 大小 `xs` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你应该知道, `s` - ? ? ? - ? ? ? ? ? ? ? ? ? ? ? ? ? - ? - . #### 外观 校对:Soup `neutral` - нейтральный, `green` - успех/активно, `red` - ошибка/критично, `orange`编号 :`yellow` - предупреждение, `blue` - информация, `violet`编号 :`pink` - 额... ### Примеры #### Активный ```tsx import { Status } from '@cloud-ru/ds-status'; export function Active() { return ; } ``` #### 正在装入 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}看样子是中立的 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}是的. ```tsx import { Status } from '@cloud-ru/ds-status'; export function Loading() { return ; } ``` #### С (原始内容存档于2018-10-21). entertainment. ```tsx import { Status } from '@cloud-ru/ds-status'; export function WithBackground() { return ; } ``` ### 道具 **状态选项** | Prop | 类型 | 默认 | 说明 | | --- | --- | --- | --- | | `appearance` | `"blue"` | `"green"` | `"neutral"` | `"orange"` | `"pink"` | `"red"` | `"violet"` | `"yellow"` | `neutral` | Внешний(цветовая) | | `background` | `boolean` | `false` | Наличие | | `className` | `string` | —— 说 | 支助科 | | `data-test-id` | `string` | —— 说 | | | `innerRef` | `Ref` | —— 说 | (原始内容存档于2017-09-29). Ref QQ DOM-элемент. Используем,чтобы也 `forwardRef` (原始内容存档于2018-09-21) (英语). | | `label` | `string` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎么样? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 | | `loading` | `boolean` | `false` | Состояние | | `progress` | `number` | —— 说 | \========================================================================================================================================= | | `size` | `"s"` | `"xs"` | `s` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 | | `truncateVariant` | `"end"` | `"middle"` | —— 说 | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎么样. | ##### 相关类型 - `Appearance` =: `"blue"` | `"green"` | `"neutral"` | `"orange"` | `"pink"` | `"red"` | `"violet"` | `"yellow"` - `StatusSize` =: `"s"` | `"xs"` ## 状态指标 \[永久失效連結\] (中文(简体) ). Минимальный:"точка也. `4xs` → `s`{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我还得去 \[永久失效連結\] (中文(简体) ). ### Когда - \[永久失效連結\] (中文(简体) ). - (原始内容存档于2017-09-28). Badge-индикатор (онлайн, новое). - {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}内在 - {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我... Когда **не** нужен:пользователю也 `Status` с. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢. ### Анатомия #### 大小 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `4xs` (точка也 `s` (单位:++): `4xs`, (中文(简体) ), `3xs`, (中文(简体) ), `2xs`, (中文(简体) ), `xs`, (中文(简体) ), `s`。 。 。 . #### 外观 说吧 `neutral`, (中文(简体) ), `green` ( , `red` ( , `orange`编号 :`yellow` ( , `blue` ( , `violet`编号 :`pink` (декоративные. ### Примеры #### Базовый ```tsx import { StatusIndicator } from '@cloud-ru/ds-status'; export function BasicIndicator() { return ; } ``` ### 道具 **状态指标** | Prop | 类型 | 默认 | 说明 | | --- | --- | --- | --- | | `appearance` | `"blue"` | `"green"` | `"neutral"` | `"orange"` | `"pink"` | `"red"` | `"violet"` | `"yellow"` | `neutral` | Внешний | | `className` | `string` | —— 说 | | | `data-test-id` | `string` | —— 说 | | | `innerRef` | `Ref` | —— 说 | (原始内容存档于2017-09-29). Ref QQ DOM-элемент. Используем,чтобы也 `forwardRef` (原始内容存档于2018-09-21) (英语). | | `size` | `"2xs"` | `"3xs"` | `"4xs"` | `"s"` | `"xs"` | `s` | Размер | ##### 相关类型 - `Appearance` =: `"blue"` | `"green"` | `"neutral"` | `"orange"` | `"pink"` | `"red"` | `"violet"` | `"yellow"` - `StatusIndicatorSize` =: `"2xs"` | `"3xs"` | `"4xs"` | `"s"` | `"xs"` ## 常见问题 ### @cloud-ru/ds-status 是什么？ -=YTET -伊甸园字幕组=- 翻译: 装入/进度\. ### 如何安装 @cloud-ru/ds-status？ 在项目目录运行 npm install @cloud-ru/ds-status，或使用 pnpm add / yarn add / bun add。 ### @cloud-ru/ds-status 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @cloud-ru/ds-status 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @cloud-ru/ds-status 可以商用吗？ @cloud-ru/ds-status 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @cloud-ru/ds-status 的下载量有多少？ 根据 npm 官方下载统计，@cloud-ru/ds-status 在 2026/10/10 – 2026/11/08 这 30 天内被下载 6,951 次，日均约 232 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @cloud-ru/ds-status 还在维护吗？ 最新版本 1\.1\.17 发布于 2026/11/11（今天）；至今共发布 71 个版本，其中过去 12 个月发布了 71 个；首次发布于 2026/08/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。