# @94ai-plus/nf-button 中文文档 规范地址：https://npmcn.com/package/%4094ai-plus/nf-button/ 版本：1\.0\.0-beta\.1 npm 元数据更新时间：2026-11-05T08:59:45.443Z 中文译文更新时间：2026-11-08T11:19:59.271Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%4094ai-plus/nf-button 原文对照：https://npmcn.com/package/%4094ai-plus/nf-button/?lang=original 项目主页：https://oss.xccjh.top/common-ui-plus/index.html 源码仓库：http://gitlab.94ai.pro/ui/common-ui-plus ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.5 MB，21 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：2 个 - peer 依赖：vue ^3\.5\.44，element-plus ^2\.14\.7 - 首次发布：2026-10-29T08:30:45.794Z - 最新版本发布：2026-11-05T08:59:45.205Z - 近 30 天下载量：1791（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：10（近 12 个月 10 个） ## 中文简介 Vue 3 按钮保存普通- ui nf- 按钮 API ## 安装 ```sh npm install @94ai-plus/nf-button ``` 也可以使用：`pnpm add @94ai-plus/nf-button`、`yarn add @94ai-plus/nf-button`、`bun add @94ai-plus/nf-button` ## README #   [![94AI](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-button@1.0.0-beta.1/dist/readme/94logo.png)   ![common-ui+](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-button@1.0.0-beta.1/dist/readme/common-plus.svg)](https://oss.xccjh.top/common-ui-plus/index.html) [![npm latest 版本](https://img.shields.io/npm/v/%4094ai-plus/nf-button/latest.svg?label=version)](https://www.npmjs.com/package/@94ai-plus/nf-button) [![开发环境 Node.js 22.13.0](https://img.shields.io/badge/Node.js-22.13.0-5FA04E.svg)](https://nodejs.org/en/blog/release/v22.13.0) [![Vue 3.5](https://img.shields.io/badge/Vue-3.5-42B883.svg)](https://vuejs.org/) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-button@1.0.0-beta.1/LICENSE) [![Repository test pass rate (default branch), not per-package results](https://oss.xccjh.top/common-ui-plus-badges/test-pass-rate.svg)](https://oss.xccjh.top/common-ui-plus-badges/test-pass-rate.svg) [![Repository source line coverage (default branch), not per-package coverage](https://oss.xccjh.top/common-ui-plus-badges/coverage.svg)](https://oss.xccjh.top/common-ui-plus-badges/coverage.svg) [![NPM](https://nodei.co/npm/@94ai-plus/nf-button.svg?downloads=true&downloadRank=true)](https://www.npmjs.com/package/@94ai-plus/nf-button) # @94ai-plus/nf-button Vue 3 原生按钮，保留旧 common-ui 的 props、click、default 插槽及 mini/small/medium 尺寸。 ## [HomePage](https://oss.xccjh.top/common-ui-plus/index.html) [官网](https://oss.xccjh.top/common-ui-plus/index.html) · [项目仓库](http://gitlab.94ai.pro/ui/common-ui-plus) · [按钮文档](http://gitlab.94ai.pro/ui/common-ui-plus/-/blob/main/docs/components/button.md) ## Installation ```bash yarn add @94ai-plus/nf-button @94ai-plus/nf-theme-chalk vue element-plus ``` ## Usage ```ts import NfButton from '@94ai-plus/nf-button' import '@94ai-plus/nf-theme-chalk/nf-button.css' app.use(NfButton) ``` ```vue ``` `submit` 为业务自身的事件处理方法。`NfConfigProvider` 的 `:nf-button="{ size: 'medium', type: 'primary' }"` 可配置所有按钮 props；支持响应式更新和嵌套继承，按钮显式属性优先于最近 Provider、外层 Provider 和组件原有默认值。`undefined` 继续继承，`false`、`0` 和空字符串保留；对象、数组和函数整体替换，不深度合并。按钮沿用 `mini / small / medium` 尺寸，不受 Element Plus 顶层 `size` 控制。详见[全局配置文档](https://oss.xccjh.top/common-ui-plus/components/fixture#component-defaults)。 全量 `@94ai-plus/common-ui` 已注册并具名导出 `NfButton`；`CommonUIResolver` 支持自动导入。OEM 使用 `@94ai-plus/nf-theme-oem/nf-button.css` 并设置主题为 oem。 icon 可为自定义 CSS 类名或 Vue 图标组件，内置适配文档常用的旧 el-icon 类名；其他旧字体图标需要调用方的样式或换用 SVG 组件。loading 使用内置 SVG，无 Element UI 或 Vue 2 依赖。 包提供 ESM、CommonJS、browser ES / UMD 和 TypeScript 声明；独立样式也可从 `@94ai-plus/nf-button/style.css` 引入。完整 API、差异和交互示例见上方按钮文档。 ## Contributors 感谢每一位参与项目建设的贡献者！ ![最近三个月的贡献者气泡图](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-button@1.0.0-beta.1/dist/readme/contributors.svg) ![最近三个月的贡献者头像墙（使用姓名首字母）](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-button@1.0.0-beta.1/dist/readme/contributors-wall.svg) 以上为随本版本发布的贡献者统计快照，统计日期与分支见图中说明；仅统计 Git 非合并提交，头像使用姓名首字母，不是 GitLab 个人照片。 ## License 本项目采用 [MIT License](https://cdn.jsdelivr.net/npm/@94ai-plus/nf-button@1.0.0-beta.1/LICENSE) 开源许可。 Copyright (c) 2026-present Jiahe Zou, 94 Intelligent Technology Co., Ltd. ## 常见问题 ### @94ai-plus/nf-button 是什么？ Vue 3 按钮保存普通- ui nf- 按钮 API ### 如何安装 @94ai-plus/nf-button？ 在项目目录运行 npm install @94ai-plus/nf-button，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.5\.44）、element-plus（^2\.14\.7）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @94ai-plus/nf-button 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @94ai-plus/nf-button 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @94ai-plus/nf-button 可以商用吗？ @94ai-plus/nf-button 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @94ai-plus/nf-button 的下载量有多少？ 根据 npm 官方下载统计，@94ai-plus/nf-button 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,791 次，日均约 60 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @94ai-plus/nf-button 还在维护吗？ 最新版本 1\.0\.0-beta\.1 发布于 2026/11/05（3 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。