Pular para o conteúdo

Componentes

Caixa de diálogo

Uma camada modal para tarefas focadas e confirmações.

Uso

Básico

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>

Caixas de diálogo aninhadas

Uma segunda caixa de diálogo aberta dentro da primeira, com a janela pai ainda montada e reduzida ao fundo, atrás da filha.

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>

Três níveis de profundidade

Somente a caixa de diálogo mais externa exibe um fundo escurecido; cada nível aberto reduz a janela atrás dele, e Escape fecha apenas a janela no topo da pilha.

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>

Formulário com seletor

Um formulário real de criação no corpo da caixa de diálogo, em que a lista de opções do seletor abre dentro da janela, e não atrás dela.

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>

Não pode ser dispensada

Com dismissable desativado, a janela ignora Escape e cliques no fundo, então só é possível fechá-la pelo canto.

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>

Anatomia

Caixa de diálogo é composto pelos blocos abaixo. Cada um é um bloco separado que só é renderizado dentro do bloco pai.

  • 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

Atributos

AtributoTipoPadrão
dismissable toggle true

bsui/dialog-backdrop

Este bloco não aceita atributos.

bsui/dialog-popup

Este bloco não aceita atributos.

bsui/dialog-close

AtributoTipoPadrão
label richtext —
variant default secondary outline ghost destructive outline
x toggle false

bsui/dialog-content

Este bloco não aceita atributos.

Este bloco não aceita atributos.

bsui/dialog-header

Este bloco não aceita atributos.

bsui/dialog-description

AtributoTipoPadrão
content richtext —

bsui/dialog-title

AtributoTipoPadrão
content richtext —

bsui/dialog-trigger

AtributoTipoPadrão
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