summaryrefslogtreecommitdiff
path: root/docs/internals/contributing/writing-code/javascript.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/internals/contributing/writing-code/javascript.txt')
-rw-r--r--docs/internals/contributing/writing-code/javascript.txt6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/internals/contributing/writing-code/javascript.txt b/docs/internals/contributing/writing-code/javascript.txt
index 25a46695c3..3d10c48f00 100644
--- a/docs/internals/contributing/writing-code/javascript.txt
+++ b/docs/internals/contributing/writing-code/javascript.txt
@@ -24,6 +24,12 @@ Code style
JSHint will be run when you run the JavaScript tests. We also recommended
installing a JSHint plugin in your text editor.
+* Where possible, write code that will work even if the page structure is later
+ changed with JavaScript. For instance, when binding a click handler, use
+ ``$('body').on('click', selector, func)`` instead of
+ ``$(selector).click(func)``. This makes it easier for projects to extend
+ Django's default behavior with JavaScript.
+
.. _javascript-patches:
JavaScript patches