URI片段

URI片段在计算机超文本中是指从属于主资源的子资源的标识字符串。主资源由统一资源标识符（URI）标识，片段标识符指向从属资源。

由井号#引入的片段标识符是文档的URL的可选最后部分。通常用于标识该文档的一部分。在RFC 3986中指定了其通用语法。^[1]URI中的井号#分隔符不是片段标识符的一部分。

概述

在URI中，井号#在URL末尾附近引入可选片段。RFC 3986定义的URI通用语法还允许使用问号?引入可选的查询部分。在带有查询和片段的URI中，片段位于查询之后。查询部分取决于URI方案并由服务器评估，例如，http:支持与ftp:不同的查询。片段取决于文档MIME类型并由客户端（Web 浏览器）评估。客户端在获取文档时不应将URI片段发送到服务器，并且如果没有本地应用程序的帮助，片段不会参与HTTP重定向。

以井号#结尾的URI是通用语法允许的，并且这是一种空片段。在MIME文档类型（例如text/html或任何XML类型）中，不允许使用空标识符来匹配此语法上合法的构造。 Web浏览器通常会在文档顶部显示一个空片段。

片段标识符的功能与URI的其余部分不同：它的处理完全是客户端进行的，没有Web服务器的参与，尽管服务器通常帮助确定MIME类型，并且MIME类型决定片段的处理。当代理（例如Web浏览器）从Web服务器请求Web资源时，代理将URI发送到服务器，但不发送片段。相反，代理等待服务器发送资源，然后代理根据文档类型和片段值处理资源。^[2]

在HTML网页中，代理将查找由HTML标记标识的锚点，该标记包含等于片段标识符的id=或name=属性。

例子

• 在MIME为text/html页面的URI（例如http://www.example.org/foo.html#bar）中，片段引用id="bar"的元素。
  • 图形Web浏览器通常滚动到位置页面，以便由片段id标识的元素的顶部与视口（viewport）的顶部对齐；因此片段标识符经常用在目录和永久链接中。
  • 可以通过CSS伪类:target更改被标识的元素的外观；维基百科使用它来高亮显示所选的参考文献。值得注意的是，CSS的display: block仅当内容是目标时才可用于显示内容，否则通过display: none隐藏。
  • 已弃用的name属性（仅允许某些元素）在现已过时的浏览器中具有类似的用途。如果存在name，则必须和id相同。
• 在所有XML文档类型中，包括对应于xml:id或类似id属性的XHTML片段，都遵循Name语法并以字母、下划线或冒号开头。值得注意的是，它们不能以数字或连字符开头。^[3]
  • xml:id是少数通用XML属性之一，例如xml:lang，无需显式声明命名空间即可使用。^[4]在XHTML中必须使用id，因为 XHTML 是在xml:id存在之前指定的。
• 在XML应用中，某种语法中的片段标识符可以是XPointer； 例如，URI http://www.example.org/foo.xml#xpointer(//Rube) 中的片段标识符指的是由URI http://www.example.org/foo.xml标识的文档中名为“Rube”的所有XML元素。给定该URI，XPointer处理器将获取文档的表示（例如通过从Internet请求）并返回文档的“Rube”元素的表示。
• 在RDF词汇表中，例如RDFS（英语：RDF_Schema）、OWL或SKOS，片段标识符用于标识同一XML命名空间中的资源，但不一定对应于文档的特定部分。例如，http://www.w3.org/2004/02/skos/core#broader标识了SKOS Core词汇中的“broader”概念，但它并不指代http://www.w3.org/2004/02/skos/core标识的资源的特定部分。它是一个完整的 RDF 文件，其中声明了该特定概念的语义以及同一词汇表中的其他概念。
• 在 MIME text/plain文档的URI中，RFC 5147 使用关键字“char”和“line”指定文档内字符和行位置和范围的片段标识符。浏览器支持似乎缺乏。^[5]以下示例标识文本文档的第 11 行到第 20 行：
  • http://example.com/document.txt#line=10,20
• 在 MIME text/csv 文档的 URI 中，RFC 7111 使用关键字"row" , "col", "cell"指定片段标识符作为行、列和单元格的选择器，例如：
  • http://example.com/data.csv#row=4 –选择第4行.
  • http://example.com/data.csv#col=2 – 选择第二列.
  • http://example.com/data.csv#row=5-7 – 选择从第5行开始的三个连续行.
  • 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 中，很少有定义片段或片段语义。^[6]媒体片段 URI 1.0（基本）语法支持使用关键字t和xywh沿二维（时间和空间）寻址媒体资源。因此，可以在音频或视频 HTML5 元素的src属性中使用以下媒体片段 URI：
  • http://example.com/foo.mp4#t=10,20
  • http://example.com/bar.webm#t=40,80&xywh=160,120,320,240
  • 其他网站使用片段部分将一些额外信息传递给在其上运行的脚本 - 例如，Google Video理解#01h25m30s格式的永久链接以在指定位置开始播放，^[7]而YouTube使用类似的代码，例如#t=3m25s.^[8]
