मोडल लेयर

अवलोकन

link

Web

tanrei-modal-layer

clock_loader_40

SwiftUI

tanreiModalLayer

radio_button_unchecked

Jetpack Compose

TanreiModalLayer

radio_button_unchecked

Flutter

TanreiModalLayer

radio_button_unchecked

React Native

ModalLayer

radio_button_unchecked

इससे जनरेट किया गया: docs/status/status.json, specs/modal-layer.spec.json

आपके अपने कार्ड के चारों ओर एक मोडल लेयर: इसे बटन से खोलें

फ़ोटो एक्सपोर्ट करें

24 फ़ोटो एक्सपोर्ट के लिए तैयार हैं।

हो गया

हर मोडल सरफ़ेस के नीचे एक ही लेयर होती है। वह सरफ़ेस के पीछे की विंडो को धुँधला करती है, ताकि पेज एक तरफ़ रखा हुआ लगे। वह वहाँ की हर चीज़ को निष्क्रिय कर देती है: पीछे की किसी चीज़ को न दबाया जा सकता है, न उस पर फ़ोकस जा सकता है, न स्क्रीन रीडर उसे पढ़ सकता है, और पेज स्क्रॉल नहीं होता। वह फ़ोकस को सरफ़ेस के भीतर ले जाती है, सरफ़ेस के खुला रहने तक उसे वहीं रखती है, और सरफ़ेस बंद होने पर उसे लौटा देती है। और जब व्यक्ति Escape दबाता है, प्लैटफ़ॉर्म का बैक इस्तेमाल करता है या स्क्रिम पर दबाता है, तो वह बंद होने का अनुरोध करती है।

मोडल लेयर वही लेयर है, अपने आप में एक कंपोनेंट के रूप में। डायलॉग, मोडल होने पर साइड शीट और बॉटम शीट, मोडल नेविगेशन ड्रॉअर, इमेज प्रीव्यू, मोडल तारीख़ और समय पिकर और खोज के मोडल व्यू, ये सब इसी से बने हैं। इनमें से हर एक अपने अलग नियम रखने के बजाय इसी के नियमों पर चलता है।

यह एक ऐडवांस्ड कंपोनेंट है। इससे आपका सामना दो तरह से होता है:

• हर मोडल सरफ़ेस की स्टाइल एक साथ बदलने के लिए। लेयर के टोकन, comp.modal-layer.*, वही हैं जिनकी ओर उन सभी कंपोनेंट के स्क्रिम और मोशन टोकन इशारा करते हैं। इन्हें अपने प्रॉडक्ट की लेयर में सेट करें, और हर मोडल सरफ़ेस एक साथ बदल जाती है: स्क्रिम का रंग और अपारदर्शिता, पीछे की चीज़ों का ब्लर, और लेयर को आने और जाने में कितना समय लगता है।
• ऐसी मोडल सरफ़ेस बनाने के लिए जो Tanrei में नहीं है: कमांड पैलेट, पूरी विंडो पर छा जाने वाला व्यू, आपका अपना व्यूअर। अपनी सरफ़ेस को लेयर के भीतर रखें, और वह आपके प्रॉडक्ट की हर दूसरी मोडल सरफ़ेस की तरह व्यवहार करेगी।

किसी फ़ैसले के लिए डायलॉग इस्तेमाल करें। किसी पैनल के लिए मोडल साइड शीट या बॉटम शीट इस्तेमाल करें। वे अपना नाम ख़ुद बताती हैं, अपनी क्रियाओं को जगह देती हैं और बाहर निकलने का रास्ता देती हैं।

वेब पर यह <tanrei-modal-layer> है। बाक़ी प्लैटफ़ॉर्मों ने इसे अभी इम्प्लीमेंट नहीं किया है।

इस्तेमाल

link

लेयर कंट्रोल्ड है। इसे दिखाने के लिए open सेट करें। जब व्यक्ति इसे बंद करने का अनुरोध करता है, तो यह कारण (escape, back या scrim) के साथ close एमिट करती है और खुली रहती है: open को वापस false आप करते हैं। इसे एक label दें, जो वह नाम है जिसे स्क्रीन रीडर पढ़कर सुनाता है।

