@weitutech/by-components 1.0.30 → 1.1.0

package/.babelrc

@@ -0,0 +1,7 @@
+{
+  "presets": ["@babel/preset-env"],
+  "plugins": [
+    "@babel/plugin-proposal-nullish-coalescing-operator",
+    "@babel/plugin-proposal-optional-chaining"
+  ]
+}

package/.editorconfig

@@ -0,0 +1,19 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.vue]
+indent_size = 2
+
+[*.vue:script]
+indent_style = space
+indent_size = 0

package/.eslintignore

@@ -0,0 +1,9 @@
+/dist/
+/lib/
+/node_modules/
+.DS_Store
+.env.local
+.env.*.local
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log* 

package/.eslintrc.cjs

@@ -0,0 +1,65 @@
+module.exports = {
+  root: true,
+  env: {
+    node: true,
+    browser: true,
+  },
+  extends: ['plugin:vue/essential', 'eslint:recommended', 'plugin:prettier/recommended'],
+  parser: 'vue-eslint-parser',
+  rules: {
+    'vue/max-attributes-per-line': [
+      'error',
+      {
+        singleline: 5,
+        multiline: {
+          max: 1,
+          allowFirstLine: false,
+        },
+      },
+    ],
+    'vue/html-self-closing': [
+      'error',
+      {
+        html: {
+          void: 'always',
+          normal: 'never',
+          component: 'always',
+        },
+      },
+    ],
+    'vue/html-closing-bracket-newline': [
+      'error',
+      {
+        singleline: 'never',
+        multiline: 'always',
+      },
+    ],
+    'vue/multiline-html-element-content-newline': [
+      'error',
+      {
+        ignoreWhenEmpty: true,
+        ignores: ['pre', 'textarea'],
+      },
+    ],
+    // "no-console": process.env.NODE_ENV === "production" ? "warn" : "off",
+    // "no-debugger": process.env.NODE_ENV === "production" ? "warn" : "off",
+    'no-unused-vars': ['warn', { args: 'none' }],
+    'prefer-const': 'warn',
+    // "no-var": "error",
+    'prettier/prettier': ['error', {}, { usePrettierrc: true }],
+
+    'vue/no-lone-template': 'off',
+    'vue/singleline-html-element-content-newline': 'off',
+    'require-atomic-updates': 'off',
+    'no-prototype-builtins': 'off',
+    'no-restricted-syntax': 'off',
+    'no-useless-catch': 'off',
+    'no-useless-escape': 'off',
+    'no-useless-return': 'off',
+    'no-case-declarations': 'off',
+
+    'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
+    'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
+    'vue/multi-word-component-names': 'off',
+  },
+}

package/.prettierignore

@@ -0,0 +1,9 @@
+/dist/
+/lib/
+/node_modules/
+.DS_Store
+.env.local
+.env.*.local
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log* 

package/.prettierrc

@@ -0,0 +1,22 @@
+{
+  "printWidth": 120,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "none",
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "htmlWhitespaceSensitivity": "ignore",
+  "bracketSameLine": false,
+  "overrides": [
+    {
+      "files": "*.vue",
+      "options": {
+        "parser": "vue",
+        "vueIndentScriptAndStyle": false
+      }
+    }
+  ]
+}

package/.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "octref.vetur",
+    "esbenp.prettier-vscode"
+  ]
+}

package/.vscode/settings.json

@@ -0,0 +1,27 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": null,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[vue]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[html]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[css]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "vue"
+  ]
+}

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+# 1.1.0 (2025-05-20)
+
+### feat
+
+- 增加table表格列宽缓存功能
+- 增加table表格行高自适应功能
+- 增加form表单按钮区域（重置、搜索按钮）
+
+# 1.0.31 (2025-05-14)
+
+### feat
+
+- 自定义时间组件，支持绑定开始时间和结束时间
+
+# 1.0.30 (2025-04-17)
+
+### feat
+
+- 增加表格列表的保存
+
 # 1.0.27 (2024-12-04)
 
 ### 🍏 Perf

package/README.md

@@ -298,11 +298,36 @@ export default {
 
 ```
 
+#### 自定义时间选择器'customDatePicker'特别说明
+
+自定义时间选择器同时支持时间段方式绑定值 和 单独时间方式绑定值
+
+```
+// 时间段方式绑定值
+{
+  type: 'customDatePicker',
+  field: 'report_time',
+  label: '报表时间'
+}
+```
+
+```
+// 单独时间方式绑定值
+{
+  type: 'customDatePicker',
+  field: 'report_time',  // 仍然保留原来的字段，保证兼容性
+  startTimeField: 'start_time',  // 新增开始时间字段
+  endTimeField: 'end_time',  // 新增结束时间字段
+  label: '报表时间'
+}
+```
+
 ### 表格 by-table
 
 [vxe-table 文档](https://vxetable.cn/v3.8/#/table/start/install)
 
 ###### 通用配置
+
 ```
 <template>
   <by-table
@@ -372,7 +397,7 @@ export default {
           }
         },
 
