Skip to content

CSS: drawer-layout ​

.instui-drawer-layout — एक विभाजित लेआउट जिसमें एक संकुचित‑योग्य साइड ट्रे और प्राथमिक स्क्रॉल करने योग्य सामग्री पैन है।

-placement-end और डिफ़ॉल्ट (start) दोनों flex-direction/inset-inline-* लॉजिकल प्रॉपर्टीज़ का उपयोग करते हैं, न कि left/right का, इसलिए ट्रे की साइड स्वतः ही direction/dir="rtl" का पालन करती है — अलग RTL नियमों की आवश्यकता नहीं है।

Source: drawer-layout.css

उपयोग ​

css
@import "@pantoken/components/components.css";
@import "@pantoken/components/drawer-layout.css";

उदाहरण ​

html
<div class="instui-drawer-layout" id="drawer" open>
  <div class="tray" role="region" aria-label="Course panel">नेविगेशन</div>
  <div class="content" role="region" aria-label="Course content">मुख्य सामग्री</div>
</div>

संरचना ​

text
.instui-drawer-layout
  drawer-layout.tray (component)
  drawer-layout.content (component)
flowchart TD n0[".instui-drawer-layout"]:::cssdoc-root n1(["drawer-layout.tray"]):::cssdoc-component n2(["drawer-layout.content"]):::cssdoc-component n0 --> n1 n0 --> n2 click n1 "/api/css/drawer-layout.tray.md" click n2 "/api/css/drawer-layout.content.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

मॉडिफायर ​

मॉडिफायरविवरण
.-openजब open एट्रिब्यूट अनुपस्थित हो तब भी ट्रे दिखाएँ।
.-placement-endट्रे को इनलाइन‑एंड साइड पर डॉक करें।
.-placement-startट्रे को इनलाइन‑स्टार्ट साइड पर डॉक करें (डिफ़ॉल्ट; इसे स्पष्ट रूप से सेट करता है)।
.-should-overlay-trayInteraction — Render the tray as an overlay instead of shrinking content inline.

पार्ट्स ​

भागविवरण
.contentमुख्य पैन।
.trayसाइड पैनल।

कस्टम प्रॉपर्टीज ​

प्रॉपर्टीप्रकारडिफ़ॉल्टविवरण
--pantoken-bp-md——ओवरले मोड के लिए चौड़ाई थ्रेशहोल्ड (30em, रेस्पॉन्सिव यूटिलिटीज़ के माध्यम से थीम्ड)।

एक्सेसिबिलिटी ​

हर क्षेत्र का नाम aria-label या aria-labelledby रखें। InstUI-शैली के क्षेत्रों के लिए div का उपयोग करें, न कि <main role="region"> का। जब ट्रे नेविगेशन के रूप में काम करे, तो नामित <nav> का उपयोग करें या ट्रे के अंदर एक रखें।

स्थितियाँरीब्रांड (हल्का)रीब्रांड (गहरा)Canvasकैनवस उच्च कंट्रास्ट
less-contrast-stays-readableWCAG 2.2 1.4.3समीक्षा आवश्यकसमीक्षा आवश्यकसमीक्षा आवश्यकसमीक्षा आवश्यक

prefers-contrast: less के अंतर्गत पृष्ठ बदलता है, लेकिन कोई भी दृश्यमान पाठ मापा नहीं जा सका।

more-contrast-respectedWCAG 2.2 1.4.3, 1.4.6समीक्षा आवश्यकसमीक्षा आवश्यकसमीक्षा आवश्यकसमीक्षा आवश्यक

prefers-contrast: more के अंतर्गत पेज बदलता है, लेकिन कोई दृश्यमान टेक्स्ट मापा नहीं जा सका।

reflow-at-320pxWCAG 2.2 1.4.10PassPassPassPass
text-spacing-no-clippingWCAG 2.2 1.4.12PassPassPassPass
स्क्रीन रीडर (अनुकरण किया गया)रीब्रांड (हल्का)रीब्रांड (गहरा)Canvasकैनवस उच्च कंट्रास्ट
AnnouncementsPassPassPassPass

ये स्वचालित परिणाम यह साबित नहीं करते कि पेज WCAG के अनुरूप है; मैन्युअल समीक्षा अभी भी आवश्यक है।

ब्राउज़र समर्थन ​

  • drawer-layout.tray/drawer-layout.content सदस्य एक @container क्वेरी के माध्यम से स्वचालित रूप से ओवरले मोड में बदल जाते हैं जब इस एलिमेंट का इनलाइन‑साइज़ ट्रे‑चौड़ाई + --pantoken-bp-md से नीचे गिरता है। @pantoken/interactions व्यवहार अतिरिक्त रूप से [should-overlay-tray]/.-should-overlay-tray (एक मैनुअल ओवरराइड) को टॉगल करता है और उन ऐप्स के लिए overlaytraychange इमिट करता है जिन्हें यह बदलाव एक इवेंट के रूप में चाहिए।

सबकम्पोनेन्ट्स ​

संबंधित ​

  • tray — एक स्वतंत्र किनारी ओवरले; यह लेआउट ट्रे और सामग्री को एक ही फ्लो में रखता है。
  • context-view — संदर्भगत क्रियाओं और विवरण के लिए एक छोटा एंकर किया गया सतह।