जब मैंने अपनी पहली Android योगदान के लिए उदाहरणों पर शोध किया, तो Kotlin में लिखी गई एनिमेशन के कुछ ही उदाहरण मौजूद थे। नेटिव एनिमेशन के भीतर एक्सेसिबिलिटी विचारों के कोड उदाहरण भी बहुत कम थे।
तो चलिए शुरू करते हैं! आइए Kotlin में एक नेटिव 'एक्सपैंड' एनिमेशन लिखने को देखते हैं, और बात करते हैं कि TalkBack या बड़े टेक्स्ट चालू होने पर उपयोगकर्ताओं की सहायता कैसे करें। सभी कोड इस उदाहरण रिपॉजिटरी में उपलब्ध है, जो एक एनिमेटेड व्यू के साथ एक सिंगल एक्टिविटी बनाता है। यह कोड Calum Turner के साथ सह-लिखा गया था।
Android एक्सेसिबिलिटी (a11y)
सभी Android डिवाइस एक बिल्ट-इन स्क्रीन रीडर TalkBack के साथ आते हैं। इसे डिवाइस की सेटिंग्स से चालू किया जा सकता है, और इसमें पहली बार उपयोग के लिए एक गाइड भी बिल्ट-इन है। पेज पर नेविगेट करने के लिए जेस्चर का उपयोग किया जाता है, फोकस किए गए एलिमेंट्स के विवरण जोर से पढ़े जाते हैं। इसके बिना, ऐप कई दृष्टिबाधित उपयोगकर्ताओं के लिए अनुपयोगी हो जाता है।
महत्वपूर्ण यह है कि सही एलिमेंट्स फोकस करने योग्य हों, उनके विवरण हों, और व्यू में परिवर्तनों की घोषणा की जाए।
उसी सेटिंग्स मेनू में डिफ़ॉल्ट बेस फॉन्ट साइज को एडजस्ट किया जा सकता है, जो 1.0 से स्केल होता है। व्यू को फॉन्ट साइज में इस बदलाव पर प्रतिक्रिया देनी चाहिए, सभी एलिमेंट्स अभी भी मौजूद और कार्यात्मक होने चाहिए।
लेआउट
हम यहां लेआउट के स्टाइलिंग विवरण नहीं देखेंगे क्योंकि वे इस उदाहरण के लिए काफी विशिष्ट हैं, लेकिन एक्सेसिबिलिटी टच हाइलाइट करने लायक हैं।
दो प्रॉपर्टीज का उपयोग किया जाता है: android:contentDescription और android:importantForAccessibility।
contentDescription वह है जो पढ़ा जाता है जब कोई एलिमेंट फोकस प्राप्त करता है। किसी भी ImageView के लिए जो फोकस प्राप्त करता है यह आवश्यक है, अन्यथा स्क्रीन रीडर उपयोगकर्ता को बेकार 'अनलेबल्ड' पढ़ेगा।
यदि यह एक बटन होता तो यह डिफ़ॉल्ट रूप से '<विवरण> बटन, सक्रिय करने के लिए डबल टैप करें' पढ़ता, लेकिन हमारे ImageView आइकन के लिए हम मैन्युअल रूप से एक्शन निर्दिष्ट करते हैं क्योंकि हमारे पास यह डिफ़ॉल्ट नहीं है।
android:contentDescription="tap to toggle extra person information"
हम importantForAccessibility:no का उपयोग '+' TextView के लिए फोकस बंद करने के लिए भी करते हैं, क्योंकि दो बैज के नीचे का टेक्स्ट एक विवरण प्रदान करता है और इसलिए '+' जोर से पढ़े जाने पर भ्रमित करने वाला होता है।
इन दोनों के लिए, TalkBack चालू करके एक वास्तविक डिवाइस पर मैन्युअल टेस्टिंग यह जानने का सबसे अच्छा संकेत है कि विजुअल्स के बिना संदर्भ समझ में आता है या नहीं।
एक्सपैंड एनिमेशन
हमारा एनिमेशन एक 'इन्फो' आइकन टैप पर सक्रिय होगा, एक डिटेल्स सेक्शन के एक्सपैंड को टॉगल करेगा।
हम यह सब एक सिंगल एक्टिविटी के अंदर करेंगे ताकि केवल एनिमेशन कोड पर फोकस रहे। एक वास्तविक ऐप में, जिस व्यू पर यह लागू होता है वह अपने फ्रैगमेंट या रिसाइक्लर व्यू में होने की अधिक संभावना है, इसलिए एक अधिक एब्स्ट्रैक्ट कोड संरचना का उपयोग किया जाएगा।
लिस्नर सेट करना
हमारे उदाहरण एक्टिविटी के onCreate में हमें पहले अपने आइकन पर एक लिस्नर सेट करना होगा और उस व्यू को पास करना होगा जिसे टॉगल किया जाना है।
infoIcon.setOnClickListener { toggleCardBody(root.personEntryBody) }
हम क्लास के भीतर एक वेरिएबल भी सेट करते हैं यह ट्रैक करने के लिए कि व्यू टॉगल है या नहीं, इसे शुरू में बंद पर सेट करते हैं।
private var isToggled = false
एक्सपैंड एनिमेशन टॉगल करना
हमारे लेआउट में, हमने personEntryBody की ऊंचाई 0dp पर सेट की है।
इसे खोलने के लिए हमें नई ऊंचाई जानने की आवश्यकता है जिसे सेट करना है, एनिमेशन कितनी देर तक चलना चाहिए, और एनिमेशन के प्रत्येक क्षण में ऊंचाई क्या होनी चाहिए।
फिर हमें isToggled को इसके उल्टे पर सेट करना होगा, और यह सुनिश्चित करना होगा कि जब फिर से टैप किया जाए तो यह उल्टा करे।
private fun toggleCardBody(body: View) {
body.measure(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT)
val maxHeight = body.measuredHeight + body.paddingTop + body.paddingBottom
val startHeight = if (isToggled) maxHeight else 0
val targetHeight = if (isToggled) 0 else maxHeight
val expandAnimator = ValueAnimator
.ofInt(startHeight, targetHeight)
.setDuration(200)
expandAnimator.addUpdateListener {
val value = it.animatedValue as Int
body.layoutParams.height = value
body.requestLayout()
}
expandAnimator.doOnEnd {
isToggled = !isToggled
}
expandAnimator.start()
}
चूंकि व्यू शुरू में 0 ऊंचाई पर ड्रॉ होता है, हमें इसके लेआउट को रीमेजर करके इसका नया आकार कैलकुलेट करना होगा।
Android व्यू लेआउट डॉक्स में वर्णित अनुसार, हम measure() का उपयोग व्यू को असाइन किए गए लेआउट पैरामीटर्स के साथ हर बार इन्फो आइकन टैप होने पर रीमेजर करने के लिए कर सकते हैं।
मैक्स ऊंचाई की गणना करने के लिए हमें मैन्युअली टॉप और बॉटम पैडिंग को इसमें जोड़ना होगा, क्योंकि ये मेजर्ड ऊंचाई में शामिल नहीं हैं।
isToggled के आधार पर हम जानते हैं कि क्या हम 0 से शुरू कर रहे हैं या एक्सपैंडेड मैक्स ऊंचाई से, और इसलिए विपरीत टारगेट ऊंचाई।
हम शुरूआती मान से टारगेट अंत मान तक जाने के लिए ValueAnimator का उपयोग करते हैं, और ms में अवधि सेट करते हैं। यह अवधि बाद में UX फील के लिए मैन्युअल टेस्टिंग पर आधारित है।
ValueAnimator
.ofInt(startHeight, targetHeight)
.setDuration(200)
हम एक अपडेट लिस्नर के साथ अवधि को ऊंचाई से जोड़ते हैं, प्रत्येक अपडेट के बाद एक नया लेआउट ड्रॉ करने का अनुरोध करते हैं और हर बार ऊंचाई एडजस्ट करते हैं।
expandAnimator.addUpdateListener {
val value = it.animatedValue as Int
body.layoutParams.height = value
body.requestLayout()
}
expandAnimator.doOnEnd {
isToggled = !isToggled
}
expandAnimator.start()
चूंकि हम Kotlin का उपयोग कर रहे हैं, हम अपने build.gradle में androidx लाइब्रेरी भी जोड़ते हैं ताकि इसके doOnEnd एक्सटेंशन से लाभ उठा सकें। यह हमें isToggled वेरिएबल को बहुत आसानी से उल्टा करने की अनुमति देता है।
अंत में हम अपनी एनिमेशन शुरू करते हैं! पहले से ही हमारे पास एक बॉडी है जो आइकन टच पर एक्सपैंड और कॉन्ट्रैक्ट करती है!
स्मूथ एनिमेशन
हमारी एनिमेशन तकनीकी रूप से वैसे ही काम करती है, एक अच्छा अतिरिक्त कदम इंटरपोलेटर जोड़ना है ताकि मूवमेंट अधिक नेचुरल लगे।
expandAnimator.interpolator = FastOutSlowInInterpolator()
हमारी एक्सेसिबिलिटी बढ़ाना
हम अपने a11y उपयोगकर्ताओं की मदद के लिए दो अंतिम चीजें जोड़ेंगे।
पहला, हम नेविगेशन में मदद के लिए AccessibilityEvent का उपयोग कर सकते हैं।
expandAnimator.doOnEnd {
if (!isToggled)
body.sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED)
isToggled = !isToggled
}
इसका मतलब है कि जब एनिमेशन बंद से खुले में जाती है, तो फोकस तुरंत बॉडी में पहले आइटम पर जाएगा, इस मामले में विवरण। लेआउट में, हमने इन्फो आइकन एक्शन का विवरण सेट किया, लेकिन चूंकि हम विजुअल इंडिकेटर पर भरोसा नहीं कर सकते कि उपयोगकर्ता अगले आइटम पर जाए, हम इसे उनके लिए संभाल सकते हैं।
दूसरा, हम विभिन्न फॉन्ट साइज की अनुमति देते हैं। measure() से रिटर्न की गई मेजर्ड ऊंचाई डिवाइस की एक्सेसिबिलिटी सेटिंग्स में सेट फॉन्ट स्केलिंग को ध्यान में नहीं रखती, और इसलिए जब बड़े स्केल पर होता है तो विवरण का निचला हिस्सा क्रॉप हो जाएगा क्योंकि यह फिट होने के लिए बहुत बड़ा है।
हम प्रोग्रामेटिकली फॉन्ट स्केल एक्सेस कर सकते हैं, और इसके आधार पर अपनी ऊंचाई स्केल कर सकते हैं। हम इसे इंटीजर में कन्वर्ट करते हैं क्योंकि फॉन्ट स्केल के परिणामस्वरूप फ्लोट हो सकता है जो लेआउट ऊंचाई के रूप में काम नहीं करेगा।
val a11yFontScale = body.context.resources.configuration.fontScale
val maxHeight = ((body.measuredHeight + body.paddingTop + body.paddingBottom) * a11yFontScale).toInt()
समाप्त!
और वहां हमारे पास है, हम अपनी अंतिम एनिमेशन पर पहुंच गए हैं! बस कुछ अतिरिक्त लाइनों के साथ हमने इसके a11y कवरेज को काफी बढ़ा दिया है और एक स्मूथ एक्सपैंडिंग सेक्शन है जो Kotlin और Android बैज दिखाता है 🎉
पढ़ने के लिए धन्यवाद 🙏
यहां कुछ अन्य चीजें हैं जो मैंने हाल ही में लिखी हैं:
- CodeceptJS E2E टेस्ट कस्टमाइज़ करना
- Jest और Enzyme II के साथ React टेस्टिंग
उपयोगी अतिरिक्त
- Android के लिए KTX एक्सप्लोर करने पर Joe Birch का बेहतरीन androidx पोस्ट
- Android एक्सेसिबिलिटी ट्यूटोरियल: शुरुआत करना