@netang/quasar 0.0.92 → 0.0.94

package/_docs/docs/.vuepress/configs/navbar/zh.js

@@ -11,6 +11,6 @@ export const navbarZh = [
     {
         text: '工具',
         activeMatch: '/utils/',
-        link: '/utils/alert',
+        link: '/utils/auth',
     },
 ]

package/_docs/docs/.vuepress/configs/sidebar/zh.js

@@ -6,21 +6,29 @@ export const sidebarZh = {
                 '/components/column-title',
                 '/components/data',
                 '/components/dialog',
-                '/components/empty',
                 '/components/dragger',
                 '/components/editor-code',
+                '/components/empty',
                 '/components/field-date',
                 '/components/field-table',
                 '/components/field-text',
                 '/components/field-tree',
+                '/components/img',
                 '/components/input-number',
+                '/components/list-menu',
+                '/components/list-menu-item',
+                '/components/power-page',
+                '/components/price',
                 '/components/render',
                 '/components/search',
                 '/components/search-item',
                 '/components/select',
                 '/components/splitter',
                 '/components/table',
+                '/components/table-column-fixed',
+                '/components/table-pagination',
                 '/components/table-splitter',
+                '/components/table-summary',
                 '/components/thumbnail',
                 '/components/toolbar',
                 '/components/uploader',
@@ -33,8 +41,39 @@ export const sidebarZh = {
         {
             text: 'Utils 工具',
             children: [
+                '/utils/auth',
+                '/utils/form',
+                '/utils/power',
+                '/utils/rule',
+                '/utils/ruleValid',
+                '/utils/search',
+                '/utils/table',
+                '/utils/tree',
                 '/utils/alert',
+                '/utils/area',
+                '/utils/arr',
+                '/utils/bus',
+                '/utils/config',
                 '/utils/confirm',
+                '/utils/copy',
+                '/utils/dialog',
+                '/utils/dict',
+                '/utils/dictOptions',
+                '/utils/getData',
+                '/utils/getFile',
+                '/utils/getImage',
+                '/utils/getTime',
+                '/utils/loading',
+                '/utils/notify',
+                '/utils/previewImage',
+                '/utils/price',
+                '/utils/symbols',
+                '/utils/timestamp',
+                '/utils/toast',
+                '/utils/uploader',
+                '/utils/useAuth',
+                '/utils/useRouter',
+                '/utils/useUploader',
             ],
         }
     ],

package/_docs/docs/components/column-title.md

@@ -1,9 +1,24 @@
 # ColumnTitle 栏目标题
 
 ::: tip
-栏目标题
+**栏目标题**
+
+用于显示一个撑满一行的栏目标题
 :::
 
+## 使用示例
+
+### 基础示例
+
+```html
+<!-- 栏目标题 -->
+<n-column-title label="订单信息" />
+```
+
+## ColumnTitle API
+
+### ColumnTitle 属性
+
 | 属性名     | 说明   | 类型                  | 可选值 | 默认值 |
 |---------|------|---------------------|-----|-----|
 | label   | 标签   | `String` / `Number` | -   | -   |

package/_docs/docs/components/data.md

@@ -4,6 +4,51 @@
 数据插槽
 :::
 
+## 使用示例
+
+### 基础示例
+
+```html
+<n-data :data="{ name: '张三', age: 23 }" v-slot="{ data }">
+    <div>姓名: {{ data.name }}</div>
+    <div>年龄: {{ data.age }}</div>
+</n-data>
+```
+
+### 复杂示例
+
+```html
+<template>
+    <n-data
+        v-for="userId in userIds"
+        :key="`data-item-${userId}`"
+        :data="userAll[userId]"
+        v-slot="{ data: userItem }"
+    >
+        <div>姓名: {{ userItem.name }}，年龄: {{ userItem.age }}</div>
+    </n-data>
+</template>
+
+<script>
+    export default {
+        setup() {
+            return {
+                userIds: [11, 22, 33],
+                userAll: {
+                    11: { id: 11, name: '张三', age: 23 },
+                    22: { id: 22, name: '李四', age: 33 },
+                    33: { id: 33, name: '王五', age: 26 },
+                },
+            }
+        }
+    }
+</script>
+```
+
+## Data API
+
+### Data 属性
+
 | 属性名  | 说明  | 类型  | 可选值 | 默认值 |
 |------|-----|-----|-----|-----|
 | data | 数据  | -   | -   | -   |

package/_docs/docs/components/dialog.md

@@ -1,8 +1,10 @@
 # Dialog 对话框
 
 ::: tip
-继承 `<q-dialog>` 所有特性
+- 继承 `<q-dialog>` 所有特性
 [中文文档](http://www.quasarchs.com/vue-components/dialog) [英文文档](https://quasar.dev/vue-components/dialog)
+
+- 使用 [$n.dialog.create()](../utils/dialog.md) 创建对话框进行使用
 :::
 
 | 属性名             | 说明       | 类型                  | 可选值 | 默认值   |

package/_docs/docs/components/img.md

@@ -0,0 +1,21 @@
+# FieldTree 下拉树
+
+::: tip
+继承 `<q-field>` 所有特性
+[中文文档](http://www.quasarchs.com/vue-components/field) [英文文档](https://quasar.dev/vue-components/field)
+:::
+
+| 属性名                         | 说明                                    | 类型        | 可选值 | 默认值   |
+|-----------------------------|---------------------------------------|-----------|-----|-------|
+| value / v-model             | 绑定值（必填）                               | -         | -   | -     |
+| expanded / v-model:expanded | 树展开节点                                 | `Array`   | -   | -     |
+| nodes                       | 节点数组                                  | `String`  | -   | -     |
+| node-key                    | 唯一的节点键值（必填）                           | `String`  | -   | id    |
+| label-key                   | 标签字段                                  | `String`  | -   | label |
+| strict                      | 是否可选任意一级(true:可选任意一级, false: 仅能选叶子节点) | `Boolean` | -   | false |
+| multiple                    | 是否多选                                  | `Boolean` | -   | false |
+| accordion                   | 手风琴模式                                 | `Boolean` | -   | false |
+| show-all-levels             | 是否显示选中值的完整路径                          | `Boolean` | -   | true  |
+| filter                      | 是否开启筛选                                | `Boolean` | -   | false |
+| collapse-tags               | 是否折叠标签(多选模式有效)                        | `Boolean` | -   | false |
+| placeholder                 | 占位符                                   | `String`  | -   | -     |

package/_docs/docs/components/list-menu-item.md

@@ -0,0 +1,21 @@
+# FieldTree 下拉树
+
+::: tip
+继承 `<q-field>` 所有特性
+[中文文档](http://www.quasarchs.com/vue-components/field) [英文文档](https://quasar.dev/vue-components/field)
+:::
+
+| 属性名                         | 说明                                    | 类型        | 可选值 | 默认值   |
+|-----------------------------|---------------------------------------|-----------|-----|-------|
+| value / v-model             | 绑定值（必填）                               | -         | -   | -     |
+| expanded / v-model:expanded | 树展开节点                                 | `Array`   | -   | -     |
+| nodes                       | 节点数组                                  | `String`  | -   | -     |
+| node-key                    | 唯一的节点键值（必填）                           | `String`  | -   | id    |
+| label-key                   | 标签字段                                  | `String`  | -   | label |
+| strict                      | 是否可选任意一级(true:可选任意一级, false: 仅能选叶子节点) | `Boolean` | -   | false |
+| multiple                    | 是否多选                                  | `Boolean` | -   | false |
+| accordion                   | 手风琴模式                                 | `Boolean` | -   | false |
+| show-all-levels             | 是否显示选中值的完整路径                          | `Boolean` | -   | true  |
+| filter                      | 是否开启筛选                                | `Boolean` | -   | false |
+| collapse-tags               | 是否折叠标签(多选模式有效)                        | `Boolean` | -   | false |
+| placeholder                 | 占位符                                   | `String`  | -   | -     |

package/_docs/docs/components/list-menu.md

@@ -0,0 +1,21 @@
+# FieldTree 下拉树
+
+::: tip
+继承 `<q-field>` 所有特性
+[中文文档](http://www.quasarchs.com/vue-components/field) [英文文档](https://quasar.dev/vue-components/field)
+:::
+
+| 属性名                         | 说明                                    | 类型        | 可选值 | 默认值   |
+|-----------------------------|---------------------------------------|-----------|-----|-------|
+| value / v-model             | 绑定值（必填）                               | -         | -   | -     |
+| expanded / v-model:expanded | 树展开节点                                 | `Array`   | -   | -     |
+| nodes                       | 节点数组                                  | `String`  | -   | -     |
+| node-key                    | 唯一的节点键值（必填）                           | `String`  | -   | id    |
+| label-key                   | 标签字段                                  | `String`  | -   | label |
+| strict                      | 是否可选任意一级(true:可选任意一级, false: 仅能选叶子节点) | `Boolean` | -   | false |
+| multiple                    | 是否多选                                  | `Boolean` | -   | false |
+| accordion                   | 手风琴模式                                 | `Boolean` | -   | false |
+| show-all-levels             | 是否显示选中值的完整路径                          | `Boolean` | -   | true  |
+| filter                      | 是否开启筛选                                | `Boolean` | -   | false |
+| collapse-tags               | 是否折叠标签(多选模式有效)                        | `Boolean` | -   | false |
+| placeholder                 | 占位符                                   | `String`  | -   | -     |

package/_docs/docs/components/power-page.md

@@ -0,0 +1,21 @@
+# FieldTree 下拉树
+
+::: tip
+继承 `<q-field>` 所有特性
+[中文文档](http://www.quasarchs.com/vue-components/field) [英文文档](https://quasar.dev/vue-components/field)
+:::
+
+| 属性名                         | 说明                                    | 类型        | 可选值 | 默认值   |
+|-----------------------------|---------------------------------------|-----------|-----|-------|
+| value / v-model             | 绑定值（必填）                               | -         | -   | -     |
+| expanded / v-model:expanded | 树展开节点                                 | `Array`   | -   | -     |
+| nodes                       | 节点数组                                  | `String`  | -   | -     |
+| node-key                    | 唯一的节点键值（必填）                           | `String`  | -   | id    |
+| label-key                   | 标签字段                                  | `String`  | -   | label |
+| strict                      | 是否可选任意一级(true:可选任意一级, false: 仅能选叶子节点) | `Boolean` | -   | false |
+| multiple                    | 是否多选                                  | `Boolean` | -   | false |
+| accordion                   | 手风琴模式                                 | `Boolean` | -   | false |
+| show-all-levels             | 是否显示选中值的完整路径                          | `Boolean` | -   | true  |
+| filter                      | 是否开启筛选                                | `Boolean` | -   | false |
+| collapse-tags               | 是否折叠标签(多选模式有效)                        | `Boolean` | -   | false |
+| placeholder                 | 占位符                                   | `String`  | -   | -     |

package/_docs/docs/components/price.md

@@ -0,0 +1,21 @@
+# FieldTree 下拉树
+
+::: tip
+继承 `<q-field>` 所有特性
+[中文文档](http://www.quasarchs.com/vue-components/field) [英文文档](https://quasar.dev/vue-components/field)
+:::
+
+| 属性名                         | 说明                                    | 类型        | 可选值 | 默认值   |
+|-----------------------------|---------------------------------------|-----------|-----|-------|
+| value / v-model             | 绑定值（必填）                               | -         | -   | -     |
+| expanded / v-model:expanded | 树展开节点                                 | `Array`   | -   | -     |
+| nodes                       | 节点数组                                  | `String`  | -   | -     |
+| node-key                    | 唯一的节点键值（必填）                           | `String`  | -   | id    |
+| label-key                   | 标签字段                                  | `String`  | -   | label |
+| strict                      | 是否可选任意一级(true:可选任意一级, false: 仅能选叶子节点) | `Boolean` | -   | false |
+| multiple                    | 是否多选                                  | `Boolean` | -   | false |
+| accordion                   | 手风琴模式                                 | `Boolean` | -   | false |
+| show-all-levels             | 是否显示选中值的完整路径                          | `Boolean` | -   | true  |
+| filter                      | 是否开启筛选                                | `Boolean` | -   | false |
+| collapse-tags               | 是否折叠标签(多选模式有效)                        | `Boolean` | -   | false |
+| placeholder                 | 占位符                                   | `String`  | -   | -     |

package/_docs/docs/components/table-column-fixed.md

@@ -0,0 +1,20 @@
+# TableSplitter 表格拆分器
+
+::: tip
+继承 [n-table]() 所有特性
+:::
+
+| 属性名                   | 说明                                          | 类型                   | 可选值 | 默认值      |
+|-----------------------|---------------------------------------------|----------------------|-----|----------|
+| value / v-model       | 绑定值（必填）                                     | -                    | -   | -        |
+| reverse               | 反转插槽                                        | `Boolean`            | -   | false    |
+| unit                  | 模型的 CSS 单位                                  | `String`             | -   | %        |
+| limits                | 两个值的数组，表示两个面板的最小和最大分割大小                     | `Array`              | -   | -        |
+| horizontal            | 是否水平拆分                                      | `Boolean`            | -   | false    |
+| after / v-model:after | 显示后置插槽(如果非双向绑定，如 :after 并不会影响内部值变化，仅做初始值使用) | `Boolean`            | -   | true     |
+| hide-after-in-mobile  | 手机模式隐藏后插槽                                   | `Boolean`            | -   | false    |
+| cache                 | 是否开启缓存（如果为字符串, 则为缓存名）                       | `Boolean` / `String` | -   | false    |
+| tooltip               | 工具提示                                        | `String`             | -   | 是否显示详情   |
+| renderPath            | 渲染组件路径（必填）                                  | `String`             | -   | -        |
+| renderDescription     | 渲染空状态描述                                     | `String`             | -   | 没有找到任何数据 |
+| noRendPageName        | 不需要加载渲染页面标识参数                               | `Boolean`            | -   | false    |

package/_docs/docs/components/table-pagination.md

@@ -0,0 +1,20 @@
+# TableSplitter 表格拆分器
+
+::: tip
+继承 [n-table]() 所有特性
+:::
+
+| 属性名                   | 说明                                          | 类型                   | 可选值 | 默认值      |
+|-----------------------|---------------------------------------------|----------------------|-----|----------|
+| value / v-model       | 绑定值（必填）                                     | -                    | -   | -        |
+| reverse               | 反转插槽                                        | `Boolean`            | -   | false    |
+| unit                  | 模型的 CSS 单位                                  | `String`             | -   | %        |
+| limits                | 两个值的数组，表示两个面板的最小和最大分割大小                     | `Array`              | -   | -        |
+| horizontal            | 是否水平拆分                                      | `Boolean`            | -   | false    |
+| after / v-model:after | 显示后置插槽(如果非双向绑定，如 :after 并不会影响内部值变化，仅做初始值使用) | `Boolean`            | -   | true     |
+| hide-after-in-mobile  | 手机模式隐藏后插槽                                   | `Boolean`            | -   | false    |
+| cache                 | 是否开启缓存（如果为字符串, 则为缓存名）                       | `Boolean` / `String` | -   | false    |
+| tooltip               | 工具提示                                        | `String`             | -   | 是否显示详情   |
+| renderPath            | 渲染组件路径（必填）                                  | `String`             | -   | -        |
+| renderDescription     | 渲染空状态描述                                     | `String`             | -   | 没有找到任何数据 |
+| noRendPageName        | 不需要加载渲染页面标识参数                               | `Boolean`            | -   | false    |

package/_docs/docs/components/table-summary.md

@@ -0,0 +1,20 @@
+# TableSplitter 表格拆分器
+
+::: tip
+继承 [n-table]() 所有特性
+:::
+
+| 属性名                   | 说明                                          | 类型                   | 可选值 | 默认值      |
+|-----------------------|---------------------------------------------|----------------------|-----|----------|
+| value / v-model       | 绑定值（必填）                                     | -                    | -   | -        |
+| reverse               | 反转插槽                                        | `Boolean`            | -   | false    |
+| unit                  | 模型的 CSS 单位                                  | `String`             | -   | %        |
+| limits                | 两个值的数组，表示两个面板的最小和最大分割大小                     | `Array`              | -   | -        |
+| horizontal            | 是否水平拆分                                      | `Boolean`            | -   | false    |
+| after / v-model:after | 显示后置插槽(如果非双向绑定，如 :after 并不会影响内部值变化，仅做初始值使用) | `Boolean`            | -   | true     |
+| hide-after-in-mobile  | 手机模式隐藏后插槽                                   | `Boolean`            | -   | false    |
+| cache                 | 是否开启缓存（如果为字符串, 则为缓存名）                       | `Boolean` / `String` | -   | false    |
+| tooltip               | 工具提示                                        | `String`             | -   | 是否显示详情   |
+| renderPath            | 渲染组件路径（必填）                                  | `String`             | -   | -        |
+| renderDescription     | 渲染空状态描述                                     | `String`             | -   | 没有找到任何数据 |
+| noRendPageName        | 不需要加载渲染页面标识参数                               | `Boolean`            | -   | false    |

package/_docs/docs/utils/alert.md

@@ -1 +1,18 @@
-# alert
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |

package/_docs/docs/utils/area.md

@@ -0,0 +1,18 @@
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |

package/_docs/docs/utils/arr.md

@@ -0,0 +1,18 @@
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |

package/_docs/docs/utils/auth.md

@@ -0,0 +1,101 @@
+# $auth 鉴权
+
+::: tip
+`@netang/quasar/utils/$auth.js` [Github](https://github.com/netangsoft/netang-quasar/blob/main/utils/%24auth.js) [Gitee](https://gitee.com/jinmarcus/netang-quasar/blob/main/utils/%24auth.js)
+
+用户登录鉴权工具
+:::
+
+## $auth.isLogin
+
+判断用户是否已登录
+
+- 类型
+
+```javascript
+$auth.isLogin(): boolean
+```
+
+
+## $auth.getUserInfo
+
+获取用户信息
+
+- 类型
+
+```javascript
+$auth.getUserInfo(): Object
+```
+
+- 返回
+
+| 参数名     | 说明      | 类型        | 默认值 | 可选值 | 示例                         |
+|---------|---------|-----------|-----|-----|----------------------------|
+| id      | 用户 id   | `Number`  | -   | -   | -                          | 
+| token   | 鉴权认证    | `String`  | -   | -   | -                          | 
+| info    | 用户信息    | `Object`  | -   | -   | { mobile: 123456, sex: 1 } | 
+| isLogin | 用户是否已登录 | `Boolean` | -   | -   | -                          | 
+
+
+## $auth.getUserId
+
+获取用户 ID
+
+- 类型
+
+```javascript
+
+$auth.getUserId(): Number
+```
+
+- 说明
+
+如果返回 0：说明用户未登录
+
+否则返回已登录的用户 ID
+
+
+## $auth.pushLogin
+
+跳转登录页面
+
+- 类型
+
+```javascript
+$auth.pushLogin(query: Object): void
+```
+
+- 说明
+
+`query` 为跳转至登录页面的参数
+
+
+## $auth.logout
+
+退出登录
+
+- 类型
+
+```javascript
+$auth.logout(): void
+```
+
+
+## $auth.updateLogin
+
+登录后更新用户状态数据
+
+- 类型
+
+```javascript
+$auth.updateLogin(options: Object): boolean
+```
+
+- options 参数
+
+| 参数名       | 说明     | 类型       | 默认值 | 可选值 | 示例                         |
+|-----------|--------|----------|-----|-----|----------------------------|
+| i         | 用户 id  | `Number` | -   | -   | -                          | 
+| t         | 鉴权认证   | `String` | -   | -   | -                          | 
+| user_info | 用户基础信息 | `Object` | -   | -   | { mobile: 123456, sex: 1 } | 
+

package/_docs/docs/utils/bus.md

@@ -0,0 +1,18 @@
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |

package/_docs/docs/utils/confirm.md

@@ -1 +1,18 @@
-# confirm
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |

package/_docs/docs/utils/copy.md

@@ -0,0 +1,18 @@
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |

package/_docs/docs/utils/dialog.md

@@ -0,0 +1,18 @@
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |

package/_docs/docs/utils/dict.md

@@ -0,0 +1,18 @@
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |

package/_docs/docs/utils/dictOptions.md

@@ -0,0 +1,18 @@
+# xxxx xxxx
+
+::: tip
+xxxxxxxx
+:::
+
+### 使用示例
+
+```javascript
+
+```
+
+
+### xxxx 参数
+
+| 参数名   | 类型    | 默认值 | 可选值 | 说明  |
+|-------|-------|-----|-----|-----|
+| xxxxx | xxxxx | -   | -   | -   |