通过使用定制 HTML 项,可将 HTML 代码添加到 Coach 或 Coach 视图。
定制 HTML 项包含一组或多组 HTML 元素,如
<div> 和
<label> 标记。
通过使用受管文件或变量,您可以将 HTML 代码直接作为文本添加。定制 HTML 项会将元素插入到 Coach 或 Coach 视图的
<div> 标记内。如果您正在容器(例如,表、选项卡、水平部分和垂直部分常用控件)中使用定制 HTML 项,那么请将 HTML 代码合并到
<div> 标记中。通过合并 HTML 代码,容器会将所有 HTML 代码视为单个实体。
限制: 如果定制 HTML 项处于表或部分等重复控件中,请不要将其绑定到作为列表项内属性的变量。通常,在创建页面时,代码生成器会将定制 HTML 内容作为 HTML 代码插入。但是,重复的控件已被绑定到列表。因为只有在运行时才会设置列表内容,所以代码生成器在创建页面时无法确定该列表中的变量索引。如果需要动态变化的文本,请考虑使用绑定到变量的控件,如“输出文本”。
要点: 请勿使用以下名称作为 HTML 源代码中的 CSS 类名,因为它们是保留的名称:
定制 HTML 项支持使用简单类型的 JavaScript 变量。当服务器为客户机生成 HTML 页面时,它用其值代替变量名称。但是,服务器生成页面后,如果值发生更改,它不会更新 HTML。仅当服务器重新生成整个 HTML 页面时,才会更新变量。如果服务器不解析变量,那么用户会看到变量名,而不是其值。
在代码中,将变量放入大括号中。对于 Coach,变量只能引用
tw.local 名称空间中的数据。即,变量可以引用本地节点下人员服务的“
变量”页面中定义的数据。例如,Coach 具有一个带有包含用户名称的
name 参数的
user 业务对象变量。您可以使 Coach 在 HTML 项中显示具有以下代码的名称:
<div>Hello, {{tw.local.user.name}}.</div>
对于 Coach 视图,变量可以引用
tw.businessData 或
tw.options 名称空间中的数据。
即,变量可以引用“业务数据”或“配置选项”节点下视图的“
变量”页面中定义的数据。例如,如果想要视图显示街道名称,那么可以将视图绑定至具有
street 参数的
address 业务对象。在 HTML 项中,添加以下代码:
{{tw.businessData.address.street}}
如果将该视图的实例放置到 Coach 中,那么用户会在视图中看到
street 参数的值。
但是,如果用户更新
street 参数,那么不会更新 HTML 项中的内容,直至服务器重新生成整个页面。
提示: 要插入脚本,请使用视图的“行为”页面上的内联脚本来添加脚本。请勿使用定制 HTML 项添加脚本。