diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index 04a7824417..065c9566ea 100644 --- a/docs/ref/contrib/admin/index.txt +++ b/docs/ref/contrib/admin/index.txt @@ -1380,6 +1380,9 @@ The :doc:`staticfiles app ` prepends ``None``) to any media paths. The same rules apply as :ref:`regular media definitions on forms `. +jQuery +~~~~~~ + Django admin Javascript makes use of the `jQuery`_ library. To avoid conflicts with user-supplied scripts or libraries, Django's jQuery is namespaced as ``django.jQuery``. If you want to use jQuery in your own admin @@ -1390,6 +1393,15 @@ If you require the jQuery library to be in the global namespace, for example when using third-party jQuery plugins, or need a newer version of jQuery, you will have to include your own copy of jQuery. +Django provides both uncompressed and 'minified' versions of jQuery, as +``jquery.js`` and ``jquery.min.js`` respectively. + +:class:`ModelAdmin` and :class:`InlineModelAdmin` have a ``media`` property +that returns a list of ``Media`` objects which store paths to the JavaScript +files for the forms and/or formsets. If :setting:`DEBUG` is ``True`` it will +return the uncompressed versions of the various JavaScript files, including +``jquery.js``; if not, it will return the 'minified' versions. + .. _jQuery: http://jquery.com Adding custom validation to the admin