सीधे मुख्य कॉन्टेंट पर जाएँ
menu palettetanreidark_modetranslate

कलर मोड

कंट्रास्ट

डिज़ाइन सिस्टम

शोकेस के सिस्टम दूसरे डिज़ाइन सिस्टम की नकल करते हैं, ताकि दिख सके कि Tanrei से कितना कुछ बनाया जा सकता है। ये सिर्फ़ उदाहरण हैं, ऐसे डिज़ाइन नहीं जिन्हें Tanrei सपोर्ट करता है।

लिंक कॉपी करेंथीम में बदलाव करें
palettetanrei

कलर मोड

कंट्रास्ट

डिज़ाइन सिस्टम

शोकेस के सिस्टम दूसरे डिज़ाइन सिस्टम की नकल करते हैं, ताकि दिख सके कि Tanrei से कितना कुछ बनाया जा सकता है। ये सिर्फ़ उदाहरण हैं, ऐसे डिज़ाइन नहीं जिन्हें Tanrei सपोर्ट करता है।

लिंक कॉपी करेंथीम में बदलाव करें
शुरुआत करेंWebReactSwiftUIJetpack ComposeFlutterReact Nativeप्रीसेटआपका अपना डिज़ाइन सिस्टमAI एजेंट के साथ Tanrei का इस्तेमालब्रांडडिज़ाइन टोकनडिज़ाइन सिस्टम और कस्टमाइज़ेशनTheme Studioरंगटाइपोग्राफ़ीआइकनशेपएलिवेशनमोशनइंटरैक्शन स्टेटव्यवहारलेआउटसाइज़ और डेंसिटीसुलभताशब्दकलर टोकनटाइप स्केल टोकनशेप टोकनएलिवेशन टोकनमोशन टोकनस्टेट टोकनस्पेस और माप के टोकनकंपोनेंटबटनमुख्य ऐक्शन बटनसेगमेंटेड बटनcupertino, m3-like में शामिलबटन ग्रुपमेन्यू वाला बटनटूलबारकॉपी बटनचेकबॉक्सरेडियो बटनस्विचचिपमेन्यूस्लाइडरस्लाइडर फ़ील्डकैलेंडरDateTimePickerफ़ील्ड ग्रुपरेडियो ग्रुपचेकबॉक्स ग्रुपसिलेक्टसिलेक्ट फ़ील्डमेन्यू बारफ़ाइल अपलोडफ़ाइल पिकर उन्नतड्रॉप ज़ोनRatingटेक्स्ट इनपुट उन्नतटेक्स्ट फ़ील्डचिप फ़ील्डफ़ील्डकॉम्बोबॉक्स उन्नतकॉम्बोबॉक्स फ़ील्डनंबर इनपुट उन्नतनंबर फ़ील्डकलर इनपुट उन्नतकलर फ़ील्डवन-टाइम कोड इनपुट उन्नतवन-टाइम कोड फ़ील्डएम्बेडेड टेक्स्ट इनपुट उन्नतचैट कंपोज़रकार्डडिवाइडरमोडल लेयर उन्नतडायलॉगलिस्टलिस्ट पंक्तिबॉटम शीटसाइड शीटकैरसेलकोड ब्लॉकटेबलपॉपओवरचरणअकॉर्डियनडिस्क्रिप्शन लिस्टफ़िगरऐप शेलपेज हेडरट्री व्यूटाइमलाइनइमेज प्रीव्यूसाइज़ हैंडलसाइज़ बदलने वाला फ़्रेमSplit viewस्क्रॉल एरियासाइज़ ट्रांज़िशनबैजप्रोग्रेस इंडिकेटरमीटरनंबर टिकरलोडिंग इंडिकेटरस्नैकबारटूलटिपकीबोर्ड शॉर्टकटटैगइनलाइन कोडकॉलआउटअवतारख़ाली स्टेटटैग ग्रुपस्केलेटनफ़ाइल आइटमस्वॉचमार्की टेक्स्टटैबटैब व्यूऐप बारनेविगेशन बारनेविगेशन ड्रॉअरखोजलिंकपेजिनेशनपिछला और अगला लिंकस्टेपरब्रेडक्रंबविषय सूचीलिंक कार्डFAB मेन्यूm3-like में शामिलस्थितिTanrei कैसे बनता हैयोगदानलाइसेंस और श्रेय
होमबुनियादी बातेंसाइज़ और डेंसिटी

