URIフラグメント

コンピュータのハイパーテキスト において、URIフラグメントとは、別のプライマリリソースに従属するリソースを参照する文字列のことです。プライマリリソースはUniform Resource Identifier（URI）によって識別され、フラグメント識別子は従属リソースを指します。

ハッシュマーク で始まるフラグメント識別子は、ドキュメントのURL#のオプションの最後の部分です。これは通常、ドキュメントの一部を識別するために使用されます。一般的な構文はRFC 3986で規定されています。^{[ 1 ]} URI のハッシュマーク区切り文字はフラグメント識別子の一部ではありません。

URI では、ハッシュマークによって#URL の末尾付近にオプションのフラグメントが導入されます。URIの一般的なRFC 3986構文では、疑問符によって導入されるオプション?のクエリ部分も許可されています。クエリとフラグメントを含む URI では、フラグメントはクエリの後に続きます。クエリ部分は URI スキームに依存し、サーバーによって評価されます (たとえば、 は とはhttp:異なりクエリをサポートしています)。フラグメントはドキュメントのMIME タイプftp:に依存し、クライアント ( Web ブラウザ) によって評価されます。クライアントはドキュメントを取得する際に URI フラグメントをサーバーに送信すべきではありません。^{[ 1 ] [ 2 ]}

で終わるURI#は汎用構文で許可されており、一種の空フラグメントです。MIMEドキュメントタイプ（例：）text/htmlや任意のXMLタイプでは、この構文的に有効な構造に一致する空の識別子は許可されていません。Webブラウザは通常、空フラグメントに対してドキュメントの先頭を表示します。

フラグメント識別子はURIの他の部分とは異なる動作をします。その処理はクライアント側のみで行われ、 Webサーバーは関与しませんが、サーバーは通常MIMEタイプの決定を支援し、MIMEタイプによってフラグメントの処理が決定されます。エージェント（Webブラウザなど）がWebサーバーからWebリソースを要求すると、エージェントはURIをサーバーに送信しますが、フラグメントは送信しません。代わりに、エージェントはサーバーがリソースを送信するのを待ち、その後、ドキュメントタイプとフラグメント値に従ってリソースを処理します。^{[ 3 ]}

HTMLウェブページ内では、エージェントはフラグメント識別子と等しい属性id=または属性を含むHTMLタグで識別されるアンカーを探します。name=

• text/htmlMIMEページのURIでは、http://www.example.org/foo.html#barフラグメントは要素を参照しますid="bar"。
  • グラフィカルな Web ブラウザは通常、フラグメント ID で識別される要素の上部がビューポートの上部と揃うようにページをスクロールします。^{[ 4 ]}そのため、フラグメント識別子は目次でよく使用されます。
  • 識別された要素の外観は、:targetCSS擬似クラスによって変更できます。^{[ 5 ]} Wikipedia は、選択された参照を強調表示するためにこれを使用しています。特に、CSS を使用すると、それがターゲットである場合にのみコンテンツを表示し、それ以外の場合は非表示にすることができます。display: blockdisplay: none
  • name要素の属性は同じ<a>目的を果たしていましたが、現在はidどの要素にも適用できる属性に置き換えられ、廃止されています。^{[ 6 ]}
• XHTMLフラグメントを含むすべてのXMLドキュメントタイプでは、または類似の属性に対応するものは、構文に従い、文字、アンダースコア、またはコロンで始まります。特に、数字またはハイフンで始めることはできません。^{[ 7 ]}xml:ididName
  • xml:idxml:langは、名前空間を明示的に宣言せずに使用できる、数少ない汎用 XML 属性の 1 つです (例: ) 。 ^{[ 8 ]} XHTML ではidも使用でき、 が好まれるようです。 ^{[ 9 ] [ 10 ]}これは、 が存在する前に XHTML が規定されたためですxml:id。
