2024/09/01 時点の英語版に基づき更新

files/ja/web/api/htmlelement/index.md

@@ -2,7 +2,7 @@
 title: HTMLElement
 slug: Web/API/HTMLElement
 l10n:
-  sourceCommit: 51a663ab797d3766a77e40af6565e43ae7af3d07
+  sourceCommit: bc7e82aa6db60568d7146ee285918550bbe4b8ce
 ---
 
 {{APIRef("HTML DOM")}}
@@ -13,24 +13,30 @@ l10n:
 
 ## インスタンスプロパティ
 
-_親である {{DOMxRef("Element")}} からプロパティを継承しています。_
+_親である {{DOMxRef("Element")}} から継承したプロパティもあります。_
 
 - {{DOMxRef("HTMLElement.accessKey")}}
   - : 要素に割り当てられたアクセスキーを表す文字列です。
 - {{DOMxRef("HTMLElement.accessKeyLabel")}} {{ReadOnlyInline}}
   - : 要素に割り当てられたアクセスキーを含む文字列を返します。
+- {{DOMxRef("HTMLElement.anchorElement")}} {{ReadOnlyInline}} {{non-standard_inline}} {{experimental_inline}}
+  - : 要素のアンカー要素への参照を返すか、アンカー要素がない場合は `null` を返します。
 - {{DOMxRef("HTMLElement.attributeStyleMap")}} {{ReadOnlyInline}}
   - : {{DOMxRef("StylePropertyMap")}} で、その要素の [`style`](/ja/docs/Web/HTML/Global_attributes#style) 属性の宣言を表します。
+- {{domxref("HTMLElement.autocapitalize", "autocapitalize")}}
+  - : ユーザー入力に対する要素の大文字小文字の動作を表す文字列。有効な値は `none`、`off`、`on`、`characters`、`words`、`sentences`　です。
+- {{domxref("HTMLElement.autofocus")}}
+  - : 論理値で、HTML の [`autofocus`](/ja/docs/Web/HTML/Element/select#autofocus) グローバル属性を反映し、ページが読み込まれたとき、または {{htmlelement("dialog")}} 要素やポップオーバー属性が設定されている要素内の要素に指定した場合、ダイアログやポップオーバーが表示されたときに、コントロールにフォーカスを当てるかどうかを示します。
 - {{DOMxRef("HTMLElement.contentEditable")}}
   - : 文字列で、 `true` の場合は要素が編集可能、`false` の場合は編集不可であることを表します。
-- {{DOMxRef("HTMLElement.isContentEditable")}} {{ReadOnlyInline}}
-  - : 論理値で、要素のコンテンツが編集可能か否かを示します。
 - {{DOMxRef("HTMLElement.dataset")}} {{ReadOnlyInline}}
   - : {{DOMxRef("DOMStringMap")}} で、スクリプトが読み書きできる要素の[カスタムデータ属性](/ja/docs/Learn/HTML/Howto/Use_data_attributes) (`data-*`) を表します。
 - {{DOMxRef("HTMLElement.dir")}}
   - : 文字列で、要素の書字方向を表す `dir` グローバル属性を反映します。利用可能な値は、`"ltr"` および `"rtl"`、`"auto"` です。
 - {{DOMxRef("HTMLElement.draggable")}}
   - : 論理値で、要素がドラッグ可能かどうかを示します。
+- {{DOMxRef("HTMLElement.editContext")}} {{experimental_inline}}
+  - : この要素に関連付けられた {{DOMxRef("EditContext")}} を返します。なければ `null` を返します。
 - {{DOMxRef("HTMLElement.enterKeyHint")}}
   - : 文字列で、仮想キーボードの Enter キーに表示するアクションラベル（またはアイコン）を定義します。
 - {{DOMxRef("HTMLElement.hidden")}}
@@ -43,12 +49,10 @@ _親である {{DOMxRef("Element")}} からプロパティを継承していま
     セッターとしては、この要素の子要素を指定された値で置き換え、すべての改行を {{HTMLElement("br")}} 要素に変換します。
 - {{DOMxRef("HTMLElement.inputMode")}}
   - : 文字列で、この要素の [`inputmode`](/ja/docs/Web/HTML/Global_attributes/inputmode) 属性の値を反映します。
-- {{domxref("HTMLElement.popover")}} {{Experimental_Inline}}
-  - : JavaScript から要素のポップオーバー状態を取得・設定し（`"auto"`または`"manual"`）、機能検出のために使用することもできます。グローバル HTML 属性 [`popover`](/ja/docs/Web/HTML/Global_attributes/popover) の値を反映します。
+- {{DOMxRef("HTMLElement.isContentEditable")}} {{ReadOnlyInline}}
+  - : 論理値で、要素のコンテンツが編集可能か否かを示します。
 - {{DOMxRef("HTMLElement.lang")}}
   - : 文字列で、要素の属性およびテキスト、要素のコンテンツの言語を表します。
-- {{DOMxRef("HTMLElement.noModule")}}
-  - : 論理値で、モジュールスクリプトに対応しているユーザーエージェントでインポートしたスクリプトが実行されるかどうかを示します。
 - {{DOMxRef("HTMLElement.nonce")}}
   - : 指定されたフェッチが実行を許可されるかどうかを判断するためにコンテンツセキュリティポリシーが使用する、一度だけ使用される暗号学的な数値を返します。
 - {{DOMxRef("HTMLElement.offsetHeight")}} {{ReadOnlyInline}}
@@ -65,10 +69,10 @@ _親である {{DOMxRef("Element")}} からプロパティを継承していま
   - : ノードとその子孫の表示されるテキストコンテンツを表します。
     ゲッターとしては {{DOMxRef("HTMLElement.innerText")}} と同じです（要素とその子孫の表示されるテキストの内容を表します）。
     セッターとしては、選択されたノードとその内容を指定された値で置き換え、改行を {{HTMLElement("br")}} 要素に変換します。
-- {{DOMxRef("HTMLElement.properties")}} {{Experimental_Inline}} {{ReadOnlyInline}}
-  - : {{DOMxRef("HTMLPropertiesCollection")}} を返します…
+- {{domxref("HTMLElement.popover")}}
+  - : JavaScript から要素のポップオーバー状態を取得・設定し（`"auto"`または`"manual"`）、機能検出のために使用することもできます。グローバル HTML 属性 [`popover`](/ja/docs/Web/HTML/Global_attributes/popover) の値を反映します。
 - {{DOMxRef("HTMLElement.spellcheck")}}
-  - : 論理値で、[スペルチェック](/ja/docs/Web/HTML/Global_attributes/spellcheck) を制御します。これはすべての HTML 要素に提供されていますが、すべての要素に効果があるとは限りません。
+  - : 論理値で、[スペルチェック](/ja/docs/Web/HTML/Global_attributes/spellcheck) のヒントを制御します。これはすべての HTML 要素で利用できますが、すべての要素に効果があるとは限りません。
 - {{DOMxRef("HTMLElement.style")}}
   - : {{DOMxRef("CSSStyleDeclaration")}} で、この要素の [`style`](/ja/docs/Web/HTML/Global_attributes#style) 属性の宣言を表します。
 - {{DOMxRef("HTMLElement.tabIndex")}}
@@ -77,10 +81,12 @@ _親である {{DOMxRef("Element")}} からプロパティを継承していま
   - : 文字列で、マウスポインターを要素に当てた時に現れるポップアップボックスのテキストを表します。
 - {{DOMxRef("HTMLElement.translate")}}
   - : 論理値で、翻訳を行うかどうかを表します。
+- {{DOMxRef("HTMLElement.virtualKeyboardPolicy")}} {{Experimental_Inline}}
+  - : 文字列で、タブレットやモバイル端末、その他ハードウェアキーボードが利用できない端末において、要素のコンテンツが編集可能な場合（例えば、{{htmlelement("input")}} 要素や {{htmlelement("textarea")}} 要素、[`contenteditable`](/ja/docs/Web/HTML/Global_attributes/contenteditable) 属性が設定されている要素）、画面に表示される仮想キーボードの動作を示します。
 
 ## インスタンスメソッド
 
-_親である {{DOMxRef("Element")}} からメソッドを継承しています。_
+_親である {{DOMxRef("Element")}} から継承したメソッドもあります。_
 
 - {{DOMxRef("HTMLElement.attachInternals()")}}
   - : {{DOMxRef("ElementInternals")}} オブジェクトを返し、カスタム要素を HTML フォームに参加できるようにします。
@@ -90,83 +96,60 @@ _親である {{DOMxRef("Element")}} からメソッドを継承しています
   - : 要素にマウスクリックイベントを送信します。
 - {{DOMxRef("HTMLElement.focus()")}}
   - : 要素に現在のキーボードフォーカスを当てます。
-- {{DOMxRef("HTMLElement.hidePopover()")}} {{Experimental_Inline}}
+- {{DOMxRef("HTMLElement.hidePopover()")}}
   - : ポップオーバー要素を{{glossary("top layer", "最上位レイヤー")}}から取り除き、`display: none` でスタイル設定することで、ポップオーバー要素を非表示にします。
-- {{DOMxRef("HTMLElement.showPopover()")}} {{Experimental_Inline}}
+- {{DOMxRef("HTMLElement.showPopover()")}}
   - : ポップオーバー要素を{{glossary("top layer", "最上位レイヤー")}}に追加し、`display: none;` スタイル設定を削除することで、ポップオーバー要素を表示します。
-- {{DOMxRef("HTMLElement.togglePopover()")}} {{Experimental_Inline}}
+- {{DOMxRef("HTMLElement.togglePopover()")}}
   - : ポップオーバー要素を非表示状態と表示状態を切り替えます。
 
 ## イベント
 
-これらのイベントを待ち受けするには `addEventListener()` を用いるか、イベントリスナーをこのインターフェイスの `onイベント名` プロパティに代入するかしてください。
+これらのイベントを待ち受けするには {{domxref("EventTarget.addEventListener", "addEventListener()")}} を用いるか、イベントリスナーをこのインターフェイスの `onイベント名` プロパティに代入するかしてください。
+
+_親である {{DOMxRef("Element")}} から継承したイベントもあります。_
+
+- {{DOMxRef("HTMLElement/cancel_event", "cancel")}}
+  - : {{HTMLElement("input")}} および {{HTMLElement("dialog")}} 要素で、ユーザーが現在開いているダイアログを <kbd>Esc</kbd> キーで閉じてキャンセルしたときに発行されます。
+- {{DOMxRef("HTMLElement/change_event", "change")}}
+  - : {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}} のいずれかの要素の `value` が変更され、ユーザーが確定したときに発行されます。{{domxref("Element/input_event", "input")}} イベントとは異なり、`change` イベントは要素の `value` が変更されるたびに発行されるわけではありません。
+- {{DOMxRef("HTMLElement/error_event", "error")}}
+  - : リソースの読み込みに失敗した、または使用することができない場合に発行されます。
+- {{DOMxRef("HTMLElement/load_event", "load")}}
+  - : リソースが正常に読み込まれたときに、リソースを保持する要素に対して発行されます。
 
-- {{DOMxRef("HTMLElement.copy_event", "copy")}}
+### クリップボードイベント
+
+- {{DOMxRef("HTMLElement/copy_event", "copy")}}
   - : ユーザーがブラウザーのユーザーインターフェイスを通じてコピー操作を開始したときに発生します。
-- {{DOMxRef("HTMLElement.cut_event", "cut")}}
+- {{DOMxRef("HTMLElement/cut_event", "cut")}}
   - : ユーザーがブラウザーのユーザーインターフェイスから切り取り操作を開始したときに発生します。
-- {{DOMxRef("HTMLElement.paste_event", "paste")}}
+- {{DOMxRef("HTMLElement/paste_event", "paste")}}
   - : ユーザーがブラウザーのユーザーインターフェイスを通じて貼り付け操作を開始したときに発生します。
-- {{domxref("HTMLInputElement/invalid_event", "invalid")}}
-  - : 制約の検証で、要素が制約を満たさなかった場合に発行されます。
-- {{DOMxRef("HTMLElement.beforetoggle", "beforetoggle")}}
-  - : 要素がポップオーバーの場合、非表示になる前、または表示される前に発行されます。
-- {{DOMxRef("HTMLElement.toggle", "toggle")}}
-  - : 要素がポップオーバーの場合、非表示になった後、または表示された後に発行されます。
-
-### アニメーションイベント
-
-- {{domxref("Element/animationcancel_event", "animationcancel")}}
-  - : アニメーションが予期せず中断されたときに発行されます。
-- {{domxref("Element/animationend_event", "animationend")}}
-  - : アニメーションが正常に完了したときに発行されます。
-- {{domxref("Element/animationiteration_event", "animationiteration")}}
-  - : アニメーションが 1 回分完了したときに発行されます。
-- {{domxref("Element/animationstart_event", "animationstart")}}
-  - : アニメーションが開始されたときに発行されます。
-
-### 入力イベント
-
-- {{domxref("HTMLElement/beforeinput_event", "beforeinput")}}
-  - : {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}} のいずれかの要素が変更される前に発行されます。
-- {{domxref("HTMLElement/input_event", "input")}}
-  - : {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}} のいずれかの要素の `value` が変更されたときに発行されます。
-- {{domxref("HTMLElement/change_event", "change")}}
-  - : {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}} のいずれかの要素の `value` が変更され、ユーザーが確定したときに発行されます。{{domxref("HTMLElement/input_event", "input")}} イベントとは異なり、`change` イベントは要素の `value` が変更されるたびに発行されるわけではありません。
-
-### ポインターイベント
-
-- {{domxref("Element/gotpointercapture_event", "gotpointercapture")}}
-  - : {{domxref("Element/setPointerCapture", "setPointerCapture()")}} を用いて要素がポインターをキャプチャしたときに発行されます。
-- {{domxref("Element/lostpointercapture_event", "lostpointercapture")}}
-  - : [キャプチャされたポインター](/ja/docs/Web/API/Pointer_events#pointer_capture)が解放されたときに発行されます。
-- {{domxref("Element/pointercancel_event", "pointercancel")}}
-  - : ポインターイベントがキャンセルされたときに発行されます。
-- {{domxref("Element/pointerdown_event", "pointerdown")}}
-  - : ポインターがアクティブになったときに発行されます。
-- {{domxref("Element/pointerenter_event", "pointerenter")}}
-  - : ポインターが要素またはその子孫の一つのヒットテスト境界に入ったときに発行されます。
-- {{domxref("Element/pointerleave_event", "pointerleave")}}
-  - : ポインターが要素のヒットテスト境界から出たときに発行されます。
-- {{domxref("Element/pointermove_event", "pointermove")}}
-  - : ポインターの座標が変化したときに発行されます。
-- {{domxref("Element/pointerout_event", "pointerout")}}
-  - : ポインターが要素の*ヒットテスト*境界を (他の理由で) 出たときに発行されます。
-- {{domxref("Element/pointerover_event", "pointerover")}}
-  - : ポインターが要素のヒットテスト境界に入ったときに発行されます。
-- {{domxref("Element/pointerup_event", "pointerup")}}
-  - : ポインターがアクティブではなくなったときに発行されます。
-
-### トランジションイベント
-
-- {{domxref("Element/transitioncancel_event", "transitioncancel")}}
-  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)がキャンセルされたときに発行されます。
-- {{domxref("Element/transitionend_event", "transitionend")}}
-  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が完了したときに発行されます。
-- {{domxref("Element/transitionrun_event", "transitionrun")}}
-  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が最初に作成されたときに発行されます。
-- {{domxref("Element/transitionstart_event", "transitionstart")}}
-  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が実際に開始されたときに発行されます。
+
+### ドラッグ & ドロップイベント
+
+- {{DOMxRef("HTMLElement/drag_event", "drag")}}
+  - : このイベントは、要素やテキスト選択がドラッグされたときに発行されます。
+- {{DOMxRef("HTMLElement/dragend_event", "dragend")}}
+  - : このイベントは、ドラッグ操作が（マウスボタンを離すか、エスケープキーを押すかして）終わったときに発行されます。
+- {{DOMxRef("HTMLElement/dragenter_event", "dragenter")}}
+  - : このイベントは、ドラッグされた要素やテキスト選択が有効なドロップ対象に入ると発行されます。
+- {{DOMxRef("HTMLElement/dragleave_event", "dragleave")}}
+  - : このイベントは、ドラッグされた要素やテキスト選択が有効なドロップ対象から外れたときに発行されます。
+- {{DOMxRef("HTMLElement/dragover_event", "dragover")}}
+  - : このイベントは、要素またはテキスト選択がドラッグされ、マウスポインターが有効なドロップ対象の上にあるとき（マウスが移動していないときは 50 ミリ秒ごと、移動中およそ 5 ミリ秒（移動が遅いとき）から 1 ミリ秒（移動が速いとき）の間に発生します。この発行パターンは {{domxref("Element/mouseover_event", "mouseover")}} とは異なります。）
+- {{DOMxRef("HTMLElement/dragstart_event", "dragstart")}}
+  - : このイベントは、ユーザーが要素やテキスト選択のドラッグを始めるには発行されます。
+- {{DOMxRef("HTMLElement/drop_event", "drop")}}
+  - : このイベントは、要素またはテキスト選択が有効なドロップ対象にドロップされたときに発行されます。
+
+### ポップオーバーイベント
+
+- {{DOMxRef("HTMLElement/beforetoggle_event", "beforetoggle")}}
+  - : 要素がポップオーバー要素である場合、非表示または表示される前に発行されます。
+- {{DOMxRef("HTMLElement/toggle_event", "toggle")}}
+  - : 要素がポップオーバー要素の時、非表示または表示された直後に発行されます。
 
 ## 仕様書