- This is taken from a mail to the pyxpcom list - it should be expanded, but a copy-paste will do for now
Normal module semantics don't exist here. The globals are 'bound' to the global object (i.e., the window), instead of to a module's
__dict__ as you expect in the Python world. Note that we don't actually 'import' anything here - the scripts and event handlers do not exist in a Python module.
The intent is to provide similar semantics to JS. For example, when a top-level window has something like:
<window ... script="foo = 1" ...
An event handler like:
<button onclick="print foo"/>
Should be able to reference 'foo' via globals as shown.
Note that you can stick arbitrary values on any DOM object - this is what JS calls 'expandos'. For example, let's say you have XUL similar to pyxultest:
Top-level script code says something like:
button = document.getElementById("some-button") button.foo = 0
And the button itself might look like:
<button id="some-button" label="click here" onclick="event.target.foo += 1; print 'Foo is now', event.target.foo"/>
Note that (a) we have stuck an arbitrary attribute on a DOM element and (b) in all cases (e.g., event handler and top-level script), the DOM node needs to be explicitly specified - the globals are the window itself. The event handler could also have used getElementById - the point is that both the event handler and top-level script share the same namespace.
Use a script-type attribute on your elements. For example,
<window script-type="application/x-python" .../>
<meta http-equiv="Content-Script-Type" content="application/x-python" /> should work (but possibly doesn't - see bug 100924). But addEventListener within a
<script type="application/x-python"> block does.
Python code can not be secured - so it will only run from trusted sources. This means you can only have Python code in chrome. Content loaded from anywhere other than a
chrome:// URL can not host Python. It should be obvious why you don't want to run http://evil.com/something_evil.py in your browser! Inside chrome, you can use Python via either HTML or XUL.