लेयर स्क्रिम के सिवा अपना कुछ नहीं बनाती। आपका कॉन्टेंट अपना रंग, शेप और पैडिंग ख़ुद रखता है, और लेयर उसे उसके अपने साइज़ में विंडो के बीच में रखती है। उसे कहीं और रखना हो, तो प्लैटफ़ॉर्म के अपने तरीक़े से रखें (वेब पर ::part(container))।

<tanrei-button id="open-palette" variant="text">कमांड</tanrei-button>

<tanrei-modal-layer label="कमांड">
  <div class="palette">
    <!-- autofocus शुरुआती फ़ोकस का निशान है। इसके बिना फ़ोकस लेयर के कंटेनर पर जाता है। -->
    <input autofocus aria-label="कमांड खोजें">
    <ul>…</ul>
  </div>
</tanrei-modal-layer>

<style>
  /* कंटेनर को ख़ुद रखें: यहाँ, विंडो के ऊपरी हिस्से के पास। */
  tanrei-modal-layer::part(container) { margin-block-start: 15vh; }
</style>

<script type="module">
  import '@tanrei/web/components/modal-layer';
  const layer = document.querySelector('tanrei-modal-layer');
  document.querySelector('#open-palette').addEventListener('click', () => (layer.open = true));
  // Escape, बैक या स्क्रिम पर दबाना। लेयर कभी अपने आप बंद नहीं होती।
  layer.addEventListener('close', (event) => {
    console.log(event.detail.reason); // 'escape', 'back' या 'scrim'
    layer.open = false;
  });
</script>

// उन्नत कंपोनेंट, जिससे दूसरे कंपोनेंट बनते हैं, advanced एंट्री से इम्पोर्ट होता है।
import { ModalLayer } from '@tanrei/react/advanced';

<ModalLayer open={open} label="कमांड" onClose={() => setOpen(false)}>
  <CommandPalette />
</ModalLayer>

अभी इम्प्लीमेंट नहीं हुआ है। योजना एक व्यू मॉडिफ़ायर की है: .tanreiModalLayer(isPresented:, accessibilityLabel:, onClose:) { … }।

अभी इम्प्लीमेंट नहीं हुआ है। योजना वाला रूप है TanreiModalLayer(visible, onCloseRequest, contentDescription) { … }।

अभी इम्प्लीमेंट नहीं हुआ है। योजना वाला रूप है TanreiModalLayer(open:, onClose:, semanticLabel:, child: …)।

अभी इम्प्लीमेंट नहीं हुआ है। योजना वाला रूप है <ModalLayer visible onClose accessibilityLabel>…</ModalLayer>।

हर मोडल सरफ़ेस की स्टाइल बदलना

link

प्रॉडक्ट अपनी लेयर फ़ाइल में लेयर के टोकन सेट करता है, और हर मोडल सरफ़ेस उनके पीछे चलती है:

{
  "tokens": {
    "tanrei.comp.modal-layer.scrim.color": { "$value": "{tanrei.sys.color.scrim}" },
    "tanrei.comp.modal-layer.scrim.blur": { "$value": { "value": 8, "unit": "px" }, "reason": "हमारी मोडल सरफ़ेस अपने पीछे की चीज़ों को फ़्रॉस्टेड काँच जैसा धुँधला कर देती हैं।" }
  }
}

स्क्रिम की अपारदर्शिता उसके रंग का अल्फ़ा है: उसे हल्का या गहरा करने के लिए रंग बदलें, या सिस्टम का scrim रोल। किसी एक सरफ़ेस को अलग रखने के लिए उसकी जगह उसी सरफ़ेस का अपना टोकन सेट करें (comp.dialog.scrim.color, comp.dialog.motion.enter-duration)। जब तक आप ऐसा नहीं करते, वह लेयर के टोकन की ओर इशारा करता है।

स्पेक

link

संरचना

भाग	विवरण
1 scrim · वैकल्पिक	The dim over the whole window behind the container, to every edge and under every system inset. It blocks presses and, while the layer is dismissible, a press on it asks the layer to close. Not drawn while scrim is false.
2 container	The box the content is in, placed in the window's safe area. It draws nothing of its own — no color, edge, shadow, shape or padding — takes focus when nothing in the content is marked for it, and is the modal dialog assistive technology reads.

