actionSource (Jakarta Faces 4.1.0 VDL Documentation)

All Tags

Description:
Declares that the composite component whose contract is declared by the <cc:interface> in which this element is nested exposes an implementation of ActionSource suitable for use as the target of attached objects in the using page. Any attached objects suitable for implementations of ActionSource may be attached to the composite component. Consider this excerpt from the using page:

<ez:loginPanel id="loginPanel" model="#{bean}">

<f:valueChangeListener for="username"

binding="#{bean.useridValueChangeListener}" />

<f:actionListener for="loginEvent"

binding="#{bean.loginEventListener}" />

<f:actionListener for="cancelEvent"

binding="#{bean.cancelEventListener}" />

<f:actionListener for="allEvents"

binding="#{bean.allEventsListener}" />

</ez:loginPanel>

The <f:actionListener> elements on lines 4, 7, and 10 refer to the attached objects declared on lines 2, 3 and 4 below.

<cc:interface name="loginPanel">

<cc:actionSource name="loginEvent" />

<cc:actionSource name="cancelEvent" />

<cc:actionSource name="allEvents" targets="loginEvent cancelEvent" />

</cc:interface>

Most of the concepts from example content from <cc:valueHolder> also applies in the case of <cc:actionSource>.

Please see <cc:interface> for a usage example.

Attributes
Name	Required	Type	Description
`name`	`true`	`jakarta.el.ValueExpression` (must evaluate to `java.lang.String`)	The value of this attribute maps back to the "for" attribute on an attachable object nested within a composite component. If the "targets" attribute is not specified, this value also represents the component ID of the target component within the that the `<cc:implementation>` ActionListener should be mapped to.
`targets`	`false`	`jakarta.el.ValueExpression` (must evaluate to `java.lang.String`)	If present, this must be a space (not tab) separated list of client ids (relative to the top level component) of components within the `<cc:implementation>` section. Space is used as the delimiter for compatibility with the IDREFS and NMTOKENS data types from the XML Schema.
`hidden`	`false`	`jakarta.el.ValueExpression` (must evaluate to `boolean`)	The "hidden" flag is used to identify features that are intended only for tool use, and which should not be exposed to humans.

All Tags