पीडीएफ के लिए जावास्क्रिप्ट

वह घंटा दूर नहीं है जब पीडीएफ दस्तावेजों को पूरी तरह से जावास्क्रिप्ट का उपयोग करके प्रदर्शित किया जा सकता है । एक ही समय में, विपरीत संभावना, अर्थात् पीडीएफ दस्तावेजों में जावास्क्रिप्ट का उपयोग, बहुत लंबे समय से मौजूद है। इस लेख में इस पर चर्चा की जाएगी।

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

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

पीडीएफ में जावास्क्रिप्ट का उपयोग अक्सर निम्नलिखित कार्यों के लिए किया जाता है:

• कुछ घटनाओं के आधार पर एक दस्तावेज़ की सामग्री को बदलने के लिए। उदाहरण के लिए, प्रिंट करते समय दस्तावेज़ का हिस्सा छिपाएं। या जब आप कोई दस्तावेज़ खोलते हैं, तो स्वचालित रूप से फॉर्म फ़ील्ड के भाग को भरें।
• पाठक क्रियाओं को सीमित करने के लिए। उदाहरण के लिए, प्रपत्र भरते समय इनपुट मानों को मान्य करने के लिए।

जावास्क्रिप्ट कोड की व्याख्या करने के लिए पीडीएफ दर्शकों के लिए, एक विशेष जावास्क्रिप्ट एपीआई परिभाषित किया गया है। प्रारंभ में, एपीआई केवल एडोब एक्रोबेट उत्पाद परिवार के लिए विकसित किया गया था, लेकिन वैकल्पिक दर्शक, एक नियम के रूप में, इस एपीआई के कुछ बुनियादी सबसेट का भी समर्थन करते हैं।

आइए पीडीएफ दस्तावेजों में जावास्क्रिप्ट का उपयोग करने के कुछ व्यावहारिक उदाहरण देखें।

नमस्ते दुनिया

हम पारंपरिक हैलो वर्ल्ड उदाहरण के साथ विषय पर अपनी चर्चा शुरू करते हैं। यह और बाद के उदाहरण पीडीएफ दस्तावेजों के साथ काम करने के लिए C # भाषा और Docotic.Pdf लाइब्रेरी का उपयोग करते हैं। सभी उदाहरणों के कोड के साथ स्रोत कोड का एक लिंक लेख के अंत में दिया गया है।

using BitMiracle.Docotic.Pdf; namespace JavascriptInPdf { public static class Demo { public static void Main(string[] args) { PdfDocument pdf = new PdfDocument(); pdf.OnOpenDocument = pdf.CreateJavaScriptAction("app.alert(\", !\", 3);"); pdf.Save("Hello world.pdf"); } } } 

यदि आप Adobe Reader में इस कोड द्वारा बनाए गए दस्तावेज़ को खोलते हैं, तो आपको निम्नलिखित कुछ दिखाई देगा:



उदाहरण में क्या होता है? निचला रेखा है

 pdf.OnOpenDocument = pdf.CreateJavaScriptAction("app.alert(\", !\", 3);"); 

पीडीएफ प्रारूप में कार्यों के लिए समर्थन शामिल है - ये ऐसी क्रियाएं हैं जो किसी विशेष घटना पर होती हैं। उदाहरण के लिए, जब कुछ पीडीएफ दस्तावेज़ में सामग्री की तालिका में हम पृष्ठ संख्या के साथ लिंक पर क्लिक करते हैं, तो संबंधित पृष्ठ पर जाने के लिए एक निश्चित कार्रवाई शुरू हो जाती है:



जावास्क्रिप्ट के लिए भी एक संबंधित कार्रवाई है। हम इसे PdfDocument.CreateJavaScriptAction विधि का उपयोग करके बनाते हैं, जिसमें हम कोड को JS पैरामीटर के रूप में पास करते हैं। हम उस कार्रवाई को ऑनऑपनडेन्यूमेंट घटना से जोड़ते हैं जो तब होती है जब दर्शक दस्तावेज़ खोलता है।

जावास्क्रिप्ट ही इस तरह दिखता है:

 app.alert(", !", 3); 

स्टैटिक ऐप क्लास जावास्क्रिप्ट एपीआई का हिस्सा है और यह व्यूअर एप्लिकेशन के साथ इंटरैक्ट करने के लिए कई तरीके प्रदान करता है। विशेष रूप से, इसमें संदेश के साथ एक मोडल संवाद प्रदर्शित करने के लिए चेतावनी पद्धति के कई अधिभार शामिल हैं। इस उदाहरण में, अधिभार का उपयोग दूसरे वैकल्पिक पैरामीटर के साथ किया जाता है - संवाद आइकन का सूचकांक, 3 का मान स्टेटस आइकन से मेल खाता है।

