模板: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)