Kaydet (Commit) c0f03175 authored tarafından James Bennett's avatar James Bennett Kaydeden (comit) Tim Graham

Fixed #19695 -- Retitle "Form Media" to "Form Assets".

üst 660c30ed
...@@ -82,7 +82,7 @@ How can I customize the functionality of the admin interface? ...@@ -82,7 +82,7 @@ How can I customize the functionality of the admin interface?
You've got several options. If you want to piggyback on top of an add/change You've got several options. If you want to piggyback on top of an add/change
form that Django automatically generates, you can attach arbitrary JavaScript form that Django automatically generates, you can attach arbitrary JavaScript
modules to the page via the model's class Admin :ref:`js parameter modules to the page via the model's class Admin :ref:`js parameter
<modeladmin-media-definitions>`. That parameter is a list of URLs, as strings, <modeladmin-asset-definitions>`. That parameter is a list of URLs, as strings,
pointing to JavaScript modules that will be included within the admin form via pointing to JavaScript modules that will be included within the admin form via
a ``<script>`` tag. a ``<script>`` tag.
......
...@@ -1554,13 +1554,13 @@ instances which allow you to easily customize the response data before ...@@ -1554,13 +1554,13 @@ instances which allow you to easily customize the response data before
rendering. For more details, see the :doc:`TemplateResponse documentation rendering. For more details, see the :doc:`TemplateResponse documentation
</ref/template-response>`. </ref/template-response>`.
.. _modeladmin-media-definitions: .. _modeladmin-asset-definitions:
``ModelAdmin`` media definitions ``ModelAdmin`` asset definitions
-------------------------------- --------------------------------
There are times where you would like add a bit of CSS and/or JavaScript to There are times where you would like add a bit of CSS and/or JavaScript to
the add/change views. This can be accomplished by using a Media inner class the add/change views. This can be accomplished by using a ``Media`` inner class
on your ``ModelAdmin``:: on your ``ModelAdmin``::
class ArticleAdmin(admin.ModelAdmin): class ArticleAdmin(admin.ModelAdmin):
...@@ -1572,8 +1572,8 @@ on your ``ModelAdmin``:: ...@@ -1572,8 +1572,8 @@ on your ``ModelAdmin``::
The :doc:`staticfiles app </ref/contrib/staticfiles>` prepends The :doc:`staticfiles app </ref/contrib/staticfiles>` prepends
:setting:`STATIC_URL` (or :setting:`MEDIA_URL` if :setting:`STATIC_URL` is :setting:`STATIC_URL` (or :setting:`MEDIA_URL` if :setting:`STATIC_URL` is
``None``) to any media paths. The same rules apply as :ref:`regular media ``None``) to any asset paths. The same rules apply as :ref:`regular asset
definitions on forms <form-media-paths>`. definitions on forms <form-asset-paths>`.
jQuery jQuery
~~~~~~ ~~~~~~
......
...@@ -171,16 +171,15 @@ You can also set the HTML ``id`` using :attr:`~Widget.attrs`. See ...@@ -171,16 +171,15 @@ You can also set the HTML ``id`` using :attr:`~Widget.attrs`. See
Styling widget classes Styling widget classes
^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^
With widgets, it is possible to add media (``css`` and ``javascript``) With widgets, it is possible to add assets (``css`` and ``javascript``)
and more deeply customize their appearance and behavior. and more deeply customize their appearance and behavior.
In a nutshell, you will need to subclass the widget and either In a nutshell, you will need to subclass the widget and either
:ref:`define a class "Media" <media-as-a-static-definition>` as a member of the :ref:`define a "Media" inner class <assets-as-a-static-definition>` or
subclass, or :ref:`create a property "media" <dynamic-property>`, returning an :ref:`create a "media" property <dynamic-property>`.
instance of that class.
These methods involve somewhat advanced Python programming and are described in These methods involve somewhat advanced Python programming and are described in
detail in the :doc:`Form Media </topics/forms/media>` topic guide. detail in the :doc:`Form Assets </topics/forms/media>` topic guide.
.. _base-widget-classes: .. _base-widget-classes:
......
...@@ -2475,7 +2475,7 @@ URL to use when referring to static files located in :setting:`STATIC_ROOT`. ...@@ -2475,7 +2475,7 @@ URL to use when referring to static files located in :setting:`STATIC_ROOT`.
Example: ``"/static/"`` or ``"http://static.example.com/"`` Example: ``"/static/"`` or ``"http://static.example.com/"``
If not ``None``, this will be used as the base path for If not ``None``, this will be used as the base path for
:ref:`media definitions<form-media-paths>` and the :ref:`asset definitions<form-asset-paths>` (the ``Media`` class) and the
:doc:`staticfiles app</ref/contrib/staticfiles>`. :doc:`staticfiles app</ref/contrib/staticfiles>`.
It must end in a slash if set to a non-empty value. It must end in a slash if set to a non-empty value.
......
...@@ -116,7 +116,7 @@ As a result, we took the following steps to rectify the issue: ...@@ -116,7 +116,7 @@ As a result, we took the following steps to rectify the issue:
(``django.core.context_processors.static``) and renamed to (``django.core.context_processors.static``) and renamed to
:func:`~django.core.context_processors.static`. :func:`~django.core.context_processors.static`.
* :ref:`form-media-paths` now uses :setting:`STATIC_URL` as the prefix * :ref:`form-asset-paths` now uses :setting:`STATIC_URL` as the prefix
**if the value is not None**, and falls back to the previously used **if the value is not None**, and falls back to the previously used
:setting:`MEDIA_URL` setting otherwise. :setting:`MEDIA_URL` setting otherwise.
......
...@@ -42,7 +42,7 @@ The library deals with these concepts: ...@@ -42,7 +42,7 @@ The library deals with these concepts:
A collection of fields that knows how to validate itself and A collection of fields that knows how to validate itself and
display itself as HTML. display itself as HTML.
Form Media Form Assets (the ``Media`` class)
The CSS and JavaScript resources that are required to render a form. The CSS and JavaScript resources that are required to render a form.
The library is decoupled from the other Django components, such as the database The library is decoupled from the other Django components, such as the database
......
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment