Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Added details on minified jQuery and DEBUG mode for contrib.admin.

Thanks Daniele Procida.
  • Loading branch information...
commit 4720117a31344483119856fb5ed803fe4c35936f 1 parent 0ca2d1e
@timgraham timgraham authored
Showing with 12 additions and 0 deletions.
  1. +12 −0 docs/ref/contrib/admin/index.txt
View
12 docs/ref/contrib/admin/index.txt
@@ -1380,6 +1380,9 @@ The :doc:`staticfiles app </ref/contrib/staticfiles>` prepends
``None``) to any media paths. The same rules apply as :ref:`regular media
definitions on forms <form-media-paths>`.
+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
Please sign in to comment.
Something went wrong with that request. Please try again.