प्रॉपर्टी

प्रॉपर्टी	टाइप	डिफ़ॉल्ट	विवरण
open	boolean	false	Whether the layer is presented. The product opens it, and closes it in answer to close (or from its content's own controls); on SwiftUI, where it is a binding, the layer writes false itself.
dismissible	boolean	true	Whether Escape, the platform's back and a press on the scrim ask the layer to close (MDL-6). Set it to false only when the person must finish with one of the content's own controls, and give the content one.
scrim	boolean	true	Whether the layer dims what lies behind its container. False for content that covers the whole window with a fill of its own (a full-window preview): the layer then draws nothing behind it and still blocks everything there (MDL-2).
label	string	""	Names the container for assistive technology ("Export photos"): the modal dialog's name. Never drawn. Required.

स्लॉट

स्लॉट	विवरण
default	The content: the surface the product presents modally (a panel, a card, a view over the whole window). The layer places its container (MDL-11) and draws, styles and sizes nothing of the content. A fixture's content string is plain text.

इवेंट

इवेंट	विवरण
close	The layer asks to be closed: Escape, the platform's back or a press on the scrim. Carries which of these it was, named escape, back or scrim (in the platform's casing). Emitted only while dismissible is true.

स्टेट

व्यवहार

EARS रूप में लिखी गई आवश्यकताएँ। हर प्लैटफ़ॉर्म के इम्प्लीमेंटेशन को इन ID के आधार पर टेस्ट किया जाता है। आवश्यकताओं का पाठ स्पेक फ़ाइल से ज्यों का त्यों, अंग्रेज़ी में दिखाया गया है।

