模板:Visible anchor/doc

有机器人使用本模板文档

---

如欲移动、删除或修改此模板文档而无法向下兼容，并会影响机器人运作，请先通知机器人操作者，谢谢您。相关的机器人：User:Cewbot/log/20201008/configuration

这个模板{{Visible anchor}}可以在页面中插入一个或多个HTML的锚。使得我们可以用[[#link|...]]语法来指向页面中的特定位置和文字，并且醒目地标记它让读者能够清楚的识别。不像{{Anchor}}模板，本模板的第一个参数会直接显示于页面中，并且连结到此时会高亮出来提醒读者内容的位置。

用法

基本用法

{{visible anchor |錨點1 |錨點2 |錨點3 |…… |text=顯示的文字 |lang=語言代碼}}

或者

{{visible anchor |錨點兼顯示的文字}}

也可以

{{visible anchor |錨點兼顯示的文字 |錨點2 |錨點3 |…… }}

锚点的名称大小写敏感，因此{{Visible anchor|Anchor name 1}}和{{Visible anchor|Anchor Name 1}}并不等价。锚点的命名请尽量遵守格式手册中关于章节标题的规范。可以新增可选的参数|text=，以指定要在锚点中显示的文字。 预设情况下，锚点中显示的文字会使用第一个参数的值。也可以新增第二个可选参数|lang=，以使用指定的 ISO 639 语言代码或 IETF 语言标记（类似{{lang}}的效果）来标记产生的可见文字。以外，也可以使用重定向{{vanchor}}来调用本模板。

连结到锚点

若要连结到同一个页面的不同锚点，可以使用以下语法[[#锚点名称]]（在视觉化编辑器中，则是在连结栏位中输入#錨點名稱。）

若要连结到不同页面的锚点，可以透过在内部链接语法中指定对应的页面名称，并加上#后面紧跟着锚点的名称，来连结到特定页面的锚点，例如以下语法[[页面名称#锚点名称]]。

如仅使用上述语法符号#会显示在连结的文字上。为了防止这种情况，请以管道连结指定显示标题：在要显示的文字之wikitext源代码放在竖线字元（ | ）之后，竖线字元放置在锚点名称之后（即[[#锚点名称|锚点名称]]或[[#锚点名称|显示文字]]），或者透过在视觉化编辑器中编辑连结文字。

目标锚点高亮显示

当点击某个锚点的连结时，目标锚点的可见文字通常会以高亮背景突出显示。（可能会因读者的浏览器或所选的 wiki 皮肤而异。）例如：

这是锚点文字，点击以该文字锚点为目标的连结后，该文字锚点将会高亮显示。

指定语言

为了帮助萤幕阅读器和其他辅助技术正确识别外语或方言的文本，可以使用|lang=参数来指定ISO 639-1语言代码或IETF语言标签，以将语言代码作为属性添加到显示的文本的HTML之中。

范例

源代码	结果	相关连结
{{vanchor|Foo}}	Foo	#Foo
{{vanchor|Bar|Baz}}	Bar	#Bar, #Baz
{{vanchor|Qux|text=This is the text that will be displayed.}}	This is the text that will be displayed.	#Qux
{{vanchor|Corge|Grault|lang=en-US}}	Corge	#Corge, #Grault

限制

字元	代码	模板	所代表之意义
	" "	不适用	（双）引号
#	#	不适用	井号
|	|	{{!}}	竖线
=	=	{{=}}	等号

• 此模板不应在章节标题中使用。如果在章节标题中使用使用本模板会导致编辑摘要中的连结变为失效连结，同时也可能出现重复的锚点（见下文）。
• 锚点名称在同一个页面上应该要是唯一的，不应该与任何标题重复。重复的锚点会导致页面对于锚点的跳转出现问题，因为如果有重复名称的锚点，#links只会跳转到第一个该名称之锚点的位置，如果您加入的锚点是一个重复名称的锚点，那么在页面对于锚点的跳转时，将无法跳转到你加入的那个锚点。此外，重复的锚点也会导致该HTML成为一个无效的HTML；您可以透过W3C验证服务来检查页面中是否有重复的锚点。
• Anchor names that contain any character shown in the table on the right will not work as expected. However, any of these characters can be replaced with the "&#" codes shown for them here. Or, the pipe symbol and equals sign can be worked around with {{!}} and {{=}}, respectively. Markup code such as <sup> and <sub> (superscript and subscript) cannot be used. Most other characters, including white space and punctuation, are not a problem.
• The template can create a maximum of 10 anchors. Specifying more than 10 anchors will result in an error message.
• If positional parameters (parameters without specifying 1=, 2=, etc.) are used, whitespace and newlines will be preserved. If you instead specify the name of the parameters (e.g. |1=) whitespace and newlines will be trimmed.

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Visible anchor模板数据

模板{{Visible anchor}}可在页面中插入一个或多个HTML锚点。 使得该位置可以使用语法[[#link|...]]来连结到。 但与{{Anchor}}不同，本模板预设会将第一餐数显示出来。

模板参数

参数		描述	类型	状态
锚点名称和显示的文字	1	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 不要尝试使用有维基代码格式的内容； 欲使用有维基代码格式的内容，请改用“text”参数。 示例值 start-of-content	字符串	必需
第二个锚点名称	2	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	推荐
第三个锚点名称	3	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	可选
第四个锚点名称	4	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	可选
第五个锚点名称	5	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	可选
第六个锚点名称	6	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	可选
第七个锚点名称	7	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	可选
第八个锚点名称	8	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	可选
第九个锚点名称	9	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	可选
第十个锚点名称	10	这个参数将成为欲建立之锚点的名称。字元"、 #、 | 和 = 必须被跳脱； 有关详细信息，请参阅主模板页面。 请勿使用有维基代码格式的内容。	字符串	可选
第十一个锚点名称	11	若要新增十个以上的锚点，请使用源代码编辑。	字符串	可选
要显示的文字	text	覆盖参数1的功能，但不作为锚点名称。 可以使用维基代码的格式。 示例值 CO<sub>2</sub>的性质	内容	推荐
语言代码	lang	给显示出来的文字透过HTML属性来指定特定的ISO 639或IETF语言代码。 对于萤幕阅读器和其他辅助技术很有用。 示例值 en-US; fr; etc.	单行文本	可选

参见

• {{Anchor}}
• {{Invisible anchor}}
• {{Anchored list}}
• {{Shortcut}}
• Help:Link § Section linking (anchors) (Shortcut: WP:ANCHOR)