आपका पाठ कैसा दिखता है?

दोस्तो, सभी को बहुत अच्छा लगा। हम आपके साथ विशेष रूप से पाठ्यक्रम के छात्रों के लिए तैयार किए गए एक लेख का अनुवाद साझा करना चाहते हैं “Android- डेवलपर। उन्नत पाठ्यक्रम । ” अच्छी पढाई हो।



एंड्रॉइड पर डिक्लेयरली स्टाइल टेक्स्ट कैसे करें।


वर्जीनिया पोलट्रेट इलस्ट्रेशन

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


क्या और कब उपयोग करें?

यह आलेख पाठ की घोषणात्मक शैली के विभिन्न दृष्टिकोणों का वर्णन करता है (जब आप किसी XML फ़ाइल में शैलियों को परिभाषित करते हैं), प्रत्येक विधि के दायरे और प्राथमिकता पर चर्चा करते हैं।

tl; डॉ;

आपको पूरी पोस्ट पढ़नी चाहिए , लेकिन यहां एक सारांश है।

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


पाठ शैली के तरीकों का पदानुक्रम

मैं स्टाइल के लिए निम्नलिखित प्रक्रिया सुझाऊंगा:

1. अपने विषय के लिए डिफ़ॉल्ट शैली के रूप में textViewStyle में किसी भी एप्लिकेशन शैली को सेट करें।
2. TextAppearance उस छोटे (छोटे) सेट को स्थापित करें जिसे आपका एप्लिकेशन उपयोग करेगा (या TextAppearance स्टाइल से इनहेरिट / उपयोग करेगा), और उन्हें सीधे अपने दृष्टिकोण से देखें।
3. TextAppearance (जो खुद आपके एक TextAppearance का निर्धारण करेगा) द्वारा समर्थित विशेषताओं को सेट करके एक style बनाएँ।
4. लेआउट में सीधे किसी भी अनूठी स्टाइल का प्रदर्शन करें।

कुछ स्टाइल दिखाओ

आप लेआउट में TextView विशेषताओं को सीधे सेट कर सकते हैं, लेकिन यह दृष्टिकोण अधिक थकाऊ और असुरक्षित हो सकता है। कल्पना करें कि इस तरह से आप एप्लिकेशन के सभी टेक्स्ट व्यू के रंग को अपडेट करने का प्रयास कर रहे हैं। अन्य सभी विचारों के साथ, आप निरंतरता, पुन: उपयोग और अद्यतन करने में आसानी को सुनिश्चित करने के बजाय (और!) शैलियों का उपयोग कर सकते हैं। इस उद्देश्य के लिए, जब भी आप संभवतः एक ही शैली को कई दृश्यों पर लागू करना चाहते हैं, तो मैं पाठ के लिए शैली बनाने की सलाह देता हूं। यह एंड्रॉइड व्यू सिस्टम द्वारा बेहद सरल और काफी हद तक समर्थित है।

जब आप दृश्य को देखते हैं तो हुड के नीचे क्या होता है? यदि आपने कभी अपना कस्टम दृश्य लिखा है, तो संभवतः आपने कॉल को reference.obtainStyledAttributes (AttributeSet, int [], int, int) में देखा था । इस प्रकार, एंड्रॉइड में व्यू-सिस्टम लेआउट में निर्दिष्ट विशेषताओं को देखने के लिए गुजरता है। AttributeSet पैरामीटर, वास्तव में, एक्सएमएल मापदंडों का एक मानचित्र माना जा सकता है जिसे आप अपने लेआउट में निर्दिष्ट करते हैं। यदि एट्रीब्यूटसेट शैली सेट करता है, तो शैली पहले पढ़ी जाती है , और फिर सीधे दृश्य में निर्दिष्ट विशेषताओं को उस पर लागू किया जाता है। इस प्रकार, हम प्राथमिकता के पहले नियम पर आते हैं।

देखें → स्टाइल

हमेशा "प्रबल" और सीधे शैली में परिभाषित विशेषताओं को ओवरराइड करने वाले दृश्य में सीधे परिभाषित विशेषताएँ। ध्यान दें कि शैली और दृश्य विशेषताओं का संयोजन लागू किया जाता है; दृश्य में एक विशेषता को परिभाषित करना, जो शैली में भी निर्दिष्ट है, पूरी शैली को रद्द नहीं करता है। यह भी ध्यान दिया जाना चाहिए कि आपके विचार में यह निर्धारित करने का कोई वास्तविक तरीका नहीं है कि शैलीकरण कहां से आता है; यह एक समान कॉल में एक बार आपके लिए व्यू सिस्टम द्वारा तय किया जाता है। आपको विकल्प और विकल्प दोनों नहीं मिल सकते।

