Django में कस्टम प्रपत्र फ़ील्ड

हाय, हेब्र!
मैं Django ढांचे का बहुत बड़ा प्रशंसक हूं और मैं अपनी सभी परियोजनाएं उस पर विशेष रूप से लिखता हूं। आज मैं अपने स्वयं के मूल समाधान के साथ फॉर्म फ़ील्ड के मानक पुस्तकालय का विस्तार करने के तरीके के बारे में बात करूंगा। लेख का उद्देश्य टर्नकी समाधान की पेशकश करना नहीं है, बल्कि कस्टम फ़ील्ड बनाने के लिए प्रौद्योगिकी को रोशन करना है।
एक छोटा सा विषयांतर। एक बार, मैं उस कंपनी के लिए एक ज्ञान का आधार बनाने पर काम कर रहा था जिसमें मैं उस समय काम कर रहा था। आधार टैग के साथ टैग किए गए लेखों का एक संग्रह था। टैग प्रविष्टि तत्व पर निम्नलिखित आवश्यकताएं लागू की गईं:

• एकाधिक इनपुट
• स्वतः पूर्ण इनपुट टैग
• टैग में स्थान हो सकते हैं (कई शब्दों से मिलकर)
• एक नया टैग बनाने की क्षमता, और सूची से चयन नहीं

कुछ खोज के बाद, मुझे jQuery टैग-इट प्लगइन मिला ! कि पूरी तरह से विजेट के लिए आवश्यकताओं को पूरा किया। यह केवल Django के लिए इस क्षेत्र को पेंच करने के लिए बनी हुई है।

स्वतः पूर्ण डेटा स्रोत

हमारा विजेट मॉडल से डेटा लेगा, जहां, वास्तव में, दर्ज किए गए टैग सहेजे जाते हैं

from django.db import models from unicodedata import category from django.utils.http import urlquote import re class Tag(models.Model): """ Model of Tags """ name = models.CharField(max_length=200, null=False, verbose_name="Tag name") slug = models.CharField(max_length=400, editable=False, verbose_name=u'Slug', unique=True, null=False) def __unicode__(self): return self.name @staticmethod def _generate_slug(value): slug = ''.join(ch for ch in value[:200] if category(ch)[0] != 'P') return urlquote(re.sub(r'([ ]+_)|(_[ ]+)|([ ]+)', '_', slug)) def save(self, *args, **kwargs): self.name = self.name.lower() self.slug = self._generate_slug(self.name) super(Tag, self).save(*args, **kwargs) @classmethod def get_or_create(cls, value): slug = cls._generate_slug(value.lower().strip()) if cls.objects.filter(slug=slug).exists(): return cls.objects.get(slug=slug) else: return cls.objects.create(name=value.lower().strip()) 

चूंकि टैग में रिक्त स्थान और अन्य कचरा हो सकता है, इसलिए हम मॉडल में स्लग फ़ील्ड का परिचय देते हैं, जो स्पष्ट रूप से टैग को उसकी सामग्री से पहचानता है, भले ही टैग नाम में शब्दों के बीच कितने रिक्त स्थान हों। हम वर्ग विधि get_or_create भी पेश करते हैं, जो स्लग क्षेत्र में पाए जाने पर एक टैग देता है, या अन्यथा एक नया टैग बनाता है। इसके अलावा, एक नया टैग बनाने से पहले, हमने इसे स्थिरता के लिए सहेजने के तरीके में नीचे की तरफ डाला।

ऑटो पूरा होने के लिए देखें

हम एक छोटे से दृश्य की रूपरेखा तैयार करते हैं जो आपके द्वारा दर्ज किए गए वर्णों से शुरू होने वाले टैग की एक सूची देता है।
टैग-यह प्लगइन! शब्द चर में दर्ज स्ट्रिंग को पास करता है।

 from models import Tag from django.http import HttpResponse import json def tag_autocomplete(request): """ url: /tag_autocomplete/""" value = request.GET['term'] available_tags = Tag.objects.filter(name__startswith=value.lower()) response = HttpResponse(json.dumps([unicode(tag) for tag in available_tags]), content_type="application/json") return response 

