The RenderNotification Mixin should documented with an example
--------------------------------------------------------------

                 Key: TAP5-1707
                 URL: https://issues.apache.org/jira/browse/TAP5-1707
             Project: Tapestry 5
          Issue Type: Improvement
          Components: tapestry-core
    Affects Versions: 5.3
            Reporter: Steve Eynon
            Priority: Trivial


The RenderNotification Mixin seems to be an idiomatic way to generate render 
phase 'like' events during an Ajax rendering. But alas the concept is a tricky 
one with a couple of gotchas and could really do with a worked example (in the 
JavaDocs) to fully explain its usage.

The email thread is :

http://tapestry.1045711.n5.nabble.com/T5-2-Looking-For-A-RenderNotification-Mixin-Example-td4917771.html

I've picked out some relevant bits...

I would like some pre and post render events to be fired on a component after 
it's handled an Ajax event and returned a Zone which it contains.

<div t:type="Zone" id="zone">
       <div t:type="Any" t:mixins="RenderNotification">
               <!-- zone content ->
       </div>
</div>

When the Any component renders as a whole, it receives the render phase methods 
which are picked up the Mixin. The Mixin then fires its own component events 
with the same name, which  bubble up the component hierarchy.

But the beforeRender and afterRender triggered by this mixins are not render 
events, so they should be handled by onBeforeRender[FromComponentId] and 
onAfterRender[FromComponentId] methods or @OnEvent(value = "afterRender", 
component = "id"). In both cases, the component id is optional.

Nice one - I may have overlooked the onBeginRender() vs beginRender().


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Reply via email to