Svein created TAP5-2581:
---------------------------
Summary: Javascript public API (interface/wrapper)
Key: TAP5-2581
URL: https://issues.apache.org/jira/browse/TAP5-2581
Project: Tapestry 5
Issue Type: Improvement
Components: tapestry-core
Affects Versions: 5.4.2
Reporter: Svein
I think Tapestry should expose JavaScript methods for "public" usage not to
break JavaScript code on upgrade. By using JSDoc (http://usejsdoc.org) users
will get warnings on code change in the IDE. Methods can be marked as
@deprecated etc. Method should be annotated @public (easier than mark all other
@private). @typedef makes code completion good and marks wrong parameters with
warning.
I am trying to use Tapestry without accessing its "internal" JavaScript
methods, but sometimes it's reasonable to access them directly. The new way of
accessing server-side events with @PublishEvent and t5/core/ajax will result
to that more developers discover other nice Tapestry JavaScript methods also.
https://github.com/sveine/tapestry-multi-module-demo/blob/master/core/src/main/resources/META-INF/modules/util/tapestryutil.js
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)
