JSP 库定义编辑器用于配置关于如何将新 JSP 库合并到项目中的详细信息。
以下详细描述了如何设置 Web 项目以使用新的组件库。该配置声明如何将文件复制到 Web 项目中以及必须进行的配置更改,以使组件正常工作。
“标记库”列示构成该库的所有定制标记并允许对工具行为进行配置。例如,您可以指定标记在“选用板”中的外观、将标记拖到编辑器上时的行为、组件在 Web 页面源中的视觉外观以及关于标记属性和数据绑定的各种详细信息。
您可以配置有关在组件库中的标记的详细信息。生成库定义时,它包含组件库中的所有标记。您可以使用上移和下移按钮来更改标记的顺序 . 指定的标记顺序将显示在“选用板”中库的外观内。
可以配置库选用板类别的一些视觉相关信息。 在这里配置适用于库中所有标记的任何样式表链接或 JavaScript 引用。从选用板中添加标记时,会将相应的 <link> 和 <script> 标记添加至 Web 页面。
可视化模式用于控制页面编辑器的设计窗格中的组件外观。该模式由 HTML 标记和一些可选替换变量组成以动态改变可视化内容。将组件拖到页面上时,将对相应的模式进行评估。 页面编辑器使用所产生的 HTML 来创建有用的设计时说明。 可用模式变量的详细信息显示在表 1 中。
变量 | 描述 | 示例 |
---|---|---|
${children} | ${children} 变量在模式中 ${children} 变量的位置处发出正在可视化的标记的所有子标记(如果有)。将按照子标记出现在原始页面中的顺序插入这些子标记。页面编辑器计算子标记的可视化,因为它们还可以使用模式。由于将所有子标记都插入在相同位置,所以模式只能使用一个 ${children} 变量。 |
|
${children:row} | ${children} 变量的 row 修饰符按照 HTML 表单元格 <td> 元素的顺序发出子标记。 当您要水平编排多个组件时,请使用此变量。 |
|
${children:grid(param[,param]*)} | grid 修饰符会创建一组包含标记的子代的 HTML 表行和单元格。 这些子代按照从左到右的顺序添加并在达到指定的列数时回绕至下一行。缺省列计数为 2。可选的以逗号分隔的参数列表会覆盖网格中的列数。 参数选项为:
按顺序检查参数,直到找到有效值为止。例如,模式 ${children:grid(attr.size, attr.numcols, 3)} 将使用标记的 size 属性(如果已定义),否则将使用 numcols 属性(如果已定义)。如果未定义这两个属性,那么将使用常量 3。 |
|
${children:stack(param)} | stack 修饰符用在选项卡式面板中,以创建用于填充堆栈化单元格可视化的表行和单元格。它会创建一个标签的水平表(可以对每一个子标记单击)。单击其中一个标签会将子标记的可视化放在堆栈顶部。可选参数通过使用 attr.attrName 语法来指定用于该标签的子标记的标记属性。 |
|
${attr:attrName} | 此变量会取代模式中当前位置的标记的属性值。如果该属性未设置值,那么将插入一个空字符串。 |
|