प्रशिक्षण
Lily अपनाने वाली टीम के लिए स्व-गति पाठ्यक्रम: आठ मॉड्यूल, हर एक में एक लक्ष्य, पढ़ने की सामग्री, असली ब्राउज़र में करने का अभ्यास और उत्तरों सहित स्व-जाँच। कुल लगभग एक दिन; एक बैठक में एक मॉड्यूल अच्छा रहता है।
शुरू करने से पहले
किसी एक फ़्रेमवर्क का ट्यूटोरियल चुनें और पहले उसे पूरा करें। अभ्यासों के लिए किसी उदाहरण ऐप को स्थानीय रूप से चलाएँ, या यहाँ के कॉम्पोनेंट पेज इस्तेमाल करें। आपको कीबोर्ड चाहिए, और मॉड्यूल 8 के लिए स्क्रीन रीडर: macOS और iOS पर VoiceOver, Windows पर NVDA या Android पर TalkBack, सभी मुफ़्त।
मॉड्यूल 1 — हेडलेस का अर्थ
लक्ष्य: जानें कि Lily क्या तय करता है और आप क्या तय करते हैं।
पढ़ें: परिचय पेज, और एक कॉम्पोनेंट पेज, जैसे Button, शुरू से अंत तक।
करें: बिना स्टाइलशीट के एक Button और एक TextInput
रेंडर करें। फिर एक थीम लिंक करें, फिर दूसरी। नोट करें कि क्या बदला और क्या नहीं।
स्व-जाँच: Lily कॉम्पोनेंट कभी क्या नहीं देता? हमेशा क्या देता है?
कभी नहीं: CSS, फ़ॉन्ट, आइकन या चित्र (पिकर के आइकन छोड़कर), अंग्रेज़ी पाठ, डेटा लाना, डिफ़ॉल्ट लोकेल या मुद्रा। हमेशा: सबसे सटीक HTML एलिमेंट, सबसे पहले उसका kebab-case क्लास हुक, जहाँ HTML कम पड़े वहाँ ARIA, कीबोर्ड व्यवहार, और आपके बाकी एट्रिब्यूट आगे भेजना।
स्व-जाँच: आप एक बटन पर लाल किनारा चाहते हैं। वह कहाँ जाएगा?
आपके CSS में, क्लास हुक (.button) पर या आपकी जोड़ी क्लास पर। कॉम्पोनेंट में कभी नहीं।
मॉड्यूल 2 — कीबोर्ड और फ़ोकस
लक्ष्य: हर कॉम्पोनेंट को बिना माउस के इस्तेमाल और परीक्षण करें।
पढ़ें: इनकी कीबोर्ड इंटरैक्शन तालिका: TabBar, Listbox और Dialog।
करें: माउस हटा दें। इन तीनों पेजों पर Tab से डेमो तक पहुँचें और तालिका में दिया सब कुछ करें। डायलॉग खोलें, Escapeदबाएँ, और देखें कि फ़ोकस कहाँ जाता है।
स्व-जाँच: टैब बार केवल एक Tab पड़ाव क्यों लेता है, हर टैब के लिए एक क्यों नहीं?
APG का संयुक्त पैटर्न: Tab विजेटों के बीच चलता है, और तीर कुंजियाँ एक विजेट के भीतर (घूमता tabindex)। दस पड़ावों वाला टैब बार कीबोर्ड उपयोगकर्ता से उसे पार करने के लिए दस बार Tab दबवाता है।
स्व-जाँच: मोडल डायलॉग बंद होने के बाद फ़ोकस कहाँ होना चाहिए?
उस नियंत्रण पर जिसने उसे खोला था। Lily के मोडल डायलॉग showModal()का उपयोग करते हैं, जो डायलॉग खुला रहने तक Tab को भी उसके भीतर रखता है।
मॉड्यूल 3 — नाम, भूमिकाएँ और स्थितियाँ
लक्ष्य: हर नियंत्रण को ऐसा नाम दें जिसे स्क्रीन रीडर बोल सके, आपके शब्दों में।
पढ़ें: इनका ARIA भाग: IconButton और SwitchButton।
करें: अपने ऐप में, उसका डेवलपमेंट सर्वर चलाकर, एक IconButton को उसके labelबिना रेंडर करें। ब्राउज़र कंसोल खोलें: Lily चेतावनी देता है कि नियंत्रण का कोई सुलभ नाम नहीं है। लेबल जोड़ें और देखें कि चेतावनी चली गई। (चेतावनियाँ केवल डेवलपमेंट बिल्ड में होती हैं, इसलिए प्रोडक्शन पेज, जैसे यह साइट, शांत रहता है।)
स्व-जाँच: कब aria-labelइस्तेमाल करें, और कब दिखने वाला पाठ?
जब भी हो सके दिखने वाला पाठ: सब उसे देखते हैं, और आवाज़ से इनपुट देने वाले उसे बोल सकते हैं। aria-label केवल वहाँ जहाँ दिखने वाला पाठ नहीं है, जैसे आइकन। अगर दोनों हों, तो नाम में दिखने वाले शब्द होने चाहिए (WCAG 2.5.3)।
स्व-जाँच: केवल लाल रंग में दिखाई गई स्थिति। क्या कमी है?
पाठ। रंग अर्थ दोहरा सकता है पर उसे अकेले कभी नहीं ढो सकता (WCAG 1.4.1); स्थिति को शब्द चाहिए।
मॉड्यूल 4 — फ़ॉर्म
लक्ष्य: ऐसा फ़ॉर्म बनाएँ जिसकी त्रुटियाँ कोई भी ढूँढ़कर ठीक कर सके।
पढ़ें और करें: सुलभ फ़ॉर्म ट्यूटोरियल, सभी पाँच चरण।
स्व-जाँच: फ़ॉर्म जाँच में विफल होता है। फ़ोकस कहाँ जाता है, और क्या पढ़ा जाता है?
त्रुटि-सारांश पर, जिसे उसके शीर्षक और लिंक की सूची के साथ घोषित किया जाता है, हर त्रुटि का एक लिंक, हर एक अपने फ़ील्ड तक ले जाता है।
स्व-जाँच: फ़ॉर्म मान्य होने तक सबमिट बटन को निष्क्रिय क्यों न करें?
निष्क्रिय बटन नहीं बता सकता कि क्या गलत है, और बहुत लोग नहीं समझ पाते कि वह कुछ क्यों नहीं करता।
मॉड्यूल 5 — थीम और कंट्रास्ट
लक्ष्य: कंट्रास्ट या फ़ोकस तोड़े बिना Lily की स्टाइल बदलें।
पढ़ें: थीमिंग ट्यूटोरियल और थीम कंट्रास्ट तालिका।
करें: अपने ब्रांड रंग से --color-primary को बदलें। जाँचें कि उसका जोड़ा, --color-primary-content, 4.5:1 तक पहुँचता है, और फ़ोकस रिंग पेज पर अब भी दिखती है।
स्व-जाँच: आपका ब्रांड रंग सफ़ेद पाठ के लिए बहुत हल्का है। क्या आप उसे फिर भी इस्तेमाल कर सकते हैं?
हाँ, सजावट के रूप में (--lily-brand: हेडर पट्टी, एक रेखा, लोगो की पृष्ठभूमि), पाठ या नियंत्रण की सीमा के लिए कभी नहीं। पाठ और सीमाएँ थीम के सामग्री-जोड़े इस्तेमाल करते हैं।
मॉड्यूल 6 — विश्वव्यापी
लक्ष्य: किसी भी देश को डिफ़ॉल्ट न बनाएँ।
पढ़ें और करें: दुनिया भर में काम करने वाला फ़ॉर्म।
स्व-जाँच: CurrencyInput की कोई डिफ़ॉल्ट मुद्रा क्यों नहीं है?
कोई भी डिफ़ॉल्ट किसी एक देश का पैसा होगा, बाकी हर जगह चुपचाप गलत। अनुपस्थित currencyCode कॉल करने वाले का दोष है।
स्व-जाँच: अरबी में एक पेज। आप क्या सेट करते हैं, और आपके CSS को क्या करना चाहिए?
lang="ar" और dir="rtl" (लोकेल पिकर दोनों सेट करता है); आपका CSS तार्किक प्रॉपर्टी इस्तेमाल करता है ताकि लेआउट अपने-आप उलट जाए।
मॉड्यूल 7 — गति
लक्ष्य: किसी को नुकसान पहुँचाए बिना एनिमेशन करें।
पढ़ें: गति की विधियाँ।
करें: अपने ऑपरेटिंग सिस्टम में "गति कम करें" चालू करें और मार्की विधि वाला पेज फिर से लोड करें। वह स्थिर रहे और पंक्तियों में टूटे। फिर कीबोर्ड से उसके रोकें बटन तक पहुँचें।
स्व-जाँच: कुछ अपने-आप पाँच सेकंड से ज़्यादा चलता है। उसके पास क्या होना चाहिए?
उसे रोकने, बंद करने या छिपाने का तरीका (WCAG 2.2.2), जो कीबोर्ड से पहुँच योग्य हो, केवल होवर से नहीं।
मॉड्यूल 8 — अपना काम जाँचें
लक्ष्य: किसी पेज को वैसे जाँचें जैसे Lily अपने पेज जाँचता है।
करें: इस पाठ्यक्रम में बनाया कोई एक पेज लें और चार जाँचें चलाएँ:
- axe (ब्राउज़र एक्सटेंशन, या किसी परीक्षण में
@axe-core/playwright): कोई उल्लंघन नहीं। - केवल कीबोर्ड: हर काम पूरा, फ़ोकस हमेशा दिखता, कभी फँसा नहीं।
- 400% तक ज़ूम करें और विंडो को 320 पिक्सेल तक संकरा करें: कोई क्षैतिज स्क्रॉल नहीं, कुछ भी कटा नहीं।
- स्क्रीन रीडर: हर नियंत्रण का नाम, भूमिका और स्थिति है, और त्रुटियाँ घोषित होती हैं।
स्व-जाँच: axe कोई उल्लंघन नहीं बताता। क्या पेज सुलभ है?
अभी सिद्ध नहीं। स्वचालित जाँचें शायद एक तिहाई समस्याएँ पकड़ती हैं; कीबोर्ड, ज़ूम और स्क्रीन रीडर जाँचें बाकी का बड़ा हिस्सा। देखें गुणवत्ता पेज कि Lily ने खुद क्या सत्यापित किया है और क्या नहीं।
पाठ्यक्रम के बाद
- स्वास्थ्य सेवा गाइड, क्लिनिकल सॉफ़्टवेयर के लिए।
- हेल्पर: पिकर, डेटा ग्रिड, कैलेंडर।
- सहायता, और परियोजना प्रश्नों के लिए।