Drupal 7 में सही aaxax अनुरोध

कई पुराने जमाने के लोग $ .ajax () का उपयोग करके अपने हाथों से अजाक्स अनुरोध भेजते हैं, जबकि ड्रुपल के पास इसके लिए काफी लचीला तंत्र है, जो कर्नेल से तैयार कोड का पुन: उपयोग करने और जेएस कोड की संख्या को कम करने की अनुमति देता है।
इसका उपयोग शुरू करने के लिए, आपको डिलीवरी कॉलबैक, Drupal.ajax और JS-कमांड जैसी चीजों से निपटने की आवश्यकता है।

डिलीवरी कॉलबैक

मैं संक्षेप में वर्णन करूंगा, क्योंकि यह प्रश्न एक अलग विषय का हकदार है।
D6 में, आपके कॉलबैक मेनू को समाप्त html लौटना चाहिए था, जो तब थीम ('पेज', $ सामग्री) में बदल गया, और आपको पेज मिल गया।
वापस लौटने के लिए, उदाहरण के लिए, पेज नंबर को दरकिनार करते हुए json डेटा, आपको कॉलबैक फ़ंक्शन के अंत में drupal_json ($ परिणाम), और बाहर निकलें () लिखना होगा।
D7 ने एक नई अवधारणा पेश की - 'डिलीवरी कॉलबैक'। इसका सार यह है कि कॉलबैक मेनू एक मध्यवर्ती रूप में प्रतिक्रिया देता है - एक निश्चित प्रारूप में एक सरणी के रूप में (Drupal.org पर रेंडर सरणियों का विवरण देखें), और एक वितरण कॉलबैक के रूप में संबंधित हुक_मेनू तत्व में निर्दिष्ट फ़ंक्शन यह निर्धारित करेगा कि क्लाइंट को कैसे जवाब दिया जाए। - एक पृष्ठ के रूप में अंधेरा या json में परिवर्तित।

Drupal.ajax

Drupal के पास अजाक्स अनुरोध भेजने का एक मानक तरीका है।
कार्यान्वयन के आधार पर, उन्होंने रूपों के साथ काम करने के बारे में सोचा (वास्तव में, फॉर्म एपीआई में इसका उपयोग हर जगह किया जाता है), लेकिन कुछ भी हमें कहीं भी उपयोग करने से रोकता है।
सबसे सरल उदाहरण इस प्रकार है:

var settings = {url : myUrl}; var ajax = new Drupal.ajax(false, false, settings); ajax.eventResponse(ajax, {}); 

तीसरी पंक्ति को तुरंत अनुरोध भेजने की आवश्यकता है। यदि आप इसे छोड़ते हैं, तो अनुरोध तब भेजा जाएगा जब settings.event JS इवेंट (डिफ़ॉल्ट 'मूसडाउन'), Drupal.ajax () के दूसरे तर्क के रूप में पारित DOM / jQuery तत्व से अधिक हो।
हमारे मामले में, मैं बस तुरंत एक अनुरोध भेजना चाहता हूं, इसलिए यह सब छोड़ दिया गया है।
यह ध्यान दिया जाना चाहिए कि Drupal.ajax को misc / ajax.js फ़ाइल में घोषित किया गया है, इसलिए इसे शामिल करना सुनिश्चित करें।

यदि आपको किसी तरह से अनुरोध प्रसंस्करण के व्यवहार को प्रभावित करने की आवश्यकता है, तो आपको बस Drupal.ajax से विरासत में प्राप्त करने की आवश्यकता है, वांछित विधि (उदाहरण के लिए सफलता कॉलबैक) को ओवरराइड करें, और फिर अपने स्वयं के वर्ग का एक ऑब्जेक्ट बनाएं।
ईवेंट हैंडलर को प्रभावित करने का एक और तरीका है - केवल कोड में समान नाम के साथ फ़ंक्शन को फिर से परिभाषित करें (स्क्रिप्ट में जो बाद में ajax.js से जुड़ा हुआ है), हालांकि मैं इस दृष्टिकोण की अनुशंसा नहीं करता हूं, कभी-कभी इसे अभी भी लागू करने की आवश्यकता है, उदाहरण के लिए, उन सभी स्थानों को प्रभावित करें जहां नए Drupal.ajax पहले से उपयोग में हैं, और आप वहां क्रॉल नहीं कर रहे हैं (दूसरे मॉड्यूल की स्क्रिप्ट)।
मैं यह भी ध्यान देता हूं कि Drupal.ajax POST भेजेगा, और json डेटाटाइप होगा। यदि यह आपको सूट नहीं करता है, तो आपको इसे फिर से परिभाषित / विरासत करने की आवश्यकता है।

