Editing the PrimaryClientAction Attribute

To edit the primaryClientAction attribute for a client action enabled component:

In the UIX Visual Editor or Design Structure Window of the desired file, select the component you wish to edit.
In the Property Inspector, click in the right column of the primaryClientAction attribute, then click the icon to enter the clientAction to fire.
The PrimaryClientAction dialog displays.
Set the following client action attributes for the client action enabled component in the primaryClientAction tab:

event - Enter the name of the event to generate in the Action Event field. Default is update.
formSubmitted - Select the Fire action by submitting Form checkbox to use form submission to fire the event.
unvalidated -Select the Don't validate page before firing checkbox to disable client side validation when the action is invoked. Note that the formSubmitted attribute takes precedence over this attribute.
parameters - In the Action Parameters section, enter any arbitrary parameter you wish to send with the form in a partial page update event. For each event parameter that you add, you must also set a formValue element. See Inserting a FormValue.
targets - (For firePartialAction only). Select the Fire Partial Targets checkbox to specify the components (partial targets) to update. In the Component to Update area, select the partial targets for updating. Only those components whose ID is set will appear in this area.
triggerText - (For firePartialAction only). In the Trigger Text field, enter the text to render in the trigger button or link when partial page rendering is not supported on the target browser. If no text is specified, then a localized version of the 'Go' button will be rendered.
source - (For fireAction only). Enter the name to send as the source parameter when the event is delivered. If this attribute is not set, the ID of the component to which the action is attached will be sent. If the ID is not set, the value of the name attribute of the parent component will be sent.

To use data binding to specify the complex attribute, click the Advanced tab. You can either enter an EL syntax data binding expression or click next to the expression field to use the Bind to Data dialog to select a data source.

Note: To use data binding, see also Data Binding a Component Attribute.

Example (UIX XML)


...
<link text="Client action enabled link">
  <primaryClientAction>
    <!-- client actions here -->
    <firePartialAction event="anyEvent"
                       formSubmitted="true"
                       targets="someTargetId">
      <parameters>
        <parameter key="keyone" value="keyvalue1"/>
        <parameter key="keytwo" value="keyvalue2"/>
      </parameters>
    </firePartialAction>
  </primaryClientAction>
</link>
...