1. 背景
ダイアログ要素のcloseメソッドを読み漁っていた際に知ったことです。
以下のdocumentのWe use show/close as the verbs for dialog elements, as opposed to verb pairs that are more commonly thought of as antonyms such as show/hide or open/close, due to the following constraintsの所を和訳します。
2. ダイアログ要素の動詞として反意語として一般的に考えられている動詞ペア
- show/hide
- open/close
2.1. ダイアログを非表示にすることと、閉じることの違い
ダイアログを非表示にすることは、ダイアログを閉じることとは異なります。
ダイアログを閉じる
そのダイアログに戻り値を与えたり、イベントを発生させたり、他のダイアログのためにページのブロックを解除したりします。
ダイアログの非表示
純粋に視覚的な特性であり、hidden属性やopen属性を削除することで既にできることです。
2.2. ダイアログを開くことと表示することの違い
ダイアログを開く
ダイアログを作成し、表示することです。
ダイアログを表示する
すでにDOMにあるダイアログ要素を取り込み、それをインタラクティブにしてユーザーに見せることです。
3. dialog.openプロパティと衝突
dialog.open()メソッドにしたかったですが、dialog.openプロパティと衝突してしまいます。
4. 結論
ダイアログを見せたり閉じたりするような対になる動作が持つ意味合いを、必ずしもコードでも同様に反意語として表現できるとは限らないです。
5. 最後に
APIのメソッドの命名の背景を知れる良い機会になりました。