जे एस-आदेशों

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

 function your_module_ajax_menu_callback() { // ... $result = array( '#type' => 'ajax', '#commands' => array( array( 'command' => $command_name, ), ), ); return $result; } 

जहाँ $ कमांड_नाम Drupal.ajax.prototyp.commands ऑब्जेक्ट से संपत्ति / JS फ़ंक्शन का नाम है।
इस मामले में, $ परिणाम रेंडर सरणी के लिए विकल्पों में से एक है, और इसके लिए आवश्यक हेडर के साथ जोंस डेटा को सही ढंग से परिवर्तित करने के लिए, इस कॉलबैक के अनुरूप हुक_मेनू तत्व को 'डिलीवरी कॉलबैक' - 'ajax_deliver' के रूप में सेट किया जाना चाहिए:

 function your_module_menu() { // ... $items['ajax/your-module/path'] = array( 'title' => 'Get content by AJAX', 'page callback' => 'your_module_ajax_menu_callback', 'page arguments' => array(), 'access arguments' => array('access content'), 'type' => MENU_CALLBACK, 'delivery callback' => 'ajax_deliver', ); return $items; } 

उन्होंने एक उत्तर दिया, लेकिन हमारी टीमों को कौन बुलाएगा? और फिर तीसरा घटक बचाव के लिए आता है - Drupal.ajax।
इसकी मदद से अजाक्स अनुरोध भेजने का मतलब है कि घटना के सफल हैंडलर को पहले ही घोषित कर दिया गया है, यह प्रतिक्रिया से सभी स्थापित आदेशों पर पुनरावृत्ति करेगा और संबंधित कार्यों को कॉल करेगा।

एक उदाहरण पर विचार करें - एक अजाक्स अनुरोध का उपयोग करके सामग्री प्राप्त करना और पृष्ठ पर कुछ कंटेनर में डालने पर जब आप किसी तत्व पर क्लिक करते हैं।
आमतौर पर हम लिखते हैं:

 $('#somen-link').click(function () { $.ajax({ type: 'GET', url: myUrl, dataType: 'html', success: function (data) { // Set up new content. $('div.container').html(data); } }); }); 

हमारे दृष्टिकोण के साथ, हम इसे इस तरह प्रतिस्थापित करेंगे:

 var ajax = new Drupal.ajax(false, '#somen-link', {url : myUrl}); ajax.eventResponse(ajax, {}); 

और कॉलबैक मेनू में ऐसा कोड (डिलीवरी कॉलबैक के रूप में ajax_deliver के बारे में मत भूलना):

 $result = array('#type' => 'ajax'); $result['#commands'][] = ajax_command_insert('div.container', $html); return $result; 

इस प्रकार, हमारे ajax अनुरोध के साथ, हमने ajax_deliver () में कमांड की एक सारणी बनाई है, जिसे json में परिवर्तित किया जाएगा, और फिर सभी कमांडों को Drupal.ajax.prototyp.success में बुलाया जाएगा जैसे ही ब्राउज़र को एक प्रतिक्रिया मिलती है।

Ajax_command_insert () फ़ंक्शन का अर्थ केवल JS कमांड के नाम और मापदंडों के साथ एक सरणी बनाना है।
इस मामले में, $ चयनकर्ता चयनकर्ता के साथ पृष्ठ पर कंटेनर में 'डेटा' कुंजी से सामग्री डालने के लिए:

 array( 'command' => 'insert', 'method' => NULL, 'selector' => $selector, 'data' => $html, 'settings' => $settings, ); 

Ajax_command_ * फ़ंक्शंस की संख्या कर्नेल में ajax.s.s. से पूर्वनिर्धारित कमांड बनाने के लिए कर्नेल में परिभाषित होती है।

आप स्वतंत्र रूप से Drupal.ajax.prototype.commands प्रोटोटाइप में एक फ़ंक्शन जोड़कर अपने आदेशों को स्वतंत्र रूप से परिभाषित कर सकते हैं:

 /** * Ajax delivery command to switch among tabs by ID. */ Drupal.ajax.prototype.commands.gotoTab = function (ajax, response, status) { // response.data is a value setted in 'data' key of command on PHP side. if (response.data) { // ... } }; 

इसे कॉल करने के लिए, आपको केवल 'कमांड' कुंजी के मान के रूप में इसका नाम गेटऑब पर सेट करना होगा:

 $result['#commands'][] = array( 'command' => 'gotoTab', ); 

इस एरे की सभी अतिरिक्त कुंजियाँ हमारे जेएस फ़ंक्शन में प्रतिक्रिया के रूप में उपलब्ध होंगी। YOUR_KEY, उदाहरण के लिए, इंसर्ट कमांड के मामले में प्रतिक्रिया दें। इस तरह हम कोई भी तर्क पारित कर सकते हैं।

यह सब हमें क्या देता है?
सबसे पहले, आदेशों का एक तैयार-तैयार सेट है, और हम आम तौर पर सफलता की घटनाओं के मैनुअल प्रसंस्करण से बच सकते हैं।
कर्नेल द्वारा प्रदान किए गए आदेशों की एक सूची ajax.js में पाई जा सकती है, जहां Drupal.ajax.prototype.commands घोषित किया गया है।

दूसरे, हम अपने आदेशों के कार्यान्वयन को एक बार लिख सकते हैं, और फिर, सर्वर साइड पर, स्क्रिप्ट कोड को बदले बिना, प्रत्येक मामले के लिए आदेशों के एक सेट (या उदाहरण के लिए, किसी को उन्हें हुक_ल्टर के माध्यम से बदलने दें) को प्रबंधित करें।