ID	आवश्यकता
MDL-1	WHEN open becomes true THE modal layer SHALL present its container above everything in its window — every region, every overlay not opened from inside it (MDL-9) and every modal layer opened before it (MDL-8) — and, WHILE scrim is true, SHALL draw its scrim over the whole window behind the container, to every edge and under every system inset, filled with comp.modal-layer.scrim.color (its alpha is the dim) and, WHILE comp.modal-layer.scrim.blur is above 0, with what lies behind it blurred by a Gaussian blur of that radius (the radius of CSS's blur()); WHERE the platform cannot blur what lies behind a window it SHALL draw the color alone. WHILE scrim is false it SHALL draw nothing behind the container and SHALL still block what is behind as MDL-2 says. A component built from the modal layer draws the scrim from its own scrim tokens, which alias these two (comp.dialog.scrim.color and comp.dialog.scrim.blur, and so on).
MDL-2	WHILE open is true THE modal layer SHALL make everything outside its container inert — not focusable, not pressable, hidden from assistive technology — and SHALL keep the content behind it from scrolling without moving it (where a scroll bar takes room, that room stays while the scroll is held), so that a press, a scroll or a key anywhere outside the container reaches nothing behind it; WHEN it closes THE modal layer SHALL restore what is behind to what it was before: its scroll position, and what was focusable, pressable and exposed.
MDL-3	WHEN open changes from false to true, and WHEN the layer is mounted with open true, THE modal layer SHALL move focus to the element in its content that the product marked for initial focus (the platform's own mark, named in the platform notes) or, without one, to the element the component built from it names (the navigation drawer's selected destination, NVD-19) or else to its container, so that assistive technology reads its name first and the next Tab reaches the first focusable element. Focus SHALL move when the layer opens, not when its motion ends.
MDL-4	WHILE open is true THE modal layer SHALL keep focus inside its container: Tab from the last focusable element in it SHALL move to the first, Shift+Tab from the first (or from the container itself) SHALL move to the last, the container SHALL keep focus WHILE nothing in it is focusable, and screen-reader navigation SHALL NOT leave it.
MDL-5	WHEN the layer closes THE modal layer SHALL return focus to the element that had it when the layer opened or, where that element no longer exists, cannot take focus or is inert, to the platform's default for a closed overlay; focus SHALL move when the layer closes, not when its motion ends.
MDL-6	WHILE dismissible is true and open is true, WHEN the user presses Escape, uses the platform's back (Android's back gesture or button, the iOS accessibility escape gesture) or presses the scrim — a press that starts and ends outside the container — THE modal layer SHALL emit close exactly once with the reason escape, back or scrim, and SHALL stay open until open becomes false: the product sets it from close (through the binding where open is one, SwiftUI), unless the component built from the modal layer closes itself as its own spec says (DLG-5, NVD-20). Escape SHALL reach the layer only after everything inside its container has heard it: a key an element inside takes (a field clearing its text, a menu closing) SHALL NOT also ask the layer to close. WHILE dismissible is false THE modal layer SHALL ignore these inputs and emit nothing, and a press on the scrim SHALL still reach nothing behind it.
MDL-7	WHEN the layer opens THE modal layer SHALL fade its scrim and its container in from transparent over comp.modal-layer.motion.enter-duration with comp.modal-layer.motion.enter-easing, and WHEN it closes SHALL fade both out over comp.modal-layer.motion.exit-duration with comp.modal-layer.motion.exit-easing, keeping them drawn until the fade ends. A component built from the modal layer SHALL fade the scrim in step with its own surface, over its own enter and exit motion, and moves its surface as its own spec says (a dialog grows, a sheet slides). The enter and exit tokens of a surface that takes the modal role (a dialog, a modal picker, an image preview) alias these four, so that one value sets the tempo of every such surface of a product; a sheet (a bottom sheet, a side sheet, a modal navigation drawer) takes the sheet role (tanrei.sys.motion.role.appear.sheet.enter and .exit) instead, so that one value sets the tempo of every sheet. WHERE motion is reduced THE modal layer SHALL fade without moving or growing anything, or SHALL appear and disappear at once WHERE the component built from it says so or on a platform whose reduced-motion setting removes every animation (Android's).
MDL-8	WHEN a modal layer opens while another is open THE modal layer SHALL stack above it with its own scrim, make the first one inert with the rest of the window, and WHEN it closes return focus to the element inside the first one that had it; Escape, the platform's back and a press on the scrim SHALL reach only the topmost layer.
MDL-9	WHEN an overlay that is not modal opens from an element inside the container — a menu, a tooltip, a popover, a select's list, a docked picker — THE modal layer SHALL let it be presented above the layer and operated while the rest of the window is inert, and SHALL NOT count a press inside it as a press on the scrim: the overlay belongs to the layer as POP-25 says.
MDL-10	THE modal layer SHALL expose its container as a modal dialog named by label, everything outside it being hidden (MDL-2); a component built from it names the dialog by its own headline or label and may expose it as an alert dialog (DLG-14). WHILE label is empty THE modal layer SHALL still open, and in debug builds SHALL report that it has no accessible name.
MDL-11	THE modal layer SHALL draw nothing of its own but the scrim: its container has no color, edge, shadow, shape or padding and hands its content no color or text style, so that plain text given as content takes what the window around it gives. It SHALL lay the container out at the size of its content, centred in the window's safe area and above the on-screen keyboard while one is shown, and never larger than that area, the content scrolling inside it where it is larger; the product places or sizes the container otherwise in the platform's own way (named in the platform notes). A component built from the modal layer places and draws its own surface (DLG-7, SSH-7, BSH-6, IMP-1).
MDL-12	THE modal layer SHALL take its layout direction from where it is used and SHALL have no direction setting of its own; it SHALL mirror nothing itself, and its content follows the direction.
MDL-13	WHERE the platform has ARIA attributes (the web), WHEN the product sets an aria- attribute on the host, by the attribute or by the ARIA property that reflects it, THE modal layer SHALL move it to the data-aria- attribute of the same name, so that the host is no second node with its name, description or state, and SHALL expose it on its dialog (MDL-10) — an id reference by the elements it names in the host's tree or a tree around it, a description after its own. WHILE label is not empty it is the dialog's name, over a name given so; WHILE label is empty, a name given so is the dialog's name and SHALL NOT be reported as having none in debug builds. WHEN the product removes the aria- attribute or its data-aria- twin, or sets the ARIA property that reflects it (ariaLabel, ariaDescribedByElements…) to null, THE modal layer SHALL take it off that element.

प्लैटफ़ॉर्म के अनुसार नामों का मिलान

पैरिटी का मतलब एक जैसे API नहीं है। हर प्लैटफ़ॉर्म एक ही कॉन्ट्रैक्ट को अपने तरीक़े से व्यक्त करता है।

स्पेक	Web	SwiftUI	Jetpack Compose	Flutter	React Native
कंपोनेंट	tanrei-modal-layer	tanreiModalLayer	TanreiModalLayer	TanreiModalLayer	ModalLayer
open · प्रॉपर्टी	open	isPresented	visible	open	visible
dismissible · प्रॉपर्टी	closedby	dismissible	dismissible	dismissible	dismissible
scrim · प्रॉपर्टी	scrim	scrim	scrim	scrim	scrim
label · प्रॉपर्टी	label	accessibilityLabel	contentDescription	semanticLabel	accessibilityLabel
close · इवेंट	close	onClose	onCloseRequest	onClose	onClose
टिप्पणियाँ	dismissible is HTML's own closedby attribute, as on <tanrei-dialog> and <tanrei-bottom-sheet>: any (the default) or none. scrim is a boolean property that defaults to true; its attribute is the inverse no-scrim (an HTML boolean attribute cannot default to true). close is a CustomEvent whose detail.reason is escape, scrim or back (back when the native cancel arrives without an Escape key, as Android's back gesture sends it); the product sets open to false from it. The content is the default slot. The container is a native <dialog> in the shadow root opened with showModal(), in the top layer over ::backdrop, the scrim (backdrop-filter blurs what is behind it); it is the container part, which a product places or sizes with ::part(container) (MDL-11). The fade out (MDL-7) keeps the closed <dialog> in the top layer in every browser, as it does every Tanrei modal overlay: closing closes the modal <dialog> at once (focus goes back, nothing is inert any more) and shows it as a manual popover, inert and taking no pointer, marked data-tanrei-leaving, until its fade and its scrim's have finished. The autofocus attribute on a slotted element marks initial focus. Debug builds (import.meta.env.DEV or the package's dev export) report an empty label (MDL-10). Snapshot harness: a 640 × 640 viewport with a surface page, the layer opened by open; the screenshot is the viewport.	Planned: a view modifier, as .sheet is: .tanreiModalLayer(isPresented: Binding<Bool>, dismissible:, scrim:, accessibilityLabel:, onClose:, content:), presented as tanreiDialog is (on iOS .fullScreenCover with a clear presentation background and the system transition off; Tanrei draws the scrim and the fade; on macOS an overlay of the modified view with the modal trait). Closing writes false to isPresented and then calls onClose with the reason. Initial focus is .defaultFocus; Escape is .onKeyPress(.escape) and the escape gesture .accessibilityAction(.escape). The blur is a material behind the scrim where the radius is above 0. The container is placed with the content's own frame and alignment.	Planned: TanreiModalLayer(visible, onCloseRequest: (TanreiModalLayerCloseReason) -> Unit, dismissible, scrim, contentDescription, content), drawn in a Dialog window of its own (as TanreiDialog and the modal sheets are) with the window's own dim off and usePlatformDefaultWidth = false; the window traps focus, answers back and hides what is behind from TalkBack. The blur is the window's blur-behind radius on Android 12 and later, and none before (MDL-1). The caller sets visible to false from onCloseRequest. The container is placed with a Modifier on the content.	Planned: TanreiModalLayer(open:, onClose:, dismissible:, scrim:, semanticLabel:, child:), a controlled overlay in the Overlay over the page with a ModalBarrier drawn in the layer's color and a BackdropFilter for the blur, a FocusScope that traps focus, BlockSemantics behind it and a PopScope for back. The container is placed with the child's own Align.	Planned: <ModalLayer visible onClose dismissible scrim accessibilityLabel>{content}</ModalLayer>, presented in a transparent Modal with animationType="none", statusBarTranslucent and navigationBarTranslucent; onRequestClose (Android's back, and Escape on a hardware keyboard) is close with the reason back or escape. React Native cannot blur what is behind a window without a native module of its own, so the scrim is the color alone (MDL-1). The container is placed with the content's own style.

