Skip to content

Commit

Permalink
Set in stone in spec
Browse files Browse the repository at this point in the history
  • Loading branch information
BalusC committed Oct 28, 2023
1 parent 0bc83fd commit 7236717
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 30 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -148,11 +148,11 @@
<p class="changed_added_2_0">A String <span class="changed_modified_2_2">or
ValueExpression (that evalulates to a String)</span> identifying the type of event
the Ajax action will apply to. If specified, it must be one of the
events supported by the component the Ajax behavior is being applied to.
events supported by the component the Ajax behavior is being applied to <span class="changed_added_5_0">as per <code>ClientBehaviorHolder#getEventNames()</code></span>.
For HTML components this would be the set of supported DOM events for the
component, plus "action" for Faces ActionSource components and "valueChange"
for Faces EditableValueHolder components. If not specified, the default
event is determined for the component. The DOM event name is the actual DOM
event is determined for the component <span class="changed_added_5_0">via <code>ClientBehaviorHolder#getDefaultEventName()</code></span>. The DOM event name is the actual DOM
event name (for example: "click") as opposed to (for example: "onclick").</p>
Expand Down
45 changes: 17 additions & 28 deletions impl/src/main/resources/com/sun/faces/standard-html-renderkit.xml
Original file line number Diff line number Diff line change
Expand Up @@ -29,33 +29,6 @@
standard HTML RenderKit. Please see the spec for additional
details for the standard render-kit.
<div class="changed_added_2_0">
<p>The following new renderers have been
added in this release of the specification.</p>
<dl>
<dt>jakarta.faces.Output</dt>
<dd>jakarta.faces.Body
</dd>
<dd>jakarta.faces.Head
</dd>
<dd>jakarta.faces.resource.Script
</dd>
<dd>jakarta.faces.resource.Stylesheet
</dd>
<dd>jakarta.faces.Composite
</dd>
</dl>
</div>
<p><a name="general_decoding">General</a> notes on decoding</p>
<ul>
Expand Down Expand Up @@ -191,11 +164,13 @@
rendered content. Components may obtain script from multiple sources. Event handler scripts may be specified
by page authors, scripts may be produced by client behaviors and renderers may produce ther own scripts.
When multiple scripts are present, the scripts must be chained together in this order:
</p>
<ul>
<li>User specified event handler scripts</li>
<li>client behavior scripts</li>
<li>renderer specific scripts</li>
</ul>
<p>
If any of the scripts in the chain returns <code>false</code>, subsequent script must not be executed.
The specification provides a utility function <code>faces.util.chain</code> to handle this capability. If there
are <code>UIParameter</code> children the parameter names and values must be passed into the client behavior
Expand All @@ -205,7 +180,7 @@
</div>
<div class="changed_added_2_2">
<p><a name="general_behavior_encoding">Rendering</a> Pass Through Attributes.</p>
<p><a name="pass_through_attributes">Rendering</a> Pass Through Attributes.</p>
<ul>
Expand Down Expand Up @@ -233,6 +208,20 @@
</ul>
</div>
<div class="changed_added_5_0">
<p><a name="behavior_event_attributes">Rendering</a> Behavior Event Attributes.</p>
<ul>
<p>
When the component is an instance of <code>ClientBehaviorHolder</code>
and the attribute name starts with 'on'
and the substring after 'on' is contained in <code>ClientBehaviorHolder#getEventNames()</code>
and it is not available as a <em>renderer specific attribute</em>,
then it must be rendered the same way as a <em>pass through attribute</em>.
</p>
</ul>
</div>
</ul>]]></description>
<renderer>
Expand Down

0 comments on commit 7236717

Please sign in to comment.