页项属性

页项属性指定当在 PageHandler 部件中声明项或数组时有意义的特征。

属性如下所示:

在下面的描述中,绑定属性是这样的属性:当 Page Designer 将项(或包含项的记录)放到 Web 页面上时,此属性的值起作用。Page Designer 可以覆盖该值,该值是缺省值。

action

action 属性是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。仅当项属性 displayUse 的值为 buttonhyperlink 时,此属性才有意义。

action 的值是指当用户单击按钮或超文本链接时调用的代码。

用于设置 action 的格式如下所示:
  action = actionValue
actionValue
下列其中一项:
  • 页面处理程序中的事件处理函数的名称
  • 一个标签,它映射至 Web 资源(例如,映射至 JSP)并与 JSF 应用程序配置资源文件中的导航规则条目的源 - 结果属性相对应
  • Java™ bean 中的方法的名称,在这种情况下,下列规则适用:
    • 格式为 bean 名称,后跟句点和方法名
    • 该 bean 名称必须与 JSF 应用程序配置资源文件中的其中一个受管 Bean 名称条目相关
如果未对 action 指定值,则用户对项的单击将具有下列作用:
  • 如果属性 displayUse 的值是 button,则会进行验证,然后 JSF 重新显示同一个 Web 页面。
  • 如果属性 displayUse 的值是 hyperlink,则不进行验证,但 JSF 重新显示同一个 Web 页面。

byPassValidation

byPassValidation 属性是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。仅当对表示命令标记(按钮或超链接)的项指定此属性时,此属性才起作用。Yes 指示在发生命令事件时要绕过验证。不将来自输入字段的数据返回至程序。

格式如下所示:
  byPassValidation = yesOrNo
yesOrNo
下列其中一个值:
  • No 是缺省值,它表示对项进行验证并且(如果有效的话)进行提交。
  • Yes 指示在发生命令事件时要绕过验证。

displayName

displayName 属性是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。此属性指定显示在项旁边的标签。

格式如下所示:
  displayName = "literal"
literal
一个加引号的字符串。

displayUse

displayUse 属性是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。此属性将项与用户界面控件相关联。

格式如下所示:
  displayUse = displayUse
displayUse
下列其中一个值:
  • button 表示控件具有按钮命令标记。
  • secret 表示数据对用户不可见;此值适用于密码。
  • hyperlink 表示当 action 属性是事件处理函数的名称时控件具有超链接命令标记;当 action 属性是标签时控件带有链接标记。当用户单击该链接时,不进行验证,也不返回输入数据。
  • input 表示控件接受用户输入;控件也可以显示由页面处理程序提供的值。
  • table 表示数据包含在表标记内。
  • output 表示控件是可见的输出字段。

help

help 属性是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。 此属性指定当用户将光标放到输入项上方时将显示的悬浮式帮助文本。

格式如下所示:
  help = literal
literal
一个加引号的字符串。

如果未对特定于项的 help 属性指定值,则 help 属性对包含该项的 pageHandler 部件起作用。有关详细信息,请参阅 EGL 源格式的 PageHandler 部件

newWindow

属性 newWindow 指示当 EGL 运行时显示 Web 页面以便响应 action 属性中标识的活动时,是否使用新的浏览器窗口。

格式如下所示:
  newWindow = yesOrNo
yesOrNo
下列其中一个值:
  • No 是缺省值,它表示使用当前浏览器窗口来显示页面。
  • Yes 表示使用新的浏览器窗口。

仅当指定了属性 action 时,属性 newWindow 才有意义;否则,使用当前浏览器窗口来显示下一页。

numElementsItem

属性 numElementsItem 是在静态数组变量或记录项中指定的,并且标识页面处理程序中的另一个项的名称。在运行时,页面处理程序设置该项以向 JSP 指示要显示的数组元素数目。此属性仅用于输出。

此属性对下列任何一项有意义:
  • 记录或数据项的静态数组
  • occurs 值大于 1 的结构项
格式如下所示:
  numElementsItem = "itemName"
itemName
页面处理程序项的名称,该项包含要显示的数组元素的数目。

因为每个动态数组都包含所使用的元素数目的指示符,所以属性 numElementsItem 对动态数组无效。有关详细信息,请参阅数组

selectFromListItem

属性 selectFromListItem(以前是 selectFromList 属性)是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。

此属性引用数组或表列,用户可从这些数组和表列中选择一个或多个值;并且,此属性指示正在声明的数组或项将接收数据以响应用户从该列表中进行的选择。

如果允许用户选择多个值,则对数组指定此属性。否则,对项指定此属性。

从用户那里接收到的值必须与下列其中一种类型相对应:
  • 用户选择的数组元素或表列的内容;或者
  • 数组下标或表索引,它是一个整数,并标识已选择的元素或列。索引范围是从 1 到可用的元素数目。

属性 selectType 指示要接收的值的类型,它可以是用户选择的内容,也可以是数组的下标或列的索引。

selectFromListItem 的格式如下所示:
  selectFromListItem = "listName"
listName
下列其中一个值,必须根据需要对此值进行限定以便完全地解析引用:
  • 任何类型的数组;或者
  • 表列,如 myTable.myColumn。

有关解析名称的详细信息,请参阅对部件的引用

selectType

selectType 属性是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。

此属性指示检索到正在声明的项中的值的类型。

格式如下所示:
  selectType = selectType
selectType
下列其中一个值:
  • index 是缺省值,它表示正在声明的数组或项将接收索引来作为对用户选择的响应。在这种情况下,该项必须具有数字类型。
  • value 表示正在声明的数组或项将接收用户的选择值以作为对用户选择的响应。在这种情况下,该项可以是任何类型。

有关背景知识信息,请参阅属性 selectFromListItem

validationOrder

属性 validationOrder 的值是一个整数,它指示项的验证器函数相对于任何其它项的验证器函数的运行时间。如果一个项的验证取决于另一个项的先前验证,则此属性很重要。

首先对任何被指定了 validationOrder 属性值的项进行验证,并且,首先验证具有最小数值的项。然后,对任何未指定 validationOrder 值的项进行验证,在这种情况下,验证顺序是项在页面处理程序中的定义顺序。

此属性的格式如下所示:
  validationOrder = integer
integer
一个文字整数,它指示该项相对于其它项的验证时间。

value

value 属性是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。此属性指定了一个字符串,当 Web 页面显示时,在用户更改值之前,此字符串作为项内容显示。

格式如下所示:
  value = "literal"
literal
一个加引号的字符串。

相关参考
数组

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.