• XML アプリケーションでは、特定の構文のフラグメント識別子はXPointerにすることができます。^{[ 11 ] [ 12 ]}例えば、URI のフラグメント識別子は、 URI http://www.example.org/foo.xmlhttp://www.example.org/foo.xml#xpointer(//Rube)で識別されるドキュメント内の「Rube」という名前のすべての XML 要素を参照します。XPointer プロセッサは、その URI が与えられると、ドキュメントの表現を取得し (インターネットから要求するなど)、ドキュメントの「Rube」要素の表現を返します。
• RDFS、OWL、SKOSなどのRDF語彙では、フラグメント識別子は同じXML名前空間内のリソースを識別するために使用されますが、必ずしもドキュメントの特定の部分に対応するわけではありません。たとえば、はSKOS Core語彙の「broader」という概念を識別しますが、で識別されるリソースの特定の部分を参照するわけではありません。完全なRDFファイルであるでは、この特定の概念の意味が、同じ語彙内の他の概念とともに宣言されています。http://www.w3.org/2004/02/skos/core#broaderhttp://www.w3.org/2004/02/skos/core
• text/plainMIME文書の URI では、RFC 5147 は、キーワード " char" と " " を使用して文書内の文字と行の位置と範囲を示すフラグメント識別子を指定し、" " または " "lineのいずれかで整合性チェックを追加できます。^{[ 13 ]}ブラウザのサポートは不足しているようです。^{[ 14 ]}次の例は、テキスト文書の 11 行目から 20 行目までを識別します。 lengthmd5
  • http://example.com/document.txt#line=10,20
• MIME 文書の URI ではtext/csv、RFC 7111 は、行、列、セルを選択するためのフラグメント識別子をキーワード " row" 、 " col"、および " cell"を使用して指定しています^{[ 15 ]}。例:
  • http://example.com/data.csv#row=4– 4行目を選択します。
  • http://example.com/data.csv#col=2– 2列目を選択します。
  • http://example.com/data.csv#row=5-7– 5行目から始まる連続する3行を選択します。
  • http://example.com/data.csv#row=5-*– 5行目から始まるすべての行を選択します。
  • http://example.com/data.csv#cell=4,1-6,2– 4行目1列目から始まり、6行目2列目で終わる領域を選択します。
