imported>壹陆：翻译，fix

2025-05-30T02:25:06Z

翻译，fix

新页面

{{Bot use warning|bots=[[User:Cewbot/log/20201008/configuration]]}}


{{tsh|vanchor}}
{{lua|Module:Anchor}}
{{Uses TemplateStyles|Template:Visible anchor/styles.css}}
這個模板{{tnull|Visible anchor}}可以在頁面中插入一個或多個[[HTML元素#锚|HTML的錨]]，編者可以用<code><nowiki>[[#link|...]]</nowiki></code>語法來指向頁面中的特定位置和文字，並且醒目地標記它、讓讀者能夠清楚的識別。不像{{tl|Anchor}}模板，本模板的'''第一個參數'''（或用{{para|text}}另行指定的文本）會直接顯示於頁面中，並且通過錨點連結跳轉而來時會高亮出來提醒讀者內容的位置。

== 用法 ==
基本用法
<syntaxhighlight lang=wikitext>{{visible anchor |錨點1 |錨點2 |錨點3 |…… |text=顯示的文字 |lang=語言代碼}}</syntaxhighlight>
或者
<syntaxhighlight lang=wikitext>{{visible anchor |錨點兼顯示的文字}}</syntaxhighlight>
也可以
<syntaxhighlight lang=wikitext>{{visible anchor |錨點兼顯示的文字 |錨點2 |錨點3 |…… }}</syntaxhighlight>

錨點的名稱大小寫敏感，因此<syntaxhighlight lang=wikitext inline>{{Visible anchor|Anchor name 1}}</syntaxhighlight>和<syntaxhighlight lang=wikitext inline>{{Visible anchor|Anchor Name 1}}</syntaxhighlight>並不等價。錨點的命名請儘量遵守[[Wikipedia:格式手冊/章節標題|格式手冊中關於章節標題的規範]]。可以新增可選的參數{{para|text}}，以指定要在錨點中顯示的文字。預設情況下，錨點中顯示的文字會使用第一個參數的值。也可以新增第二個可選參數{{para|lang}}，以使用指定的 ISO 639 語言代碼或 IETF 語言標記（類似{{tl|lang}}的效果）來標記產生的可見文字。以外，也可以使用重定向{{tl|vanchor}}來調用本模板。

===連結到錨點===
若要連結到同一個頁面的不同錨點，可以使用以下語法<syntaxhighlight lang=wikitext inline>[[#錨點名稱]]</syntaxhighlight>（在視覺化編輯器中，則是在連結欄位中輸入<code>#錨點名稱</code>。）

若要連結到不同頁面的錨點，可以透過在內部連結語法中指定對應的頁面名稱，並加上<code>#</code>後面緊跟著錨點的名稱，來連結到特定頁面的錨點，例如以下語法<syntaxhighlight lang=wikitext inline>[[頁面名稱#錨點名稱]]</syntaxhighlight>。

如僅使用上述語法符號<code><nowiki>#</nowiki></code>會顯示在連結的文字上。為了防止這種情況，請以管道連結指定顯示標題：在要顯示的文字之wikitext原始碼放在豎線字元（<code> | </code>）之後，豎線字元放置在錨點名稱之後（即<syntaxhighlight lang=wikitext inline>[[#錨點名稱|錨點名稱]]</syntaxhighlight>或<syntaxhighlight lang=wikitext inline>[[#錨點名稱|顯示文字]]</syntaxhighlight>），或者透過在視覺化編輯器中編輯連結文字。

===目標錨點高亮顯示 ===
當點擊某個錨點的連結時，目標錨點的可見文字通常會以高亮背景突出顯示。（可能會因讀者的瀏覽器或所選的 wiki 皮膚而異。）例如：<blockquote>''{{vanchor|this|text=這是錨點文字}}''，點擊[[#this|以該文字錨點為目標的連結]]後，該文字錨點將會高亮顯示。</blockquote>

=== 指定語言 ===
為了幫助螢幕閱讀器和其他輔助技術正確識別外語或方言的文本，可以使用{{para|lang}}參數來指定[[ISO 639-1]]語言代碼或[[IETF語言標籤]]，以將語言代碼作為屬性添加到顯示的文本的HTML之中。

== 範例 ==
{| class="wikitable"1
! 原始碼
! 結果
! 相關連結
|-
| <code><nowiki>{{vanchor|Foo}}</nowiki></code>
| {{vanchor|Foo}}
| [[#Foo]]
|-
| <code><nowiki>{{vanchor|Bar|Baz}}</nowiki></code>
| {{vanchor|Bar|Baz}}
| [[#Bar]], [[#Baz]]
|-
| <code><nowiki>{{vanchor|Qux|text=This is the text that will be displayed.}}</nowiki></code>
| {{vanchor|Qux|text=This is the text that will be displayed.}}
| [[#Qux]]
|-
| <code><nowiki>{{vanchor|Corge|Grault|lang=en-US}}</nowiki></code>
| {{vanchor|Corge|Grault|lang=en-US}}
| [[#Corge]], [[#Grault]]
|}

== 限制 ==
{|class="wikitable floatright"
|---
! 字元
! [[XML与HTML字符实体引用列表|代碼]]
! 模板
! 所代表之意義
|---
| "
| <code>&quot;</code> <br /><code>&#34;</code>
| {{N/a}}
| （雙）[[引号]]
|---
| #
| <code>&#35;</code>
| {{N/a}}
| [[井號]]
|---
| |
| <code>&#124;</code>
| {{tl|!}}
| [[豎線]]
|---
| =
| <code>&#61;</code>
| {{tl|{{=}}}}
| [[等号]]
|}

* {{strong|此模板不應在章節標題中使用。}}如果在章節標題中使用使用本模板會導致編輯摘要中的連結變為失效連結，同時也可能出現重複的錨點（見下文）。
* 錨點名稱在同一個頁面上應該要是唯一的，不應該與任何標題重複。重複的錨點會導致頁面對於錨點的跳轉出現問題，因為如果有重複名稱的錨點，<code>#links</code>只會跳轉到第一個該名稱之錨點的位置，如果您加入的錨點是一個重複名稱的錨點，那麼在頁面對於錨點的跳轉時，將無法跳轉到你加入的那個錨點。此外，重複的錨點也會導致該HTML成為一個無效的HTML；您可以透過[[W3C驗証服務]]來檢查頁面中是否有重複的錨點。
* 包含右表列出之任意字符的錨點因技術原因不會照常工作，不過可以用表中所述的“&”轉義語法使用，管道符與等號也可以用{{tl|!}}和{{tl|{{=}}}}替代。如{{tag|sup|o}}、{{tag|sub|o}}（上標與下標）等的格式標籤無法使用。大多數其他字符——如各類空白字元和標點符號——都能正常使用。
* 本模板可生成最多10個錨點，超過的話會產生錯誤消息。
* 使用匿名參數語法（不包括如 1=, 2= 等的參數名稱）時，模板會保留空白字元和換行。如果使用模板時指出參數名稱（如{{para|1}}），空白字元和換行會被削除。

== 模板數據 ==
{{TemplateDataHeader}}
<templatedata>
{
"params": {
"1": {
"label": "錨點名稱和顯示的文字",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。不要嘗試使用有維基代碼格式的內容；欲使用有維基代碼格式的內容，請改用“text”參數。",
"example": "start-of-content",
"type": "string",
"required": true
},
"2": {
"label": "第二個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string",
"suggested": true
},
"3": {
"label": "第三個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string"
},
"4": {
"label": "第四個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string"
},
"5": {
"label": "第五個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string"
},
"6": {
"label": "第六個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string"
},
"7": {
"label": "第七個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string"
},
"8": {
"label": "第八個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string"
},
"9": {
"label": "第九個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string"
},
"10": {
"label": "第十個錨點名稱",
"description": "這個參數將成為欲建立之錨點的名稱。字元\"、 #、 | 和 = 必須被跳脫；有關詳細信息，請參閱主模板頁面。請勿使用有維基代碼格式的內容。",
"type": "string"
},
"11": {
"label": "第十一個錨點名稱",
"description": "若要新增十個以上的錨點，請使用原始碼編輯。",
"type": "string",
"required": false
},
"text": {
"label": "要顯示的文字",
"description": "覆蓋參數1的功能，但不作為錨點名稱。可以使用維基代碼的格式。",
"example": "CO<sub>2</sub>的性質",
"type": "content",
"suggested": true
},
"lang": {
"label": "語言代碼",
"description": "給顯示出來的文字透過HTML屬性來指定特定的ISO 639或IETF語言代碼。對於螢幕閱讀器和其他輔助技術很有用。",
"example": "en-US; fr; etc.",
"type": "line"
}
},
"description": "模板{{Visible anchor}}可在頁面中插入一個或多個HTML錨點。使得該位置可以使用語法[[#link|...]]來連結到。但與{{Anchor}}不同，本模板預設會將第一參數顯示出來。"
}
</templatedata>

== 參見 ==
* {{tl|Anchor}}
* {{tl|Invisible anchor}}
* {{tl|Anchored list}}
* {{tl|Shortcut}}
* [[Help:Link#Section linking (anchors)|Help:Link § Section linking (anchors)]] (Shortcut: [[WP:ANCHOR]])
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||


[[Category:格式模板]]
}}</includeonly>

Template:Visible anchor/doc - 版本历史

imported>壹陆：​翻译，fix

imported>壹陆：翻译，fix