跳转到正文

组件

对话框

用于聚焦任务和确认操作的模态层。

用法

基础

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>

嵌套对话框

从第一个对话框中打开第二个对话框,父级保持挂载并在子级后方缩小。

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 只会关闭堆栈顶层。

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>

带选择框的表单

对话框主体中放置了实际的创建表单,选择框列表会在弹出层内展开,而不会显示在弹出层后方。

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 和背景点击,因此只能通过角落的关闭按钮退出。

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/dialog
  • bsui/dialog-backdrop
  • bsui/dialog-popup
  • bsui/dialog-close
  • bsui/dialog-content
  • bsui/dialog-footer
  • bsui/dialog-header
  • bsui/dialog-description
  • bsui/dialog-title
  • bsui/dialog-trigger

属性

属性类型默认
dismissable toggle true

bsui/dialog-backdrop

此区块不接受任何属性。

bsui/dialog-popup

此区块不接受任何属性。

bsui/dialog-close

属性类型默认
label richtext —
variant default secondary outline ghost destructive outline
x toggle false

bsui/dialog-content

此区块不接受任何属性。

此区块不接受任何属性。

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 right left
trigger_href text —
trigger_variant default secondary outline ghost link destructive default
trigger_size default sm lg icon icon-sm default
trigger_disabled toggle false