Bagaimanakah elemen dialog asli berfungsi?

Question

Accepted Answer

`<dialog>` ialah elemen asli untuk **modals dan dialogs**. Ia mengendalikan focus trapping, backdrop, top layer, dan Escape-to-close — fitur yang sebaliknya anda kena bina secara manual dengan banyak JavaScript dan ARIA.

```html
<dialog id="myModal">
  <form method="dialog">           
    <h2>Confirm</h2>
    <p>Are you sure?</p>
    <button value="cancel">Cancel</button>
    <button value="ok">OK</button>
  </form>
</dialog>
```

## Membuka dan menutup dalam JS

```js
const modal = document.getElementById("myModal");

modal.showModal(); // opens as a MODAL: backdrop + focus trapped + Esc closes
modal.show();      // opens as a NON-modal (no backdrop, page stays interactive)
modal.close("ok"); // closes, sets returnValue

modal.addEventListener("close", () => {
  console.log(modal.returnValue); // "ok" or "cancel" — from the button's value
});
```

## Apa yang anda dapatkan secara percuma dengan showModal()

- **Focus trapping** — Tab kekal di dalam dialog semasa terbuka.
- **Backdrop** — boleh disisipkan melalui `::backdrop`, dan klik di luar boleh dikesan.
- **Top layer** — memapar di atas segalanya tidak kira `z-index`.
- **Kunci Escape** menutupnya.
- **`method="dialog"`** pada borang menutup dialog dan merekod butang mana yang dihantar.

## Menggaya backdrop

```css
dialog::backdrop { background: rgba(0, 0, 0, 0.5); }
dialog { border: none; border-radius: 8px; padding: 2rem; }
```

## Mengapa ini penting

Sebelum `<dialog>`, modals yang boleh diakses memerlukan pengurusan fokus manual, peranan ARIA, penguncian skrol, dan pengendalian Escape — sumber pepijat yang terkenal.

Elemen asli memberikan anda semua itu dengan betul dari kotak.

Gunakan `showModal()` untuk modals sebenar; ia adalah lalai moden dan mudah diakses untuk dialogs.