-        customColumnConfig: { // 自定义列  
+        customColumnConfig: { // 自定义列
           showCustomColumn: true, // 是否显示自定义列
           infoMethod: getCustomTableList,  // 回显用的接口
           submitMethod: setCustomTableList, // 保存用的接口
@@ -411,7 +436,9 @@ export default {
 </script>
 
 ```
+
 ###### 自定义列支持多级表头
+
 ```
 <template>
   <by-table
@@ -450,7 +477,7 @@ export default {
           },
           { field: 'address', title: 'Address', sortable: true, showOverflow: true }
         ],
-      }  
+      }
     }
   },
   methods: {
@@ -467,4 +494,4 @@ export default {
   }
 }
 </script>
-```
+```

package/docs/form.md

@@ -1,4 +1,5 @@
-### 类型(没有注册看Element的组件使用方法)
+### 类型(没有注册看 Element 的组件使用方法)
+
 ```
   | 'input'
   | 'inputNumber'
@@ -12,15 +13,81 @@
   | 'upload'
   | 'customDatePicker' // 自定义的时间选择器
   | 'search' // 搜索按钮区域
+  | 'formButtons' // 表单按钮区域
   | 'custom' // 自定义
 ```
 
 #### Event
 
-|  事件   | 参数  |
-|  ----  | ----  |
-| change  | context: IFormItems |
-| queryBtnClick  | 无 |
+| 事件          | 参数                |
+| ------------- | ------------------- |
+| change        | context: IFormItems |
+| queryBtnClick | 无                  |
 
 完整案列见 [表单 by-form](../README.md)
-  
+
+#### 表单按钮区域（重置、搜索按钮）
+
+- formItem使用'formButtons'类型
+- @submit 触发搜索事件
+- @reset 触发重置事件 （内部已实现重置逻辑，如无需其他逻辑，可不实现）
+
+```
+// 示例：
+//formItems中使用示例：
+{
+  //重置、搜索 按钮
+  type: 'formButtons',
+  labelWidth: '10px',
+  otherOptions: {
+    submit: true, //  是否显示搜索按钮,默认显示
+    reset: false, //  是否显示重置按钮,默认显示
+    submitText: '搜索', //  搜索按钮文字
+    resetText: '重置' //  重置按钮文字
+    showSubmitIcon: true, //  是否显示搜索按钮图标,默认显示
+  }
+}
+
+//form使用示例：（by-form & by-page-search组件使用示例）
+<by-form
+  ref="BFormRef"
+  v-model="formData"
+  v-bind="formConfig"
+  @submit="handleSubmit"
+  @reset="handleReset"
+></by-form>
+
+<by-page-search
+  v-model="searchQuery"
+  :search-form-config="formConfig"
+  @change="handleFormChange"
+  @submit="handleSubmit"
+  @reset="handleReset"
+></by-page-search>
+```
+
+### 特殊说明
+
+#### 自定义时间选中器'customDatePicker'特别说明
+
+自定义时间选中器同时支持时间段方式绑定值 和 单独时间方式绑定值
+
+```
+// 时间段方式绑定值
+{
+  type: 'customDatePicker',
+  field: 'report_time',
+  label: '报表时间'
+}
+```
+
+```
+// 单独时间方式绑定值
+{
+  type: 'customDatePicker',
+  field: 'report_time',  // 仍然保留原来的字段，保证兼容性
+  startTimeField: 'start_time',  // 新增开始时间字段
+  endTimeField: 'end_time',  // 新增结束时间字段
+  label: '报表时间'
+}
+```

package/docs/table.md

@@ -1,10 +1,25 @@
 ### table
-  #### 自定义列宽
-    注意📢： 一个项目中的name属性千万不能重名、一个项目中的name属性千万不能重名、一个项目中的name属性千万不能重名
-    给table组件设置name值属性、类型为String格式、表格会自动缓存用户拖拽之后的结果
-  #### 自定义列
+
+#### 列宽缓存
+
+    - 列宽缓存会根据 name 属性进行缓存; 所以如果业务中表格需要缓存列宽，请务必给table组件设置name属性（类型为String）
+
+    - name属性值不能重复，最好根据当前业务场景进行命名（如： name='adManage_headline2_account'）,能保证不重名即可
+
+    - 当新增列、删除列时，会实时更新列宽缓存
+
+    - 注意📢： 一个项目中的name属性千万不能重名、一个项目中的name属性千万不能重名、一个项目中的name属性千万不能重名
+
+#### 行高自适应
+
+    - 如果需要行高自适应，请设置属性：:auto-height="true"
+
+    - 如果某个单元格的内容超出单元格显示，会自动撑高单元格
+
+#### 自定义列
+
     给table组件设置以下对象
-    customColumnConfig: { // 自定义列  
+    customColumnConfig: { // 自定义列
       showCustomColumn: true, // 是否显示自定义列
       infoMethod: getCustomTableList,  // 回显用的接口
       infoMethodParams: {}, // 回显用的接口参数
@@ -21,6 +36,8 @@
         { title: "操作", width: 80, fixed: "right", slots: { default: "operate" }}
       ]
     }
-  #### Event
-  见[第三方插件vxe-table](./extension.md)
-完整案列见 [表格 by-table](../README.md)
+
+#### Event
+
+见[第三方插件vxe-table](./extension.md)
+完整案列见 [表格 by-table](../README.md)