定制 HTML

通过使用定制 HTML 项,可将 HTML 代码添加到 Coach 或 Coach 视图。

定制 HTML 项包含一组或多组 HTML 元素,如 <div><label> 标记。 通过使用受管文件或变量,您可以将 HTML 代码直接作为文本添加。定制 HTML 项会将元素插入到 Coach 或 Coach 视图的 <div> 标记内。如果您正在容器(例如,表、选项卡、水平部分和垂直部分常用控件)中使用定制 HTML 项,那么请将 HTML 代码合并到 <div> 标记中。通过合并 HTML 代码,容器会将所有 HTML 代码视为单个实体。
限制: 如果定制 HTML 项处于表或部分等重复控件中,请不要将其绑定到作为列表项内属性的变量。通常,在创建页面时,代码生成器会将定制 HTML 内容作为 HTML 代码插入。但是,重复的控件已被绑定到列表。因为只有在运行时才会设置列表内容,所以代码生成器在创建页面时无法确定该列表中的变量索引。如果需要动态变化的文本,请考虑使用绑定到变量的控件,如“输出文本”。
要点: 请勿使用以下名称作为 HTML 源代码中的 CSS 类名,因为它们是保留的名称:
  • CoachView
  • ContentBox

定制 HTML 项支持使用简单类型的 JavaScript 变量。当服务器为客户机生成 HTML 页面时,它用其值代替变量名称。但是,服务器生成页面后,如果值发生更改,它不会更新 HTML。仅当服务器重新生成整个 HTML 页面时,才会更新变量。如果服务器不解析变量,那么用户会看到变量名,而不是其值。

在代码中,将变量放入大括号中。对于 Coach,变量只能引用 tw.local 名称空间中的数据。即,变量可以引用本地节点下人员服务的“变量”页面中定义的数据。例如,Coach 具有一个带有包含用户名称的 name 参数的 user 业务对象变量。您可以使 Coach 在 HTML 项中显示具有以下代码的名称:
<div>Hello, {{tw.local.user.name}}.</div>
对于 Coach 视图,变量可以引用 tw.businessDatatw.options 名称空间中的数据。 即,变量可以引用“业务数据”或“配置选项”节点下视图的“变量”页面中定义的数据。例如,如果想要视图显示街道名称,那么可以将视图绑定至具有 street 参数的 address 业务对象。在 HTML 项中,添加以下代码:
{{tw.businessData.address.street}}
如果将该视图的实例放置到 Coach 中,那么用户会在视图中看到 street 参数的值。 但是,如果用户更新 street 参数,那么不会更新 HTML 项中的内容,直至服务器重新生成整个页面。
提示: 要插入脚本,请使用视图的“行为”页面上的内联脚本来添加脚本。请勿使用定制 HTML 项添加脚本。