• MIME audio/*、image/*、video/* ドキュメントの URI では、フラグメントやフラグメントのセマンティクスが定義されているものはほとんどありません。^{[ 16 ]} Media Fragments URI 1.0 (基本) 構文では、キーワードとを使用してメディア リソースを 2 つの次元 (時間的および空間的) に沿ってアドレス指定することがサポートされておりt、xywhMedia Fragments 1.0 URI (高度) ではとが追加されていますtrack。id[ ^{17 ]したがって}、次のメディア フラグメント URI を、またはHTML5src要素の属性で使用できます。 audiovideo
  • http://example.com/foo.mp4#t=10,20（これは、10秒から始まり20秒未満で終わる時間間隔を示します）
  • http://example.com/bar.webm#t=40,80&xywh=160,120,320,240
  • この仕様では、コロンを使用して時、分（2桁）、秒（2桁）を指定し、小数点を使用してミリ秒を指定することもできます。また、接頭辞を使用して他の時間表記方法を指定することも可能です。npt:（通常プレイ時間）がデフォルトです。
  • 他のウェブサイトではフラグメント部分を使用して、その上で実行されているスクリプトに追加情報を渡します。たとえば、Google Video はの形式のパーマリンクを理解して、#01h25m30s指定された位置から再生を開始します。^{[ 18 ]}また、YouTube はのような同様のコードを使用します#t=3m25s。^{[ 19 ]}
• JavaScriptでは、現在の HTML または XHTML ページのフラグメント識別子は「hash」プロパティでアクセスできますlocation.hash^{[ 20 ]} – JavaScript は他のドキュメントタイプでも使用できます。AJAX の台頭に伴い、一部の Web サイトでは、ページを再読み込みする必要のないページ変更でブラウザの戻るボタンの動作をエミュレートしたり、サブページをエミュレートしたりするためにフラグメント識別子を使用しています。
  • 例えば、Gmail はほぼすべてのインターフェース (メールボックス、個々のメール、検索結果、設定) に単一の URL を使用しています。フラグメントは、これらのインターフェースを直接リンクできるようにするために使用されます。^{[ 21 ]}
  • Adobe Flash Web サイトは、フラグメント部分を使用して、Web サイトまたはWeb アプリケーションの状態をユーザーに通知したり、ディープ リンクを容易にしたりできます。これは通常、SWFAddress JavaScript ライブラリの助けを借りて行われます。
• JSONドキュメントにリンクするURIは、特定の値へのポインタを指定できます。^{[ 22 ]}
  • 例えば、末尾が の URL を#/foo使用すると、 で始まるドキュメント内のキーと値のペアから値を抽出できます。{ "foo": ["bar", "baz"], ... }
• MIMEドキュメントのURIでは、application/pdfPDFビューアはいくつかのフラグメント識別子を認識します。^{[ 23 ] [ 24 ]}例えば、URLがで終わると、ほとんどのリーダーはPDFを開いて35ページまでスクロールします。他にも、 (HTMLアンカーに類似)、、など、.pdf#page=35いくつかのパラメータが可能です。複数のパラメータはアンパサンドで組み合わせることができます。 #nameddest=#search="word1 word2"#zoom=
  • http://example.org/doc.pdf#view=fitb&nameddest=Chapter3。
• SVGでは、フラグメントはviewBox()、、、preserveAspectRatio()などの引数を指定できますtransform()。^{[ 25 ]}
• テキスト内のテキストスニペットを識別するために、フラグメントは":~:text=[prefix-,]textStart[,textEnd][,-suffix]「textStart」をハイライトするか、適用されている場合は「textEnd」に進み移ります。接頭辞と接尾辞はハイライトされませんが、ページ上のテキストを見つけるのに役立ちます。例: https://en.wikipedia.org/w/index.php?title=Cat&oldid=916388819#:~:text=Claws-,Like%20almost,the%20Felidae%2C,-cats ^{[ 26 ]}

プレーンテキスト文書（アンカーメタデータを保存できない）で使用するフラグメント識別子、または著者がアンカータグを使用していないHTML文書内の場所を参照するためのフラグメント識別子について、いくつかの提案がなされている。

• 2012年9月現在、メディアフラグメントURI 1.0（基本）はW3C勧告です。^{[ 27 ]}
• Chrome バージョン 80 以降^{[ 28 ] [ 29 ]}および Firefox バージョン 131 以降^{[ 30 ]}はW3Cの WICGテキスト フラグメント^{[ 31 ]}を実装しているため、#:~:text=fooブラウザは を検索しfoo、一致するテキストをハイライト表示して、そのテキストまでスクロールします。開始と終了に加えて、スニペットはコンテキストも指定できます。コンテキストとは、 の前または後に続くテキストですfooが、ハイライト表示されません (を使用する例: #:~:text=night-,vision'vision' の前に 'night' がある検索)。)
• Python Package Index は、ファイルの MD5 ハッシュをフラグメント識別子として URL に追加します。[ 32 ^{] MD5が}壊れていなければ (壊れたハッシュ関数です)、パッケージの 完全性を保証するために使用できます。

  https://pypi.python.org ... zodbbrowser-0.3.1.tar.gz#md5=38dc89f294b24691d3f0d893ed3c119c

• ハッシュバン^{[ 33 ]}フラグメントは、感嘆符で始まるフラグメントです!。これは、現在では非推奨となっている動的なシングルページアプリケーションのインデックス作成に使用されていました。感嘆符はHTML4 、XHTML、およびXML識別子では不正であり、その機能からある程度分離されています。ただし、 HTML5では許可されています。^{[ 34 ]}
  • 2009年から2015年の間に、Google Webmaster Centralは、ステートフルAJAXページのフラグメント識別子に最初の感嘆符を使用する「AJAXクローリングスキーム」 ^{[ 35 ] [ 36 ]}を提案し、その後推奨しました。
    http://example.com/page?query#!state
  • ^{別の実装としては、 [ 35 ]}#!をに置き換えるという方法がある。?_escaped_fragment_=
  • ハッシュバンURIは、ブラウザでJavaScriptが有効になっていないユーザーにはページにアクセスできなくなるため、W3Cのジェニ・テニソンをはじめとする多くのライターによって問題視されてきました。また、ブラウザがRefererヘッダーにフラグメント識別子を送信することが許可されていないため、 HTTPリファラーヘッダーも壊れてしまいます。^{[ 33 ]}
  • 2015年、GoogleはハッシュバンAJAXクローリングの提案を非推奨とし、代わりにプログレッシブエンハンスメントとHTML5のhistory.pushState()^{[ 37 ]}メソッドの使用を推奨した。^{[ 38 ]}
  • Mozilla Foundation の従業員である Gervase Markham は、検索用のフラグメント識別子として の形式を提案しました#!s!search terms。 の後に数字 ( #!s10!) を追加すると、ブラウザは検索語のn#!s-3!番目の出現箇所を検索する必要があります。負の数 ( ) は、ドキュメントの末尾から逆方向に検索を開始します。互換性のあるブラウザにこの機能を追加するためのGreasemonkeyスクリプトが利用可能です。^{[ 39 ]}

    http://example.com/index.html#!s3!search terms

• ETHチューリッヒのエリック・ワイルドとマルセル・バシュナーゲルは、これを拡張して、キーワード「」を使用して、プレーンテキスト文書内の断片を正規表現で識別するようにしました。 ^{[ 40 ]}また、 Firefoxブラウザの拡張機能としてのプロトタイプ実装についても説明しています。たとえば、次のコードは、文書内のどこにでも大文字小文字を区別しないテキスト「RFC」を見つけます。 match

  http://example.com/document.txt#match=[rR][fF][cC]

• Foresight InstituteのK. Yeeは、アンカー識別子と区別するために、コロンとキーワードで区切られた「拡張フラグメント識別子」を提案している。wordsこのスキームにおける最初の提案は、「フラグメント仕様スキーム」ID「」を持つテキスト検索フラグメント識別子である。^{[ 41 ]}次の例では、文書内で「検索語のコンテキスト」という文字列の最初の出現箇所を検索し、「検索語」という単語を強調表示する。

  http://example.com/index.html#:words:some-context-for-a-(search-term)

• LiveURLsプロジェクト^{[ 42 ]}は、ページ内のテキスト領域を参照するためのフラグメント識別子フォーマットを提案しました。その形式は#FWS+C、Fが最初の単語の長さ（最大5文字）、Wが最初の単語自体、Sが選択されたテキストの長さ、Cが選択されたテキストの32ビットCRCです。 ^{[ 43 ]}彼らは、このスキームのバリアントをFirefoxブラウザの拡張機能として実装しました。^{[ 44 ]}形式は#LFWS+C、Lがフラグメント自体の長さを2桁の16進数で表したものです。実装されたバリアントを使用して「Fragment」という単語にリンクすると、次のようになります。

  http://example.com/index.html#115Fragm8+-52f89c4c

• Firefox 5 までは、 #xpath:/html/body/div[3] のようなXPathリンクがサポートされていました。これは、 http://antimatter15.com/wp/2009/11/xpath-bookmark-bookmarklet/のようなブックマークレットと組み合わせて使用​​することで、適切な ID を持たない HTML ドキュメント内のリンクを作成することができました。この機能は、 https: //bugzilla.mozilla.org/show_bug.cgi ?id=457102 のコードクリーンアップの一環として削除されました。
• ePub電子書籍フォーマットでは、EPUB Canonical Fragment Identifier（epubcfi、^{[ 45 ]} 2011-2017）が、フラグメント識別子を使用して任意のコンテンツを参照するためのW3C / IDPF標準化された方法を定義し、文書構造とパターンマッチングによってアンカーされていないテキスト範囲を特定します。これらの動的なディープリンクは、テキストが更新された後にコンテンツを見つけるのに役立ち、たとえばApple Booksで使用されています。

• クエリ文字列
• URI正規化
• URL（Uniform Resource Locator）
• クリーンなURL
• URIスキーム

• W3Cメディアフラグメントワーキンググループは、視聴覚素材内のメディアフラグメント（画像内の領域や動画のサブクリップなど）を扱うためのURI構文と意味論を確立する。
• MediaMixerコミュニティポータルは、メディアフラグメント技術の使用に関するプレゼンテーション、チュートリアル、ユースケース、デモンストレーションを収集しています。