टोकन

टोकन	किसका एलियास	रिज़ॉल्व किया गया मान (लाइट)
--tanrei-comp-modal-layer-motion-enter-duration	sys.motion.role.appear.modal.enter	350ms
--tanrei-comp-modal-layer-motion-enter-easing	sys.motion.easing.enter	cubic-bezier(0.2, 0, 0, 1)
--tanrei-comp-modal-layer-motion-exit-duration	sys.motion.role.appear.modal.exit	300ms
--tanrei-comp-modal-layer-motion-exit-easing	sys.motion.easing.exit	cubic-bezier(0.3, 0, 1, 1)
--tanrei-comp-modal-layer-scrim-blur	—	0px
--tanrei-comp-modal-layer-scrim-color	sys.color.scrim	#000000 · 40%

फ़िक्स्चर

मानक रेंडरिंग। हर प्लैटफ़ॉर्म हर फ़िक्स्चर का स्नैपशॉट एक ही ID से लेता है, ताकि नतीजों की तुलना की जा सके।

open

open: true label: Export photos 640 × 640 की विंडो में अलग से बनाया गया

no-scrim

open: true scrim: false label: Export photos 640 × 640 की विंडो में अलग से बनाया गया

इससे जनरेट किया गया: specs/modal-layer.spec.json, tokens/comp/modal-layer.tokens.json, design/tokens/

