JSF 1.2 日历组件属性窗口

另请参见

在使用可视设计器编辑的某个页面上选择日历组件 时，将显示该组件的“属性”窗口。

日历组件的大多数属性既是 JSP 属性，又是页面 Bean 中 Calendar Java 组件的属性。

此 JavaServer Faces 1.2 组件具有以下属性。

常规

• id。类型：字符串
  页面 Bean 和 JSP 文件中的日历组件的名称。

外观

• columns。类型：整型
  用于呈现组件的字符列数。缺省值为 20。
• dateFormatPattern。类型：字符串
  用户要输入的日期的格式。通常没有必要设置此属性，因为系统会自动根据语言环境来选择模式。

  如果要指定日期格式，请单击该属性右侧的省略号按钮 (...)，并从属性编辑器的列表中选择预定义的日期格式。您还可以添加自己的格式。如果要添加格式，可输入的值仅限于 yyyy（表示年）、MM（表示月）和 dd（表示日）的某种组合，这三者之间用分隔符进行分隔。分隔符通常包括 /（斜杠）、.（句点）和 -（破折号）。例如，以下日期格式可接受：

  • MM/dd/yyyy
  • yyyy.MM.dd
  • dd-MM-yyyy
• dateFormatPatternHelp。类型：文本
  出现在日期输入字段下面并显示日期输入字段所接受的格式模式的文本。如果未设置 dateFormatPattern 属性，系统会自动为您选择帮助文本。如果已设置 dateFormatPattern 属性，则应将 dateFormatPatternHelp 属性绑定到一个本地化字符串，该字符串与要支持的每种语言环境的设置相匹配。
• label。类型：字符串
  在文本输入字段旁边显示的标签，通常描述用户应输入的内容。
  • label 属性不像标签组件那样灵活。如果要对标签的外观进行更多控制（如相对于组件定位标签），则可以使用标签组件。
• labelLevel。类型：整型
  影响标签外观的数值。1（强），较大并以粗体显示。2（中），为缺省值，较小并以粗体显示。3（弱），较小并正常显示（非粗体）。仅当设置了标签属性时，该属性才会生效。
• style。类型：字符串
  要应用到组件中的层叠样式表规则（CSS 级别 2）。例如：

     position: absolute; left: 288px; top: 312px

  您既可以直接输入值，也可以单击省略号 (...) 按钮以使用样式编辑器。

  • 此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效，其原因是组件区域被具有不同样式设置的子组件遮盖住了。

  有关 CSS2 样式属性的列表，请参见以下 Web 页：
  

• styleClass。类型：字符串
  呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...)，将会看到一个列表，其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息，请参见 CSS 编辑器。
  • 有关已添加到此属性中的类为何没能对组件产生影响的说明，请参见上文中的 style 属性描述。
  • 如果将当前主题中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类，则所做更改会影响到使用此样式类的所有组件。但是，您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中，随后在将这些类添加到此属性时，所做更改只影响此组件的实例。

数据

• maxDate。类型：java.util.Date
  用户可以选择的最晚日期。缺省值为 selectedDate 属性值以后时间间隔为 100 年的日期，或者，如果未设置此属性，则缺省值为当前日期以后时间间隔为 100 年的日期。
• minDate。类型：java.util.Date
  用户可以选择的最早日期。缺省值为 selectedDate 属性值以前时间间隔为 100 年的日期，或者，如果未设置此属性，则缺省值为当前日期以前时间间隔为 100 年的日期。
• required。类型：布尔型
  如果选定，则用户必须输入日历的值，然后才能提交页面。如果将消息组件添加到页面并将其 for 属性链接到此组件，则当用户尝试在不输入值的情况下提交页面时，屏幕将显示一条错误消息。
• selectedDate。类型：日期
  表示用户所选的日历日期的 java.util.Date 对象。如果右键单击该组件，并选择“绑定到数据”，则可以将此属性绑定到数据提供器或对象，以便在服务器上处理用户输入的值。

  最初显示该组件时，如果未设置此属性，则其值缺省为当前日期。如果提供了 minDate 和 maxDate 值，您也可以为该属性提供一个值，该属性值最初会显示一个介于该范围的日期。

• validatorExpression。类型：方法表达式
  指示提交值时使用的 JavaServer Faces 验证器表达式。验证器可确保用户输入的值正确。如果不满足验证器定义的条件，验证器将发送一条可以在消息组件中显示的消息。

  可以从下拉列表中选择一个验证器。如果选择 (null)，则不会调用任何验证器。如果选择了验证器，则还需要选择 required 属性以确保用户输入值。

  • 例如，可通过右键单击组件并选择“编辑事件处理程序”> "validate" 来定义您自己的 validate 方法。如果您定义了自己的方法，则会覆盖可能已在此属性中设置的任何值。

行为

