模板:URL/doc
外觀
此頁面是Template:URL的模板文件。 此頁面可能包含了模板的使用說明、分類和其他內容。 |
此模板文件被引用於約55,000個頁面。 為了避免造成大規模的影響,所有對此模板文件的編輯應先於沙盒、測試樣例或您的沙盒上測試。 測試後無誤的版本可以一次性地加入此模板文件中,但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
此模板使用Lua語言: |
本模版用於生成格式化的外部連結。本模板生成的連結會使用<wbr>
進行處理,方便瀏覽器自動換行。
用法
[編輯]{{URL|1=url name|2=optional display text}}
- 第一個參數用於寫入相應的URL外鏈,並對其分析,如果沒附帶相應的協議名的話,默認添加為「http://」協議頭,如果有相應協議頭的話,則根據協議頭顯示相應的連接圖標,現支持「 http:// 」,「 https:// 」和「 ftp:// 」三種協議。
- 第二個參數為可選參數,可以改變連結顯示時的名稱,若留空,則直接顯示連接。
- 注:如果沒指定第一個參數的話,第二個參數直接顯示填入值,但不生成連結。
- 如果不填任何參數,則自動生成模板的例子寫法。
含有等號的網址
[編輯]如果網址中含有等號(「=」),需指定參數|1=
{{URL | 1=https://example.com/?id=42 }}
→ example.com?id=42 <span class="url">[https://example.com/?id=42 example<wbr/>.com?id=42]</span>
此時,如果指定標題,第二個參數也需顯式標示:
{{URL | 1=https://example.com/?id=42 | 2=Title }}
→ Title<span class="url">[https://example.com/?id=42 Title]</span>
- 警告:
- 強烈建議顯式標明參數名來寫入參數(尤其連結中有類似等號("=")時),避免錯誤解釋,導致無法顯示連接。如果存在第二參數的話,更加需要顯式參數名,以免錯誤覆蓋第一參數的值。
- 如果連結中含有包含問號或井號的查詢字符串的話,強烈建議連結後加「/」做結束,以免解釋錯誤,「/」不會被顯示出來的,請放心。為防止錯誤將查詢字符串被改變(如小寫化),強烈建議使用顯式參數名寫入參數。
範例
[編輯]Code | Result |
---|---|
{{ URL }} | {{URL|example.com|可选的显示文本}}
|
{{ URL | }} | {{URL|example.com|可选的显示文本}}
|
{{URL ||example}} | example |
{{ URL | EXAMPLE.com }} | example |
{{ URL | example.com }} | example |
{{ URL | www.example.com }} | www |
{{ URL | http://www.example.com }} | www |
{{ URL | https://www.example.com }} | www |
{{ URL | ftp://www.example.com }} | www |
{{ URL | ftp://ftp.example.com }} | ftp |
{{ URL | http://www.example.com/ }} | www |
{{ URL | http://www.example.com/path }} | www |
{{ URL | www.example.com/foo }} | www |
{{ URL | http://www.example.com/foo | link }} | link |
{{ URL | www.example.com/foo | link }} | link |
{{ URL | http://www.example.com/path/ }} | www |
{{ URL | www.example.com/foo/ }} | www |
{{ URL | http://www.example.com/foo/ | link }} | link |
{{ URL | www.example.com/foo/ | link }} | link |
微格式
[編輯]The template wraps the displayed URL with a class="url"
so that it is included in any parent microformat which takes a URL parameter - see our microformats project.
參見
[編輯]- {{official website}}