فرم در جنگو قابلیت های زیادی داره و من توی پروژه های مختلف هر بار چالش هایی داشتم که به مرور متوجه شدم که این قابلیت ها خیلی میتونه کمک کنه.
1.فرض کنید که توی یک فرم از یک مدل ما میخایم که یک فیلد رو نشون کاربر نده و اون رو پنهان کنه برای اون کار باید از HiddenInput استفاده کرد link_form.fields['provider'].widget = forms.HiddenInput()
2.فرض کنید به همون فیلد فرم میخایم یه مقدار اولیه بدیم که دیگه نیاز نباشه کاربر فیلدی رو پر کنه. link_form.initial = {'provider': svc}
3.هر فیلد توی یک فرم یک queryset داره که متونید اون رو تغییر بدید و مثلا یه فیلدش رو کم کنید یا sort کنید. self.fields['provider'].queryset.order_by('name')
4.یکی از نکات مشکلسازی که وجود داره. اگر میخاید فیلدهای یک فرم رو توی view تغییراتی بهش بدید (از اون چیزی که کاربر وارد میکنه) باید اون فیلد رو save کنید و اون instance ساخته شده رو تغییر بدید و بعدش commit کنید. link_instance = link_form.save(commit=False)
5.اگر بخایم مقدار وارد شده توسط کاربر رو بگیریم باید از cleaned_data استفاده کنیم. link_form.cleaned_data['provider'].name
6.توی خود کلاس Form میتونید برای هر فیلد محدودیت هایی ایجاد کنید و در صورت تخطی از اون محدودیت ها ValidationError برگردونید.
Form و View ای که تمامی این موارد رو توش داره رو در کدهای زیر میبینید. هر بار نیاز به زدن چنین فرمهایی بودیم بد نیست یه سری به اینا بزنیم.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
@login_required @permission_required('user.can_call_service_view_custom') def link_outgoing_add(request, service_id): svc = Service.objects.get(pk=service_id) if request.method == "POST": link_form = LinkADDForm(request.POST) else: link_form = LinkADDForm() link_form.fields['provider'].widget = forms.HiddenInput() link_form.initial = {'provider': svc} link_form.fields['consumer'].queryset = link_form.fields['consumer'].queryset.exclude(pk=svc.pk) link_form.fields['interface'].queryset = link_form.fields['interface'].queryset.exclude(pk=svc.pk) link_form.fields['interface2'].queryset = link_form.fields['interface2'].queryset.exclude(pk=svc.pk) if request.method == 'POST': if link_form.is_valid(): link_instance = link_form.save(commit=False) link_instance.provider_name = convert_string(link_form.cleaned_data['provider'].name) link_instance.consumer_name = convert_string(link_form.cleaned_data['consumer'].name) if link_form.cleaned_data.get('interface'): link_instance.interface_name = convert_string(link_form.cleaned_data['interface'].name) if link_form.cleaned_data.get('interface2'): link_instance.interface2_name = convert_string(link_form.cleaned_data['interface2'].name) if link_form.cleaned_data.get('protocol'): link_instance.protocol_name = convert_string(link_form.cleaned_data['protocol'].name_fixed) link_instance.save() return redirect('man:link_outgoing', service_id=service_id) return render(request, 'man/link/link-outgoing-add.html', context={'link_form': link_form}) |
و فرم مربوطه
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 |
class LinkADDForm(forms.ModelForm): class Meta: model = Link fields = ("provider", "consumer", "interface", "interface2", "protocol", "lt", "description", "api", "frequency", "ESBVerified", "ProviderVerified", "ConsumerVerified") def __init__(self, *args, **kwargs): super(LinkADDForm, self).__init__(*args, **kwargs) self.fields['provider'].queryset = self.fields['provider'].queryset.order_by('name') self.fields['consumer'].queryset = self.fields['consumer'].queryset.order_by('name') self.fields['interface'].queryset = self.fields['interface'].queryset.order_by('name') self.fields['interface2'].queryset = self.fields['interface2'].queryset.order_by('name') def clean(self): cleaned_data = super().clean() interface = cleaned_data.get('interface') interface2 = cleaned_data.get('interface2') if interface and interface2 and interface == interface2: raise ValidationError('واسط ها یکی هستند') return cleaned_data def clean_interface(self): interface = self.cleaned_data['interface'] provider = self.cleaned_data['provider'] consumer = self.cleaned_data['consumer'] if interface == provider: raise ValidationError('واسط با مبدا یکی است') if interface == consumer: raise ValidationError('واسط با مقصد یکی است') return interface def clean_interface2(self): interface2 = self.cleaned_data['interface2'] provider = self.cleaned_data['provider'] consumer = self.cleaned_data['consumer'] if interface2 == provider: raise ValidationError('واسط دوم با مبدا یکی است') if interface2 == consumer: raise ValidationError('واسط دوم با مقصد یکی است') return interface2 |
یه وقتهایی چند فرم رو توی یک view میخایم داشته باشیم. برای اینکه بدونیم کدوم فرم سابمیت شده باید از کلید name توی input HTML استفاده کنیم. مثلا سابمیت به صورت زیره
|
1 |
<input type="submit" class="btn btn-lg btn-success" name="user-office-form-submit" value="تایید"> |
حالا توی ویو باید به روش زیر بنویسیم:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 |
def user(request, user_id): u = User.objects.get(pk=user_id) p, _ = Profile.objects.get_or_create(user=u) uo_offices = UserOffice.objects.filter(user=u).values_list("office", flat=True) branches = Branch.objects.prefetch_related('office_set').all() branches_data = list() for b in branches: branches_data.append({ "id": b.id, "name": b.name, "name_fixed": b.name_fixed, "offices": [ {"id": o.id, "name": o.name, "title_fa": o.title_fa} for o in b.office_set.all() ] }) acesses = u.accesses.all() context = { 'muser': u, 'id': user_id, 'accesses': acesses, 'branches': branches, "brnaches_json": branches_data } if request.method == "POST": visitor_form = VisitorForm(request.POST, instance=u) profile_form = ProfileForm(request.POST, instance=p) group_nac_form = GroupNacForm(request.POST, instance=u) user_office_form = UserOfficeForm(request.POST) if 'visitor-profile-form-submit' in request.POST: if visitor_form.is_valid() and profile_form.is_valid(): visitor_form.save() profile_form.save() messages.success(request, "اطلاعات بروزرسانی شد") return redirect('man:management_user', user_id=user_id) else: if visitor_form.errors: messages.add_message(request, messages.ERROR, 'فیلد تاریخ انقضا اجباری است.') if 'group-nac-form-submit' in request.POST: if group_nac_form.is_valid(): group_nac_form.save() messages.success(request, "گروه کاربر بروزرسانی شد.") return redirect('man:management_user', user_id=user_id) else: if group_nac_form.errors: messages.add_message(request, messages.ERROR, 'فیلد گروه ها را بررسی فرمایید') if 'user-office-form-submit' in request.POST: if user_office_form.is_valid(): office = user_office_form.cleaned_data['office'] UserOffice.objects.filter(user=u).delete() for o in office: o_obj = Office.objects.get(pk=int(o)) UserOffice.objects.create( office=o_obj, user=u ) messages.success(request, "دسترسی سرویس کاتالوگ بروزرسانی شد.") return redirect('man:management_user', user_id=user_id) else: visitor_form = VisitorForm() if u.expire: visitor_form.fields['expire'].initial = u.expire profile_form = ProfileForm() if p and p.expert: profile_form.fields['expert'].initial = p.expert group_nac_form = GroupNacForm(instance=u) initial_offices = list(uo_offices) user_office_form = UserOfficeForm(initial={'office': initial_offices}) context['visitor_form'] = visitor_form context['info_form'] = profile_form context['group_nac_form'] = group_nac_form context['user_office_form'] = user_office_form if not u.is_active: return render(request, "man/user/user-inactive.html", context) return render(request, "man/user/user.html", context) |
به قسمت if name in request.POST دقت کنید.
اگر چند فرم داشته باشیم که فیلدهایی با اسم مشابه داشته باشند باید از prefix توی فرم جنگو استفاده کنیم. اینطوری برای فیلدهای هر فرم prefix متفاوتی خواهیم داشت.
