kinlink

字段标签动态修改示例

标签修改系统概览

灵活的字段标签内容管理，实现多语言支持和动态文本更新

此示例演示如何使用kinlink API动态修改表单字段的标签文本内容。通过程序化标签控制，实现多语言切换、个性化标签和上下文相关的提示信息。

标签修改核心功能

  • 📝 文本内容更新：动态修改字段标签显示文本
  • 🌍 多语言支持：基于用户语言偏好切换标签
  • 🎯 个性化标签：根据用户角色显示不同标签
  • 🔄 上下文感知：基于表单状态动态调整标签内容
  • ⭐ 必填标记：自动添加或移除必填字段标识
  • 📱 响应式文本：适配不同屏幕尺寸的标签长度

关键功能

  • 监听表单加载完成事件

  • 通过setFieldLabelText方法修改字段标签文本

  • 错误处理与日志记录

代码示例

/**
* 示例1: 修改字段标签
* 功能：修改表单字段的标签显示文本
*/
(function () {
// 监听表单加载完成事件
kinlink.events.on(kinlink.FormEvents.FORM_LOADED, () => {
  try {
    // 修改字段标签文本
    kinlink.formApi.setFieldLabelText('文字列__1行__0', '姓（中文）');
    kinlink.formApi.setFieldLabelText('文字列__1行__1', '名（中文）');
    kinlink.formApi.setFieldLabelText('单行文本框_8', '姓（英文）');
    kinlink.formApi.setFieldLabelText('单行文本框_9', '名（英文）');
  } catch (error) {
    console.error('修改字段标签失败:', error);
  }
});
})();

使用说明

要使用此功能，只需将代码复制到您的kinlink自定义JavaScript中。根据您的表单字段，修改代码中的字段代码（如'文字列__1行__0'）和所需的新标签文本。

完整代码请下载查看：

1-修改字段标签.js

注意事项

请确保使用正确的字段代码，字段代码可以在表单设计器中找到。如果字段代码不存在，修改操作将不会生效。

API参考

此示例使用了以下kinlink API：

  • kinlink.events.on(eventName, callback) - 注册事件监听器

  • kinlink.FormEvents.FORM_LOADED - 表单加载完成事件

  • kinlink.formApi.setFieldLabelText(fieldCode, text) - 设置字段标签文本