सरल से जटिल तक

अधिक यथार्थवादी उदाहरण पर विचार करें।

कई पीडीएफ दस्तावेज़ों को भरने के लिए कुछ रूपों का वर्णन किया जाता है - यह एक बैंक जमा समझौता, एक वीजा आवेदन पत्र या एक विदेशी आवेदन हो सकता है। पासपोर्ट, छुट्टी का आवेदन आदि। काफी सुविधाजनक, चूंकि इस तरह के एक फॉर्म को सीधे दर्शक में भरा जा सकता है और बचाया या मुद्रित किया जा सकता है। PDF दस्तावेज़ों के लेखक प्रपत्रों को उपयोगकर्ता के लिए जावास्क्रिप्ट का उपयोग करके उन्हें भरना आसान बना सकते हैं।

वास्तविक दस्तावेजों में अक्सर भरने की तारीख दर्ज करने के लिए फ़ील्ड होते हैं। उदाहरण के लिए, यह इस तरह दिख सकता है:



सिद्धांत रूप में, एक दस्तावेज़ बनाते हुए, हम वहां रुक सकते हैं। हालांकि, आप थोड़ा आगे जा सकते हैं और भरने के कार्य को थोड़ा सरल कर सकते हैं - उदाहरण के लिए, डिफ़ॉल्ट तिथि को वर्तमान एक पर सेट करना - 99% मामलों में यह ठीक वही है जो आवश्यक है।

डिफ़ॉल्ट तिथि निर्धारित करें

स्क्रीनशॉट के रूप में दिनांक के लिए फ़ील्ड बनाने का C # कोड, इस मामले में इतना दिलचस्प नहीं है। जावास्क्रिप्ट के बारे में केवल एक भाग पर विचार करें। दस्तावेज़ खोलते समय, खेतों में वर्तमान तिथि निर्धारित करना आवश्यक है, यह निम्नानुसार किया जाता है:

 function setDay(date) { var dayField = this.getField("day"); if (dayField.value.length == 0) { dayField.value = util.printd("dd", date); } } function setMonth(date) { var monthField = this.getField("month"); if (monthField.value.length == 0) { monthField.value = util.printd("date(ru){MMMM}", date, true); } } function setYear(date) { var yearField = this.getField("year"); if (yearField.value.length == 0) { yearField.value = util.printd("yyyy", date); } } function setCurrentDate() { var now = new Date(); setDay(now); setMonth(now); setYear(now); } setCurrentDate(); 

पिछले उदाहरण की तुलना में, जेएस कोड की मात्रा में वृद्धि हुई है, इसलिए उद्धरणों से बचने और लाइन ब्रेक लगाने की आवश्यकता के कारण सीधे सी # लाइन में इसका उपयोग करना असुविधाजनक हो गया है। इसलिए, हम इस कोड को संसाधनों में डालेंगे, फिर स्क्रिप्ट का उपयोग इस तरह किया जाएगा:

 pdf.OnOpenDocument = pdf.CreateJavaScriptAction(Resources.SetCurrentDate); 

परिणामस्वरूप, जब आप दस्तावेज़ खोलते हैं, तो हम निम्नलिखित चित्र देखेंगे:



महीना सेट करने के लिए कोड पर ध्यान दें - हम स्थानीय महीने का प्रदर्शन करने के लिए एक विशेष अधिभार का उपयोग करते हैं ।printd विधि।

 monthField.value = util.printd("date(ru){MMMM}", date, true); 

यह एडोब रीडर में उत्कृष्ट परिणाम देता है, लेकिन, दुर्भाग्य से, यह गारंटी नहीं है कि अन्य दर्शक ऐसे विशिष्ट डिजाइनों का सही समर्थन करेंगे। दस्तावेज़ डिज़ाइन करते समय, इसे ध्यान में रखा जाना चाहिए। यह अधिक वर्बोज़ (वांछित मामले में महीने का नाम प्राप्त करना) के साथ इस कोड को बदलने के लायक हो सकता है, लेकिन बड़ी संख्या में दर्शकों द्वारा समर्थित है।

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

दर्ज किए गए मानों की मान्यता

