Zend_Form_Element: अपना तत्व बनाएं

0. परिचय।

विकास प्रक्रिया में, बहुत बार आपको विभिन्न कस्टम चयन, इनपुट, फ़ाइल डाउनलोडर और बहुत कुछ का उपयोग करने की आवश्यकता होती है। इस मामले में, आपको क्लाइंट साइड पर अतिरिक्त हैंडलर लिखना होगा, क्योंकि ZF को मानक फॉर्म एलिमेंट्स के अलावा बॉक्स से कुछ भी नहीं पता है (कैप्चा एक अपवाद है)। यह लेख jQuery के लिए facebook- जैसे टेक्स्टबॉक्स लिस्ट प्लगइन के आधार पर एक तत्व के निर्माण पर चर्चा करेगा, जो इस तरह दिखता है:

1. थ्योरी।

दरअसल, एक नया तत्व बनाने के लिए, दो शर्तों को पूरा करना होगा:

1. Zend_Form_Element_Xhtml से विरासत में मिला एक तत्व वर्ग की आवश्यकता है;
2. सहायक देखें, जो प्रतिपादन के लिए जिम्मेदार होगा;
3. तत्व का नाम हमारे नेमस्पेस में होना चाहिए (इस मामले में ईव_) और इसे सही ढंग से कॉन्फ़िगर किया जाना चाहिए।

2. अभ्यास।

2.1। एक ईव_Form_Element_TextboxList बनाएं

वर्ग संरचना में निम्नलिखित मुख्य भाग होते हैं:

1. तत्व को प्रस्तुत करने वाले दृश्य सहायक को निर्दिष्ट करना;
2. डिफ़ॉल्ट विकल्प सेट करना;
3. सेटिंग (या संयोजन) विकल्प (वैकल्पिक) के लिए विधि अधिभार;
4. इस स्तर पर अन्य विकल्पों \ तरीकों की आवश्यकता नहीं है और Zend_Form_Element में देखा जा सकता है।

एलिमेंट क्लास के मुख्य कार्य वेरिफाइटरों के डेकोरेटर \ फिल्टर और प्रोसेसिंग ऑप्शंस को उनके हेल्पर को व्यू हेल्पर में ट्रांसफर करने के लिए प्रबंधित कर रहे हैं।
टिप्पणियों के साथ लिस्टिंग में कक्षा का स्रोत कोड:

class Eve_Form_Element_TextboxList extends Zend_Form_Element_Xhtml { /** *   * @var string */ public $helper = 'formTextboxList'; /** *  - * @var array */ public $options = array( 'js_main' => '/js/jquery.textboxlist.js', //      'js_autocomplete' => '/js/jquery.textboxlist.autocomplete.js', //       ( ) 'js_growinginput' => '/js/jquery.growinginput.js', //   'use_autocompletion' => '0', //     'autocomplete_script' => null, // backend,    'css_main' => '/css/textboxlist.css', //  'css_autocomplete' => '/css/textboxlist.autocomplete.css', ); /** *         * * @param array $options * @return Eve_Form_Element_TextboxList */ public function setOptions(array $options) { /** *     ,    ,    *     */ $diff = array_intersect_key($options, $this->options); $this->options = array_merge($this->options, $diff); /** *      ,     html    */ foreach ($diff as $key => $option) { unset ($options[$key]); } parent::setOptions($options); return $this; } } 

2.2। एक दृश्य सहायक बनाएं Eve_View_Helper_FormTextboxList

कक्षा में एक विधि होनी चाहिए जो वर्ग के नाम से मेल खाती है, जिसे सहायक तक पहुँचने पर स्वचालित रूप से कहा जाता है।
लिस्टिंग कोड + टिप्पणियाँ:

 class Eve_View_Helper_FormTextboxList extends Zend_View_Helper_FormElement { /** * Generates a 'textboxList' element. * * @access public * * @param string|array $name If a string, the element name. If an * array, all other parameters are ignored, and the array elements * are extracted in place of added parameters. * * @param mixed $value The element value. * * @param array $attribs Attributes for the element tag. * * @return string The element XHTML. */ public function formTextboxList($name, $value = '', $attribs = null, $options = null) { $id = $name; $elemId = $this->view->escape($id); $xhtml = '<input type="text" name="' . $this->view->escape($name) . '" id="' . $this->view->escape($id) . '"'; //     if (!empty($value)) { $xhtml .= ' value="' . $this->view->escape($value) . '"'; } //     html  $xhtml .= $this->_htmlAttribs($attribs); $xhtml .= '/>' . PHP_EOL; /** *   ,     , ..  ,     *    ,      . */ // add content and end tag $xhtml .= $content . ($this->view->doctype()->isXhtml() ? '/>' : '>') . PHP_EOL; $this->view->headScript->appendFile($options['js_growinginput']); $this->view->headScript->appendFile($options['js_main']); $this->view->headScript->appendFile($options['js_autocomplete']); $this->view->headLink->appendStylesheet($options['css_main']); $this->view->headLink->appendStylesheet($options['css_autocomplete']); $xhtml .= '<script type="text/javascript"> var tl_' . $elemId . ' = new $.TextboxList("#' . $elemId. '", {unique: true, plugins: {autocomplete: {}}}); '; if ((int) $options['use_autocompletion'] == 1) { if (!$options['autocomplete_script']) { throw new Zend_View_Exception('No autocompletion backend is set for ' . __CLASS__ . ' plugin.'); } else { $.getJSON('" . $options['autocomplete_script'] . "', null, function (data) { tl.plugins['autocomplete'].setValues(data); tl.getContainer().removeClass('textboxlist-loading'); });"; } } $xhtml .= '</script>'; return $xhtml; } } 

2.3। एक विन्यास के माध्यम से प्रारंभ।

यह कई के लिए सामान्य से अलग नहीं है:

 elements.categories.type = textboxList elements.categories.options.label = Categories elements.categories.options.use_autocompletion = 1 elements.categories.options.autocomplete_script = /categories/ajax/get-all/ 

3. आउटरो।

इस प्रकार, एक अलग तत्व बनाया गया था जो पूरी तरह से नए प्रकार के इनपुट को आकर्षित करता है।
Jquery प्लगइन वहाँ पर पाया जा सकता है - http://devthought.com/projects/jquery/textboxlist/ ।
प्लगइन के पास पर्याप्त विकल्प हैं जो इस घटक के हिस्से के रूप में लागू नहीं किए गए थे। और हां, प्लगइन एक मुफ्त लाइसेंस के तहत नहीं है।

UPD: 1. अपडेट किया गया ( यह टिप्पणी देखें)