• 在JavaScript中，当前HTML或XHTML页面的片段标识符可以在“hash”属性location.hash中访问 - 请注意，JavaScript 也可以与其他文档类型一起使用。 随着AJAX的兴起，一些网站使用片段标识符来模拟浏览器的后退按钮行为，以进行不需要重新加载的页面更改，或模拟子页面。
  • 例如，Gmail几乎每个界面都使用单个URL – 邮箱、个人邮件、搜索结果、设置 – 该片段用于使这些界面可以直接链接。^[9]
  • Adobe Flash网站可以使用片段部分来通知用户网站或Web应用程序的状态，并促进深度链接，通常在SWFAddress JavaScript库的帮助下。
• 链接到JSON文档的URI可以指定指向特定值的指针。^[10]
  • 例如，以#/foo结尾的URL可用于从以{ "foo": ["bar", "baz"], ... }开头的文档中的“键-值对”中提取值。
• 在 MIME application/pdf 文档的 URI 中，PDF查看器可识别许多片段标识符。^[11][12]例如，以 .pdf#page=35结尾的 URL 将导致大多数读者打开 PDF 并滚动到第35页。其他几个参数也是可能的，包括#nameddest=（类似于HTML锚点）、#search="word1 word2", #zoom=等。多个参数可以用 & 符号组合：
  • http://example.org/doc.pdf#view=fitb&nameddest=Chapter3.
• 在SVG中，片段可以指定viewBox(), preserveAspectRatio(), transform()等参数。^[13]

W3C提案

对于与纯文本文档（无法存储锚元数据）一起使用的片段标识符，或者引用 HTML 文档中作者未使用锚标记的位置，已经提出了一些W3C提案：

• 2012年9月，Media Fragments URI 1.0 (basic)已成为W3C推荐标准。^[14]
• Chrome版本80及更高版本^[15][16]实现了WICG Text Fragments,^[17]因此#:~:text=foo将导致浏览器搜索foo，突出显示匹配的文本，然后滚动到它。除了开始和结束之外，代码片段还可以指定上下文：必须在foo之前或之后但不会突出显示的文本（例如搜索前面带有“night”的“vision”）。
• Python的Package Index将文件的MD5哈希值附加到URL作为片段标识符。^[18]如果MD5未被破坏，这可以用来确保包的完整性。

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

• hash-bang^[19]片段是以感叹号!开头的片段。它用于索引动态单页应用程序的现已被弃用的方法中。感叹号在HTML4、XHTML和XML标识符中是非法的，因此与该功能有一定程度的分离。然而，它在HTML5中是允许的。^[20]
  • 2009年至2015年间，Google网站管理员中心提出并推荐了一种“AJAX 抓取方案”^[21][22]，在有状态AJAX页面的片段标识符中使用初始感叹号：
    http://example.com/page?query#!state
  • 另一个实现是替换#!为?_escaped_fragment_=^[21]
  • Hash-bang URI 被W3C的Jeni Tennison等许多人认为是有问题的，因为它们使那些没有在浏览器中激活JavaScript的人无法访问页面。它们还会破坏HTTP Referer标头，因为浏览器不允许发送Referer标头中的片段标识符。^[19]
  • 2015 年，Google 弃用了他们的hash-bang AJAX抓取提案，转而建议使用渐进增强和HTML5的history.pushState()^[23]方法。^[24]
  • Mozilla基金会Gervase Markham提出了一种用于搜索的片段标识符，其形式为#!s!search terms。 在s(#!s10!) 后添加数字表示浏览器应搜索第n次出现的搜索词。负数(#!s-3!)从文档末尾开始向后搜索。Greasemonkey脚本可用于将此功能添加到兼容浏览器。^[25]

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

• 苏黎世联邦理工学院的Erik Wilde和Marcel Baschnagel将其扩展为使用正则表达式（使用关键字“match”）来识别纯文本文档中的片段。^[26]他们还描述了一个原型实现作为Firefox浏览器的扩展。例如，以下命令将在文档中的任何位置查找不区分大小写的文本“RFC”：

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

• Foresight Institute的K. Yee提出了用冒号和关键字分隔的“扩展片段标识符”，以将它们与锚标识符区分开来。具有“片段规范方案”id“words”的文本搜索片段标识符是该方案中的第一个提案。^[27]以下示例将在文档中搜索字符串“some context for a search term”的第一次出现，然后突出显示单词“search term”：

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

  • 上述方案在Chrome 80版本中实现。^[28]
