JavaScript-настройки в админке

События встраиваемых форм

Возможно, вам потребуется выполнить JavaScript-код при добавлении или удалении встраиваемой формы в форме изменения админки. Для этого используются события jQuery formset:added и formset:removed. Обработчик событий принимает три аргумента:

• event — это событие jQuery.
• $row — это новая (или удалённая) строка.
• formsetName — это набор форм, к которому принадлежит строка.

Событие срабатывает, используя пространство имён django.jQuery.

В вашем пользовательском шаблоне change_form.html, расширьте блок admin_change_form_document_ready и добавьте код обработчика событий:

{% extends 'admin/change_form.html' %}
{% load static %}

{% block admin_change_form_document_ready %}
{{ block.super }}
<script type="text/javascript" src="{% static 'app/formset_handlers.js' %}"></script>
{% endblock %}

(function($) {
    $(document).on('formset:added', function(event, $row, formsetName) {
        if (formsetName == 'author_set') {
            // Do something
        }
    });

    $(document).on('formset:removed', function(event, $row, formsetName) {
        // Row removed
    });
})(django.jQuery);

Следует учесть два момента:

• JavaScript-код должен находиться в блоке шаблона, если вы наследуете admin/change_form.html, иначе он не будет отображён в конечном HTML.
• {{ block.super }} добавляется, потому что блок admin_change_form_document_ready Django содержит JavaScript-код для обработки различных операций в форме изменения, и нам нужно, чтобы он тоже был отображён.

Иногда вам нужно работать с плагинами jQuery, которые не зарегистрированы в пространстве имён django.jQuery. Для этого просто измените способ прослушивания событий. Вместо обертывания обработчика в пространство имён django.jQuery, просто прослушайте событие, сгенерированное оттуда. Например:

{% extends 'admin/change_form.html' %}
{% load static %}

{% block admin_change_form_document_ready %}
{{ block.super }}
<script type="text/javascript" src="{% static 'app/unregistered_handlers.js' %}"></script>
{% endblock %}

django.jQuery(document).on('formset:added', function(event, $row, formsetName) {
    // Row added
});

django.jQuery(document).on('formset:removed', function(event, $row, formsetName) {
    // Row removed
});