@fox-js/phone-skills 4.0.1-0

package/foxui/references/fox-notice-bar/doc.md

@@ -0,0 +1,71 @@
+<!--
+ * @Author: 江成
+ * @Date: 2026-04-27 00:37:28
+ * @LastEditors: 江成
+ * @LastEditTime: 2026-05-12 22:33:21
+-->
+---
+title: NoticeBar 组件使用规范
+impact: HIGH
+type: capability
+description: 用于循环播放展示一组消息通知
+tags: [foxui, fox-notice-bar, FoxNoticeBar]
+version: "4.0.0"
+author: jiangcheng
+related: ["fox-js","fox-noticebar"]
+---
+
+# NoticeBar 组件使用规范
+
+## 1. 核心职责 (Core Responsibility)
+NoticeBar 是 foxui 中用于 **用于循环播放展示一组消息通知** 的标准组件。
+- **基于**: NutUI `nut-notice-bar` 进行了二次封装 (若为纯自研组件则填 "自定义开发")
+- **核心增强**: 基于 NutUI 组件二次封装、适配 H5 与小程序多端、支持插槽扩展自定义内容、支持主题定制
+- **适用场景**: 用于循环播放展示一组消息通知
+
+> 💡 **关键原则**: 在所有 用于循环播放展示一组消息通知 中，**必须**优先使用此组件，禁止直接使用原生 NutUI 组件。
+
+---
+
+## 2. 关键 API 说明 (Key API)
+
+### 2.1 Props 属性
+
+| 属性名 | 类型 | 必填 | 默认值 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| `list` | 纵向滚动数据列表 | Array |  |
+| `speed` | 滚动的速度 | Number | 50 |
+| `stand-time` | 停留时间毫秒 | Number | 1000 |
+| `complex-am` | 稍复杂的动画，耗能会高 | Boolean | false |
+| `height` | 每一个滚动列的高度px，注意：在使用 slot 插槽定义滚动单元时，按照实际高度修改此值 | Number | 40 |
+| `close-mode` | 是否启用右侧关闭图标，可以通过slotname=rightIcon自定义图标 | Boolean | false |
+| `wrapable` | 是否开启文本换行 | Boolean | false |
+
+### 2.2 Events 事件
+
+| 事件名 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `click` | 外层点击事件回调 | event: Event |
+| `close` | 关闭通知栏时触发 | event: Event |
+| `across-end` | 横向滚动结束时触发 | event: Event |
+
+### 2.3 Methods 方法
+
+| 方法名 | 参数 | 说明 |
+| :--- | :--- | :--- |
+无
+
+### 2.4 Slots 插槽
+
+| 插槽名 | 说明 |
+| :--- | :--- |
+无
+
+## 3. 例子 (Examples)
+
+
+
+## 4. 相关组件 (Related Components)
+- **fox-js**: 与 NoticeBar 配合使用的相关组件
+- **fox-noticebar**: 与 NoticeBar 配合使用的相关组件
+

package/foxui/references/fox-notify/doc.md

@@ -0,0 +1,72 @@
+<!--
+ * @Author: 江成
+ * @Date: 2026-04-27 00:37:28
+ * @LastEditors: 江成
+ * @LastEditTime: 2026-05-12 22:33:21
+-->
+---
+title: Notify 组件使用规范
+impact: HIGH
+type: capability
+description: 在页面顶部展示消息提示，支持函数调用和组件调用两种方式
+tags: [foxui, fox-notify, FoxNotify]
+version: "4.0.0"
+author: jiangcheng
+related: ["fox-js","fox-cell","fox-cell-group"]
+---
+
+# Notify 组件使用规范
+
+## 1. 核心职责 (Core Responsibility)
+Notify 是 foxui 中用于 **在页面顶部展示消息提示，支持函数调用和组件调用两种方式** 的标准组件。
+- **基于**: NutUI `nut-notify` 进行了二次封装 (若为纯自研组件则填 "自定义开发")
+- **核心增强**: 基于 NutUI 组件二次封装、支持 v-model 双向绑定、支持主题定制
+- **适用场景**: 在页面顶部展示消息提示，支持函数调用和组件调用两种方式
+
+> 💡 **关键原则**: 在所有 在页面顶部展示消息提示，支持函数调用和组件调用两种方式 中，**必须**优先使用此组件，禁止直接使用原生 NutUI 组件。
+
+---
+
+## 2. 关键 API 说明 (Key API)
+
+### 2.1 Props 属性
+
+| 属性名 | 类型 | 必填 | 默认值 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| `type` | 提示的信息类型，可选值为primary、success、danger、warning | string | danger |
+| `visible` | 显示与否 | boolean | false |
+| `msg` | 展示文案，支持通过\n换行 | string | '' |
+| `duration` | 展示时长ms，值为 0 时，notify 不会消失 | number | 3000 |
+| `color` | 字体颜色 | string | '' |
+| `background` | 背景样式 | string | '' |
+| `class-name` | 自定义类名 | string \ | number |
+| `position` | 自定义位置，可选值为 top bottom left right center | string | top |
+
+### 2.2 Events 事件
+
+| 事件名 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `click` | 点击事件回调 | - |
+| `closed` | 关闭事件回调 | - |
+
+### 2.3 Methods 方法
+
+| 方法名 | 参数 | 说明 |
+| :--- | :--- | :--- |
+无
+
+### 2.4 Slots 插槽
+
+| 插槽名 | 说明 |
+| :--- | :--- |
+无
+
+## 3. 例子 (Examples)
+
+
+
+## 4. 相关组件 (Related Components)
+- **fox-js**: 与 Notify 配合使用的相关组件
+- **fox-cell**: 与 Notify 配合使用的相关组件
+- **fox-cell-group**: 与 Notify 配合使用的相关组件
+

package/foxui/references/fox-number-keyboard/doc.md

@@ -0,0 +1,77 @@
+<!--
+ * @Author: 江成
+ * @Date: 2026-04-27 00:37:28
+ * @LastEditors: 江成
+ * @LastEditTime: 2026-05-12 22:33:21
+-->
+---
+title: NumberKeyboard 组件使用规范
+impact: HIGH
+type: capability
+description: 虚拟数字键盘
+tags: [foxui, fox-number-keyboard, FoxNumberKeyboard]
+version: "4.0.0"
+author: jiangcheng
+related: ["fox-js","fox-group","fox-row-item","fox-button","fox-input-item"]
+---
+
+# NumberKeyboard 组件使用规范
+
+## 1. 核心职责 (Core Responsibility)
+NumberKeyboard 是 foxui 中用于 **虚拟数字键盘** 的标准组件。
+- **基于**: NutUI `nut-number-keyboard` 进行了二次封装 (若为纯自研组件则填 "自定义开发")
+- **核心增强**: 基于 NutUI 组件二次封装、支持 v-model 双向绑定、支持主题定制
+- **适用场景**: 虚拟数字键盘
+
+> 💡 **关键原则**: 在所有 虚拟数字键盘 中，**必须**优先使用此组件，禁止直接使用原生 NutUI 组件。
+
+---
+
+## 2. 关键 API 说明 (Key API)
+
+### 2.1 Props 属性
+
+| 属性名 | 类型 | 必填 | 默认值 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| `v-model:visible` | 是否显示键盘 | boolean | false |
+| `v-model` | 当前输入值 | string | - |
+| `title` | 键盘标题 | string | - |
+| `type` | 键盘模式 | string | default：默认样式<br>rightColumn：带右侧栏 |
+| `random-keys` | 随机数 | boolean | false |
+| `custom-key` | 自定义键盘额外的键 | string  | 数组形式最多支持添加2个,超出默认取前2项 |
+| `maxlength` | 输入值最大长度，结合 v-model 使用 | number \ | string |
+| `confirm-text` | 自定义完成按钮文字，如"支付"，"下一步"，"提交"等 | string | 完成 |
+| `pop-class` | 自定义弹框类名 | string | - |
+
+### 2.2 Events 事件
+
+| 事件名 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `input` | 点击按键时触发 | 按键内容 |
+| `delete` | 点击删除键时触发 | - |
+| `close` | 点击关闭按钮时触发 | - |
+| `blur` | 点击关闭按钮或非键盘区域时触发 | - |
+
+### 2.3 Methods 方法
+
+| 方法名 | 参数 | 说明 |
+| :--- | :--- | :--- |
+无
+
+### 2.4 Slots 插槽
+
+| 插槽名 | 说明 |
+| :--- | :--- |
+无
+
+## 3. 例子 (Examples)
+
+
+
+## 4. 相关组件 (Related Components)
+- **fox-js**: 与 NumberKeyboard 配合使用的相关组件
+- **fox-group**: 与 NumberKeyboard 配合使用的相关组件
+- **fox-row-item**: 与 NumberKeyboard 配合使用的相关组件
+- **fox-button**: 与 NumberKeyboard 配合使用的相关组件
+- **fox-input-item**: 与 NumberKeyboard 配合使用的相关组件
+

