launchpad development
JavaScript in Launchpad
This page covers everything to do with JavaScript development in Launchpad.
Some useful links:
See all the JavaScript-related pages on the wiki
Zope, JavaScript, and YUI3 Tips
Zope's TAL engine is clever, and helpfully breaks any <script> nodes in your template. Here's how to make the TAL interpreter do the right thing:
<js tal:replace="structure string:<script>...</script>" />
Zope3 forms have field names with dots in them, like this:
<input id="field.action.visibility" name="field.action.visibility" type="hidden"/>
This makes it impossible to grab <input> nodes with CSS3 selectors, or with YUI3's Y.get() function.
For example, this will return null:
Y.get('#field.action.visibility');You can take advantage of Y.get()'s node-wrapping abilities to work around this. These all return a Node instance:
Y.get(Y.DOM.byId('field.action.visibility'));
Y.get(document.getElementById('field.action.visibility'));
Y.get("#someform input[name='field.action.visibility']");
Sometimes you need to pass a raw DOM node into another JavaScript library, but YUI3's Y.get() function returns a YUI3 Node instance, which is incompatible.
You can unwrap the Node instance like this:
var yui_node = Y.get('#foo');
var raw_node = Y.Node.getDOMNode(yui_node);
By default the YUI3 test runner stops any JavaScript exceptions from propagating. This prevents the test suite from breaking on errors in the code under test, but it also stops Firebug from stopping on errors in the test case itself.
You can force the debugger to open on test-case programming errors by selecting both the Break on All Errors and Track Throw/Catch options under the Firebug Script tab's Options menu.
