组件
对话框
用于聚焦任务和确认操作的模态层。
用法
基础
Edit profile
Make changes to your profile here, then save when you are done.
HTML
<bs:bsui-dialog>
<bs:bsui-dialog-trigger trigger_label="Edit profile" trigger_variant="outline" />
<bs:bsui-dialog-backdrop />
<bs:bsui-dialog-popup>
<bs:bsui-dialog-header>
<bs:bsui-dialog-title content="Edit profile" />
<bs:bsui-dialog-description content="Make changes to your profile here, then save when you are done." />
</bs:bsui-dialog-header>
<bs:bsui-dialog-content>
<bs:bsui-field>
<bs:bsui-field-label text="Name" />
<bs:bsui-input defaultValue="Pedro Duarte" />
</bs:bsui-field>
</bs:bsui-dialog-content>
<bs:bsui-dialog-footer>
<bs:bsui-dialog-close label="Cancel" variant="outline" />
<bs:bsui-dialog-close label="Save changes" variant="default" />
</bs:bsui-dialog-footer>
</bs:bsui-dialog-popup>
</bs:bsui-dialog>嵌套对话框
从第一个对话框中打开第二个对话框,父级保持挂载并在子级后方缩小。
Workspace settings
Renaming a workspace updates every invite link that points at it.
Delete Northwind?
Nine projects and their build history go with it.
HTML
<bs:bsui-dialog>
<bs:bsui-dialog-trigger trigger_label="Workspace settings" trigger_variant="outline" />
<bs:bsui-dialog-backdrop />
<bs:bsui-dialog-popup>
<bs:bsui-dialog-header>
<bs:bsui-dialog-title content="Workspace settings" />
<bs:bsui-dialog-description content="Renaming a workspace updates every invite link that points at it." />
</bs:bsui-dialog-header>
<bs:bsui-dialog-content>
<bs:bsui-field>
<bs:bsui-field-label text="Workspace name" />
<bs:bsui-input defaultValue="Northwind" />
</bs:bsui-field>
</bs:bsui-dialog-content>
<bs:bsui-dialog-footer>
<bs:bsui-dialog>
<bs:bsui-dialog-trigger trigger_label="Delete" trigger_variant="destructive" />
<bs:bsui-dialog-popup>
<bs:bsui-dialog-header>
<bs:bsui-dialog-title content="Delete Northwind?" />
<bs:bsui-dialog-description content="Nine projects and their build history go with it." />
</bs:bsui-dialog-header>
<bs:bsui-dialog-footer>
<bs:bsui-dialog-close label="Keep workspace" variant="outline" />
<bs:bsui-dialog-close label="Delete forever" variant="destructive" />
</bs:bsui-dialog-footer>
</bs:bsui-dialog-popup>
</bs:bsui-dialog>
<bs:bsui-dialog-close label="Save changes" variant="default" />
</bs:bsui-dialog-footer>
</bs:bsui-dialog-popup>
</bs:bsui-dialog>深入三层
只有最外层对话框会绘制背景遮罩;每打开一层,后方的一层都会缩小;按 Escape 只会关闭堆栈顶层。
Publish 2.4.0
Fourteen commits landed since the last tag.
Changes in this release
Two of them touch the public API.
Two breaking changes
Anyone still on 2.3 has to update their config before upgrading.
HTML
<bs:bsui-dialog>
<bs:bsui-dialog-trigger trigger_label="Publish release" />
<bs:bsui-dialog-backdrop />
<bs:bsui-dialog-popup>
<bs:bsui-dialog-header>
<bs:bsui-dialog-title content="Publish 2.4.0" />
<bs:bsui-dialog-description content="Fourteen commits landed since the last tag." />
</bs:bsui-dialog-header>
<bs:bsui-dialog-footer>
<bs:bsui-dialog>
<bs:bsui-dialog-trigger trigger_label="Review changes" trigger_variant="outline" />
<bs:bsui-dialog-popup>
<bs:bsui-dialog-header>
<bs:bsui-dialog-title content="Changes in this release" />
<bs:bsui-dialog-description content="Two of them touch the public API." />
</bs:bsui-dialog-header>
<bs:bsui-dialog-footer>
<bs:bsui-dialog>
<bs:bsui-dialog-trigger trigger_label="Breaking changes" trigger_variant="destructive" />
<bs:bsui-dialog-popup>
<bs:bsui-dialog-header>
<bs:bsui-dialog-title content="Two breaking changes" />
<bs:bsui-dialog-description content="Anyone still on 2.3 has to update their config before upgrading." />
</bs:bsui-dialog-header>
<bs:bsui-dialog-footer>
<bs:bsui-dialog-close label="Understood" variant="default" />
</bs:bsui-dialog-footer>
</bs:bsui-dialog-popup>
</bs:bsui-dialog>
<bs:bsui-dialog-close label="Back" />
</bs:bsui-dialog-footer>
</bs:bsui-dialog-popup>
</bs:bsui-dialog>
<bs:bsui-dialog-close label="Publish" variant="default" />
</bs:bsui-dialog-footer>
</bs:bsui-dialog-popup>
</bs:bsui-dialog>带选择框的表单
对话框主体中放置了实际的创建表单,选择框列表会在弹出层内展开,而不会显示在弹出层后方。
New project
Projects inherit the plan of the workspace they belong to.
Lowercase letters, numbers and dashes.
Europe
United States
Asia Pacific
HTML
<bs:bsui-dialog>
<bs:bsui-dialog-trigger trigger_label="New project" />
<bs:bsui-dialog-backdrop />
<bs:bsui-dialog-popup>
<bs:bsui-dialog-header>
<bs:bsui-dialog-title content="New project" />
<bs:bsui-dialog-description content="Projects inherit the plan of the workspace they belong to." />
</bs:bsui-dialog-header>
<bs:bsui-dialog-content>
<bs:bsui-stack direction="column" gap="4" align="stretch">
<bs:bsui-field>
<bs:bsui-field-label text="Project name" />
<bs:bsui-input placeholder="Northwind API" />
<bs:bsui-field-description text="Lowercase letters, numbers and dashes." />
</bs:bsui-field>
<bs:bsui-field>
<bs:bsui-field-label text="Region" />
<bs:bsui-select placeholder="Pick a region" defaultValue="eu">
<bs:bsui-select-trigger />
<bs:bsui-select-popup>
<bs:bsui-select-option value="eu" label="Europe" />
<bs:bsui-select-option value="us" label="United States" />
<bs:bsui-select-option value="ap" label="Asia Pacific" />
</bs:bsui-select-popup>
</bs:bsui-select>
</bs:bsui-field>
<bs:bsui-checkbox label="Seed the project with sample data" defaultChecked="true" />
</bs:bsui-stack>
</bs:bsui-dialog-content>
<bs:bsui-dialog-footer>
<bs:bsui-dialog-close label="Cancel" variant="outline" />
<bs:bsui-dialog-close label="Create project" variant="default" />
</bs:bsui-dialog-footer>
</bs:bsui-dialog-popup>
</bs:bsui-dialog>不可关闭
关闭功能停用后,对话框会忽略 Escape 和背景点击,因此只能通过角落的关闭按钮退出。
Migration in progress
Closing this window does not stop the migration.
HTML
<bs:bsui-dialog dismissable="false">
<bs:bsui-dialog-trigger trigger_label="Migrate database" />
<bs:bsui-dialog-backdrop />
<bs:bsui-dialog-popup>
<bs:bsui-dialog-close x="true" />
<bs:bsui-dialog-header>
<bs:bsui-dialog-title content="Migration in progress" />
<bs:bsui-dialog-description content="Closing this window does not stop the migration." />
</bs:bsui-dialog-header>
<bs:bsui-dialog-content>
<bs:bsui-progress value="62" max="100" label="Rewriting indexes" />
</bs:bsui-dialog-content>
</bs:bsui-dialog-popup>
</bs:bsui-dialog>结构
对话框由以下区块组成。每个区块都是独立的区块,只会在其父级内部渲染。
bsui/dialogbsui/dialog-backdropbsui/dialog-popupbsui/dialog-closebsui/dialog-contentbsui/dialog-footerbsui/dialog-headerbsui/dialog-descriptionbsui/dialog-titlebsui/dialog-trigger
属性
| 属性 | 类型 | 默认 |
|---|---|---|
dismissable | toggle | true |
bsui/dialog-backdrop
此区块不接受任何属性。
bsui/dialog-popup
此区块不接受任何属性。
bsui/dialog-close
| 属性 | 类型 | 默认 |
|---|---|---|
label | richtext | — |
variant | outline | |
x | toggle | false |
bsui/dialog-content
此区块不接受任何属性。
bsui/dialog-footer
此区块不接受任何属性。
bsui/dialog-header
此区块不接受任何属性。
bsui/dialog-description
| 属性 | 类型 | 默认 |
|---|---|---|
content | richtext | — |
bsui/dialog-title
| 属性 | 类型 | 默认 |
|---|---|---|
content | richtext | — |
bsui/dialog-trigger
| 属性 | 类型 | 默认 |
|---|---|---|
trigger | text | — |
trigger_block | text | bsui/button |
trigger_label | richtext | — |
trigger_icon | icon | — |
trigger_iconPosition | left | |
trigger_href | text | — |
trigger_variant | default | |
trigger_size | default | |
trigger_disabled | toggle | false |