दिशानिर्देश

link

लेयर क्या करती है और आप पर क्या छोड़ती है

link

लेयर	आपका कॉन्टेंट
अपने पीछे की विंडो को हर किनारे तक धुँधला करती है (या scrim बंद होने पर कुछ नहीं बनाती)।	अपना रंग, शेप, शैडो और पैडिंग। लेयर इनमें से कुछ नहीं जोड़ती।
पीछे की हर चीज़ को निष्क्रिय करती है और पेज को स्क्रॉल होने से रोकती है।	अपना स्क्रॉल, जब वह विंडो से ऊँचा हो।
फ़ोकस को भीतर ले जाती है, वहीं रखती है, बंद होने पर लौटा देती है।	उस एलिमेंट पर निशान लगाता है जिसे सबसे पहले फ़ोकस मिलना चाहिए, अगर ऐसा कोई हो।
Escape, प्लैटफ़ॉर्म के बैक और स्क्रिम पर दबाने पर बंद होने का अनुरोध करती है।	बाहर निकलने का अपना रास्ता: बंद करें, रद्द करें या हो गया बटन।
कंटेनर को उसके कॉन्टेंट के साइज़ में विंडो के बीच में रखती है।	अगर बीच में नहीं, तो वह कहाँ जाए।

स्क्रिम के बिना

link

ऐसे कॉन्टेंट के लिए scrim बंद करें जो पूरी विंडो को अपने फ़िल से ढकता है, जैसे गहरे बैकग्राउंड पर कोई व्यूअर। तब धुँधला करने को कुछ बचता ही नहीं। लेयर फिर भी पीछे की हर चीज़ को रोके रखती है, और आपके कॉन्टेंट के बाहर दबाने पर फिर भी बंद होने का अनुरोध होता है।

करें

link

• लेयर को label से नाम दें। फ़ोकस भीतर जाने पर स्क्रीन रीडर उसे पढ़कर सुनाता है।
• कॉन्टेंट में बाहर निकलने का एक दिखने वाला रास्ता रखें। हर कोई Escape के बारे में नहीं जानता, और बैक हर डिवाइस पर नहीं होता।
• प्रॉडक्ट की मोडल सरफ़ेस को comp.modal-layer.* के ज़रिए बदलें, ताकि वे एक जैसी बनी रहें।

न करें

link

• सिर्फ़ लेयर से डायलॉग या शीट न बनाएँ। डायलॉग या शीट इस्तेमाल करें, जो हेडलाइन, क्रियाएँ और उनकी जगह पहले से देते हैं।
• कॉन्टेंट में बाहर निकलने के रास्ते के बिना dismissible बंद न करें। व्यक्ति के पास निकलने का कोई रास्ता नहीं बचेगा।
• इसे किसी ऐसी चीज़ के लिए इस्तेमाल न करें जिसे पेज को रोकना नहीं चाहिए। पॉपओवर, मेन्यू या स्नैकबार पेज को इस्तेमाल के लायक़ छोड़ते हैं।