• disabled。类型：布尔型
  如果选定，则表示该组件应从不接收焦点或包含在提交中。当该组件不适用于页面时，可以使用此属性。请参见 readOnly 属性下面有关使用 disabled 属性与使用 readOnly 属性的效果对比说明。
• readOnly。类型：布尔型
  如果选定，则用户无法输入值，但仍可以提交组件值。当该组件适用但不可更改时，可以使用此属性。
  • 在提交页面时将包含 readonly 字段，这一点与 disabled 字段恰好相反，在提交页面时是不包含 disabled 字段的。如果您使用 disabled 属性，JavaServer Faces 根本检测不到提交的任何值。
• toolTip。类型：字符串
  为日期输入字段设置 HTML title 属性。如果用户将鼠标光标悬停在输入字段上，则会显示此属性的文本值。
  • 如果禁用该组件，则在大多数浏览器中将不显示工具提示。
• visible。类型：布尔型
  指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下，将选定此属性。如果取消选择此属性，则组件的 HTML 代码将呈现在页面上，但该组件在浏览器中不可见，因为它被样式设置隐藏了。由于 HTML 代码呈现出来，因此在提交表单时仍然可以处理组件，而且在浏览器中查看源代码的用户可以看到 HTML 代码。此外，您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
  • 如果需要完全隐藏组件（例如，由于它包含某些用户不应该看到的敏感信息），请取消选择 rendered 属性。

辅助功能

• tabIndex。类型：字符串
  （可选）按文档的 Tab 键顺序指定日历的位置，从而确定当用户使用 Tab 键在文档中移动时组件成为焦点的时间。该值必须为 0 至 32767 之间的整数。

JavaScript

• onBlur。类型：字符串
  组件失去焦点时执行的 JavaScript。
• onChange。类型：字符串
  组件失去焦点以及获得焦点后其值被修改时执行的 JavaScript。
  • 注意：只有在用户将值键入到日历的文本输入字段时，onChange 才触发。当用户从弹出式日历中选择值时不会触发。
• onClick。类型：字符串
  用户单击组件时执行的 JavaScript。
• onDblClick。类型：字符串
  用户双击组件时执行的 JavaScript。
• onFocus。类型：字符串
  组件获得焦点时执行的 JavaScript。
• onKeyDown。类型：字符串
  组件具有焦点并按下某个键时执行的 JavaScript。
• onKeyPress。类型：字符串
  组件具有焦点并按下及释放某个键时执行的 JavaScript。
• onKeyUp。类型：字符串
  组件具有焦点并释放某个键时执行的 JavaScript。
• onMouseDown。类型：字符串
  在鼠标光标位于组件上方且用户按下鼠标按钮时执行的 JavaScript。
• onMouseMove。类型：字符串
  用户在组件中移动鼠标光标时执行的 JavaScript。
• onMouseOut。类型：字符串
  在鼠标光标位于组件上方后用户将其从组件移开时执行的 JavaScript。
• onMouseOver。类型：字符串
  用户将鼠标光标移动到组件上方时执行的 JavaScript。
• onMouseUp。类型：字符串
  鼠标光标位于组件上方且用户释放鼠标按钮时执行的 JavaScript。
• onSelect。类型：字符串
  用户选择组件中的文本时执行的 JavaScript。
  • 注意：只有在日历的文本输入字段中选择值时，onSelect 才触发。如果键入一个值并在文本字段中选择它，或者从弹出式日历中选择一个值，然后使用鼠标在文本字段中选择它，此事件将会触发。

  高级

  • immediate。类型：布尔型
    如果选定该属性，当用户在日历中输入完日期时，将先执行页面 Bean 中的代码，然后再执行验证、更新模型值等操作。实际上，代码在服务器中立即执行，然后返回该页面。获取此功能的一种更简单的方法是，将组件与虚拟表单关联起来，然后右键单击该组件并选择“更改时自动提交”。
  • rendered。类型：布尔型
    如果选定该属性，将在任何后续页提交中呈现和处理日历。如果未选定该属性，日历则不会出现在页面中，甚至不作为隐藏组件出现。

  事件

  要设置事件属性，请在可视设计器中右键单击组件，然后选择“编辑事件处理程序”> "<事件名称>"。

  • valueChange。表示在更改组件值时调用的组件值更改侦听程序方法的名称。要在页面 Bean 中定义此方法，通常可以在“导航”窗口中右键单击组件，然后选择“编辑事件处理程序”> "processValueChange"。该方法的缺省名称为 component-id_processValueChange，其中 component-id 是 id 属性的值。
  • validate。表示为验证组件值而调用的方法的名称（如果存在）。如果要编写 validate 方法代码，请在“导航”窗口中右键单击该组件，然后选择“编辑事件处理程序”> "validate"。该方法的缺省名称为 component-id_validate，其中 component-id 是组件的 id 属性的值。

  另请参见

  日历组件

  使用组件

  组件任务：快速参考

  ---

  法律声明