#फ़ॉर्मेटर

फ़ॉर्मेटर का उपयोग कच्चे डेटा को पढ़ने में आसान टेक्स्ट में बदलने के लिए किया जाता है। इन्हें डेटा पर कोलन (:) का उपयोग करके लागू किया जाता है और इन्हें एक श्रृंखला में इस्तेमाल किया जा सकता है, जहाँ प्रत्येक फ़ॉर्मेटर का आउटपुट अगले के लिए इनपुट बन जाता है। कुछ फ़ॉर्मेटर स्थिर (constant) या गतिशील (dynamic) पैरामीटर का समर्थन करते हैं।

#अवलोकन

#1. सिंटैक्स स्पष्टीकरण

फ़ॉर्मेटर को कॉल करने का मूल तरीका इस प्रकार है:

{d.property:formatter1:formatter2(...)}

उदाहरण के लिए, स्ट्रिंग "JOHN" को "John" में बदलने के उदाहरण में, पहले सभी अक्षरों को छोटे अक्षरों में बदलने के लिए lowerCase का उपयोग किया जाता है, और फिर पहले अक्षर को बड़ा करने के लिए ucFirst का उपयोग किया जाता है।

#2. उदाहरण

डेटा:

{
  "name": "JOHN",
  "birthday": "2000-01-31"
}

टेम्पलेट:

My name is {d.name:lowerCase:ucFirst}. I was born on {d.birthday:formatD(LL)}.

#3. परिणाम

रेंडर होने के बाद, आउटपुट इस प्रकार होगा:

My name is John. I was born on January 31, 2000.

#स्थिर पैरामीटर

#1. सिंटैक्स स्पष्टीकरण

कई फ़ॉर्मेटर एक या एक से अधिक स्थिर पैरामीटर का समर्थन करते हैं, जो कॉमा से अलग किए जाते हैं और आउटपुट को संशोधित करने के लिए कोष्ठकों में रखे जाते हैं। उदाहरण के लिए, :prepend(myPrefix) टेक्स्ट के सामने "myPrefix" जोड़ देगा।

ध्यान दें: यदि पैरामीटर में कॉमा या स्पेस शामिल हैं, तो इसे सिंगल कोट्स में बंद करना होगा, उदाहरण के लिए: prepend('my prefix')।

#2. उदाहरण

टेम्पलेट उदाहरण (विशिष्ट फ़ॉर्मेटर के उपयोग के लिए विवरण देखें)।

#3. परिणाम

आउटपुट में टेक्स्ट के सामने निर्दिष्ट प्रीफिक्स जोड़ा जाएगा।

#गतिशील पैरामीटर

#1. सिंटैक्स स्पष्टीकरण

फ़ॉर्मेटर गतिशील पैरामीटर का भी समर्थन करते हैं। ये पैरामीटर एक बिंदु ('.') से शुरू होते हैं और इन्हें कोट्स में बंद नहीं किया जाता है।
गतिशील पैरामीटर निर्दिष्ट करने के दो तरीके हैं:

• पूर्ण JSON पाथ: d. या c. से शुरू होता है (जो मूल डेटा या पूरक डेटा को संदर्भित करता है)।
• सापेक्ष JSON पाथ: एकल बिंदु ('.') से शुरू होता है, यह दर्शाता है कि प्रॉपर्टी को वर्तमान पैरेंट ऑब्जेक्ट से खोजा गया है।

उदाहरण के लिए:

{d.subObject.qtyB:add(d.subObject.qtyC)}

इसे सापेक्ष पाथ के रूप में भी लिखा जा सकता है:

{d.subObject.qtyB:add(.qtyC)}

यदि आपको ऊपरी स्तर (पैरेंट या उससे ऊपर) के डेटा तक पहुँचना है, तो आप कई बिंदुओं का उपयोग कर सकते हैं:

{d.subObject.qtyB:add(..qtyA):add(.qtyC)}

#2. उदाहरण

डेटा:

{
  "id": 10,
  "qtyA": 20,
  "subObject": {
    "qtyB": 5,
    "qtyC": 3
  },
  "subArray": [{
    "id": 1000,
    "qtyE": 3
  }]
}

टेम्पलेट में उपयोग:

{d.subObject.qtyB:add(d.subObject.qtyC)}      // परिणाम: 8 (5 + 3)
{d.subObject.qtyB:add(.qtyC)}                   // परिणाम: 8
{d.subObject.qtyB:add(..qtyA):add(.qtyC)}        // परिणाम: 28 (5 + 20 + 3)
{d.subArray[0].qtyE:add(..subObject.qtyC)}       // परिणाम: 6 (3 + 3)

#3. परिणाम

प्रत्येक उदाहरण का परिणाम क्रमशः 8, 8, 28 और 6 है।

ध्यान दें: कस्टम इटरेटर या ऐरे फ़िल्टर को गतिशील पैरामीटर के रूप में उपयोग करने की अनुमति नहीं है, उदाहरण के लिए:

{d.subObject.qtyB:add(..subArray[i].qtyE)}
{d.subObject.qtyB:add(d.subArray[i].qtyE)}