图片中的资源链接

通过将 xref 属性分配给内联或块图像宏，可以创建从图像到页面、附件、图像或元素的链接。

Xref元素属性

在块图像宏和内嵌图像宏的属性列表中可以设置 xref 元素属性。xref 属性是可选的。无论是将其分配给块图像宏还是内嵌图像宏，它的结构和行为方式都是相同的。

xref 属性接受一个可发布资源（页面、附件或图像）的资源 ID 作为值。

Example 1. Example 1. Set the xref attribute and assign it a resource ID

image::an-image.jpg[xref=version@component:module:family$file.ext]

它还接受当前页面中指定的元素的ID。当分配给 xref 属性时，元素ID必须以散列符号( # )作为前缀。

Example 2. Example 2. Set the xref attribute and assign is an element ID

image::an-image.gif[xref=#fragment]

当您的站点发布并且访问者选择嵌入的图像时，它们将链接到已发布资源的 URL 或跳转到对应于指定元素 ID 的当前已发布页面中的锚点。

xref 属性是一个命名属性。如果您在图像宏中设置位置属性，例如 alt文本 、宽度或高度，请在设置 xref 或任何其他命名属性之前在属性列表中分配它们。

Example 3. Example 3. Optional positional and named attributes assigned to an image macro

image:an-image.svg[The image alt text,xref=version@component:module:family$file.ext,title="A tooltip for the image"]

在图像宏的属性列表中，位置属性和命名元素属性用逗号分隔。

从图像链接到页面

要从嵌入图像中引用页面，请在属性列表中设置 xref 属性，后面跟着等号( = )，然后是目标页面的资源ID。需要指定多少个目标页面的资源ID坐标取决于相对于当前页面的目标页面的组件版本和模块。

Example 4. Example 4. current-page.adoc

image::console.svg[xref=modes.adoc] (1)

1	分配给 `xref` 的资源 ID 只指定页面的文件坐标，因为在本例中，假设当前页面和目标页面属于相同的组件版本和模块。

示例4中显示的块图像宏将把图像 console.svg 嵌入到当前页面中，并创建从图像到目标页面的已发布 URL 的链接。

您还可以在页面的资源 ID 末尾附加片段以链接到页面内的元素。在示例5中，一个对应于 modes.adoc 内容中设置的元素ID protocols 的片段附加到 modes.adoc 的资源 ID 的末尾。

Example 5. Example 5. current-page.adoc

image::console.svg[xref=modes.adoc#protocols]

您还可以链接到当前页面中的元素ID。

从图像链接到附件

要从嵌入的图像引用附件，请在属性列表中设置 xref 属性，后面跟着等号( = )，然后是目标附件的资源ID。确保在分配给 xref 属性的值中指定了族坐标 attachment$ 。

示例6显示了一个内联图像宏，它在宏的属性列表中设置了三个位置属性，后面是命名的 xref 属性。为 xref 属性分配附件的资源ID。

Example 6. Example 6. current-page.adoc

Select the image:red-dot.jpg[Red circle,40,40,xref=telemetry:attachment$flight-patterns.pdf]. (1) (2)

1	位置属性是可选的。如果您确实在图像宏上设置了一个或多个位置属性，请在设置 `xref` 或任何其他命名属性之前在属性列表中分配它们。在本例中，位置属性 alt、width 和 height 按照图像宏接受的顺序设置。
2	分配给 `xref` 的资源ID指定目标附件的模块、`attachment$` 和文件坐标，因为在本例中，假设目标附件属于与当前页面不同的模块。当资源是附件时，总是需要 `attachment$` 坐标。

示例6中所示的内联图像宏将把图像 red-dot.jpg 嵌入到当前页面中，并创建一个从图像到目标附件的已发布 URL 的链接。

从图像到当前页面元素的深度链接

要在当前页面中引用元素，请将元素的 ID 分配给 xref 属性。当您将元素 ID 分配给 xref 属性时，在其前面加上哈希符号( # )。示例7显示了一个块图像宏，其中 xref 属性分配了一个元素 ID ，该元素 ID 对应于当前页面上的一个 ID 。

Example 7. Example 7. current-page.adoc

image::panorama.png[xref=#elevation] (1)

The range can be traversed by Cottonwood Pass, Independence Pass, or Hagerman Pass.

[#elevation] (2)
== Pass elevations

The passes usually open in late spring.

1	在属性列表中设置 `xref` 属性，后面是等号( `=` )、散列符号( `#` )，然后是与当前页面中分配给元素的 ID 相对应的元素 ID 。
2	在当前页面上设置并分配给某个节的元素 ID 。

例7中显示的块图像宏将把图像 panorama.png 嵌入到当前页面中，并创建一个链接，从图像到当前页面上的 Pass elevations 章节的开头。

了解更多

有关其它图像宏属性和有关元素 id 的更多信息，请参阅 AsciiDoc 文档。