Vai al contenuto

Componenti

Finestra di dialogo

Un livello modale per attività e conferme che richiedono attenzione.

Utilizzo

Base

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>

Finestre di dialogo annidate

Una seconda finestra di dialogo aperta dall'interno della prima, il cui contenitore resta montato e si riduce sullo sfondo dietro la finestra figlia.

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>

Tre livelli di profondità

Solo la finestra di dialogo più esterna visualizza uno sfondo; ogni livello aperto riduce quello sottostante e Esc chiude solo la finestra in cima alla pila.

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>

Modulo con un select

Un vero modulo di creazione nel corpo della finestra di dialogo, in cui l'elenco del listbox del select si apre all'interno del popup anziché dietro di esso.

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>

Non chiudibile

Con dismissable disattivato, il dialog ignora Esc e i clic sullo sfondo, quindi l’unico modo per chiuderlo è il pulsante nell’angolo.

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>

Struttura

Finestra di dialogo è composto dai blocchi seguenti. Ognuno è un blocco separato che viene visualizzato solo all'interno del proprio genitore.

  • 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

Attributi

AttributoTipoPredefinito
dismissable toggle true

bsui/dialog-backdrop

Questo blocco non accetta attributi.

bsui/dialog-popup

Questo blocco non accetta attributi.

bsui/dialog-close

AttributoTipoPredefinito
label richtext —
variant default secondary outline ghost destructive outline
x toggle false

bsui/dialog-content

Questo blocco non accetta attributi.

Questo blocco non accetta attributi.

bsui/dialog-header

Questo blocco non accetta attributi.

bsui/dialog-description

AttributoTipoPredefinito
content richtext —

bsui/dialog-title

AttributoTipoPredefinito
content richtext —

bsui/dialog-trigger

AttributoTipoPredefinito
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