Джангода кірістірілген пішіндерді қалай пайдалануға болады

Django, python, formsets

Django пішін жиындары көріністегі күрделі қайталанатын пішін өрістерін басқарады. Пішіндерді пайдалана отырып, сіз бастапқыда қанша пішін болғанын, қайсысы өзгертілгенін және қайсысын жою керектігін біле аласыз.
Пішіндер мен пішін үлгілері сияқты, Django бірнеше үлгі даналарын өңдейтін пішін үшін пішін жиынын жасау тапсырмасын жеңілдететін пішін үлгісі жиындарын қамтамасыз етеді.

Django сонымен қатар ортақ сыртқы кілтке жататын нысандар жиынын өңдеу үшін пайдалануға болатын кірістірілген пішін жиындарын қамтамасыз етеді.
Төмендегі үлгі мысалдарында біз барлық еншілестерді өңдеу үшін, ата-ана үшін немесе барлық еншілес мекенжайлар үшін кірістірілген пішіндер жинағын жаза аламыз.

# models.py

class Parent(models.Model):
    name = models.CharField(max_length=255)

class Child(models.Model):
    parent = models.ForeignKey(Parent)
    name = models.CharField(max_length=255)

class Address(models.Model):
    child = models.ForeignKey(Child)
    country = models.CharField(max_length=255)
    state = models.CharField(max_length=255)
    address = models.CharField(max_length=255)

# forms.py

from django.forms.models import inlineformset_factory

ChildrenFormset = inlineformset_factory(models.Parent, models.Child, extra=1)
AddressFormset = inlineformset_factory(models.Child, models.Address, extra=1)

Жоғарыда сипатталған пішім жиындарын пайдалана отырып, бір бетте тектік үшін барлық еншілес элементтерді өңдеуге және басқа бетте барлық еншілес элемент мекенжайларын өңдеуге болады. Пайдаланушыларға бір беттегі мекенжайлармен бірге барлық еншілес элементтерді қосуға немесе өңдеуге рұқсат бергіңіз келсе, еншілес пішін жинағында әрбір еншілес пішін үшін мекенжай пішіндерінің толық жинағы болуы керек.
Бұл жағдайда кірістірілген пішіндерді пайдалану мағынасы бар. Кірістірілген пішіндер жинағы қарапайым кірістірілген пішіндер жинағы болып табылады.
Кірістірілген пішіндерді өңдеу үшін келесі қадамдарды орындау қажет:

1-қадам: Негізгі кірістірілген пішіндер жинағын жасаңыз

# forms.py

from django.forms.models import BaseInlineFormSet

class BaseChildrenFormset(BaseInlineFormSet):
    pass

ChildrenFormset = inlineformset_factory(models.Parent,
                                        models.Child,
                                        formset=BaseChildrenFormset,
                                        extra=1)

2-қадам. Төменде көрсетілгендей әрбір пішін үшін кірістірілген пішін жиынын тіркеу. BaseInlineFormSet суперсыныбы пішін жиынындағы әрбір пішін үшін өрістерді қосуға жауап беретін add_fields әдісін анықтайды. Сондай-ақ, мұнда кірістірілген пішіндер жинағын байланыстыру логикасын жаза аламыз.

# forms.py
class BaseChildrenFormset(BaseInlineFormSet):

    def add_fields(self, form, index):
        super(BaseChildrenFormset, self).add_fields(form, index)

        # save the formset in the 'nested' property
        form.nested = AddressFormset(
                        instance=form.instance,
                        data=form.data if form.is_bound else None,
                        files=form.files if form.is_bound else None,
                        prefix='address-%s-%s' % (
                            form.prefix,
                            AddressFormset.get_default_prefix()),
                        extra=1)

Ескерту: Мұнда біз кірістірілген пішіндер жиынын (AddressFormset) қамтитын "form.nested" деп аталатын жаңа сипат жасадық.

3-қадам: көріністердегі пішіндер жинағын және кірістірілген пішін жиындарын өңдеу

# views.py

def manage_children(request, parent_id):
    """Edit children and their addresses for a single parent."""

    parent = get_object_or_404(models.Parent, id=parent_id)

    if request.method == 'POST':
        formset = forms.ChildrenFormset(request.POST, instance=parent)
        if formset.is_valid():
            formset.save()
            return redirect('parent_view', parent_id=parent.id)
    else:
        formset = forms.ChildrenFormset(instance=parent)

    return render(request, 'manage_children.html', {
                  'parent':parent,
                  'children_formset':formset})

4-қадам: Үлгідегі кірістірілген пішіндер жинағын көрсету

# manage_children.html (Just formset display part)

{{ children_formset.management_form }}
{{ children_formset.non_form_errors }}

{% for child_form in children_formset.forms %}
    {{ child_form }}

    {% if child_form.nested %}
        {{ child_form.nested.management_form }}
        {{ child_form.nested.non_form_errors }}

        {% for nested_form in child_form.nested.forms %}
            {{ nested_form }}
        {% endfor %}

    {% endif %}

{% endfor %}

Бірнеше тармаққа назар аудару керек:

1. Тексеру. Пішіндер жинағындағы пішінді тексеру кезінде біз оның кірістірілген пішіндер жинағындағы ішкі пішіндерін де тексеруіміз керек.

2. Деректерді сақтау. Пішінді сақтаған кезде кірістірілген пішіндер жинағындағы пішіндерге толықтырулар мен өзгертулерді де сақтау керек.

Бет жіберілген кезде пішіндерді тексеру үшін formset.is_valid() деп атаймыз. Кірістірілген пішім жиындары үшін тексеруді қосу үшін біз пішім жинағында is_valid параметрін қайта анықтаймыз.

# forms.py

class BaseChildrenFormset(BaseInlineFormSet):
    ...

    def is_valid(self):
        result = super(BaseChildrenFormset, self).is_valid()

        if self.is_bound:
            for form in self.forms:
                if hasattr(form, 'nested'):
                    result = result and form.nested.is_valid()

        return result

Бұл пішіндерді және кірістірілген пішіндерді тексеруді аяқтайды. Енді біз сақталғандарды өңдеуіміз керек. Бұл әрекетті орындау үшін, негізгі пішін жиынын және барлық кірістірілген пішім жиындарын сақтау үшін сақтау әдісін қайта анықтау керек.

# forms.py

class BaseChildrenFormset(BaseInlineFormSet):
    ...

    def save(self, commit=True):

        result = super(BaseChildrenFormset, self).save(commit=commit)

        for form in self.forms:
            if hasattr(form, 'nested'):
                if not self._should_delete_form(form):
                    form.nested.save(commit=commit)

        return result

Сақтау әдісі пішіндер жинағындағы пішіндерді, сондай-ақ әрбір пішін үшін кірістірілген пішіндер жинағындағы барлық пішіндерді сақтауға жауап береді.
Django CRM (Тұтынушымен қарым-қатынасты басқару) ашық бастапқы пакеті туралы қосымша ақпаратты осы сілтемеден алыңыз.