sohelp-eleplus 1.1.26 → 1.1.28

package/sohelp-user-modal-select/index.vue

@@ -0,0 +1,87 @@
+<template>
+  <sohelp-modal-select v-bind="$attrs" :labelField="labelField" :valueField="valueField" :gridProps="mergedGridProps"
+    :selectionTemplate="selectionTemplate" :modalProps="mergedModalProps"></sohelp-modal-select>
+</template>
+
+<script>
+export default {
+  name: 'SohelpUserModalSelect'
+};
+</script>
+
+<script setup>
+import { computed } from 'vue';
+
+import SohelpModalSelect from '../sohelp-modal-select/index.vue';
+
+const defaultGridProps = {
+  url: '/admin/system/user/page',
+  gridOptions: {    
+    columns: [
+      {
+        field: 'user_name',
+        title: '用户姓名',
+        width: 120
+      },
+      {
+        field: 'login_name',
+        title: '登录账户',
+        width: 200
+      },
+      {
+        field: 'nickname',
+        title: '昵称',
+        width: 120
+      }
+    ]
+  }
+};
+
+const props = defineProps({
+  gridProps: {
+    type: Object,
+    default: () => ({})
+  },
+  modalProps: {
+    type: Object,
+    default: () => ({})
+  },
+  valueField: {
+    type: String,
+    default: 'id'
+  },
+  labelField: {
+    type: String,
+    default: 'user_name'
+  },
+  selectionTemplate: {
+    type: String,
+    default: '${user_name}-${login_name}'
+  }
+});
+
+const mergedGridProps = computed(() => {
+  const { gridProps } = props;
+  return {
+    url: gridProps?.url ?? defaultGridProps.url,
+    gridOptions: gridProps?.gridOptions ?? defaultGridProps.gridOptions
+  };
+});
+
+const mergedModalProps = computed(() => {
+  return {
+    title: '选择用户',
+    ...props.modalProps,
+    width: props.modalProps?.width || 800,
+  };
+});
+
+
+
+
+
+
+
+
+
+</script>

package/sohelp-user-select/README.md

@@ -1,22 +1,33 @@
-# SohelpUserSelect
+# SohelpUserSelect 用户选择器
 
-A specialized selection component for selecting users, built on top of `sohelp-dyn-select`.
+基于 `sohelp-dyn-select` 封装的用户选择组件，预设了用户列表接口地址和字段映射，开箱即用。
 
-## Props
-
-| Name | Type | Default | Description |
-| :--- | :--- | :--- | :--- |
-| `datasource` | `Array`, `Function`, `Promise` | Required | The data source for user options. |
-| `url` | `String` | `'/engine/web/user/list'` | The default URL for fetching user data. |
-| `labelField` | `String` | `'user_name'` | The field name for the user label. |
-| `valueField` | `String` | `'id'` | The field name for the user value. |
-| `modelValue` | `String`, `Number`, `Array` | `""` | The selected value (v-model). |
-| `...` | - | - | Supports all `sohelp-dyn-select` props. |
-
-## Usage
+## 基础用法
 
 ```vue
 <template>
-  <sohelp-user-select v-model="userId" :datasource="users" />
+  <sohelp-user-select v-model="userId" />
 </template>
+
+<script setup>
+import { ref } from 'vue';
+
+const userId = ref('');
+</script>
 ```
+
+## 属性 (Props)
+
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- | :--- |
+| modelValue | String / Number / Array | `''` | 否 | 绑定值（v-model） |
+| datasource | Array / Function / Promise | `undefined` | 否 | 自定义数据源，优先级高于 url |
+| url | String | `'/engine/web/user/list'` | 否 | 用户列表接口地址 |
+| labelField | String | `'user_name'` | 否 | 显示文本字段名 |
+| valueField | String | `'id'` | 否 | 值字段名 |
+
+> 同时支持所有 `sohelp-dyn-select` 和 `el-select` 原生属性，通过 `v-bind="$attrs"` 透传。
+
+## 公开方法 (Expose)
+
+组件通过 `defineExpose({})` 暴露，当前无额外公开方法。

package/sohelp-user-select/index.vue