विजेट और प्रपत्र फ़ील्ड

विजेट और फॉर्म फील्ड को सीधे उनके आवेदन के स्थान पर - फॉर्ममेक्सो में घोषित किया जा सकता है। मैंने ऐसा किया, क्योंकि मैंने इसे कहीं और इस्तेमाल करने की योजना नहीं बनाई थी।
मुझे एक छिपे हुए इनपुट फ़ील्ड से विजेट विरासत में मिला है, क्योंकि टैग-इट प्लगइन विज़ुअलाइज़ेशन करता है! ..

 from django import forms class TagitWidget(forms.HiddenInput): """ Widget on the basis of Tag-It! http://aehlke.github.com/tag-it/""" class Media: js = (settings.STATIC_URL + 'js/tag-it.js', settings.STATIC_URL + 'js/tagit_widget.js',) css = {"all": (settings.STATIC_URL + 'css/jquery.tagit.css',)} 

टैग-it.js और jquery.tagit.css टैग-इट प्लगइन की फाइलें हैं! .. tagit_widget.js की सामग्री नीचे वर्णित की जाएगी।

 class TagitField(forms.Field): """ Tag field """ widget = TagitWidget def __init__(self, tag_model, *args, **kwargs): self.tag_model = tag_model super(TagitField, self).__init__(*args, **kwargs) def to_python(self, value): tag_strings = value.split(',') return [self.tag_model.get_or_create(tag_string) for tag_string in tag_strings if len(tag_string) > 0] def validate(self, value): if len(value) == 0 and self.required: raise ValidationError(self.error_messages['required']) def prepare_value(self, value): if value is not None and hasattr(value, '__iter__'): return ','.join((unicode(tag) for tag in value)) return value def widget_attrs(self, widget): res = super(TagitField, self).widget_attrs(widget) or {} res["class"] = "tagit" return res 

प्रपत्र फ़ील्ड की घोषणा में, विजेट निर्दिष्ट करें। सामान्य मापदंडों के अलावा, हम कंस्ट्रक्टर को एक टैग मॉडल देते हैं, जिसके साथ हम टैग नामों की सूची को to_python विधि में टैग ऑब्जेक्ट्स की सूची में बदल देते हैं। पहले से तैयार विधि उलटा परिवर्तन करती है। Widget_attrs पद्धति में, "फ़ील्ड" विशेषता को छिपे हुए फ़ील्ड में जोड़ें, जिसके द्वारा स्क्रिप्ट उन्हें टैग-इट प्लगइन को लागू करने के लिए आवश्यक फ़ील्ड खोजेगी! ...
स्क्रिप्ट स्वयं tagit_widget.js फ़ाइल में स्थित है और इसके निम्न रूप हैं:

 $(document).ready(function() { $(".tagit").tagit({ allowSpaces: true, autocomplete: {delay: 0, minLength: 2, source: "/tag_autocomplete/" } }); }); 

अतिरिक्त प्लगइन विकल्प यहां मिल सकते हैं । मैं केवल यह कह सकता हूं कि यहां मैं टैग (रिक्त स्थान) को टैग करने की अनुमति देता हूं, प्रवेश (देरी) के बाद बिना देरी के ऑटो-पूरा करता हूं, दूसरे वर्ण में प्रवेश करने के साथ शुरू होता है (minLength) और हमारे विचार (स्रोत) से विकल्प ले रहा है।

निष्कर्ष

मैदान उपयोग के लिए तैयार है। आप इसे इस प्रकार लगा सकते हैं:

 from models import Tag class SomeForm(forms.Form): tag = TagitField(Tag, label='Tags', required=True) 

मुख्य बात यह है कि टेम्पलेट में इस फॉर्म से स्टैटिक्स को जोड़ना न भूलें

 <!doctype html> <html> <head> <title>Tag-It!</title> {{some_form.media}} </head> <body> <form action=""> {{some_form.as_p}} </form> </body> </html> 

एक अच्छा django कोडिंग है।