• LiveURLs项目^[29]提出了一种片段标识符格式，用于引用页面内的文本区域，其形式为#FWS+C，其中 F 是第一个单词的长度（最多5个字符），W是第一个单词本身，S是所选文本的长度，C是所选文本的32位CRC。^[30]他们使用#LFWS+C的形式实现了该方案的变体作为 Firefox 浏览器的扩展^[31]，其中L是片段本身的长度，采用两个十六进制数字。使用已实现的变体链接到单词“Fragment”将产生：

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

• 在 Firefox 5 之前，Firefox 支持 XPath 链接，例如 #xpath:/html/body/div[3]，它可以与书签结合使用，例如 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，^[32] 2011-2017）定义了一种W3C/IDPF标准化方法，用于使用片段标识符引用任意内容，通过文档结构和模式匹配来定位非锚定文本范围。 这些动态深层链接有助于在文本更新和使用后定位内容，例如在Apple Books中。

参见

• Query string
• URI normalization
• URL
• Clean URL
• URI scheme

参考文献

1. RFC 3986 Uniform Resource Identifier (URI): Generic Syntax. Internet Engineering Task Force. January 2005 [2012-03-06]. 
2. Representation types and fragment identifier semantics. Architecture of the World Wide Web, Volume One. W3C. 2004 [2011-07-13]. 
3. Validity constraint: ID. XML 1.0 (Fifth Edition). W3C. 2008 [2011-07-13]. 
4. xml:id Version 1.0. W3C. 2005 [2011-07-13]. 
5. Issue 77024. Chromium. 2011 [2011-07-13]. 
6. Media Type Review. W3C Media Fragments Working Group. 2009 [2009-04-29]. 
7. New Feature: Link within a Video. 2006-07-19 [2011-07-13]. 
8. Link To The Best Parts In Your Videos. YouTube. 2008-10-30 [2011-07-13]. 
9. Link to Specific Content in Gmail, Google Blogoscoped, 2007-11-17
10. Bryan, P. RFC 6901 – JavaScript Object Notation (JSON) Pointer. The Internet Society. 2 April 2013 [14 July 2022]. 
11. Parameters for Opening PDF Files – Specifying parameters in a URL (PDF). Adobe. April 2007 [2017-09-20]. 
12. Taft, E.; Pravetz, J.; Zilles, S.; Masinter, L. RFC 3778 – The application/pdf Media Type. The Internet Society. May 2004 [2017-09-20]. doi:10.17487/RFC3778. 
13. Linking – SVG 1.1 (Second Edition). 
14. Media Fragments URI 1.0 (basic) W3C Recommendation. [2012-09-25]. 
15. Scroll to Text Fragment. Chrome Platform Status. Google Chrome. [2020-05-18] （英语）. 
16. Kelly, Gordon. Google Chrome 80 Released With Controversial Deep Linking Upgrade. Forbes. [2020-06-04] （英语）. 
17. WICG/scroll-to-text-fragment: Proposal to allow specifying a text snippet in a URL fragment. GitHub. WebPlatform.org Incubator Community Group at W3C. [2020-05-18] （英语）. 
18. Pypi md5 check support. [2011-07-13]. Pypi has the habit to append an md5 fragment to its egg urls, we'll use it to check the already present distribution files in the cache 
19. Hash URIs. W3C Blog. 2011-05-12 [2011-07-13]. 
20. HTML 5.1 2nd Edition. W3C. 2017 [2018-08-03]. 
21. Proposal for making AJAX crawlable. 2009-10-07 [2011-07-13]. 
22. (Specifications) Making AJAX Applications Crawlable. Google Inc. [2013-05-04]. 
23. Manipulating the browser history. Mozilla Developer Network. [2017-02-23] （美国英语）. 
24. Deprecating our AJAX crawling scheme. Official Google Webmaster Central Blog. [2017-02-23] （美国英语）. 
25. Fragment Search, gerv.net
26. Fragment identifiers for plain text files, Erik Wilde and Marcel Baschnagel, Swiss Federal Institute of Technology (ETH Zürich), Proceedings of the sixteenth ACM conference on Hypertext and hypermedia doi:10.1145/1083356.1083398
27. Text-Search Fragment Identifiers, K. Yee, Network Working Group, Foresight Institute, March 1998
28. bmcquade; bokan; nburris. Feature: Scroll to Text Fragment. Chrome Platform Status. chromium.org. 2022-03-24 [3 May 2022]. 
29. LiveURLs project
30. The technology behind LiveURLs, accessed 2011-03-13
31. "Web Marker" Firefox add-on, accessed 2011-03-13
32. EPUB Canonical Fragment Identifiers 1.1. idpf.org. [2020-06-03]. 

外部链接

• W3C Media Fragments Working Group, establishing a URI syntax and semantics to address media fragments in audiovisual material (such as a region in an image or a sub-clip of a video)
• MediaMixer collects presentations, tutorials, use cases and demonstrators related to use of Media Fragment technology