.ts 前端脚本文件

.ts 是推荐使用的前端脚本源码形式，运行目标是浏览器端。开发者可以用 TypeScript 语法编写页面、应用、项目或系统级的个性化逻辑，系统会在运行前编译为浏览器可执行的 JavaScript。

前端 .ts 脚本常用于页面组件交互、页面级工具函数、应用级公共逻辑、系统或项目级钩子脚本。页面级脚本通常与页面元数据同目录并同名，例如 order.spg 对应 order.spg.ts；应用或项目级钩子脚本通常使用 custom.ts。

常见位置

位置	说明
/{project}/app/{app}.app/custom.ts	应用级前端脚本，作用于应用内用户页面。
/{project}/public/custom.ts	项目级前端脚本，作用于项目内用户页面。
/sysdata/public/custom.ts	系统级前端脚本，作用于系统页面或全局页面。
*.spg.ts、*.dash.ts、*.rpt.ts、*.fapp.ts	页面或资源关联的前端脚本，通常与对应元数据文件同目录。

编辑注意事项

1. 优先维护 .ts 源文件，不要同时手工改同名 .js 编译产物。
2. .ts 面向浏览器运行，不能直接使用后端 Rhino、JVM 或服务器专用 API。
3. 被 .html 或 .ftl 页面加载的同目录脚本，需要确认最终加载路径，可参考 HTML 和 FTL 自定义页面。
4. 引用元数据结构时，先阅读对应文件类型页和 DTS，避免只按字段名猜测。
5. 修改后需要在浏览器端验证页面加载、交互动作和控制台错误。

相关参考

• 脚本开发
• 脚本文件的组织
• HTML 和 FTL 自定义页面
• types/api/succ.bo.d.ts