--- title: slug: Web/HTML/Element/ins tags: - Element - HTML - HTML edits - Inserted Text - Insertion - Reference - Web - ins translation_of: Web/HTML/Element/ins ---

{{HTMLRef}}

HTML の <ins> 要素は、文書に追加されたテキストの範囲を表します。同様に、 {{HTMLElement("del")}} 要素を使用して文書から削除されたテキストの範囲を表すことができます。

{{EmbedInteractiveExample("pages/tabbed/ins.html", "tabbed-standard")}}
コンテンツカテゴリ 記述コンテンツ または フローコンテンツ
許可されている内容 透過的コンテンツ
タグの省略 {{no_tag_omission}}
許可されている親要素 記述コンテンツを受け入れるすべての要素
暗黙の ARIA ロール 対応するロールなし
許可されている ARIA ロール すべて
DOM インターフェイス {{domxref("HTMLModElement")}}

属性

他のすべての HTML 要素と同様に、この要素はグローバル属性を持っています。

{{htmlattrdef("cite")}}
会議の議事録やトラブルシューティングシステムのチケットといった、追加についての説明を記したリソースへの URI を示します。
{{htmlattrdef("datetime")}}
この属性は変更が行われた日時を示し、有効な日付または日時の文字列でなければなりません。値が日付または日時の文字列として解釈できなかった場合は、要素にタイムスタンプが関連付けられなくなります。時刻がない日付の書式については、妥当な日付文字列の書式を参照してください。日付と時刻の両方を含む場合の文字列の書式については、妥当な日時文字列の書式を参照してください。

<ins>This text has been inserted</ins>

結果

{{EmbedLiveSample("Examples")}}

アクセシビリティの考慮

<ins> 要素が存在することは、多くの読み上げ技術の既定の設定では読み上げられません。 CSS の {{cssxref("content")}} プロパティを {{cssxref("::before")}} および {{cssxref("::after")}} 擬似要素と共に使うことで読み上げさせることができます。

ins::before,
ins::after {
  clip-path: inset(100%);
  clip: rect(1px, 1px, 1px, 1px);
  height: 1px;
  overflow: hidden;
  position: absolute;
  white-space: nowrap;
  width: 1px;
}

ins::before {
  content: " [挿入開始] ";
}

ins::after {
  content: " [挿入終了] ";
}

読み上げソフトを使用する人によっては、特に冗長になるコンテンツのアナウンスを意図的に無効にしていることがあります。このため、この手法を悪用しないようにすることは重要であり、コンテンツが挿入されていることを知らないと理解に影響するような場面でのみ使用するようにしてください。

仕様書

仕様書 状態 備考
{{SpecName('HTML WHATWG', 'edits.html#the-ins-element', '<ins>')}} {{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'edits.html#the-ins-element', '<ins>')}} {{Spec2('HTML5 W3C')}}
{{SpecName('HTML4.01', 'struct/text.html#h-9.4', '<ins>')}} {{Spec2('HTML4.01')}}

ブラウザーの互換性

{{Compat("html.elements.ins")}}

関連情報