logologo
开始
手册
开发
插件
API
English
简体中文
开始
手册
开发
插件
API
English
简体中文
logologo
概述

区块

概述

数据区块

表格
表单
详情
列表
网格卡片
图表

筛选区块

表单

其他区块

操作面板
Iframe
引用区块
Markdown
JS Block

区块设置项

数据范围
布局
区块联动规则
字段联动规则
排序规则
区块删除
区块标题

字段

概述

通用配置项

表格字段
详情字段
筛选表单字段
表单字段

特有配置项

日期
文件管理器
子表单
下拉选择器
数据选择器
子表格
子详情
标题
JS Field
JS Item
JS Column

字段配置项

默认值
字段标签
显示标签
字段提示信息
数据范围
字段组件
数值格式化
模式
必填
标题字段
验证规则
关系字段组件

操作

概述

操作配置项

编辑按钮
二次确认
字段赋值
绑定工作流
编辑弹窗
操作联动规则

操作类型

新增
查看
删除
编辑
导入
导入Pro
导出
导出pro
导出附件
筛选
链接
打开弹窗
刷新
提交数据
触发工作流
更新记录
批量更新
JS Action
操作权限

进阶

联动规则
事件流
变量
RunJS
Previous Page变量

#在线编写 & 运行 JS

在 NocoBase 中,RunJS 提供了一种轻量级的扩展方式,适合 快速实验、临时逻辑处理 的场景,无需创建插件或修改源码,即可通过 JavaScript 实现界面或交互的个性化定制。

通过它,你可以直接在界面设计器中输入 JS 代码,实现:

  • 自定义渲染内容(字段、区块、列、项等)
  • 自定义交互逻辑(按钮点击、事件联动)
  • 结合上下文数据,实现动态行为

#支持的场景

#JS 区块

通过 JS 自定义渲染区块,可完全控制区块的结构与样式。
适合展示自定义组件、统计图表、第三方内容等高度灵活的场景。

20250916105031

文档:JS 区块

#JS 操作

通过 JS 自定义操作按钮的点击逻辑,可执行任意前端或 API 请求操作。
例如:动态计算值、提交自定义数据、触发弹窗等。

20250916105123

文档:JS 操作

#JS 字段

通过 JS 自定义字段的渲染逻辑。 可根据字段值动态显示不同样式、内容或状态。

20250916105354

文档:JS 字段

#JS 项

通过 JS 渲染独立项,不绑定具体字段。常用于展示自定义信息块。

20250916104848

文档:JS 项

#JS 表格列

通过 JS 自定义表格列的渲染。
可实现复杂的单元格展示逻辑,如进度条、状态标签等。

20250916105443

文档:JS 表格列

#Linkage rules(联动规则)

在表单或页面中通过 JS 控制字段间的联动逻辑。
例如:当一个字段变化时动态修改另一个字段的值或可见性。

20251029114532

文档:联动规则

#Eventflow(事件流)

通过 JS 自定义事件流的触发条件与执行逻辑,构建更复杂的前端交互链路。

文档:事件流