साइज़ और डेंसिटी

कंट्रोल के साइज़ के लिए पाँच ऊँचाइयों की सीढ़ी; दबाई जा सकने वाली हर चीज़ का सबसे छोटा साइज़; और वह साइज़ जो कोई कंटेनर अपने अंदर की चीज़ों को देता है।

content_copyMarkdown में देखें

कोई कंट्रोल या पंक्ति कितनी ऊँची हो, यह तीन मानों से तय होता है। कंट्रोल की ऊँचाई और न्यूनतम टार्गेट पूरे डिज़ाइन सिस्टम के होते हैं: प्रॉडक्ट हर एक को अपनी लेयर में एक बार सेट करता है। साइज़ एक कंपोनेंट का, या कंपोनेंट के एक ग्रुप का होता है: बटन जहाँ रखा है, वहाँ small, medium या large होता है।

साइज़ की सीढ़ी

सीढ़ी tanrei.sys.control.height.* की पाँच ऊँचाइयाँ है, जिन्हें कंट्रोल के साइज़ पढ़ते हैं: medium कंट्रोल की ऊँचाई है, tanrei.dial.control.height (डिफ़ॉल्ट रूप से 40), और बाकी स्टेप उससे पूरी साइज़ यूनिट (dial.size.unit, डिफ़ॉल्ट रूप से 4px) नीचे और ऊपर हैं: small दो और extra-small चार नीचे, large चार और extra-large आठ ऊपर। कुछ कंट्रोल ऊँचाइयों पर ये ऊँचाइयाँ, टोकन के अपने नियमों से निकाली हुई:

टोकन dial.control.height 36px dial.control.height 40px dial.control.height 44px dial.control.height 48px dial.control.height 56px
--tanrei-sys-control-height-extra-small 20px 24px 28px 32px 40px
--tanrei-sys-control-height-small 28px 32px 36px 40px 48px
--tanrei-sys-control-height-medium 36px 40px 44px 48px 56px
--tanrei-sys-control-height-large 52px 56px 60px 64px 72px
--tanrei-sys-control-height-extra-large 68px 72px 76px 80px 88px

इससे जनरेट किया गया: design/tokens/tanrei.light.tokens.json, tokens/sys/measure.tokens.json

कई कंपोनेंट अपनी ऊँचाई इन्हीं स्टेप से पढ़ते हैं, और जो एक ही स्टेप पढ़ते हैं, वे हर कंट्रोल ऊँचाई पर बराबर ऊँचे रहते हैं: Button के small, medium और large सीढ़ी के small, medium और large स्टेप पढ़ते हैं। सीढ़ी की अपनी कोई निचली सीमा नहीं है, क्योंकि extra-small उन चीज़ों के लिए है जिन्हें कोई नहीं दबाता, जैसे टैग या कीबोर्ड शॉर्टकट।

न्यूनतम टार्गेट

tanrei.sys.target.minimum वह सबसे कम ऊँचाई है जिस पर कोई भी चीज़ बनाई जाती है जिसे व्यक्ति दबाता है, और सिर्फ़ आइकन वाले कंट्रोल की सबसे कम चौड़ाई भी। दबाए जाने वाले हर बॉक्स या पंक्ति की ऊँचाई इसे निचली सीमा मानकर निकाली जाती है, इसलिए कोई भी साइज़ उसे इससे नीचे नहीं बनाता। यह डेवलपर का अपना मान है: कोई डायल इसे स्केल नहीं करता, क्योंकि जो निचली सीमा उसी चीज़ के साथ सिकुड़ जाए जिसे वह रोकती है, वह निचली सीमा नहीं रहती।

डिफ़ॉल्ट सिस्टम में न्यूनतम 36 है, पॉइंटर और उँगली दोनों के लिए। Button की ऊँचाइयाँ इसे काम करते दिखाती हैं: कोष्ठक में लिखा मान वह है जो साइज़ और कंट्रोल की ऊँचाई देते हैं, और उससे पहले की ऊँचाई वह है जिस पर न्यूनतम टार्गेट बटन को रोके रखता है।

