U
}Ha7 @ s d dl Z d dlmZmZ d dlmZ d dlmZ d dlm Z d dl
m Z d dl m
Z
mZmZmZ G dd d ZG d
d d eZdS ) N)NoReverseMatchreverse) mark_safe)FormHelpersException)Layout) LayoutSlice)
TEMPLATE_PACKflatattlist_difference render_fieldc @ s\ e Zd Zdd Zdd Zdd Zdd Zd d
Zd d Zd
d Z dd Z
dd Z dd Z dS )DynamicLayoutHandlerc C s | j d krtdd S )Nz+You need to set a layout in your FormHelper)layoutr self r 7/tmp/pip-unpacked-wheel-rp2i33ek/crispy_forms/helper.py
_check_layout
s
z"DynamicLayoutHandler._check_layoutc C s | | jd krtdd S )Nz3You need to pass a form instance to your FormHelper)r formr r r r r _check_layout_and_form s
z+DynamicLayoutHandler._check_layout_and_formc C s$ | t| jtdt| jjdS )zD
Returns all layout objects of first level of depth
r )r r r
slicelenfieldsr r r r all s zDynamicLayoutHandler.allc O s> | |dd}|dd}| jj|||d}t| j|S )zX
Returns a LayoutSlice pointing to layout objects of type `LayoutClass`
max_levelr greedyF)r r )r popr
Zget_layout_objectsr )r Z
LayoutClasseskwargsr r Zfiltered_layout_objectsr r r filter s
zDynamicLayoutHandler.filterc C sN | | j }g }|D ]&}t| jj|d j|r|| qt| j|S )zX
Returns a LayoutSlice pointing to fields with widgets of `widget_type`
r r r
get_field_names
isinstancer r widgetappendr r Z widget_typelayout_field_namesZfiltered_fieldspointerr r r filter_by_widget( s
z%DynamicLayoutHandler.filter_by_widgetc C sN | | j }g }|D ]&}t| jj|d j|s|| qt| j|S )zb
Returns a LayoutSlice pointing to fields with widgets NOT matching `widget_type`
r r r$ r r r exclude_by_widget7 s
z&DynamicLayoutHandler.exclude_by_widgetc C sx t |trlt| |r t| |S | | j }g }|D ]&}t|dkr8|d |kr8|| q8t | j|S t | j|S )z{
Return a LayoutSlice that makes changes affect the current instance of the layout
and not a copy.
r )
r! strhasattrgetattrr r
r r r# r )r keyr% Zfiltered_fieldr& r r r __getitem__F s
z DynamicLayoutHandler.__getitem__c C s || j |< d S Nr
)r r- valuer r r __setitem___ s z DynamicLayoutHandler.__setitem__c C s | j j|= d S r/ )r
r )r r- r r r __delitem__b s z DynamicLayoutHandler.__delitem__c C s | j d k rt| j jS dS d S )Nr )r
r r r r r r __len__e s
z DynamicLayoutHandler.__len__N)
__name__
__module__ __qualname__r r r r r' r( r. r2 r3 r4 r r r r r s r c @ s4 e Zd ZdZdZdZdZdZdZdZ dZ
dZ dZ dZ
dZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ d#dd Z d
d Z e d d
Z!e!j"dd
Z!e dd Z#e#j"dd Z#e dd Z$e$j"dd Z$e dd Z%e%j"dd Z%e dd Z&e&j"dd Z&dd Z'd d Z(e)fd d Z*e)fd!d"Z+dS )$
FormHelperah
This class controls the form rendering behavior of the form passed to
the `{% crispy %}` tag. For doing so you will need to set its attributes
and pass the corresponding helper object to the tag::
{% crispy form form.helper %}
Let's see what attributes you can set and what form behaviors they apply to:
**form_method**: Specifies form method attribute.
You can set it to 'POST' or 'GET'. Defaults to 'POST'
**form_action**: Applied to the form action attribute:
- Can be a named url in your URLconf that can be executed via the `{% url %}` template tag. Example: 'show_my_profile'. In your URLconf you could have something like::
path('show/profile/', 'show_my_profile_view', name = 'show_my_profile')
- It can simply point to a URL '/whatever/blabla/'.
**form_id**: Generates a form id for dom identification.
If no id provided then no id attribute is created on the form.
**form_class**: String containing separated CSS classes to be applied
to form class attribute. The form will always have by default
'uniForm' class.
**form_group_wrapper_class**: String containing separated CSS classes to be applied
to each row of inputs.
**form_tag**: It specifies if tags should be rendered when using a Layout.
If set to False it renders the form without the tags. Defaults to True.
**form_error_title**: If a form has `non_field_errors` to display, they
are rendered in a div. You can set title's div with this attribute.
Example: "Oooops!" or "Form Errors"
**formset_error_title**: If a formset has `non_form_errors` to display, they
are rendered in a div. You can set title's div with this attribute.
**form_style**: Uni-form has two built in different form styles. You can choose
your favorite. This can be set to "default" or "inline". Defaults to "default".
**include_media**: Whether to automatically include form media. Set to False if
you want to manually include form media outside the form. Defaults to True.
Public Methods:
**add_input(input)**: You can add input buttons using this method. Inputs
added using this method will be rendered at the end of the form/formset.
**add_layout(layout)**: You can add a `Layout` object to `FormHelper`. The Layout
specifies in a simple, clean and DRY way how the form fields should be rendered.
You can wrap fields, order them, customize pretty much anything in the form.
Best way to add a helper to a form is adding a property named helper to the form
that returns customized `FormHelper` object::
from crispy_forms.helper import FormHelper
from crispy_forms.layout import Submit
class MyForm(forms.Form):
title = forms.CharField(_("Title"))
@property
def helper(self):
helper = FormHelper()
helper.form_id = 'this-form-rocks'
helper.form_class = 'search'
helper.add_input(Submit('save', 'save'))
[...]
return helper
You can use it in a template doing::
{% load crispy_forms_tags %}
{% crispy form %}
post defaultNTFc C s* i | _ g | _|d k r&|| _| || _d S r/ )attrsinputsr build_default_layoutr
r r r r r __init__ s
zFormHelper.__init__c C s t |j S r/ )r r keysr? r r r r> s z FormHelper.build_default_layoutc C s | j S r/ ) _form_methodr r r r form_method s zFormHelper.form_methodc C s" | dkrtd| | _d S )N)getr9 zSOnly GET and POST are valid in the form_method helper attribute)lowerr rB )r methodr r r rC s
c C s, z t | jW S tk
r& | j Y S X d S r/ )r _form_actionr r r r r form_action s zFormHelper.form_actionc C s
|| _ d S r/ )rG )r actionr r r rH s c C s | j dkrdS | j dkr dS d S )Nr; r: inlineZ inlineLabels) _form_styler r r r
form_style s
zFormHelper.form_stylec C s" | dkrtd| | _d S )N)r; rJ zXOnly default and inline are valid in the form_style helper attribute)rE r rK )r styler r r rL s
c C s | j S r/ )_help_text_inliner r r r help_text_inline
s zFormHelper.help_text_inlinec C s || _ | | _d S r/ )rN _error_text_inliner flagr r r rO s c C s | j S r/ )rP r r r r error_text_inline s z FormHelper.error_text_inlinec C s || _ | | _d S r/ )rP rN rQ r r r rS s c C s | j | d S r/ )r= r# )r Z input_objectr r r add_input s zFormHelper.add_inputc C s
|| _ d S r/ r0 )r r
r r r
add_layout" s zFormHelper.add_layoutc C s t |_| j|_| jj|| j||d}| js8| js8| j rt
|j }t
||j}|D ]J}| js| jrt|j | jjs| j rV|j | jjrV|t||| j||d7 }qVt|S )zB
Returns safe html of the rendering of the layout
)
template_pack)setZrendered_fieldsfield_templateZcrispy_field_templater
renderrL render_unmentioned_fieldsrender_hidden_fieldsrender_required_fieldstupler rA r
r" Z is_hiddenZ is_requiredr r )r r contextrV htmlr Zleft_fields_to_renderfieldr r r
render_layout% s& zFormHelper.render_layoutc s | j | j| j| jpd| | j | j| j| j | j | j
| j | j | j
| jd}|dkrd| j krtd| j
}|rd fdd|D |d < n,td
| j
}|rd fd d|D |d < i |d
< | jr| j |d
< | jr| j |d
d< | jr | j |d
d< | jrJ|dkr6d| j |d
d< n| j |d
d< n$|dkrn| jddd |d
d< | jr| j|d
d< t|d
|d< | jr| j|d< | jr| j |d< | j r| j |d< | j D ]2\}}||kr|dkr| ds|||< q|S ) zD
Used by crispy_forms_tags to get helper attributes
z
%s/field.html) disable_csrfrS field_classrX rC form_show_errorsform_show_labelsrL form_tagrO html5_required
include_media label_classuse_custom_controlZ
bootstrap4zform-horizontalzcol(-(xl|lg|md|sm))?-(\d+)z offset%s-%sc s g | ]} |d |d f qS )r r .0mZoffset_patternr r
W s z-FormHelper.get_attributes..Zbootstrap_checkbox_offsetszcol-(lg|md|sm|xs)-(\d+)zcol-%s-offset-%sc s g | ] } | qS r r rl ro r r rp ^ s r< rI idZuni_formz
uniForm %sclassr: z uniFormform_group_wrapper_classZ
flat_attrsr= form_error_titleformset_error_title)r
r= _) rb rS rc rX rC striprd re rL rf rO rg rh ri rj
form_classsplitrefindallr< copyrH form_idrD rs r r= rt ru __dict__items
startswith)r rV r Zbootstrap_size_matchZattribute_namer1 r ro r get_attributes= st
zFormHelper.get_attributes)N),r5 r6 r7 __doc__rB rG rK r r} rx rs r
rf rt ru rd rZ r[ r\ rN rP rg re templaterX rb rj ri rc rh r@ r> propertyrC setterrH rL rO rS rT rU r ra r r r r r r8 l sj O
r8 )rz Z django.urlsr r Zdjango.utils.safestringr Zcrispy_forms.exceptionsr Zcrispy_forms.layoutr Zcrispy_forms.layout_slicer Zcrispy_forms.utilsr r r
r r r8 r r r r s `