主体组件属性窗口
另请参见
在“导航”窗口 中选择主体组件时,将显示该组件的“属性”窗口。此组件具有以下属性。
常规
id。 类型:字符串
页面 Bean 和 JSP 文件中主体组件的名称。
外观
imageURL。 类型:字符串
将作为页面背景显示的图像的 URL 或文件名。单击省略号 (...) 按钮可输入 URL 或导航至图像文件。
导航至某个文件后,请选择该文件并单击“确定”。此时,在页面上将会显示该图像。图像文件将被复制到项目中,您可以在“项目”窗口 中的 "<项目名称> " >“Web 页”> "resources" 下面看到该文件。
style。 类型:字符串
要应用到主体组件中的层叠样式表规则(CSS 级别 2)。例如:
background-color: aqua;
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器 。
此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
如果直接编辑这些值,注意不要删除 -rave-layout:grid 样式。此样式指示页面是处于网格模式,还是处于流模式。通常,缺省网格模式是用于排列页面上组件的最有用的设置。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
styleClass。 类型:字符串
呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器 。
有关已添加到此属性中的类为何没能对组件产生影响的说明,请参见上文中的 style 属性描述。
如果将当前主题 中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类,则所做更改会影响到使用此样式类的所有组件。但是,您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中,随后在将这些类添加到此属性时,所做更改只影响此组件的实例。
行为
focus。 类型:字符串
指定在装入页面时获取焦点的组件。您可以从下拉列表中选择一个组件。如果未选定 preserveFocus (false),则 focus 属性将控制每次呈现页面时接收焦点的元素。
preserveFocus。 类型:布尔型
确定在提交页面时此页面的焦点(在页面第一次显示之后)是否将设置为具有此焦点的元素。如果未选定该属性 (false),则焦点不会重置为选定元素。
visible。 类型:布尔型
指示用户能否在呈现 HTML 页面时看到主体页面。如果取消选择此属性,则主体的 HTML 代码将呈现在页面上,但该主体在浏览器中不可见,因为它被样式设置隐藏了。由于 HTML 代码呈现出来,因此在浏览器中查看源代码的用户可以看到 HTML 代码。此外,您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏主体。
如果需要完全隐藏主体(例如,由于它包含某些用户不应该看到的敏感信息),请取消选择 rendered 属性。
JavaScript
onBlur。 类型:字符串
主体失去焦点时执行的 JavaScript。
onClick。 类型:字符串
用户单击主体时执行的 JavaScript。
onDblClick。 类型:字符串
用户双击主体时执行的 JavaScript。
onFocus。 类型:字符串
主体获得焦点时执行的 JavaScript。
onKeyDown。 类型:字符串
主体具有焦点并按下某个键时执行的 JavaScript。
onKeyPress。 类型:字符串
主体具有焦点并按下及释放某个键时执行的 JavaScript。
onKeyUp。 类型:字符串
主体具有焦点并释放某个键时执行的 JavaScript。
onLoad。 类型:字符串
将页面装入浏览器时执行的 JavaScript。
onMouseDown。 类型:字符串
鼠标光标停留在主体上方且用户按下鼠标按钮时执行的 JavaScript。
onMouseMove。 类型:字符串
用户在主体中移动鼠标光标时执行的 JavaScript。
onMouseOut。 类型:字符串
鼠标光标位于主体上方之后用户将其从主体上移开时执行的 JavaScript。
onMouseOver。 类型:字符串
用户将鼠标光标移动到主体上方时执行的 JavaScript。
onMouseUp。 类型:字符串
鼠标光标停留在主体上方且用户释放鼠标按钮时执行的 JavaScript。
onUnLoad。 类型:字符串
当用户退出页面并从浏览器中卸载页面时执行的 JavaScript。
高级
rendered。 类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理主体组件。如果未选定该属性,则根本不会显示 <body> 标记及其内容(页面内容)。
另请参见
头组件
使用组件
组件任务:快速参考
法律声明