यद्यपि शैलियाँ अत्यंत उपयोगी हैं, उनकी अपनी सीमाएँ हैं। उनमें से एक यह है कि आप केवल एक शैली को दृश्य पर लागू कर सकते हैं (जैसा कि सीएसएस की तरह कुछ के विपरीत, जहां आप कई कक्षाएं लगा सकते हैं)। हालाँकि, TextAppearance का एक ट्रिक है, यह TextAppearance विशेषता प्रदान करता है, जो style समान ही काम करता style । यदि आप TextAppearance माध्यम से पाठ की style TextAppearance , तो अन्य शैलियों के लिए style विशेषता को निशुल्क छोड़ दें, जो व्यावहारिक दिखता है। आइए देखें कि TextAppearance क्या TextAppearance और यह कैसे काम करता है।

TextAppearance

TextAppearance में कुछ भी जादुई नहीं है (उदाहरण के लिए, कई शैलियों को लागू करने के लिए एक गुप्त मोड जिसे आपको !!!! के बारे में नहीं जानना चाहिए), TextView आपको कुछ अतिरिक्त कार्यों से बचाता है। आइए TextView कंस्ट्रक्टर पर एक नज़र डालें कि यह क्या हो रहा है।

 TypedArray a = theme.obtainStyledAttributes(attrs, com.android.internal.R.styleable.TextViewAppearance, defStyleAttr, defStyleRes); TypedArray appearance = null; int ap = a.getResourceId(com.android.internal.R.styleable.TextViewAppearance_textAppearance, -1); a.recycle(); if (ap != -1) { appearance = theme.obtainStyledAttributes(ap, com.android.internal.R.styleable.TextAppearance); } if (appearance != null) { readTextAppearance(context, appearance, attributes, false); appearance.recycle(); } // a little later a = theme.obtainStyledAttributes(attrs, com.android.internal.R.styleable.TextView, defStyleAttr, defStyleRes); readTextAppearance(context, a, attributes, true); 

तो यहाँ क्या हो रहा है? मूल रूप से, android:textAppearance पहले यह देखता है कि आपने android:textAppearance निर्दिष्ट किया है android:textAppearance , यदि हां, तो यह इस शैली को लोड करता है और वहां सूचीबद्ध सभी गुणों को लागू करता है। बाद में, वह सभी विशेषताओं को दृश्य से लोड करता है (जिसे वह शैली सहित याद करता है) और उन्हें लागू करता है। तो हम दूसरी प्राथमिकता नियम पर आते हैं:

देखें → स्टाइल → टेक्स्टऐपैरेंस

चूंकि पाठ की उपस्थिति पहले जांची जाती है, इसलिए सीधे या शैली में परिभाषित कोई भी विशेषता इसे ओवरराइड करेगी।

TextAppearance साथ, ध्यान में रखने के लिए एक और TextAppearance है: यह उस शैली विशेषताओं का सबसेट का समर्थन करता है जो TextView प्रदान करता है। यह समझने के लिए कि मेरा क्या मतलब है, आइए इस पंक्ति पर वापस आते हैं:

obtainStyledAttributes(ap, android.R.styleable.TextAppearance);

हमने 4 तर्कों के साथ receiveStyledAttributes संस्करण को देखा, यह 2-तर्क संस्करण इससे थोड़ा अलग है। वह दी गई शैली को देखता है (जैसा कि पहले पैरामीटर id द्वारा परिभाषित किया गया है) और इसे केवल उस शैली में विशेषताओं के अनुसार फ़िल्टर करता है जो दूसरे पैरामीटर में दिखाई देती है, attrs सरणी। तो शैलीगत android.R.styleable.TextAppearance TextAppearance के दायरे को परिभाषित करता है। इस परिभाषा को देखते हुए, हम देखते हैं कि TextAppearance कई का समर्थन करता है, लेकिन सभी नहीं, विशेषताएँ जो TextAppearance का समर्थन करती हैं ।

 <attr name="textColor" /> <attr name="textSize" /> <attr name="textStyle" /> <attr name="typeface" /> <attr name="fontFamily" /> <attr name="textColorHighlight" /> <attr name="textColorHint" /> <attr name="textColorLink" /> <attr name="textAllCaps" format="boolean" /> <attr name="shadowColor" format="color" /> <attr name="shadowDx" format="float" /> <attr name="shadowDy" format="float" /> <attr name="shadowRadius" format="float" /> <attr name="elegantTextHeight" format="boolean" /> <attr name="letterSpacing" format="float" /> <attr name="fontFeatureSettings" format="string" /> 