@@ -18,7 +18,7 @@
   const props = defineProps({
     datasource: {
       type: [Array, Function, Promise],
-      required: true
+      default: undefined
     },
     url: {
       type: String,
@@ -41,4 +41,8 @@
     name: 'SohelpUserSelect'
   };
 </script>
-<style></style>
+<style>
+  .sohelp-user-select{
+    width: 100%;
+  }
+</style>

package/sohelp-user-tag/README.md

@@ -1,15 +1,13 @@
-# SohelpUserTag
+# SohelpUserTag 用户头像标签
 
-A component to display user information (Avatar + Nickname). Falls back to default company LOGO if no info is provided.
+用户头像标签组件，显示用户头像和昵称，无头像时显示公司 LOGO（待实现）。
 
-## Description
-
-Displays user avatar and nickname. Currently a placeholder/simple implementation.
-
-## Usage
+## 基础用法
 
 ```vue
 <template>
   <sohelp-user-tag />
 </template>
 ```
+
+> 该组件当前为占位状态，功能待实现。

package/sohelp-user-tag/index.vue

@@ -1,12 +1,12 @@
 <template>
-  <div>头像+nickname,如果没有显示默认公司LOGO</div>
+  <div class="sohelp-user-tag">
+    <!-- TODO: 待实现 - 用户头像标签（头像+昵称，无头像显示公司LOGO） -->
+    <el-empty description="用户头像标签 - 待实现" />
+  </div>
 </template>
+<script setup>
+  // TODO: 待实现
+</script>
 <script>
-export default {
-  name: "SohelpUserTag"
-}
+  export default { name: 'SohelpUserTag' };
 </script>
-
-<style scoped>
-
-</style>

package/sohelp-user-tree/README.md

@@ -1,15 +1,12 @@
-# SohelpUserTree
+# SohelpUserTree 用户树
 
-A specialized tree component for displaying users, inheriting from `SohelpTree`.
+用户树组件，用于以树形结构展示和选择用户。当前版本为占位组件，功能待实现。
 
-## Description
-
-Intended for user selection in a tree structure. Currently a wrapper/placeholder inheriting from `SohelpTree`.
-
-## Usage
+## 基础用法
 
 ```vue
 <template>
-  <sohelp-user-tree :data="userData" />
+  <!-- 当前版本为占位组件，功能待实现 -->
+  <sohelp-user-tree />
 </template>
 ```

package/sohelp-user-tree/index.vue

@@ -1,11 +1,12 @@
 <template>
-<div>SohelpUserTree用户弹窗是继承SohelpTree</div>
+  <div class="sohelp-user-tree">
+    <!-- TODO: 待实现 - 用户树选择弹窗（继承SohelpTree） -->
+    <el-empty description="用户树选择弹窗 - 待实现" />
+  </div>
 </template>
+<script setup>
+  // TODO: 待实现
+</script>
 <script>
-export default {
-  name: "SohelpUserTree"
-}
+  export default { name: 'SohelpUserTree' };
 </script>
-<style scoped>
-
-</style>

package/sohelp-vform-drawer/README.md

@@ -1,25 +1,43 @@
-# SohelpVformDrawer
+# SohelpVformDrawer 表单抽屉
 
-A drawer component that renders a VForm based on configuration, wrapping `sohelp-vform-eleplus`.
+基于 `sohelp-drawer` 和 `sohelp-vform-eleplus` 封装的表单抽屉组件，在抽屉中加载动态表单。
 
-## Props
-
-| Name | Type | Default | Description |
-| :--- | :--- | :--- | :--- |
-| `refid` | `String` | Required | The configuration ID for the form. |
-| `...` | - | - | Supports all `sohelp-drawer` props. |
-
-## Methods
-
-| Name | Description |
-| :--- | :--- |
-| `getFormJson()` | Returns the form JSON configuration. |
-| `getFormData()` | Returns the current form data. |
-
-## Usage
+## 基础用法
 
 ```vue
 <template>
-  <sohelp-vform-drawer refid="form_config_id" v-model="visible" />
+  <sohelp-vform-drawer ref="vformDrawerRef" refid="myForm" />
 </template>
+
+<script setup>
+import { ref } from 'vue';
+const vformDrawerRef = ref(null);
+
+// 获取表单 JSON 配置
+const json = vformDrawerRef.value?.getFormJson();
+// 获取表单数据
+const data = vformDrawerRef.value?.getFormData();
+</script>
 ```
+
+## 属性 (Props)
+
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| refid | String | - | 是 | 表单引用 ID，用于加载对应的 vform 配置 |
+
+> 支持透传 `sohelp-vform-eleplus` 的所有属性。
+
+## 插槽 (Slots)
+
+| 插槽名 | 说明 |
+| --- | --- |
+| default | 自定义表单内容，透传至 sohelp-vform-eleplus |
+| footer | 自定义底部操作区域 |
+
+## 公开方法 (Expose)
+
+| 方法名 | 返回值 | 说明 |
+| --- | --- | --- |
+| getFormJson() | Object | 获取表单的 JSON 配置 |
+| getFormData() | Object | 获取表单当前数据 |

package/sohelp-vform-drawer/index.vue

@@ -2,7 +2,7 @@
   <sohelp-drawer>
     <sohelp-vform v-bind="$attrs" :refid="refid" ref="sohelpVformRef">
       <slot>
-        <template v-for="(slotProps, slotName) in $scopedSlots" :key="slotName">
+        <template v-for="(slotProps, slotName) in $slots" :key="slotName">
           <slot :name="slotName" v-bind="slotProps" />
         </template>
       </slot>
@@ -25,7 +25,7 @@ export default {
       required: true
     }
   },
-  setup(props, {emits, attrs}) {
+  setup(props, {emit, attrs}) {
     const sohelpVformRef = ref(null);
     const getFormJson =()=>{
       return sohelpVformRef.value.getFormJson();

package/sohelp-vform-eleplus/README.md

@@ -1,39 +1,41 @@
-# SohelpVformEleplus
+# SohelpVformEleplus 可视化表单渲染器
 
-A core component for rendering dynamic forms using VForm and `moduleCache`. Supports toolbars, dynamic loading, and integration with the global configuration.
+基于 VFormRender 封装的动态表单渲染组件，通过 `refid` 从模块缓存加载表单布局配置，支持工具栏按钮和自定义脚本执行。
 
-## Props
+## 基础用法
 
-| Name | Type | Default | Description |
-| :--- | :--- | :--- | :--- |
-| `refid` | `String` | `''` | The configuration ID for the form layout. |
-| `moduleType` | `String` | `'tab'` | The display mode/style (e.g., 'tab'). |
-| `title` | `String` | `''` | The title of the form/page. |
-| `modelValue` | `Object` | `{}` | The form data object (v-model). |
-| `data` | `Object` | `{}` | Additional data context. |
-
-## Methods
+```vue
+<template>
+  <sohelp-vform-eleplus
+    refid="my_form_layout"
+    v-model="formData"
+    v-model:data="extraData"
+    title="表单标题"
+  />
+</template>
 
-| Name | Description |
-| :--- | :--- |
-| `loadConfig(refid)` | Loads the form configuration by ID. |
-| `setFormJson(json)` | Sets the form JSON configuration manually. |
-| `setFormData(data)` | Sets the form data. |
-| `setModelValue(value)` | Sets the model value. |
-| `getFormData(validate)` | Retrieves the form data, optionally validating it. |
-| `toolbarButtonClick(config)` | Handles toolbar button clicks and executes configured handlers. |
+<script setup>
+import { ref } from 'vue';
+const formData = ref({});
+const extraData = ref({});
+</script>
+```
 
-## Features
+## 属性 (Props)
 
-- **Dynamic Configuration**: Loads form layout and toolbar from `moduleCache`.
-- **Toolbar Support**: Renders a toolbar with customizable buttons and handlers.
-- **VForm Integration**: Wraps `VFormRender` for powerful form capabilities.
-- **Global Config**: Respects global size settings.
+| 属性名 | 类型 | 默认值 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| refid | String | '' | 否 | 表单布局配置 ID，用于从模块缓存加载配置 |
+| moduleType | String | 'tab' | 否 | 显示模式/样式类名，影响工具栏和主体布局方向 |
+| title | String | '' | 否 | 表单页面标题 |
+| modelValue | Object | {} | 否 | 表单数据对象，支持 v-model |
+| data | Object | {} | 否 | 附加数据上下文，支持 v-model:data |
 
-## Usage
+## 公开方法 (Expose)
 
-```vue
-<template>
-  <sohelp-vform-eleplus refid="my_form_config" v-model="formData" />
-</template>
-```
+- `loadConfig(refid)` - 根据配置 ID 加载表单布局
+- `setFormJson(json)` - 手动设置 VForm JSON 配置
+- `setFormData(data)` - 设置表单数据
+- `setModelValue(value)` - 设置 modelValue
+- `getFormData(validate?)` - 获取表单数据，可选是否验证（默认 true）
+- `toolbarButtonClick(config)` - 手动触发工具栏按钮点击事件

package/sohelp-vform-eleplus/index.vue

@@ -28,6 +28,7 @@
 <script setup>
   import { defineProps, getCurrentInstance, inject, onMounted, reactive, ref, watch } from 'vue';
   import { moduleCache } from '../cache/ModuleCache.js';
+  import { safeFunctionExec } from '../utils/safe-eval.js';
   import { useRoute } from 'vue-router';
   import { ElMessage } from 'element-plus';
   import { usePageTab } from '@/utils/use-page-tab.js';
@@ -154,8 +155,7 @@
           $param: route.query,
           $config: config
         };
-        const func = new Function('modelValue', config.handler);
-        func.call(scope, modelValue.value || {});
+        safeFunctionExec(config.handler, ['modelValue'], [modelValue.value || {}], scope);
       } catch (e) {
         console.error('工具栏按钮单击事件出错:' + props.refid, e);
         ElMessage.error(e);