# @1doc/1ds-react 中文文档
规范地址：https://npmcn.com/package/%401doc/1ds-react/
版本：2\.26\.1
npm 元数据更新时间：2026-11-05T20:49:43.472Z
中文译文更新时间：2026-11-06T22:33:53.716Z
软件包许可：未声明
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%401doc/1ds-react
原文对照：https://npmcn.com/package/%401doc/1ds-react/?lang=original
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：3.7 MB，762 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：react \>=18，react-dom \>=18，@1doc/1ds-tokens \>=0\.8\.0
- 首次发布：2026-03-26T16:16:55.766Z
- 最新版本发布：2026-11-05T20:49:43.298Z
- 近 30 天下载量：2246（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）
## 中文简介
Biblioteca de communites React do 1DS Design System. 互联网档案馆的存檔,存档日期2013-12-02.
## 安装
```sh
npm install @1doc/1ds-react
```
也可以使用：`pnpm add @1doc/1ds-react`、`yarn add @1doc/1ds-react`、`bun add @1doc/1ds-react`
## README
# @ 1doc/1ds 反应
Biblioteca de communites React do 1DS Design System. 互联网档案馆的存檔,存档日期2013-12-02.
📚 **故事手册:** [https://1dsux.vercel.app (英语)](https://1dsux.vercel.app/)
## 英斯特拉桑
```bash
pnpm add @1doc/1ds-react @1doc/1ds-tokens
```
`@1doc/1ds-tokens` 国家 **依赖性** o app Instala e 进口 os CSS de {\\fn华文楷体\\fs20\\bord1\\shad1\\1che0e0e0\\2ch000000}快活地去取出活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活.
## 配置
> \[大 进口 o CSS 表示不使用 entrada da aplicação (P`main.tsx`, (中文(简体) ), **巢状圆形**. . . . . . .
```tsx
import "@1doc/1ds-tokens/css/primitives.css";
import "@1doc/1ds-tokens/css/semantic.css";
import "@1doc/1ds-tokens/css/theme-1doc.css"; // tema da sua marca (ver Temas)
```
奥斯·卡米尼奥斯 `dist/css/...` (原始内容存档于2018-09-26) (英语). continuam funcionando, mas prefira os subpaths 埃斯塔维斯 `css/...` 爱奇艺.
## 乌苏
```tsx
import { Button } from "@1doc/1ds-react";
function App() {
return (
);
}
```
## 构成部分
动脉- 警报- 阿凡达集团- 徽章- Breadcrumb- 按钮- 卡片- 复选框 · 芯片 · 确认拨号 · 数据表 · 日期选取器 · 分割器 · 下放 · 空态 · 文件输入 · 网格 · 图标 · 输入 · 链接 · Logo · Modal · 多选择 · 页面页眉 相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相 Skeleton · 斯平纳 · 步道 · 切换 · 标签 · 标签 · 文本 · 文本区域 · TimePicker · 托斯克/托斯克 · 工具提示
(原始内容存档于2018-10-21) (中文(简体) ). Props e exemplos de cada 组件: 故事本 (link acima) ou os `.d.ts` (JSDoc em português em todas 作为道具).
> \[注\] 作为道具的接口 **埃斯特里塔斯语name** (声) `[key: string]: any`(简体中文) : (原始内容存档于2018-09-26) (英语). Prop é mrocho de compilação. Atributos 仲裁法院`data-*` (例如) **塞内加尔 转接 DOM** pelos 组件 – antes compilavam mas shaem (原始内容存档于2018-03-29) (英语). sileniosamente descartados; africa o TypeScript avisa.
## 视线
奥斯·伊克内斯 **间断** 多斯组件(切夫龙、卡伦达里奥、setas de) funcionam) 互联网档案馆的存檔,存档日期2013-12-16 **出栏** ——卡达元件导入a 树上可摇动,没有捆绑.
{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 **sue app** (单位:千美元)``, (中文(简体) ), `startIcon`, (中文(简体) ), `Tab.icon`... {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我们得去见见他 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我
```tsx
// 1) Recomendado: objeto importado (tree-shakeable, typo = erro de compilação)
import { faHouse } from "@fortawesome/free-solid-svg-icons";
;
// 2) Por nome (string): exige registrar os ícones na library UMA vez no bootstrap
import { library } from "@1doc/1ds-react";
import { faHouse, faGear } from "@fortawesome/free-solid-svg-icons";
library.add(faHouse, faGear);
;
```
> \[尖叫声\] 叶子 `library.add(fas)` (pacote inteiro): adiciona~900 kB ao捆. (原始内容存档于2018-10-21). Registre apenas os ícones que o app usa, ou prefira objetos interminados. 使用包名 FontAsome na faixa **6.x (单位:千美元)** (compatível com o svg-core do DS). 星洲网.
## 泰马
特玛通过阿特里布托 `data-theme` 没有 ``乌蒂利塔里奥斯 `@1doc/1ds-react`数字 : `setTheme` • 妇女 `getTheme` • 妇女 `initTheme` • 妇女 `onThemeChange` • 妇女 `registerTheme` • 妇女 `getAvailableThemes`。 。 。 .
| 马尔卡 | 轻 (arquivo / set Theme) | 阴暗 |
| --- | --- | --- |
| 1 文件 | `theme-1doc.css` 编号 : `"1doc"` | `theme-1doc-dark.css` 编号 : `"1doc-dark"` |
| 绿色 | `theme-1ds-green.css` 编号 : `"1ds-green"` | `theme-1ds-green-dark.css` 编号 : `"1ds-green-dark"` |
| 橙红色 | `theme-1ds-orange.css` 编号 : `"1ds-orange"` | `theme-1ds-orange-dark.css` 编号 : `"1ds-orange-dark"` |
| 紫色 | `theme-1ds-purple.css` 编号 : `"1ds-purple"` | `theme-1ds-purple-dark.css` 编号 : `"1ds-purple-dark"` |
| 红色 | `theme-1ds-red.css` 编号 : `"1ds-red"` | `theme-1ds-red-dark.css` 编号 : `"1ds-red-dark"` |
| 黄色 | `theme-1ds-yellow.css` 编号 : `"1ds-yellow"` | `theme-1ds-yellow-dark.css` 编号 : `"1ds-yellow-dark"` |
Alto 对比 (acessibilidade, fora da mariz de marcas): `theme-1doc-high-contrast.css` 编号 : `"1doc-high-contrast"` - 预留资金, 文本o Branco, interativo amarelo。 O DS não o aplica (英语) (原始内容存档于2016-10-12). sozinho; ver a sção "Alto compacte" do README de `@1doc/1ds-tokens` 段 次 页 次 `prefers-contrast: more`。 。 。 .
> O CSS do tema escolhido pricisa estar 互联网档案馆的存檔,存档日期2014-12-02 **导入器** 段 次 页 次 `setTheme` 三、 结 论 伊非陀罗. 托多斯·特马斯·克多斯·卡尔雷加多斯·琼托斯 `[data-theme="..."]`)——出道于克米卡.
### 白色标签
CRIE um CSS com (英语) `[data-theme="minha-marca"]` 25个符号 `--umds-theme-*` (a) 国家、地区、领土、领土、领土、领土、领土、领土、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、财产、 萨尔瓦多 4 `primary-*`(原始内容存档于2018-03-13) (英语). carregue-o após o `semantic.css` 电子 维利塔里奥·阿塞塔-洛(validação + stainência):
```tsx
import { registerTheme, initTheme, setTheme } from "@1doc/1ds-react";
registerTheme("minha-marca");
registerTheme("minha-marca-dark");
initTheme(); // restaura tema persistido (inclusive custom, já registrado)
setTheme("minha-marca");
```
## 福图拉里奥斯
托多斯·奥斯·坎多斯·帕西帕姆确实提交 Nativo (`