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

Thanks Daniele Procida.
This commit is contained in:
Tim Graham 2013-01-13 15:11:24 -05:00
parent 0ca2d1e20a
commit 4720117a31
1 changed files with 12 additions and 0 deletions

View File

@ -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 ``None``) to any media paths. The same rules apply as :ref:`regular media
definitions on forms <form-media-paths>`. definitions on forms <form-media-paths>`.
jQuery
~~~~~~
Django admin Javascript makes use of the `jQuery`_ library. To avoid Django admin Javascript makes use of the `jQuery`_ library. To avoid
conflicts with user-supplied scripts or libraries, Django's jQuery is 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 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 when using third-party jQuery plugins, or need a newer version of jQuery, you
will have to include your own copy of jQuery. 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 .. _jQuery: http://jquery.com
Adding custom validation to the admin Adding custom validation to the admin