टोकन dial.control.height 36px dial.control.height 40px dial.control.height 44px dial.control.height 48px dial.control.height 56px
--tanrei-comp-button-container-height-small 36px (28px) 36px (32px) 36px 40px 48px
--tanrei-comp-button-container-height-medium 36px 40px 44px 48px 56px
--tanrei-comp-button-container-height-large 52px 56px 60px 64px 72px

इससे जनरेट किया गया: design/tokens/tanrei.light.tokens.json, tokens/comp/button.tokens.json

दो और मान बताते हैं कि दबाव कितने बड़े एरिया से लिया जाए: उँगली के नीचे sys.target.touch और बारीक पॉइंटर के नीचे sys.target.pointer। दोनों डिफ़ॉल्ट रूप से न्यूनतम के बराबर हैं, इसलिए एक मान तीनों को सेट कर देता है। किसी प्लैटफ़ॉर्म के दिशानिर्देश मानने वाला सिस्टम इन्हें बड़ा रखता है; तब अकेला रखा कंट्रोल जितना बनता है उससे आगे, उस बड़े एरिया से दबाव लेता है, और पड़ोसियों से सटी पंक्ति उतनी ऊँची बनाई जाती है। टार्गेट से छोटा बना निशान, जैसे चेकबॉक्स का बॉक्स या छोटी चिप, अपना साइज़ रखता है और अपना हिट एरिया टार्गेट तक बढ़ा देता है। साथ आने वाला हर सिस्टम क्या सेट करता है:

डिज़ाइन सिस्टम minimum touch pointer
tanrei 36px 36px 36px
cupertino 28px 44px 28px
m3-like 32px 48px 44px

