配置 JSP 库定义
JSP 库定义
JSP 库定义编辑器用于配置关于如何将新 JSP 库合并到项目中的详细信息。
关于此任务
- 库名
- 库的名称。
- 描述
- 库描述。
- 标记库 URI
- 组件库的标记库 URI。
- 外线拨号前缀
- 提供给标记的前缀。
- 版本
- 版本号指示库定义中配置的级别。它表示何时有更新的资源可用于现有 Web 应用程序。最初创建库定义时,请为所选标记库选取一个有意义的版本。
例如,从公开可用标记库的发行版号开始。版本号的典型形式是以逗点分隔的字符串,例如 1.2.3.4。库定义正在使用中并且已在一个或多个 Web 应用程序中安装了标记库的资源之后,对定义的进一步更改可能需要版本更新。如果在已部署的库定义的应用程序配置部分中进行了任何更改,请增加版本号。增加的版本号向工作台指示有更新的资源或配置更改可用。使用该标记库的任何 Web 项目都会被标记为错误。与该错误相关联的快速修复可以使用当前配置更新 Web 项目。切记: 如果未将标记库添加至 Web 项目,那么不必增加版本号。将动态读取对“库定义”的任何区域(“应用程序配置”部分除外)所做的更改,因此不需要版本更改。
应用程序配置
以下详细描述了如何设置 Web 项目以使用新的组件库。该配置声明如何将文件复制到 Web 项目中以及必须进行的配置更改,以使组件正常工作。
关于此任务
- 资源
- 资源区域用于定义第一次使用库时要复制到 Web 项目的文件。源路径是 JSP 定义项目内某个文件的相对路径。 目标路径是项目中使用该库的位置的路径。例如,可能会向源路径 /mystylesheet.css 中的文件提供目标 /theme。 此目标路径会导致将 CSS 文件的副本放在 Web 项目的 /theme 文件夹中。
- web.xml 更新
- 此部分包含有关几种类型的修改的信息,这些修改针对使用该库的 Web 项目的部署描述符进行。 可以在编辑器的相应子部分中配置新 Servlet、上下文参数和过滤器。
- 要添加 Servlet、上下文参数或过滤器,请执行下列操作:
- 选择 web.xml。
- 单击添加,然后从对话框中选择项目。
- servlet
- 此页面定义要添加到 web.xml 的新 Servlet 的参数。
- 上下文参数
- 此部分记录用于在 Web 部署描述符中添加上下文参数的详细信息。在 Web 项目中第一次使用该库时,会修改 web.xml 文件以包括此信息。
- 过滤器
- 此部分定义一个新过滤器,该过滤器将添加到 web.xml 文件。
通过单击编辑器中的添加来添加此过滤器的初始化参数。
- 初始化参数
- 此页面收集 web.xml 过滤器定义的初始化参数的数据。
- URL 映射
- 此部分收集过滤器的任何基于 URL 的映射。
- servlet 映射
- 此部分收集基于 Servlet 名称的过滤器映射,该名称在 web.xml 中其他位置进行定义。
标记库
此部分列示构成该库的所有定制标记并允许配置有关工具行为的很多详细信息。例如,您可以指定标记在“选用板”中的外观、将标记拖到编辑器上时的行为、组件在 Web 页面源中的视觉外观以及关于标记属性和数据绑定的各种详细信息。
关于此任务
编辑器的此部分用于配置有关组件库中实际标记的详细信息。生成库定义时,它包含组件库中的所有标记。您可以使用上移和下移按钮来更改标记的顺序 . 指定的标记顺序将显示在“选用板”中库的外观内。
可以在此页面上配置库选用板类别的一些视觉相关信息。 在这里配置适用于库中所有标记的任何样式表链接或 JavaScript 引用。从选用板中添加标记时,会将相应的 <link> 和 <script> 标记添加至 Web 页面。
- Tag
- 此页面配置组件标记在选用板中的外观,其中包含图标和标签信息。缺省情况下,也可以隐藏该标记,或者将其从选用板选项中除去。
- 删除属性
- 此页面上的参数用于修改从选用板插入新标记时的行为。如果该组件是类似于容器的控件,并且允许其他组件作为子代,那么请选中允许子代。样式表链接和 JavaScript 引用可在此页面上按标记逐个指定。还可以对标记页面上的整个库实施样式表和 JavaScript 规范。
- 缺省标记特性
- 要设置标记的缺省特性值,请指定该特性的名称和值。从选用板添加组件标记时,将自动设置此特性值。
- 直观表示
- 对于许多组件,将正确呈示可视页面编辑器中的标记的显示。在某些情况下,标记呈现会彻底失败或显示不当。如果显示失败,那么该标记将显示为带有标记名的灰色框。当发生此问题时,您可以通过使用各种可变组合键指定基本 HTML 标记来定制标记的外观。此标记在页面编辑器中被用作替代可视化方式。
- 样本可视化模板可用,并且包括如何使用可变组合键的示例。要查看这些模板,请单击“详细信息”部分中的编辑。了解有关可视化模式变量的更多信息:
可视化模式用于控制页面编辑器的设计窗格中的组件外观。该模式由 HTML 标记和一些可选替换变量组成以动态改变可视化内容。将组件拖到页面上时,将对相应的模式进行评估。 页面编辑器使用所产生的 HTML 来创建有用的设计时说明。 可用模式变量的详细信息显示在表 1 中。
表 1. 可视化模式变量. 描述和示例提供了变量的相关信息。 变量 描述 示例 ${children} ${children} 变量在模式中 ${children} 变量的位置处发出正在可视化的标记的所有子标记(如果有)。将按照子标记出现在原始页面中的顺序插入这些子标记。页面编辑器计算子标记的可视化,因为它们还可以使用模式。由于将所有子标记都插入在相同位置,所以模式只能使用一个 ${children} 变量。 <div> ${children} </div>${children:row} ${children} 变量的 row 修饰符按照 HTML 表单元格 <td> 元素的顺序发出子标记。 当您要水平编排多个组件时,请使用此变量。 <table> <tr> ${children:row} </tr> </table>${children:grid(param[,param]*)} grid 修饰符会创建一组包含标记的子代的 HTML 表行和单元格。 这些子代按照从左到右的顺序添加并在达到指定的列数时回绕至下一行。缺省列计数为 2。可选的以逗号分隔的参数列表会覆盖网格中的列数。
参数选项为:- attr.attrName
- 名为 attrName 的标记特性的值。此参数必须解析为整数。
- N
- 正整数常量。
按顺序检查参数,直到找到有效值为止。例如,模式 ${children:grid(attr.size, attr.numcols, 3)} 将使用标记的 size 属性(如果已定义),否则将使用 numcols 属性(如果已定义)。如果未定义这两个特性,那么将使用常量 3。
<table> ${children:grid(attr.columns, 2)} </table>${children:stack(param)} stack 修饰符用在选项卡式面板中,以创建用于填充堆栈化单元格可视化的表行和单元格。它会创建一个标签的水平表(可以对每一个子标记单击)。单击其中一个标签会将子标记的可视化放在堆栈顶部。可选参数通过使用 attr.attrName 语法来指定用于该标签的子标记的标记特性。 <table> ${children:stack(attr.label)} </table>${attr:attrName} 此变量会取代模式中当前位置的标记的特性值。如果该特性未设置值,那么将插入一个空字符串。 <input type="text" value="${attr:value}" /> - 标记特性
- 您可以对每个标记指定特性描述和类型。列表中特性的顺序和每一个特性的类型会影响在“属性”视图中显示和编辑它们的方式。特定的类型指示一组可用选项或特定的帮助程序对话框,以帮助您设置特性值。
- “属性”视图
- 这个可选部分包含用户定义的“属性”视图页面的用户界面元素和布局信息。可将嵌套的子元素添加在“属性”视图部分下面以定义一个或多个选项卡的内容。
- Tab 键
- 选项卡包含它所包括的其他 UI 元素且对应于“属性”视图。选项卡名称显示在该视图中,并最初显示主要(第一个)选项卡。第一个选项卡始终具有所选标记的名称,因此将忽略第一个选项卡的名称特性的值。
- 栏
- “列”元素直观地将一组其他 UI 元素分组到一个垂直列。在“选项卡”或“部分”元素内定义了两个或多个列,并在每一个列内配置子控件。非列元素在使用列的容器内不受支持。您可能需要将部分中的多列编排分隔成它自己的区域。
- 编辑器
- “编辑器”元素定义:
- 显示在“属性”视图上的用户界面控件的类型,例如单选按钮。
- 用户界面控件修改的当前标记的特性。
- 显示在用户界面控件旁边的字符串标签。
- 编辑器参数
- 某些编辑器元素可以采用可选编辑器参数以定制控件的行为。例如,您可以使用选项参数(用于定义可允许的值)来配置组合框和其他类似的选择控件。 选项参数的值使用语法 enum{value1, value2, value3},或者如果在组合框中使用不同的标签和值时,它使用以下语法:enum{name1:value1, name2:value2}。 其他大部分预定义的编辑器参数都接受 true 或 false 值。
- 标签
- “标签”元素会在“属性”视图中放置一个包含文本信息的标签。
- 部分
- “部分”元素是一个用于定义 UI 的独立部分的容器。部分可用于提供用于缩放它们包含的控件的间隔的控件。例如,可以将某个部分配置成跨越环绕布局中多个列,或为它自己的内容定义新的列结构。
- 分隔符
- “分隔符”元素使用水平线来划分“属性”视图内容。