Commit d406afe1 authored by Tim Graham's avatar Tim Graham
Browse files

Fixed #19597 - Added some notes on jQuery in admin.

Thanks Daniele Procida.
parent b4b00349
Loading
Loading
Loading
Loading
+12 −9
Original line number Diff line number Diff line
@@ -1383,15 +1383,18 @@ 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
JavaScript without including a second copy, you can use the ``django.jQuery``
object on changelist and add/edit views.

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 admin Javascript makes use of the `jQuery`_ library.

To avoid conflicts with user-supplied scripts or libraries, Django's jQuery
(version 1.4.2) is namespaced as ``django.jQuery``. If you want to use jQuery
in your own admin JavaScript without including a second copy, you can use the
``django.jQuery`` object on changelist and add/edit views.

The :class:`ModelAdmin` class requires jQuery by default, so there is no need
to add jQuery to your ``ModelAdmin``'s list of media resources unless you have
a specifc need. For example, if you require the jQuery library to be in the
global namespace (for example when using third-party jQuery plugins) or if you
need a newer version of jQuery, you will have to include your own copy.

Django provides both uncompressed and 'minified' versions of jQuery, as
``jquery.js`` and ``jquery.min.js`` respectively.