package/foxui/references/fox-over-lay/doc.md

@@ -0,0 +1,70 @@
+<!--
+ * @Author: 江成
+ * @Date: 2026-04-27 00:37:28
+ * @LastEditors: 江成
+ * @LastEditTime: 2026-05-12 22:33:21
+-->
+---
+title: OverLay 组件使用规范
+impact: HIGH
+type: capability
+description: 创建一个遮罩层，通常用于阻止用户进行其他操作
+tags: [foxui, fox-over-lay, FoxOverLay]
+version: "4.0.0"
+author: jiangcheng
+related: ["fox-js","fox-button","fox-overlay"]
+---
+
+# OverLay 组件使用规范
+
+## 1. 核心职责 (Core Responsibility)
+OverLay 是 foxui 中用于 **创建一个遮罩层，通常用于阻止用户进行其他操作** 的标准组件。
+- **基于**: NutUI `nut-over-lay` 进行了二次封装 (若为纯自研组件则填 "自定义开发")
+- **核心增强**: 基于 NutUI 组件二次封装、支持 v-model 双向绑定、适配 H5 与小程序多端、支持插槽扩展自定义内容、支持主题定制
+- **适用场景**: 创建一个遮罩层，通常用于阻止用户进行其他操作
+
+> 💡 **关键原则**: 在所有 创建一个遮罩层，通常用于阻止用户进行其他操作 中，**必须**优先使用此组件，禁止直接使用原生 NutUI 组件。
+
+---
+
+## 2. 关键 API 说明 (Key API)
+
+### 2.1 Props 属性
+
+| 属性名 | 类型 | 必填 | 默认值 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| `v-model:visible` | 控制遮罩的显示/隐藏 | boolean | false |
+| `z-index` | 自定义遮罩层级 | string \ | number |
+| `duration` | 显示/隐藏的动画时长，单位秒 | string \ | number |
+| `overlay-class` | 自定义遮罩类名 | string | - |
+| `overlay-style` | 自定义遮罩样式 | CSSProperties | - |
+| `lock-scroll` | 遮罩显示时的背景是否锁定 | boolean | true |
+| `close-on-click-overlay` | 点击遮罩时是否关闭 | boolean | true |
+
+### 2.2 Events 事件
+
+| 事件名 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `click` | 点击时触发 | event: Event |
+
+### 2.3 Methods 方法
+
+| 方法名 | 参数 | 说明 |
+| :--- | :--- | :--- |
+无
+
+### 2.4 Slots 插槽
+
+| 插槽名 | 说明 |
+| :--- | :--- |
+| `default` | 内嵌遮罩内容自定义 |
+
+## 3. 例子 (Examples)
+
+
+
+## 4. 相关组件 (Related Components)
+- **fox-js**: 与 OverLay 配合使用的相关组件
+- **fox-button**: 与 OverLay 配合使用的相关组件
+- **fox-overlay**: 与 OverLay 配合使用的相关组件
+

package/foxui/references/fox-page/doc.md