यदि आपको फॉर्म भरते समय तारीख बदलने की आवश्यकता है, तो यह समझ में आता है कि दिन और वर्ष के लिए खेतों में केवल संख्या दर्ज करने की अनुमति है। हम इसके लिए निम्नलिखित जावास्क्रिप्ट कोड का उपयोग करते हैं:

 function validateNumeric(event) { var validCharacters = "0123456789"; for (var i = 0; i < event.change.length; i++) { if (validCharacters.indexOf(event.change.charAt(i)) == -1) { app.beep(0); event.rc = false; break; } } } validateNumeric(event); 

C # कोड में, हम इनपुट चरित्र की जांच करने के लिए नियंत्रण के OnKeyPress घटना का उपयोग करते हैं:

 PdfJavaScriptAction validateNumericAction = m_document.CreateJavaScriptAction(Resources.ValidateNumeric); dayTextBox.OnKeyPress = validateNumericAction; yearTextBox.OnKeyPress = validateNumericAction; 

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

फ़ील्ड मान सिंक्रनाइज़ेशन

अक्सर ऐसा होता है कि एक दस्तावेज़ में एक ही जानकारी को कई बार इंगित करने की आवश्यकता होती है। और जावास्क्रिप्ट का उपयोग करते हुए पीडीएफ दस्तावेजों के मामले में, आप उपयोगकर्ता को समान कार्यों को दोहराने से बचा सकते हैं।

मान लीजिए कि आपके पास एक दस्तावेज है जो इस तरह दिखता है:



हम इसे संशोधित करते हैं ताकि जब नाम के साथ फ़ील्ड में से एक बदल जाए, तो दूसरा भी अपडेट हो जाए।

हम एक सरल जावास्क्रिप्ट फ़ंक्शन का उपयोग करते हैं:

 function synchronizeFields(sourceFieldName, destinationFieldName) { var source = this.getField(sourceFieldName); var destination = this.getField(destinationFieldName); if (source != null && destination != null) { destination.value = source.value; } } 

और निम्नलिखित C # कोड भी:

 PdfDocument pdf = new PdfDocument(“Names.pdf”); pdf.SharedScripts.Add( pdf.CreateJavaScriptAction(Resources.SynchronizeFields) ); pdf.GetControl("name0").OnLostFocus = pdf.CreateJavaScriptAction("synchronizeFields(\"name0\", \"name1\");"); pdf.GetControl("name1").OnLostFocus = pdf.CreateJavaScriptAction("synchronizeFields(\"name1\", \"name0\");"); pdf.Save("NamesModified.pdf"); 

अब, यदि फ़ोकस को किसी भी टेक्स्ट बॉक्स द्वारा खो दिया जाता है, तो दूसरे का मान अपडेट किया जाएगा। पहले से मिले तकनीक पर ध्यान न दें - सामान्य जावास्क्रिप्ट कोड को PdfDocument.SaredScripts संग्रह में रखा गया है, और फिर हमें विशिष्ट कार्यों से सामान्य कोड में परिभाषित फ़ंक्शन को कॉल करने का अवसर मिलता है।

संक्षेप में कहना

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

फिर भी, दस्तावेज़ की सामग्री की तुलना में ऐसी विशेषताएं माध्यमिक हैं, इसलिए पीडीएफ में जावास्क्रिप्ट का व्यावहारिक मूल्य इतना अधिक नहीं है। इसके अतिरिक्त, कई समस्याएं इससे जुड़ी हैं:

• पारंपरिक वेब विकास के मामले में जावास्क्रिप्ट कोड लिखना अधिक कठिन है। आपको लिखित कोड की शुद्धता को सत्यापित करने के लिए एक दस्तावेज़ बनाने और खोलने की आवश्यकता है।
• जावास्क्रिप्ट पूरी तरह से केवल Adobe दर्शकों द्वारा समर्थित है। वैकल्पिक दर्शकों में, समर्थन पूरी तरह से सीमित या अनुपस्थित है।
• जावास्क्रिप्ट को पीडीएफ दर्शक में अक्षम किया जा सकता है।
• सैद्धांतिक रूप से, किसी दस्तावेज़ में जावास्क्रिप्ट स्क्रिप्ट का निष्पादन असुरक्षित है, और समय-समय पर विभिन्न कमजोरियों का पता लगाया जाता है।

वर्णित जानकारी के साथ सशस्त्र, यदि एक पीडीएफ दस्तावेज़ एक बार खोलने पर आपको शतरंज खेलने का सुझाव देता है, तो आश्चर्यचकित न हों, और उस समय फॉक्सिट रीडर को सिस्टम से चुपचाप हटा दें;)

आप यहां लेख से नमूना कोड डाउनलोड कर सकते हैं ।