Przejdź do treści

Komponenty

Okno dialogowe

Warstwa modalna do zadań wymagających skupienia i potwierdzeń.

Użycie

Podstawowy

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>

Zagnieżdżone okna dialogowe

Drugie okno dialogowe otwarte wewnątrz pierwszego; okno nadrzędne pozostaje zamontowane i zmniejsza się za oknem podrzędnym.

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>

Trzy poziomy zagnieżdżenia

Tło rysuje tylko najbardziej zewnętrzne okno dialogowe, każdy otwarty poziom zmniejsza ten znajdujący się za nim, a Escape zamyka tylko okno ze szczytu stosu.

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>

Formularz z selektorem

Rzeczywisty formularz tworzenia w treści okna dialogowego, w którym lista listbox selektora otwiera się wewnątrz wyskakującego okna, a nie za nim.

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>

Bez możliwości zamknięcia

Przy wyłączonej opcji zamykania okno dialogowe ignoruje klawisz Escape i kliknięcia w tło, więc jedynym wyjściem jest przycisk zamykania w rogu.

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>

Budowa

Okno dialogowe składa się z poniższych bloków. Każdy z nich jest osobnym blokiem, który renderuje się tylko wewnątrz swojego elementu nadrzędnego.

  • 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

Atrybuty

AtrybutTypDomyślnie
dismissable toggle true

bsui/dialog-backdrop

Ten blok nie przyjmuje atrybutów.

bsui/dialog-popup

Ten blok nie przyjmuje atrybutów.

bsui/dialog-close

AtrybutTypDomyślnie
label richtext —
variant default secondary outline ghost destructive outline
x toggle false

bsui/dialog-content

Ten blok nie przyjmuje atrybutów.

Ten blok nie przyjmuje atrybutów.

bsui/dialog-header

Ten blok nie przyjmuje atrybutów.

bsui/dialog-description

AtrybutTypDomyślnie
content richtext —

bsui/dialog-title

AtrybutTypDomyślnie
content richtext —

bsui/dialog-trigger

AtrybutTypDomyślnie
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