इससे जनरेट किया गया: tokens/systems/*.system.json, design/tokens/<system>/tanrei.light.tokens.json

बिल्ड हर सिस्टम को जाँचता है: तीनों में से कोई 24px (WCAG 2.5.8) से कम नहीं, touch और pointer कभी न्यूनतम से कम नहीं, न्यूनतम कभी कंट्रोल की ऊँचाई से ज़्यादा नहीं, और निचली सीमा वाली कोई ऊँचाई न्यूनतम से कम नहीं। अगर प्रॉडक्ट की अपनी लेयर कोई टार्गेट 24px से कम रखती है, तो उसे चेतावनी के रूप में बताया जाता है; न्यूनतम से छोटा दबाव का एरिया, या कंट्रोल की ऊँचाई से ज़्यादा न्यूनतम, हर सिस्टम में अस्वीकार किया जाता है।

इन्हें लेयर में सेट करना

दोनों ऐसे टोकन हैं जिन्हें लेयर एक कारण के साथ सेट करती है:

"tokens": {
  "tanrei.dial.control.height": { "$value": { "value": 32, "unit": "px" }, "reason": "A tool used all day with a mouse: controls and rows lower." },
  "tanrei.sys.target.minimum": { "$value": { "value": 32, "unit": "px" }, "reason": "Used with a mouse; 32 is the least we draw." }
}

वेब पर ऊँचाइयाँ डायल के CSS एक्सप्रेशन हैं, इसलिए रूट एलिमेंट पर --tanrei-dial-control-height सेट करने से, बिना नए बिल्ड के, उसके साथ चलने वाली सारी ऊँचाइयाँ एक साथ बदल जाती हैं। Theme Studio में “साइज़” वाली पंक्ति में कंट्रोल की ऊँचाई, साइज़ यूनिट और न्यूनतम टार्गेट हैं।

कंटेनर पर सेट किया गया साइज़

साइज़ वहीं सेट होता है जहाँ कंपोनेंट रखे हैं। वेब पर बटन ग्रुप का size, एक बार सेट हो जाने पर, उसके अंदर के हर उस Button का साइज़ होता है जो अपना साइज़ सेट नहीं करता:

<tanrei-button-group size="small">
  <tanrei-button variant="outlined">Cancel</tanrei-button>
  <tanrei-button variant="filled">Publish</tanrei-button>
  <tanrei-button variant="text" size="medium">Details</tanrei-button>
</tanrei-button-group>
  • कंपोनेंट का अपना साइज़ जीतता है। ऊपर का तीसरा Button medium है।
  • सिर्फ़ सेट किया हुआ साइज़ नीचे जाता है। जिस ग्रुप में size नहीं है, वह कोई साइज़ नहीं देता, इसलिए उसका हर Button अपने डिफ़ॉल्ट, medium, पर बनता है, या उस साइज़ पर जो ग्रुप के चारों ओर का कोई कंटेनर सेट करता है; जहाँ कंटेनर एक-दूसरे के अंदर हों, वहाँ साइज़ सेट करने वाला सबसे पास का कंटेनर तय करता है।
  • जो साइज़ कंपोनेंट के पास नहीं है, वह उसका सबसे पास वाला साइज़ बन जाता है, सीढ़ी के क्रम extra-small, small, medium, large, extra-large में, और दो बराबर पास हों तो बड़ा वाला।
  • बटन ग्रुप और टूलबार अपने साइज़ के हिसाब से अपना कुछ नहीं बदलते। उनकी दूरियाँ, कोने और डिवाइडर उनके वेरिएंट के ही रहते हैं, उतनी ऊँचाई के आइटम के चारों ओर जितनी पर वे बने हैं।

कंटेनर से मिले साइज़ पर बना कंपोनेंट भी साइज़ की सीढ़ी और न्यूनतम टार्गेट के साथ वैसे ही चलता है जैसे अपने साइज़ पर। कंटेनर का साइज़ बदलने पर, या कंपोनेंट को कंटेनर में लाने या उससे बाहर ले जाने पर, वह तुरंत अपने नए साइज़ पर बनता है।

कौन साइज़ देता है, कौन लेता है

तीन कंटेनर अपने ऊपर सेट किया गया साइज़ अपने अंदर की चीज़ों को देते हैं:

  • बटन ग्रुप, अपने Button को।
  • टूलबार, अपने Button और मेन्यू वाले बटन को, चाहे वे किसी ग्रुप में हों या नहीं, और अपने ओवरफ़्लो बटन को।
  • लिस्ट, अपनी लिस्ट पंक्तियों को।

ये कंपोनेंट, जब अपना साइज़ सेट नहीं करते, तो इन कंटेनरों में से सबसे पास वाले का साइज़ लेते हैं, और जहाँ कोई कंटेनर साइज़ सेट नहीं करता वहाँ medium पर बनते हैं: Button, मेन्यू वाला बटन, कॉपी बटन और लिस्ट पंक्ति; और अपनी हर पंक्ति या हिस्से को उसी साइज़ पर बनाने वाले लिस्ट, ट्री व्यू, अकॉर्डियन, विषय सूची, डिस्क्रिप्शन लिस्ट और टेबल।

साइज़ इससे आगे नहीं जाता। अकॉर्डियन, डिस्क्रिप्शन लिस्ट और टेबल अपने अंदर रखी चीज़ों को कोई साइज़ नहीं देते: टेबल के किसी सेल में रखा Button अपना साइज़ रखता है, या टेबल के चारों ओर के कंटेनरों का साइज़ लेता है। और कुछ कंपोनेंट किसी कंटेनर से साइज़ लेते ही नहीं:

  • मेन्यू, कॉन्टेक्स्ट मेन्यू और मेन्यू बार के मेन्यू समेत, खोज का व्यू, और सिलेक्ट या कॉम्बोबॉक्स की सूची। ये सब पेज के ऊपर, आसपास के कंट्रोल से अलग खुलते हैं, इसलिए small टूलबार उस मेन्यू को छोटा नहीं करता जिसे उसका कोई Button खोलता है। मेन्यू और खोज medium होते हैं, जब तक वे अपना size सेट न करें; सिलेक्ट या कॉम्बोबॉक्स के विकल्प उसके बॉक्स के साइज़ के साथ चलते हैं।
  • टूलबार के अंदर का सिलेक्ट, नंबर इनपुट, टेक्स्ट इनपुट या स्लाइडर, जो वही साइज़ रखते हैं जो आप उन्हें देते हैं।
  • टाइमलाइन, जिसका साइज़ उसके टेक्स्ट का साइज़ है।