सुलभता

link

रोल

dialog

लेबलिंग

The container is a modal dialog named by label; everything outside it is hidden from assistive technology while the layer is open. The scrim is not exposed. A component built from the modal layer names the dialog by its own headline or label, and the dialog may be an alert dialog.

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

दिखने वाला आकार छोटा होने पर भी हिट एरिया न्यूनतम टार्गेट साइज़ को पूरा करता है। minimum 32px · pointer 44px · spacing 8px · touch 48px

कीबोर्ड

कुंजियाँ	क्रिया
Tab / Shift+Tab	Move focus through the focusable elements in the container, wrapping from the last to the first and back; focus never leaves the layer.
Escape	Asks the layer to close (close, reason escape) while dismissible is true; with stacked layers, only the topmost. A key an element inside takes first goes no further.

टिप्पणियाँ

• The modal layer is what every modal surface of Tanrei has in common: the dialog, the modal side sheet, the modal bottom sheet, the modal navigation drawer, the image preview, the modal date-time picker and the search's modal views are each built from it and cite its rules. Restyle their scrim and their tempo once, through comp.modal-layer.*.
• Use it alone for a modal surface Tanrei does not have — a command palette, a takeover over the whole window, a viewer of your own. For a decision use the Dialog; for a panel, the modal side sheet or bottom sheet: they already hold focus, name themselves and place their actions.
• Give the content a way out of its own (a Close, Cancel or Done button). Escape, back and the scrim are not found by everyone, and with dismissible false they do nothing.
• The layer has no target of its own; what the product puts in it meets the minimum target itself.
• Inert, focus moved in, kept and given back: the WAI-ARIA Authoring Practices' modal dialog pattern and HTML's modal dialog. The web presents the container with a modal <dialog> element (showModal gives the top layer and inertness); the other platforms present it in a window or a route of its own with the system's dim switched off, so that every platform draws the layer's own scrim.

इससे जनरेट किया गया: specs/modal-layer.spec.json, tokens/sys/measure.tokens.json

कंपोनेंट क्या सँभालता है

link

• कंटेनर एक मोडल डायलॉग है, जिसका नाम label से आता है। उसके खुला रहते उसके बाहर की हर चीज़ सहायक तकनीक से छिपी रहती है।
• लेयर खुलने पर फ़ोकस उसके भीतर जाता है, तब भी जब उसे खुला ही लिखा गया हो। वह उस एलिमेंट पर जाता है जिस पर आपने निशान लगाया है, नहीं तो कंटेनर पर, ताकि सबसे पहले नाम पढ़ा जाए।
• Tab और Shift+Tab लेयर के भीतर ही घूमती रहती हैं। फ़ोकस कभी पीछे के पेज तक नहीं पहुँचता।
• बंद होने पर फ़ोकस वहीं लौटता है जहाँ वह था। अगर वह एलिमेंट अब नहीं है, तो फ़ोकस वहाँ जाता है जहाँ प्लैटफ़ॉर्म उसे रखता है।
• Escape बंद होने का अनुरोध तभी करती है जब भीतर की हर चीज़ उसे सुन चुकी हो। Escape पर अपना टेक्स्ट साफ़ करने वाला फ़ील्ड, या बंद होता मेन्यू, लेयर को खुला रखता है।
• किसी लेयर के भीतर से खोली गई लेयर उसके ऊपर आती है। Escape, बैक और अपने स्क्रिम का जवाब सिर्फ़ सबसे ऊपर वाली देती है।

आपको क्या करना है

link

• ऐसा label दें जो बताए कि सरफ़ेस किस लिए है।
• जब कोई फ़ॉर्म या खोज फ़ील्ड ही सरफ़ेस की वजह हो, तो फ़ोकस पाने वाले पहले एलिमेंट पर निशान लगाएँ।
• कॉन्टेंट को एक दिखने वाला कंट्रोल दें जो उसे बंद करे, और जब तक वह कंट्रोल न हो, dismissible चालू रखें।