# @bestow-ui/react 中文文档 规范地址：https://npmcn.com/package/%40bestow-ui/react/ 版本：2\.1\.0 npm 元数据更新时间：2026-11-06T06:09:33.214Z 中文译文更新时间：2026-11-08T09:46:31.981Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40bestow-ui/react 原文对照：https://npmcn.com/package/%40bestow-ui/react/?lang=original 项目主页：https://dev-bestow.github.io/BestOW-UI/ 源码仓库：https://github.com/Dev-BestOW/BestOW-UI ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.6 MB，16 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：17 个 - peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0 - 首次发布：2026-10-14T01:38:09.850Z - 最新版本发布：2026-11-06T06:09:32.890Z - 近 30 天下载量：1825（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：30（近 12 个月 30 个） ## 中文简介 (原始内容存档于2018-10-26). Resact QQ-------------------------------------------------------------------------------------------------------------------------------------------------- , KWCAG 2. 2.---------------------------------------------------------------------------------- ## 安装 ```sh npm install @bestow-ui/react ``` 也可以使用：`pnpm add @bestow-ui/react`、`yarn add @bestow-ui/react`、`bun add @bestow-ui/react` ## README # @ bestow-ui/反应 [![npm](https://img.shields.io/npm/v/@bestow-ui/react)](https://www.npmjs.com/package/@bestow-ui/react) [![license](https://img.shields.io/npm/l/@bestow-ui/react)](https://github.com/Dev-BestOW/BestOW-UI/blob/main/LICENSE) [![CI](https://github.com/Dev-BestOW/BestOW-UI/actions/workflows/ci.yml/badge.svg)](https://github.com/Dev-BestOW/BestOW-UI/actions/workflows/ci.yml) **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢.** [香草摘录](https://vanilla-extract.style/) 와 [Radix 用户界面](https://www.radix-ui.com/) 위에. > 韩国服务反应设计系统,在CI中验证无障碍. 医生用韩文. ![회원가입 화면 — 왼쪽은 라이트 기본 테마, 오른쪽은 다크 모드에 브랜드색(#7c3aed)을 입힌 같은 화면](https://raw.githubusercontent.com/Dev-BestOW/BestOW-UI/main/docs/images/hero.png) - **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢** ——동의(전체),인증번호(문자),전화번호·사업자등록번호(검증) 금액 ("12만"5000원")·주소 ("12만":""12만"5000원")·날짜 ("12우편번호")·날짜 ("12우편번호":"12만")·기간 ("12만":". - **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢** -=YTET -伊甸园字幕组=- 翻译:. # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #, [KWCAG 2.2 항목별 대응 근거](https://dev-bestow.github.io/BestOW-UI/?path=/docs/accessibility-kwcag-2-2-%EB%8C%80%EC%9D%91--docs)를. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎样 [점검](https://github.com/Dev-BestOW/BestOW-UI/blob/main/docs/SCREEN-READER-CHECKLIST.md)을. - **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢** -=ytet -伊甸园字幕组=- 翻译:. [테마](https://dev-bestow.github.io/BestOW-UI/?path=/story/foundations-theme-builder--builder)에서. - **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢** —— CSS 0, Next.js App路由器 지원,쓰는 校对:Soup. - **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢** {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}你觉得呢, `LocaleProvider` {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎样. ⚡ **[斯塔克·布里茨(英语:StackBlitz (film))](https://stackblitz.com/github/Dev-BestOW/BestOW-UI/tree/main/examples/vite-starter?file=src%2FApp.tsx)** (설치 📖 **说吧** [故事书](https://dev-bestow.github.io/BestOW-UI/) • 妇女 [下一个](https://dev-bestow.github.io/BestOW-UI/playground/) ## 설치 ```bash npm install @bestow-ui/react # pnpm add @bestow-ui/react / yarn add @bestow-ui/react ``` 反应出18分. [`@bestow-ui/icons`](https://www.npmjs.com/package/@bestow-ui/icons) 와 [`@bestow-ui/tokens`](https://www.npmjs.com/package/@bestow-ui/tokens) 는. ## 시작하기 ```tsx import '@bestow-ui/react/styles.css'; // 앱 진입점에서 한 번 import { ThemeProvider, ToastProvider, Button, useToast } from '@bestow-ui/react'; export function App() { return ( ); } function SaveButton() { const { toast } = useToast(); return ; } ``` Next.js App路由器 提供商 `'use client'` 파일로 `app/layout.tsx` 에서. {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}你觉得呢. {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}你觉得怎样`Typography`, (中文(简体) ), `Stack`, (中文(简体) ), `Grid`, (中文(简体) ), `Container`, (中文(简体) ), `Card`, (中文(简体) ), `Badge`, (中文(简体) ), `Divider`, (中文(简体) ), `EmptyState`, (中文(简体) ), `Progress`, (中文(简体) ), `Skeleton`, (中文(简体) ), `DescriptionList`, (中文(简体) ), `VisuallyHidden`는 (联合来文), `createTheme`• 妇女`createIntentColors`• 妇女`vars`• 妇女`formatKoreanAmount` {\\fn华文仿宋\\fs16\\1cHD1D1D1}好. 자세한 [童话小说](https://dev-bestow.github.io/BestOW-UI/)에. `styles.css` {\\FN黑体\\FS22\\BORD1\\SHAD0\\3AHBE\\4AH00\\FSCX67\\FSCY66\\2CHFFFFFF\\3CH808080}你觉得呢 `bestow` === 翻译:`className` 등 선택자 우선순위와, CSS系统 `@layer base { … }` 에. 尾风: **指南:"尾风"**。 。 。 . 0.x吗? [마이그레이션](https://github.com/Dev-BestOW/BestOW-UI/blob/main/docs/MIGRATION-1.0.md)를. ## 다크 ```tsx const [mode, setMode] = useState('system'); // 'light' | 'dark' | 'system' …; ``` Modal-Tooltip 选择 \\ Toast 门户网站 \\ \\ \\ \\ \\ \\ \\. `'system'` (原始内容存档于2013-10-12). OS. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 [童话本](https://dev-bestow.github.io/BestOW-UI/)에. ## 브랜드 ```tsx import { ThemeProvider, createTheme, createIntentColors } from '@bestow-ui/react'; const brand = createTheme( createIntentColors('primary', '#7c3aed'), // 라이트·다크 색 세트, 글자 대비 4.5:1 보장 { common: { radius: { md: '6px' } } }, ); …; ``` \================================================================================================================================================================================================ (==================== (========= (============= (================= 색만 `color.border.input`• 妇女`inputHover`• 妇女`control` 토큰을. {\\FN黑体\\FS22\\BORD1\\SHAD0\\3AHBE\\4AH00\\FSCX67\\FSCY66\\2CHFFFFFF\\3CH808080}你觉得呢. ```css :root { --bestow-color-primary-solid: #7c3aed; } ``` ## 문구 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你说什么. `LocaleProvider` {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢. ```tsx import { LocaleProvider, en } from '@bestow-ui/react'; … ``` ## 폼 反应-hook-form \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \* \*\* \* \* \* \* \* \* \* \*\* \* \* \* \* \*\*\*\* \* \*\*\*\* 입력창은 `register` 를,값을也 `Controller` 로. 제출에 `ErrorSummary` 가. 자세한 [화면](https://dev-bestow.github.io/BestOW-UI/?path=/docs/guides-%ED%99%94%EB%A9%B4-%ED%8C%A8%ED%84%B4--docs) 가이드에. ## 컴포넌트 | 분류 | 컴포넌트 | | --- | --- | | 레이아웃 | `Stack`(구간별 `{ base, md }`, (中文(简体) ), `Grid`, (中文(简体) ), `Container`, (中文(简体) ), `Divider`, (中文(简体) ), `Card`, (中文(简体) ), `VisuallyHidden` . . . . . `media`(640 sm-768 lg 1024 xl 1280px) (千分之一) | | 글자 | `Typography` | | 동작 | `Button`, (中文(简体) ), `IconButton`, (中文(简体) ), `Link` | | 폼 | `Input`, (中文(简体) ), `TextField`, (中文(简体) ), `PasswordInput`(보기), `SearchInput`(请进), `FormField`(직접:입력에也, `Textarea`, (中文(简体) ), `Select`, (中文(简体) ), `NativeSelect`, (中文(简体) ), `Combobox`, (中文(简体) ), `NumberInput`, (中文(简体) ), `FileUpload`, (中文(简体) ), `Checkbox`, (中文(简体) ), `CheckboxGroup`, (中文(简体) ), `RadioGroup`, (中文(简体) ), `Switch`, (中文(简体) ), `Slider` | | 피드백 | `Alert`, (中文(简体) ), `ErrorSummary`, (中文(简体) ), `Progress`, (中文(简体) ), `ToastProvider` + 键 `useToast`, (中文(简体) ), `Spinner`, (中文(简体) ), `Skeleton`, (中文(简体) ), `Badge`, (中文(简体) ), `Tag` + 键 `TagGroup`(고른,필터·필터也, `EmptyState` | | 오버레이 | `Modal`, (中文(简体) ), `Drawer`, (中文(简体) ), `Popover`, (中文(简体) ), `Tooltip`, (中文(简体) ), `DropdownMenu` | | 탐색 | `Tabs`, (中文(简体) ), `SegmentedControl`, (中文(简体) ), `Accordion`, (中文(简体) ), `Pagination`, (中文(简体) ), `Breadcrumb`, (中文(简体) ), `SkipLink`, (中文(简体) ), `Stepper` | | 표시 | `Avatar`, (中文(简体) ), `Table`(+ 数) `TableEmpty`, (中文(简体) ), `TableSkeleton`, (中文(简体) ), `useTableSelection`, (中文(简体) ), `DescriptionList` | | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 | `AgreementGroup`(약관), `VerificationCodeInput`( , `PhoneNumberInput`, (中文(简体) ), `BusinessNumberInput`, (中文(简体) ), `CorporateNumberInput`( , `CardNumberInput`, (中文(简体) ), `AccountNumberInput`(+++++++++++++++++++++) `KOREAN_BANKS`, (中文(简体) ), `ResidentNumberInput`(주민·외국인등록번호,뒷자리也, `AmountInput`, (中文(简体) ), `AddressInput`, (中文(简体) ), `DatePicker`, (中文(简体) ), `DateRangePicker`(+ 数) `dateRangePresets`, (中文(简体) ), `Calendar` (+ 数) `formatPhoneNumber`, (中文(简体) ), `formatBusinessNumber`, (中文(简体) ), `isValidBusinessNumber`, (中文(简体) ), `formatKoreanAmount`, (中文(简体) ), `formatKoreanDate`时 `formatResidentNumber`• 妇女`isValidResidentNumber`• 妇女`parseResidentNumber`时 `maskName`• 妇女`maskPhoneNumber`• 妇女`maskResidentNumber`• 妇女`maskCardNumber`• 妇女`maskDigits`, (中文(简体) ), `parseISODate`, (中文(简体) ), `toISODate` {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 [`@bestow-ui/korean-utils`](https://www.npmjs.com/package/@bestow-ui/korean-utils) 에서,다시也 | | 문구 | `LocaleProvider`, (中文(简体) ), `en`(영어 | | 테마 | `ThemeProvider`, (中文(简体) ), `createTheme`, (中文(简体) ), `createIntentColors`, (中文(简体) ), `vars`, (中文(简体) ), `useTheme`, (中文(简体) ), `usePortalProps` | | 도움 | `focusField` | {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 [{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢](https://dev-bestow.github.io/BestOW-UI/?path=/docs/guides-%EC%96%B8%EC%A0%9C-%EB%AC%B4%EC%97%87%EC%9D%84-%EC%93%B0%EB%82%98--docs) 가이드를. ## 지원 Chrome-Edge-Firefox-Safari ================================================================================================================================================================================================================================================. **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你还得去吗** E2E,反应18-19 CI,QQ(Voice Over-NVDA), {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢. {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 [支助](https://github.com/Dev-BestOW/BestOW-UI/blob/main/SUPPORT.md), (中文(简体) ), {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 [警卫](https://github.com/Dev-BestOW/BestOW-UI/blob/main/SECURITY.md) {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢. ## 링크 - [故事书](https://dev-bestow.github.io/BestOW-UI/) - 문서디자인모든 - [页:1](https://dev-bestow.github.io/BestOW-UI/llms.txt) • 妇女 [llms- full.txt (英语)](https://dev-bestow.github.io/BestOW-UI/llms-full.txt) - Cursor-Claude – AI + + + + (+ 道具 + + + ) - [GitHub 图像](https://github.com/Dev-BestOW/BestOW-UI) - 소스, [이슈](https://github.com/Dev-BestOW/BestOW-UI/issues), (中文(简体) ), [기여](https://github.com/Dev-BestOW/BestOW-UI/blob/main/CONTRIBUTING.md) - [변경](https://github.com/Dev-BestOW/BestOW-UI/blob/main/packages/react/CHANGELOG.md) • 妇女 [0.x](https://github.com/Dev-BestOW/BestOW-UI/blob/main/docs/MIGRATION-1.0.md) ## 라이선스 [麻省理工学院](https://github.com/Dev-BestOW/BestOW-UI/blob/main/LICENSE) 德韦斯特OW ## 常见问题 ### @bestow-ui/react 是什么？ \(原始内容存档于2018-10-26\)\. Resact QQ-------------------------------------------------------------------------------------------------------------------------------------------------- , KWCAG 2\. 2\.---------------------------------------------------------------------------------- ### 如何安装 @bestow-ui/react？ 在项目目录运行 npm install @bestow-ui/react，或使用 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 需要手动安装。 ### @bestow-ui/react 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @bestow-ui/react 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @bestow-ui/react 可以商用吗？ @bestow-ui/react 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @bestow-ui/react 的下载量有多少？ 根据 npm 官方下载统计，@bestow-ui/react 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,825 次，日均约 61 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @bestow-ui/react 还在维护吗？ 最新版本 2\.1\.0 发布于 2026/11/06（2 天前）；至今共发布 30 个版本，其中过去 12 个月发布了 30 个；首次发布于 2026/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。