imported>Speravir: /* Syntax */ auch hier: URI

2025-05-24T00:00:05Z

Syntax: auch hier: URI

Neue Seite

Als '''Fragmentbezeichner''' ({{enS|fragment identifier}}) ist ein optionaler Teil eines [[Uniform Resource Identifier|URI]] und wird dazu benutzt, eine Untereinheit oder einen Teil einer Ressource zu spezifizieren oder zu adressieren.

== Verwendung ==
Im Gegensatz zum [[Query-String]] werden Fragmentbezeichner bei client-server-basierten Systemen ''nicht'' an den Server übermittelt. Es wird also stets die komplette Ressource vom Server angefordert. Die Auswertung des Fragmentbezeichners erfolgt allein im Client (und kann im Beispiel von Webbrowsern auch von clientseitigen Skripten ausgewertet werden) und seine Interpretation und Bedeutung hängt unter anderem vom Typ der angeforderten Ressource ab.

Da der Server den Fragmentbezeichner nicht kennt, kann er auch keine Fehlermeldungen oder Redirects an den Client zurückgeben, falls z. B. ein – über den Fragmentbezeichner spezifizierte – Abschnitt eines Dokumentes nicht mehr existiert oder in ein anderes Dokument verschoben wurde.

== Syntax ==

Der Fragmentbezeichner ist – sofern vorhanden – stets der letzte Teil eines URI. Er wird durch ein Doppelkreuz (<code>#</code>) eingeleitet und erstreckt sich bis zum Ende des URI. Das Doppelkreuz selbst gehört dabei ''nicht'' zum Fragmentbezeichner, sondern nur der Teil danach.

:{|class=wikitable
|+ syntaktische Beispiele
! URL !! Bedeutung
|-
| {{Nowrap|https://example.org/path/to/resource#fragment}}
| Der Fragmentbezeichner ist ''fragment''
|-
| {{Nowrap|https://example.org/path/to/resource#}}
| rowspan=2| Der Fragmentbezeichner ist leer, es ist die ''gesamte'' Ressource gemeint. Beide URLs sind gleichbedeutend
|-
| {{Nowrap|https://example.org/path/to/resource}}
|}

Gemäß <nowiki>RFC 2396</nowiki>, Abschnitt 4.1<ref>{{RFC-Internet |RFC=2396 |Titel=Uniform Resource Identifier |Datum=1998 |Abschnitt=4.1 |Abschnittstitel=Fragment Identifier}}</ref> in Verbindung mit Abschnitt 2, dürfen folgende Zeichen in einem Fragmentbezeichner enthalten sein:
* ''unreserved'' Zeichen: <code>a-z A-Z 0-9 . ~ _ -</code>
* ''sub-delims'': <code> ! $ & ' ( ) * + , ; =</code>
* sonstige erlaubte Zeichen: <code>: @ / ?</code>
* alle anderen Zeichen müssen [[URL-Encoding|prozent-kodiert]] werden, wobei für Nicht-ASCII-Zeichen im Allgemeinen kein Zeichensatz vorgegeben ist, jedoch UTF-8 inzwischen als Quasi-Standard gilt.

Je nach Typ der referenzierten Ressource kann der Fragmentbezeichner ein bestimmtes, genormtes Format haben. Üblich sind beispielsweise (hier zur Veranschaulichung ''mit'' Doppelkreuz dargestellt, wie es am Ende einer URL dargestellt wird):

* (menschenlesbarer) Name: z. B. Kapitelnamen (ggf. abgekürzt): <code>#Form_und_Gr%C3%B6%C3%9Fe</code>
* opaquer, automatisch generierter Hash oder fortlaufende Nummer: <code>#b95d534fe38e</code>
* Paar aus Name und Wert, bzw. Folge von Name-Wert-Paaren, oft durch <code>&</code> oder <code>;</code> voneinander getrennt, ähnlich wie bei einem [[Query-String]]: <code>#line=10,20;length=9876,UTF-8</code><ref>{{RFC-Internet |RFC=5147 |Titel=URI Fragment Identifiers for the text/plain Media Type |Datum=2008 |Abschnitt=5 |Abschnittstitel=Examples}}</ref>

Es gibt aber auch komplexere Formate und Webframeworks, die umfangreiche Daten in den Fragmentbezeichner kodieren.

== Beispiele ==
Fragmentbezeichner werden üblicherweise einer [[Uniform Resource Identifier|URI]] (also auch einer [[Uniform Resource Locator|URL]]) hinzugefügt, um Teile eines Dokuments zu adressieren. Der Fragmentbezeichner wird in diesem Fall mit dem [[Rautezeichen]] (<code>#</code>) in der URI gekennzeichnet. Er steht optional am Ende einer URI.

Die Interpretation des Fragmentbezeichners ist abhängig von der Art der Ressource und dem [[Parser]]. Beispiele:

* In [[Hypertext Markup Language|HTML]] verweist <code><nowiki>https://example.com/document.html</nowiki>'''#anker1'''</code> auf das HTML-Element in ''document.html'', das das [[Anker (HTML)|Anker]]-Attribut <code>name="anker1"</code> (oder <code>id="anker1"</code>) enthält.
* In [[Extensible Markup Language|XML]] sollte sich mit <code><nowiki>https://example.com/document.xml</nowiki>'''#xpointer(//Kamel)'''</code> ein [[XPointer]] einsetzen lassen, der alle XML-Elemente mit Namen „Kamel“ aus der Datei ''document.xml'' als Ergebnis liefert.
* Für [[Portable Document Format|PDF]]-Dokumente beschreibt <code><nowiki>https://example.com/document.pdf</nowiki>'''#page=123'''</code> die S. 123 in ''document.pdf''.
* Für [[Webvideo]]s und andere audiovisuelle Medien kann ein Zeitpunkt, Ausschnitt oder Kapitel bestimmt werden. Es gibt unterschiedliche Paarungen ''Schlüsselwort''<code>=</code>''Wert'', wobei das ''Schlüsselwort'' beispielsweise <code>track</code> oder <code>t</code> oder auch <code>id</code> heißen könnte.<ref>[https://www.w3.org/TR/media-frags/ Media Fragments URI 1.0 (basic)], [[W3C]]</ref> Das erforderliche Schlüsselwort wie auch die Interpretation des zugewiesenen Wertes hängt von der Art des Mediums ab. So soll <code><nowiki>https://</nowiki>example.com/video.mp4'''#t=40'''</code> zur 40. Sekunde des Videos auf <code>video.mp4</code> springen.
* Über ein sogenanntes Textfragment kann ein [[Webbrowser]], der die Fähigkeit dazu besitzt, angewiesen werden, diesen Text hervorzuheben – auf welche Weise, ist browserabhängig. Beispiel: <code><nowiki>https://</nowiki>example.org/path/to/resource'''#:~:text=illustrative%20examples'''</code> markiert im Webdokument die Textstelle <mark>illustrative examples</mark>.<ref>[https://wicg.github.io/scroll-to-text-fragment/ URL Fragment Text Directives], [[W3C]]</ref>

Die [[Scalable Vector Graphics|Scalable-Vector-Graphics]]-Spezifikation (SVG) erlaubt den Zugriff auf verschiedene Elemente innerhalb derselben [[Vektorgrafik]] über Fragmentbezeichner. Dadurch ist es beispielsweise möglich, verschiedene [[Icon (Computer)|Icons]] einer grafischen Benutzeroberfläche in einer gemeinsamen SVG-Datei vorzuhalten und bei Bedarf nur das gewünschte Icon zu referenzieren.<ref>{{Internetquelle |url=https://css-tricks.com/svg-fragment-identifiers-work/ |titel=How SVG Fragment Identifiers Work |autor=Chris Coyier |datum=2017-01-29 |werk=CSS Tricks |sprache=en |abruf=2019-01-16}}</ref> Der Fragmentbezeichner wird auch in diesem Fall mit einem Doppelkreuz vom Namen der Ressource abgetrennt, muss aber kein Teil einer URI sein.

== Weblinks ==
* {{RFC-Internet |RFC=2396 |Titel=Uniform Resource Identifier |Datum=1998 |Updated=3986}}
* {{RFC-Internet |RFC=3986 |Titel=Uniform Resource Identifier (URI) |Datum=2005-01 |Abschnitt=3.5 |Abschnittstitel=Fragment}}
* {{RFC-Internet |RFC=5147 |Titel=URI Fragment Identifiers for the text/plain Media Type }}
* [https://www.w3.org/TR/html401/struct/links.html HTML 4.01 Specification – Links in HTML documents] ([[W3C]], englisch)
* [https://url.spec.whatwg.org/ URL – Living Standard]([[WHATWG]], englisch)
* {{Webarchiv |url=https://partners.adobe.com/public/developer/en/acrobat/PDFOpenParameters.pdf |wayback=20161115011909 |text=PDF Open Parameters |format=englisch, PDF, 157 kB, für [[Adobe Acrobat]]}}
* [https://developer.mozilla.org/de/docs/Web/URI/Reference/Fragment/Text_fragments Textfragmente - URIs] ([[MDN Web Docs]])

== Einzelnachweise ==
<references />

[[Kategorie:URI]]

Fragmentbezeichner - Versionsgeschichte

imported>Speravir: /* Syntax */ auch hier: URI