# JS增强触发弹窗表单
>[info] JS增强触发弹出的表单可以是 `online表单` 也可以是 `自定义开发的表单`。
[TOC=2,3]
## 使用说明
- 支持按钮 :按钮样式[button]+按钮类型[js] 或者 按钮样式[link]+按钮类型[js]
- js增强弹框方法:`this.openCustomModal`,方法参数如下表
| 参数名 | 类型| 描述 |
| --- | --- | --- |
| title |string | 弹框标题,默认 '自定义弹框' |
| width| int| 弹框宽度,默认600 |
| row | object| 操作的数据,如果是button按钮,不设置则默认为当前选中行的数据,如果是link按钮,需要传入函数自带参数row |
| **formComponent**| string | **自定义弹框内表单组件地址**,设置的格式和系统菜单组件值的配置一样,如果没有设置,则弹框默认打开的是当前表单 |
| requestUrl| string | 表单提交地址,如不设置,则默认表单提交地址为原online编辑地址,formComponent未设置时生效 |
| hide|array| 隐藏的表单控件名, formComponent未设置时生效,可以使原表单的某些控件隐藏 |
| show|array| 显示的表单控件名, formComponent未设置时生效 ,如果设置,hide参数失效(show与hide互斥),且只有该数组内的控件才会显示 |
## 具体场景
### 场景一、button按钮触发弹窗online表单
1.添加按钮:按钮样式[button],按钮类型[js],按钮编码`test1`对应增强函数名
![](https://img.kancloud.cn/a1/e4/a1e4301e982aa28a3c94144a0f1bb51c_792x404.png)
2.添加 list页面的js增强
```
test1(){
this.openCustomModal({
title: '测试自定义弹框1',
width: 800
});
}
```
3.效果演示
![](https://img.kancloud.cn/3e/ba/3eba8207a1cfd3050af360164b8b18c3_1924x756.png)
-------
### 场景二、link按钮触发弹窗online表单,并控制字段显隐
1.添加按钮:按钮样式\[link\],按钮类型\[js\],按钮编码`test2`对应增强函数名
![](https://img.kancloud.cn/4b/9e/4b9e36ca72965607d31e8ff09b580880_788x469.png)
2.添加 list页面的js增强
```
test2(row){
this.openCustomModal({
row: row,
title: '测试自定义弹框2',
width: 800,
hide: ['age', 'sex']
});
}
```
3.效果演示
![](https://img.kancloud.cn/69/04/690428413ccb3b2f14714df6983cdbc6_1890x756.png)
>[info] link按钮和button的区别在于,link按钮需要手动传入参数:row,button按钮默认不需要传入,但是操作的时候需要先选中数据。
-----
### 场景三、button按钮触发弹窗渲染自定义开发页面
>[info] 目前自定义开发页面,开源版本暂时不支持。
1.添加按钮:按钮样式[button],按钮类型[js],按钮编码`test3`对应增强函数名
![](https://img.kancloud.cn/78/d0/78d08c84541c9843ac73abcf10052005_786x451.png)
2.添加 list页面的js增强
```
test3(){
this.openCustomModal({
formComponent: 'demo/hello/index.vue',
title: '测试自定义弹框3',
width: 800
});
}
```
3.效果演示
![](https://img.kancloud.cn/b0/91/b091bcf0c66e4c034be49e40ccd93948_1890x756.png)
**备注:**
上述formComponent用到一个自定义的表单页
文件地址:`src/views/demo/hello/index.vue`
文件内容:
```
<template>
<a-form :labelCol="{span:3}">
<a-form-item label="名称" >
<a-input placeholder="请输入名称" v-model:value="name"/>
</a-form-item>
</a-form>
</template>
<script>
import { ref, onMounted } from 'vue'
import { defHttp } from '/@/utils/http/axios'
import { useMessage } from '/@/hooks/web/useMessage';
export default {
name: "hello",
props: {
// 行数据
row: {
type: Object,
default: () => {
},
required: false
},
// 该地址是online默认的编辑提交地址 如不满足要求需自定义
url: {
type: String,
default: '',
required: false
}
},
setup(props, {emit}) {
const name = ref('')
const { createMessage } = useMessage();
onMounted(() => {
name.value = props.row.name
});
/**
* 自定义的表单页面 弹窗确定按钮触发函数名必须写:handleSubmit
*/
function handleSubmit() {
let params = Object.assign({}, props.row, { name: name.value });
defHttp.put({ url: props.url, params }, { isTransformResponse: false }).then((res) => {
if (res.success) {
// 提交完毕 关闭弹窗 调用事件:emit('close')
emit('close')
} else {
createMessage.warning(res.message)
}
});
}
return {
name,
handleSubmit
}
}
}
</script>
```
- 项目介绍
- 常见问题
- 开发环境准备
- 环境准备
- 启动项目
- 切换Vue3路由
- 项目配置详细说明
- 上线部署
- 快速构建&部署
- Docker镜像启动
- 项目配置
- 菜单配置
- 菜单缓存
- 积木报表菜单配置
- 首页配置
- 国际化
- 菜单国际化
- 组件注册
- 项目规范
- 跨域处理
- 样式库
- 图标生成
- package依赖介绍
- 菜单TAB风格
- 备份文档
- 详细构建和配置
- 构建部署1.0
- 切换Mock接口
- 原生路由(作废)
- 原生菜单(作废)
- 页面开启缓存(作废)
- 环境准备1.0
- 数据 mock&联调
- UI组件
- Form 表单组件
- Table 表格
- Modal 弹窗
- Drawer 抽屉组件
- Icon 图标组件
- Button 按钮
- 更多基础组件
- JSelectUser选择用户 ✔
- JSelectPosition岗位选择 ✔
- JSelectDept部门选择 ✔
- JCheckbox ✔
- JImportModal 列表导入弹窗组件
- JInput特殊查询组件 ✔
- JPopup弹窗选择组件 ✔
- JTreeSelect树形下拉框 (异步加载) ✔
- JAreaSelect 省市县级联组件
- JDictSelectTag 字典标签 ✔
- JEllipsis 超长截取显示组件 ✔
- JUpload 上传组件 ✔
- JEasyCron 定时表达式选择组件 ✔
- JInputPopup 多行输入窗口组件 ✔
- JSwitch 开关选择组件 ✔
- JTreeDict 分类字典树形下拉组件 ✔
- JSelectInput 可输入下拉框 ✔
- JEditor 富文本编辑器 ✔
- JMarkdownEditor Markdown编辑器 ✔
- JSearchSelect 字典表的搜索组件 ✔
- JSelectUserByDept 根据部门选择用户 ✔
- JVxeTable
- 组件配置文档
- 自定义组件
- 封装自定义组件
- 自定义组件增强
- 多级联动配置
- 使用示例
- 常见问题解答
- JAreaLinkage 省市县联动组件 ✔
- JCategorySelect 分类字典树 ✔
- JImageUpload 图片上传 ✔
- JSelectMultiple 下拉多选 ✔
- JSelectRole 选择角色 ✔
- JFormContainer 表单组件禁用 ✔
- SuperQuery 高级查询
- UserSelect 高级用户选择组件
- Basic
- Page
- Authority
- PopConfirmButton
- CollapseContainer
- ScrollContainer
- LazyContainer
- CodeEditor
- JsonPreview
- CountDown
- ClickOutSide
- CountTo
- Cropper
- Description
- FlowChart
- Upload
- Tree
- Excel
- Qrcode
- Markdown
- Loading
- Tinymce
- Time
- StrengthMeter
- Verify
- Transition
- VirtualScroll
- ContextMenu
- Preview
- Loading
- 前端权限
- 表单权限
- 显隐控制 ✔
- 禁用控制 ✔
- 列表权限
- 按钮权限控制
- 列字段显隐控制
- 行编辑组件权限
- 显隐控制
- 禁用控制
- 代码生成
- Online在线代码生成
- GUI代码生成
- 代码生成模板介绍
- vue3和vue3Native详细说明
- 深入开发
- 定义Form新组件
- 自定义列表查询
- 自定义表单布局
- 开发笔记
- 组件权限控制
- 使用Antd Vue原生Form
- 自定义图表组件
- 自定义渲染函数
- 如何编写mock接口
- 缓存用法
- 精简版代码制作
- 微前端(qiankun)集成
- 前端小技巧
- 表单整体禁用
- 弹框内下拉框错位
- 界面如何设置响应式
- 抽屉(Drawer)宽度自适应
- 生成菜单脚本
- Online表单
- Online常见问题
- Online表单配置
- 配置参数说明
- 系统标准字段
- 表单类型-主子表|树表
- 自定义查询配置
- Online表单风格
- Online表单删除说明
- Online联合查询配置
- online表单视图功能说明
- Online表单开启评论
- Online表单控件介绍
- 常用基础控件
- 高级关联记录
- Online表单控件配置
- 基本配置
- 控件扩展配置
- 默认值表达式
- 自定义查询配置
- 字段href
- 默认值(填值规则)
- 导入导出自定义规则
- Online表单权限配置
- 字段权限配置与授权
- 按钮权限配置与授权
- 数据权限配置与授权
- 联合查询数据权限规则说明
- 在线增强
- 自定义按钮
- SQL增强
- JS增强
- 按钮触发JS增强
- 列表Api
- 列表操作列前置事件
- 表单Api
- beforeSubmit事件
- loaded事件
- 表单值改变事件【单表/主表】
- 表单值改变事件【从表】
- 表单值改变事件【从改主】
- 控制字段显示与隐藏
- js增强实现下拉联动
- js增强控制下拉树数据
- JS增强 触发弹窗
- JS增强 http请求
- JS增强 方法定义
- 对接表单设计器后需注意
- JAVA增强
- 快速开始
- Online java增强 导入
- Online java增强 导出
- Online java增强 查询
- Online Java增强 http-api
- 表单类
- 列表类
- 其他功能示例
- 导入数据库表支持排除表
- 通过字段Href实现三级联动
- excel数据导入支持校验
- Online报表
- Online报表配置
- 配置成菜单
- 其他功能
- 推送消息
- ISO 8601书写格式
- 系统消息跳转至详情表单
- 菜单【批量申请(自定义)】功能说明
- Online自动化测试
- online AI自动化测试数据制作
- Online AI自动化测试数据制作
- Online AI模型测试用例功能详情
- JAVA后台功能
- saas多租户切换
- 新功能实现saas租户隔离
- 第三方集成
- 敲敲云集成钉钉