TextAppearance द्वारा समर्थित स्टाइलिंग विशेषताएँ

यहाँ कुछ TextAppearance विशेषताएँ हैं जिन्हें TextAppearance में शामिल नहीं किया गया है: lineHeight[Multiplier|Extra] , lines , breakStrategy और breakStrategy । TextAppearance वर्ण स्तर पर काम करता है, पैरा स्तर नहीं, इसलिए पूरे लेआउट को प्रभावित करने वाले गुण समर्थित नहीं हैं।

इसलिए, TextAppearance बहुत उपयोगी है, यह हमें पाठ शैलीकरण विशेषताओं के लिए उन्मुख शैली को परिभाषित करने की अनुमति देता है, और अन्य उद्देश्यों के लिए style को स्वतंत्र रूप से छोड़ देता है। हालांकि, इसका एक सीमित दायरा है और प्राथमिकता श्रृंखला के निचले भाग पर है, इसलिए सीमाओं के बारे में मत भूलना।

उचित चूक

जब हमने देखा कि एंड्रॉइड दृश्य कैसे विशेषताओं ( context.obtainStyledAttributes ) को हल करता है, तो हमने वास्तव में इसे थोड़ा सरल किया। वह theme.obtainStyledAttributes (वर्तमान Theme Context 'का उपयोग करके) को कॉल करती है । लिंक की जांच करते समय, प्राथमिकता क्रम जिसे हमने पहले जांचा था, दिखाया गया है, और 2 और स्थानों को इंगित किया गया है कि वह विशेषताओं को हल करने के लिए देख रहा है: दृश्य और विषय के लिए डिफ़ॉल्ट शैली।

किसी विशेष विशेषता के अंतिम मूल्य का निर्धारण करते समय, चार इनपुट पैरामीटर खेलने में आते हैं:

1. इस विशेषता में कोई विशेषता मान।
2. विशेषता संसाधन एटसेटसेट में निर्दिष्ट ("शैली" नाम दिया गया)।
3. डिफ़ॉल्ट शैली defStyleAttr और defstyleres द्वारा निर्दिष्ट है
4. इस सूत्र में बुनियादी मूल्य।

थीम प्रलेखन से स्टाइलिंग प्राथमिकता क्रम

हम थीम पर वापस लौटेंगे, लेकिन पहले डिफ़ॉल्ट शैलियों पर एक नज़र डालते हैं। यह डिफ़ॉल्ट शैली क्या है? इस प्रश्न का उत्तर देने के लिए, मुझे लगता है कि TextView थीम से एक छोटा सा निकास और एक साधारण Button पर एक नज़र डालना उपयोगी होगा। जब आप अपने लेआउट में < Button > सम्मिलित करते हैं, तो यह कुछ ऐसा दिखता है।


मानक बटन

क्यों? यदि आप Button के स्रोत कोड को देखते हैं, तो आप देखेंगे कि यह बहुत छोटा है:

 public class Button extends TextView { public Button(Context context) { this(context, null); } public Button(Context context, AttributeSet attrs) { this(context, attrs, com.android.internal.R.attr.buttonStyle); } public Button(Context context, AttributeSet attrs, int defStyleAttr) { this(context, attrs, defStyleAttr, 0); } public Button(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) { super(context, attrs, defStyleAttr, defStyleRes); } @Override public CharSequence getAccessibilityClassName() { return Button.class.getName(); } @Override public PointerIcon onResolvePointerIcon(MotionEvent event, int pointerIndex) { if (getPointerIcon() == null && isClickable() && isEnabled()) { return PointerIcon.getSystemIcon(getContext(), PointerIcon.TYPE_HAND); } return super.onResolvePointerIcon(event, pointerIndex); } } 

वह सब है! यहाँ पूरी कक्षा है (कोई टिप्पणी नहीं)। आप इसे स्वयं यहां देख सकते हैं । मैं इंतजार करूंगा। तो बैकग्राउंड, कैपिटल लेटर्स, रिपल आदि कहां से आते हैं? आप चूक गए होंगे, लेकिन यह सभी कंस्ट्रक्टर में 2 तर्कों के साथ परिभाषित किया जाएगा; जब XML से लेआउट लिया जाता है तो उसे कहा जाता है। यह अंतिम पैरामीटर है जो defaultStyleAttr को com.android.internal.R.attr.buttonStyle में परिभाषित करता है। यह डिफ़ॉल्ट शैली है, जो अनिवार्य रूप से एक अप्रत्यक्ष संदर्भ बिंदु है, जो आपको डिफ़ॉल्ट शैली को निर्दिष्ट करने की अनुमति देता है। यह सीधे शैली को इंगित नहीं करता है, लेकिन आपको अपने विषय में निर्दिष्ट उन लोगों में से एक को इंगित करने की अनुमति देता है जो विशेषताओं को हल करते समय जांच करेगा। और यह बिल्कुल वैसा ही है जैसा कि आप आमतौर पर विरासत में मिलने वाले सभी विषयों को मानक विगेट्स के रूप और स्वरूप प्रदान करते हैं। उदाहरण के लिए, यदि आप विषय सामग्री को देखते हैं, तो यह @style/Widget.Material.Light.Button को परिभाषित करता है, और यह शैली है जो सभी विशेषताओं को प्रदान करती है जो कि theme.obtainStyledAttributes होगी यदि आपने कुछ और नहीं किया।

TextView वापस, यह एक डिफ़ॉल्ट शैली भी प्रदान करता है: textViewStyle । यह बहुत सुविधाजनक हो सकता है यदि आप अपने आवेदन में प्रत्येक TextView में कुछ शैलियों को लागू करना चाहते हैं। मान लीजिए कि आप डिफ़ॉल्ट लाइन स्पेसिंग को 1.2 पर सेट करना चाहते हैं। आप इसे style/TextAppearance साथ कर सकते हैं और कोड समीक्षा के दौरान इसे लागू करने का प्रयास कर सकते हैं (या शायद लिंट में एक सुरुचिपूर्ण कस्टम नियम के साथ), लेकिन आपको सतर्क रहने और यह सुनिश्चित करने की आवश्यकता है कि आप नई टीम के सदस्यों की भर्ती करें , रिफैक्टरिंग आदि से सावधान रहें।

एक बेहतर तरीका यह है कि आवेदन में सभी TextView लिए अपनी स्वयं की डिफ़ॉल्ट शैली को निर्दिष्ट किया जाए, जिससे वांछित व्यवहार निर्धारित किया जा सके। आप textViewStyle लिए अपनी स्वयं की शैली सेट करके ऐसा कर सकते हैं, जो कि प्लेटफ़ॉर्म से या डिफ़ॉल्ट रूप से MaterialComponents/AppCompat से विरासत में मिला है।

 <style name="Theme.MyApp" parent="@style/Theme.MaterialComponents.Light"> ... <item name="android:textViewStyle">@style/Widget.MyApp.TextView</item></style> <style name="Widget.MyApp.TextView" parent="@android:style/Widget.Material.TextView"> <item name="android:textAppearance">@style/TextAppearance.MyApp.Body</item> <item name="android:lineSpacingMultiplier">@dimen/text_line_spacing</item> </style> 

इसे ध्यान में रखते हुए, हमारी प्राथमिकता नियम का रूप लेती है:

दृश्य -> ​​शैली -> डिफ़ॉल्ट शैली -> पाठ्य-वस्तु

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

यदि आपको विजेट विरासत में मिला है और अपनी स्वयं की डिफ़ॉल्ट शैली को निर्दिष्ट नहीं करता है, तो कंस्ट्रक्टरों में डिफ़ॉल्ट पैरेंट क्लास शैली का उपयोग करना सुनिश्चित करें (केवल 0 पास न करें)। उदाहरण के लिए, यदि आप AppCompatTextView से विरासत में प्राप्त करते हैं और 2 तर्क के साथ अपना स्वयं का निर्माता लिखते हैं, तो android.R.attr.textViewStyle defaultStyleAttr ( यहाँ ) के रूप में पास करना सुनिश्चित करें, अन्यथा आप मूल वर्ग के व्यवहार को खो देंगे।

सूत्र

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

एक उदाहरण तब होगा जब आप पूरे एप्लिकेशन में फ़ॉन्ट बदलने का प्रयास करेंगे। आप ऊपर वर्णित विधियों में से एक का उपयोग कर सकते हैं, लेकिन हर जगह पाठ की शैलियों / उपस्थिति को मैन्युअल रूप से समायोजित करना नीरस और असुरक्षित होगा, और डिफ़ॉल्ट शैली केवल विजेट स्तर पर काम करेगी; उपवर्ग इस व्यवहार को ओवरराइड कर सकते हैं, उदाहरण के लिए बटन अपने स्वयं के android:buttonStyle को परिभाषित करते हैं android:buttonStyle , जिसे आपका android:textViewStyle android:buttonStyle । इसके बजाय, आप अपने विषय में फ़ॉन्ट निर्दिष्ट कर सकते हैं:

 <style name="Theme.MyApp" parent="@style/Theme.MaterialComponents.Light"> ... <item name="android:fontFamily">@font/space_mono</item> </style> 

अब कोई भी दृश्य जो इस विशेषता का समर्थन करता है, वह इसे उठाएगा यदि यह किसी उच्च प्राथमिकता के साथ किसी चीज से ओवरराइड नहीं है:

दृश्य → शैली → डिफ़ॉल्ट शैली → थीम → टेक्स्टएपैरेंस

फिर से, चूंकि यह दृश्य स्टाइल सिस्टम का हिस्सा है, यह टेक्स्ट फॉर्म में दी गई हर चीज को ओवरराइड कर देगा, लेकिन किसी भी अधिक विशिष्ट विशेषताओं द्वारा ओवरराइड किया जाएगा।

इस प्राथमिकता को याद रखें। संपूर्ण एप्लिकेशन के लिए एक फ़ॉन्ट के साथ हमारे उदाहरण में, आप Toolbar इस फ़ॉन्ट Toolbar लेने की उम्मीद कर सकते हैं, क्योंकि इसमें शीर्षक है, जो एक TextView । हालाँकि, टूलबार वर्ग स्वयं एक डिफ़ॉल्ट शैली को परिभाषित करता है, जिसमें titleTextAppearance , जो android:fontFamily को परिभाषित करता है android:fontFamily , और इसे सीधे android:fontFamily हेडर में सेट करता है, जो थीम स्तर मान को ओवरराइड करता है। विषय-स्तरीय शैली उपयोगी हो सकती हैं, लेकिन ओवरराइड करना आसान है, इसलिए सुनिश्चित करें कि उन्हें ठीक से लागू किया गया है।

बोनस: अनारक्षित मुद्दे

यह पूरा लेख दृश्य स्तर पर पाठ की घोषणात्मक डिजाइन के लिए समर्पित था, TextView भरने के दौरान पूरे टेक्स्ट दृश्य को कैसे स्टाइल किया जाए। किसी भी शैली को भरने के बाद लागू किया जाता है (उदाहरण के लिए, textView.setTextColor(…) ) घोषणात्मक स्टाइल को ओवरराइड करेगा। TextView Span माध्यम से छोटी शैलियों का भी समर्थन करता है। मैं इस विषय में नहीं जाऊंगा, जैसा कि फ्लोरिना मुन्टेंस्कु के लेखों में विस्तार से वर्णित है।

→ स्पैंटास्टिक पाठ स्पैन के साथ स्टाइल
→ अंडरस्पैंडिंग स्पैन

मैं इसे पूर्णता के लिए उल्लेख करूंगा, यह ध्यान रखने के लिए कि कार्यक्रम स्टाइल और स्पैन प्राथमिकता के क्रम के शीर्ष पर होगा:

स्पैन → सेटर्स → व्यू → स्टाइल → डिफॉल्ट स्टाइल → थीम → टेक्स्टऐपैरेंस

अपनी शैली चुनें

यद्यपि आपके पाठ को स्टाइल करने के कई तरीके हैं, विधियों और उनकी सीमाओं के बीच के अंतर को समझना आपको एक विशिष्ट कार्य के लिए सही उपकरण ढूंढने में मदद करता है या यह समझने में मदद करता है कि एक विधि दूसरे पर पूर्वता क्यों लेती है।

एक अच्छा पाठ स्टाइल है!

हम सभी को एक मुफ्त वेबिनार में आमंत्रित करते हैं, जिसके ढांचे में हम डीआई फ्रेमवर्क डैगर 2 से परिचित होंगे: हम अध्ययन करेंगे कि कैसे डैगर 2 कोड उत्पन्न करता है, हम जेएसआर 330 एनोटेशन और डैगर 2 निर्माणों से निपटेंगे, हम सीखेंगे कि मल्टी-मॉड्यूल एप्लिकेशन में डैगर 2 का उपयोग कैसे करें और डैगर एंड्रॉइड इंजेक्टर पर विचार करें।