# @datadog/druids 中文文档

规范地址：https://npmcn.com/package/%40datadog/druids/

版本：0\.1\.1
npm 元数据更新时间：2026-11-06T20:22:47.795Z
中文译文更新时间：2026-11-11T13:42:11.003Z
软件包许可：SEE LICENSE IN EULA\.txt

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

原始 npm 页面：https://www.npmjs.com/package/%40datadog/druids
原文对照：https://npmcn.com/package/%40datadog/druids/?lang=original
项目主页：https://datadoghq.com/
源码仓库：https://datadoghq.com/

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

- 包体积（解压后）：7.5 MB，1264 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0
- 首次发布：2026-05-11T12:12:53.763Z
- 最新版本发布：2026-11-06T20:22:47.657Z
- 近 30 天下载量：4687（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

供外部使用的数据犬 DRUIDS 组件

## 安装

```sh
npm install @datadog/druids
```

也可以使用：`pnpm add @datadog/druids`、`yarn add @datadog/druids`、`bun add @datadog/druids`

## README

# @ datadog/ druids (数据狗/德鲁兹)

Datadog DRUIDS 组件供外部使用.

## 构成部分

每个部分都有自己的切入点,例如: `import { Button } from '@datadog/druids/form/Button';`。 。 。 .

### 对话框

-   `Modal` 从 `@datadog/druids/dialogs/Modal`
-   `Popover`, (中文(简体) ), `usePopoverProps` 从 `@datadog/druids/dialogs/Popover`
-   `PopoverMenuItem` 从 `@datadog/druids/dialogs/PopoverMenuItem`

### 表单

-   `Button` 从 `@datadog/druids/form/Button`
-   `Checkbox` 从 `@datadog/druids/form/Checkbox`
-   `InputNumber` 从 `@datadog/druids/form/InputNumber`
-   `InputPassword` 从 `@datadog/druids/form/InputPassword`
-   `InputSearch` 从 `@datadog/druids/form/InputSearch`
-   `InputText` 从 `@datadog/druids/form/InputText`
-   `RadioButtons` 从 `@datadog/druids/form/RadioButtons`
-   `Select` 从 `@datadog/druids/form/Select`
-   `SoftToggle` 从 `@datadog/druids/form/SoftToggle`
-   `SplitButton` 从 `@datadog/druids/form/SplitButton`
-   `TextArea` 从 `@datadog/druids/form/TextArea`
-   `ToggleButtons` 从 `@datadog/druids/form/ToggleButtons`
-   `ToggleSwitch` 从 `@datadog/druids/form/ToggleSwitch`

### 版式

-   `DruidsEnvironment` 从 `@datadog/druids/layout/DruidsEnvironment`
-   `Grid` 从 `@datadog/druids/layout/Grid`
-   `GridItem` 从 `@datadog/druids/layout/GridItem`
-   `HorizontalSeparator` 从 `@datadog/druids/layout/HorizontalSeparator`
-   `SidePanel` 从 `@datadog/druids/layout/SidePanel`
-   `Spacing` 从 `@datadog/druids/layout/Spacing`

### 措施

-   `CalloutValue` 从 `@datadog/druids/measures/CalloutValue`
-   `ScoreBar` 从 `@datadog/druids/measures/ScoreBar`

### 杂项

-   `Hook` 从 `@datadog/druids/misc/Hook`
-   `MessageBox` 从 `@datadog/druids/misc/MessageBox`

### 导航

-   `ProminentTabList` 从 `@datadog/druids/nav/ProminentTabList`
-   `TabListSkeleton` 从 `@datadog/druids/nav/TabListSkeleton`

### 药丸

-   `Badge` 从 `@datadog/druids/pills/Badge`
-   `CalloutTag` 从 `@datadog/druids/pills/CalloutTag`
-   `ChangePill` 从 `@datadog/druids/pills/ChangePill`
-   `StatusPill` 从 `@datadog/druids/pills/StatusPill`

### 图表

-   `Table` 从 `@datadog/druids/table/Table`
-   `TableEmptyState` 从 `@datadog/druids/table/TableEmptyState`
-   `TablePagination` 从 `@datadog/druids/table/TablePagination`

### 时间

-   `DateRangePicker` 从 `@datadog/druids/time/DateRangePicker`

### 类型

-   `Text` 从 `@datadog/druids/typography/Text`

### 图标

每个 DRUIDS 图标都有自己的入口: `@datadog/druids/icons/<Name>` 出口 `<Name>Icon`, (中文(简体) ), 比如说 `import { CheckIcon } from '@datadog/druids/icons/Check';`编辑 `Icon` 组件从 `@datadog/druids/icons/Icon`。 。 。 .

## 许可证

这些组件是专有的Datadog材料,仅供与Datadog Services(如Datadog App Builder and Actions)相关的使用. 他们由数据犬管理 [最终用户许可证协议(EULA)](https://www.datadoghq.com/legal/eula/) 并服从于我们 [可接受使用政策(AUP)](https://www.datadoghq.com/legal/acceptable-use/). 不得使用、复制、修改、分发、转售或并入除Datadog服务以外的任何产品或服务,包括用于商业或竞争目的,也不得授予Datadog商标任何权利或暗示Datadog认可。 这些组成部分是“照旧”提供的,没有支助或服务一级的承诺,也没有遵守无障碍要求方面的任何说明或保证.

这些材料的使用和操作受以下《最终用户许可证协议》的制约: [https://www.datadoghq.com/legal/eula/ 互联网档案馆的存檔,存档日期2013-12-02](https://www.datadoghq.com/legal/eula/)

## 常见问题

### @datadog/druids 是什么？

供外部使用的数据犬 DRUIDS 组件

### 如何安装 @datadog/druids？

在项目目录运行 npm install @datadog/druids，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @datadog/druids 支持 TypeScript 吗？

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

### @datadog/druids 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @datadog/druids 可以商用吗？

@datadog/druids 使用 SEE LICENSE IN EULA\.txt 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @datadog/druids 的下载量有多少？

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

### @datadog/druids 还在维护吗？

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