HowTo कॉम्पोनेंट
"कैसे करें: कॉम्पोनेंट", वेब कॉम्पोनेंट का एक कलेक्शन है. इनमें यूज़र इंटरफ़ेस (यूआई) के सामान्य पैटर्न लागू किए जाते हैं. इन बदलावों का मकसद, शिक्षा से जुड़ा संसाधन उपलब्ध कराना है. अलग-अलग कॉम्पोनेंट को लागू करने के बारे में ज़्यादा जानकारी के लिए, टिप्पणियों के साथ दी गई जानकारी पढ़ें. इससे आपको इन कॉम्पोनेंट के बारे में ज़्यादा जानकारी मिल सकती है. ध्यान दें कि ये यूज़र इंटरफ़ेस (यूआई) लाइब्रेरी नहीं हैं. साथ ही, इनका इस्तेमाल प्रोडक्शन में नहीं किया जाना चाहिए.
घटक
<howto-checkbox>: फ़ॉर्म में बूलियन विकल्प दिखाता है. सबसे सामान्य टाइप का चेकबॉक्स, ड्यूअल-टाइप होता है. इसमें उपयोगकर्ता, सही का निशान लगाने और हटाने के बीच टॉगल कर सकता है.<howto-tabs>: कॉन्टेंट को कई पैनल में बांटकर, दिखने वाले कॉन्टेंट को सीमित करता है.<howto-tooltip>: यह एक पॉप-अप है, जो किसी एलिमेंट पर कीबोर्ड फ़ोकस होने या माउस घुमाने पर, उस एलिमेंट से जुड़ी जानकारी दिखाता है.
लक्ष्य
हमारा मकसद, ऐसे बेहतरीन कॉम्पोनेंट लिखने के सबसे सही तरीके बताना है जो ऐक्सेस किए जा सकते हों, बेहतर परफ़ॉर्म करते हों, जिन्हें मैनेज किया जा सकता हो, और जिनमें स्टाइल आसानी से लागू की जा सकती हो. हर कॉम्पोनेंट पूरी तरह से अलग होता है, ताकि इसे रेफ़रंस के तौर पर लागू किया जा सके.
सुलभता
ये कॉम्पोनेंट, WAI ARIA Authoring Practices का पूरी तरह से पालन करते हैं. यह Accessible Rich Internet Application (एरिया) स्टैंडर्ड के बारे में बताने और उसे दिखाने के लिए बनी एक गाइड है. अगर आपको ARIA के बारे में जानकारी नहीं है, तो WebFundamentals पर हमारा परिचय देखें. हर कॉम्पोनेंट, लेखन के तरीकों के काम के सेक्शन से लिंक होता है. कोड में बदलाव करने से पहले, हमारा सुझाव है कि आप लेख लिखने के तरीकों से जुड़ा सेक्शन पढ़ें. हालांकि, ऐसा करना ज़रूरी नहीं है.
परफ़ॉर्मेंस
वेब डेवलपमेंट में, "परफ़ॉर्मेंस" शब्द का इस्तेमाल कई चीज़ों के लिए किया जा सकता है. <howto> के संदर्भ में, परफ़ॉर्मेंस का मतलब ज़्यादातर उन ऐनिमेशन से होता है जो मोबाइल डिवाइसों पर भी लगातार 60fps पर चलते हैं.
विज़ुअल में बदलाव करने की सुविधा
लेआउट या चुनी गई या चालू स्थिति को दिखाने के अलावा, कॉम्पोनेंट को स्टाइल नहीं किया जाता. ऐसा इसलिए किया जाता है, ताकि लागू करने के दौरान विज़ुअल को आसानी से बदला जा सके और उस पर फ़ोकस किया जा सके. डिज़ाइन पर समय बर्बाद किए बिना, हम कोड को सिर्फ़ उस हिस्से तक सीमित रखते हैं जो कॉम्पोनेंट को काम करने के लिए ज़रूरी है. अगर कॉम्पोनेंट के काम करने के लिए किसी स्टाइल की ज़रूरत है, तो स्टाइल को टिप्पणी के साथ मार्क किया जाएगा. इसमें इसकी वजह बताई जाएगी.
आसानी से मैनेज किया जा सकने वाला कोड
'कैसे करें: कॉम्पोनेंट' रेफ़रंस के तौर पर लागू किए गए हैं. इसलिए, हमने ज़्यादा समय इस बात पर लगाया है कि कोड को पढ़ने और समझने में आसानी हो. साथ ही, उसमें ज़्यादा से ज़्यादा टिप्पणियां की गई हैं.
नॉन-लक्ष्य
लाइब्रेरी / फ़्रेमवर्क / टूलकिट हो
<howto> कॉम्पोनेंट को npm, bower या किसी अन्य प्लैटफ़ॉर्म पर पब्लिश नहीं किया जाता, क्योंकि इन्हें प्रोडक्शन में इस्तेमाल नहीं किया जाता. कम शब्दों में और आसानी से पढ़े जा सकने वाले कोड के लिए, हम मॉडर्न JavaScript API का इस्तेमाल कर रहे हैं. साथ ही, वेब कॉम्पोनेंट के स्टैंडर्ड को लागू करने वाले मॉडर्न ब्राउज़र के साथ काम कर रहे हैं. इन लागू करने के तरीकों को पढ़ने के बाद, अपनी ज़रूरतों के हिसाब से कोड में बदलाव किया जा सकता है.
पुराने सिस्टम के साथ काम करना
सीधे तौर पर कोड पर भरोसा नहीं किया जाना चाहिए. अगर किसी एलिमेंट को लागू करने का बेहतर तरीका मिलता है, तो हो सकता है कि हम किसी भी एलिमेंट के लागू होने और एपीआई में काफ़ी बदलाव कर दें. ऐसा ज़्यादातर मामलों में होगा. यह एक ऐसा रिसॉर्स है जिसे अपडेट किया जाता रहता है. यहां वेब यूज़र इंटरफ़ेस (यूआई) बनाने के सबसे सही तरीकों को शेयर, एक्सप्लोर, और उन पर चर्चा की जा सकती है.
पूरी हो चुकी हो
फ़िलहाल, हम WAI ARIA Authoring Practices में मौजूद *सभी *कॉम्पोनेंट लागू नहीं करते और शायद आगे भी न करें. हालांकि, अन्य <howto> कॉम्पोनेंट में इस्तेमाल किए गए सिद्धांतों का फिर से इस्तेमाल करने से, पाठकों को ऐसे कॉम्पोनेंट लागू करने में मदद मिल सकती है जो मौजूद नहीं हैं.