模态框草稿 Storybook
概述
模态框
用于向用户显示需要立即关注或对其当前用户流程至关重要的内容。当模态框打开时,用户无法与模态框背后的页面内容交互,并且在用户完成要求或关闭模态框之前,无法返回到之前的工作流程。
使用时机
- 需要用户立即响应。
- 通知用户与其当前工作相关的紧急信息。
- 确认用户决策。
不使用时机
- 当用户需要重复进行某项任务时,避免使用模态框。
- 不要将模态框用于与当前工作流程无关的非必要信息。
用法
主要组件有以下属性
title
- 模态框的标题或自定义头部元素className
contentClassName
- 模态框内容的特定类名closeOnEscape
closeOnBackdropClick
trapFocus
- 是否在焦点范围卸载后,将焦点恢复到焦点范围加载时聚焦的元素。isOpen
onDismiss
onClickBackdrop
- 如果未设置,并且设置了onDismiss
,则会调用onDismiss
ModalTabsHeader - 带有标签页的自定义头部元素,具有以下属性
icon
title
tabs
activeTab
onChangeTab
类型和行为
-
基本模态框:带有默认头部、主要内容、关闭按钮和/或操作按钮的基本模态框。
-
使用 contentClassName 属性的模态框:在这种情况下,模态框内容应用了特定的类。
-
带有标签页的模态框:在这种情况下,模态框带有标签页,每个标签页都有其主要内容和按钮。
可访问性
对话框 (模态框) 模式 构建模态框时请检查键盘行为。我们注意到,当内容溢出时,用户无法滚动,除非
- 模态框底部包含交互元素,例如按钮。
- 内容具有
tabIndex = 0
,因此可以通过键盘聚焦。