@@ -0,0 +1,76 @@
+<!--
+ * @Author: 江成
+ * @Date: 2026-04-27 00:37:28
+ * @LastEditors: 江成
+ * @LastEditTime: 2026-05-12 22:33:21
+-->
+---
+title: Page 组件使用规范
+impact: HIGH
+type: capability
+description: 页面布局
+tags: [foxui, fox-page, FoxPage]
+version: "4.0.0"
+author: jiangcheng
+related: ["fox-js","fox-header-bar","fox-footer-bar","fox-content","fox-group","fox-input-item","fox-row-item","fox-button"]
+---
+
+# Page 组件使用规范
+
+## 1. 核心职责 (Core Responsibility)
+Page 是 foxui 中用于 **页面布局** 的标准组件。
+- **基于**: NutUI `nut-page` 进行了二次封装 (若为纯自研组件则填 "自定义开发")
+- **核心增强**: 基于 NutUI 组件二次封装、内置必填校验标识、支持 v-model 双向绑定、支持禁用/只读状态、内置表单校验能力
+- **适用场景**: 页面布局
+
+> 💡 **关键原则**: 在所有 页面布局 中，**必须**优先使用此组件，禁止直接使用原生 NutUI 组件。
+
+---
+
+## 2. 关键 API 说明 (Key API)
+
+### 2.1 Props 属性
+
+| 属性名 | 类型 | 必填 | 默认值 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| `browse` | 浏览模式 | on | off |
+| `disabled` | 禁用设置 | String,Boolean | - |
+| `readonly` | 只读设置 | String,Boolean | - |
+| `labelPosition` | 标签位置left,right,top | String | left |
+| `labelWidth` | 标签宽度 | String,Number | - |
+
+### 2.2 Events 事件
+
+| 事件名 | 类型 | 说明 |
+| :--- | :--- | :--- |
+无
+
+### 2.3 Methods 方法
+
+| 方法名 | 参数 | 说明 |
+| :--- | :--- | :--- |
+| `validate` | 校验页面范围内的组件 | — |
+| `clearValidate` | 清空校验信息 | — |
+| `setNameValidateRules` | 设置校验规则 | — |
+| `resetFields` | 重置数据并清空校验信息 | — |
+
+### 2.4 Slots 插槽
+
+| 插槽名 | 说明 |
+| :--- | :--- |
+无
+
+## 3. 例子 (Examples)
+
+
+
+## 4. 相关组件 (Related Components)
+- **fox-js**: 与 Page 配合使用的相关组件
+- **fox-header-bar**: 与 Page 配合使用的相关组件
+- **fox-footer-bar**: 与 Page 配合使用的相关组件
+- **fox-content**: 与 Page 配合使用的相关组件
+- **fox-group**: 与 Page 配合使用的相关组件
+- **fox-input-item**: 与 Page 配合使用的相关组件
+- **fox-row-item**: 与 Page 配合使用的相关组件
+- **fox-button**: 与 Page 配合使用的相关组件
+

package/foxui/references/fox-pagination/doc.md

@@ -0,0 +1,73 @@
+<!--
+ * @Author: 江成
+ * @Date: 2026-04-27 00:37:28
+ * @LastEditors: 江成
+ * @LastEditTime: 2026-05-12 22:33:21
+-->
+---
+title: Pagination 组件使用规范
+impact: HIGH
+type: capability
+description: 当数据量较多时，采用分页的形式分隔长列表。
+tags: [foxui, fox-pagination, FoxPagination]
+version: "4.0.0"
+author: jiangcheng
+related: ["fox-js","fox-icon"]
+---
+
+# Pagination 组件使用规范
+
+## 1. 核心职责 (Core Responsibility)
+Pagination 是 foxui 中用于 **当数据量较多时，采用分页的形式分隔长列表。** 的标准组件。
+- **基于**: NutUI `nut-pagination` 进行了二次封装 (若为纯自研组件则填 "自定义开发")
+- **核心增强**: 基于 NutUI 组件二次封装、支持 v-model 双向绑定、支持插槽扩展自定义内容、支持主题定制
+- **适用场景**: 当数据量较多时，采用分页的形式分隔长列表。
+
+> 💡 **关键原则**: 在所有 当数据量较多时，采用分页的形式分隔长列表。 中，**必须**优先使用此组件，禁止直接使用原生 NutUI 组件。
+
+---
+
+## 2. 关键 API 说明 (Key API)
+
+### 2.1 Props 属性
+
+| 属性名 | 类型 | 必填 | 默认值 | 说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| `v-model` | 当前页码 | Number | 1 |
+| `mode` | 显示模式,可选值为 simple | String | multi |
+| `prev-text` | 上一页按钮文字 | String | 上一页 |
+| `next-text` | 下一页按钮文字 | String | 下一页 |
+| `page-count` | 总页数 | String,Number | 传入/根据页数计算 |
+| `total-items` | 总记录数 | String,Number | 0 |
+| `items-per-page` | 每页记录数 | String,Number | 10 |
+| `show-page-size` | 显示的页码个数 | String,Number | 5 |
+| `force-ellipses` | 是否显示省略号 | Boolean | false |
+
+### 2.2 Events 事件
+
+| 事件名 | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `change` | 页码改变时触发 | value |
+
+### 2.3 Methods 方法
+
+| 方法名 | 参数 | 说明 |
+| :--- | :--- | :--- |
+无
+
+### 2.4 Slots 插槽
+
+| 插槽名 | 说明 |
+| :--- | :--- |
+| `prev-text` | 自定义上一页按钮内容 |
+| `next-text` | 自定义下一页按钮内容 |
+| `page` | 自定义页码 |
+
+## 3. 例子 (Examples)
+
+
+
+## 4. 相关组件 (Related Components)
+- **fox-js**: 与 Pagination 配合使用的相关组件
+- **fox-icon**: 与 Pagination 配合使用的相关组件
+