WordPress: Template Tags/wp link pages:修订间差异
来自站长百科
无编辑摘要 |
无编辑摘要 |
||
第1行: | 第1行: | ||
== 描述 == | == 描述 == | ||
为标了页数的文章显示网页链接(例如,includes the <code><!--nextpage--></code> [[WordPress:Write_Post_SubPanel#Quicktags | Quicktag]]一次或者更多的几次)。这与[[WordPress:Template_Tags/link_pages|link_pages()]]的运行方式基本相同,不同点在于参数是以查询字符串的形式出现的。标签必须在[[WordPress:The_Loop|The_Loop]]内部。 | |||
== 用法 == | == 用法 == | ||
%%% <?php wp_link_pages('arguments'); ?> %%% | %%% <?php wp_link_pages('arguments'); ?> %%% | ||
== 例子== | == 例子== | ||
== 默认用法 == | == 默认用法 == | ||
默认显示网页链接,网页链接的前后都有段落标签,使用''上一页'' 和''下一页'',并将这些网页标号为''第 1页,第 2页''等等。 | 默认显示网页链接,网页链接的前后都有段落标签,使用''上一页'' 和''下一页'',并将这些网页标号为''第 1页,第 2页''等等。 | ||
<?php wp_link_pages(); ?> | <?php wp_link_pages(); ?> | ||
===段落标签中的网页链接=== | ===段落标签中的网页链接=== | ||
显示由段落标签包围的网页链接。 | 显示由段落标签包围的网页链接。 | ||
<?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?> | <?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?> | ||
=== DIV中的网页链接=== | === DIV中的网页链接=== | ||
在DIV中为CSS reference显示网页链接<tt><div id="page-links"></tt>。 | 在DIV中为CSS reference显示网页链接<tt><div id="page-links"></tt>。 | ||
<?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?> | <?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?> | ||
== | == 参数== | ||
; before : (''string'') 所有的链接之前放置的文本。默认为<tt><p>Pages:</tt>。 | |||
; after : (''string'') 所有的链接之后放置的文本。默认为<tt></p></tt>。 | |||
; after : | |||
; | ; next_or_number : (''string'') 暗示是否会用到网页数字。有效的参数值是: | ||
:* <tt>number</tt> (Default) | :* <tt>number</tt> (Default) | ||
:* <tt>next</tt> (在 WordPress 1.5 或者以后的版本中有效) | |||
:* <tt>next | |||
; | ; nextpagelink : (''string'') 链接到下一个网页的文本 。默认为<tt>下一个网页</tt>。(在WordPress1.5及以后的版本中有效) | ||
; previouspagelink: (''string'') 上一个网页链接的文本。默认为<tt>上一个网页</tt>。(在WordPress1.5及以后的版本中有效) | |||
; pagelink : (''string'') 网页数字的格式字符串。字符串中的<tt> % </tt> <tt> % </tt>会被数字取代,因此<tt>Page %</tt>会产生"第 1页", "第2页",等等。默认为<tt>%</tt>。 | |||
; more_file : (''string'') 链接指向的而网页。默认为当前网页。 | |||
== 相关的 == | == 相关的 == |
2008年7月16日 (三) 11:03的最新版本
描述[ ]
为标了页数的文章显示网页链接(例如,includes the <!--nextpage-->
Quicktag一次或者更多的几次)。这与link_pages()的运行方式基本相同,不同点在于参数是以查询字符串的形式出现的。标签必须在The_Loop内部。
用法[ ]
%%% <?php wp_link_pages('arguments'); ?> %%%
例子[ ]
默认用法[ ]
默认显示网页链接,网页链接的前后都有段落标签,使用上一页 和下一页,并将这些网页标号为第 1页,第 2页等等。
<?php wp_link_pages(); ?>
段落标签中的网页链接[ ]
显示由段落标签包围的网页链接。
<?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?>
DIV中的网页链接[ ]
在DIV中为CSS reference显示网页链接<div id="page-links">。
<?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?>
参数[ ]
- before
- (string) 所有的链接之前放置的文本。默认为<p>Pages:。
- after
- (string) 所有的链接之后放置的文本。默认为</p>。
- next_or_number
- (string) 暗示是否会用到网页数字。有效的参数值是:
- number (Default)
- next (在 WordPress 1.5 或者以后的版本中有效)
- nextpagelink
- (string) 链接到下一个网页的文本 。默认为下一个网页。(在WordPress1.5及以后的版本中有效)
- previouspagelink
- (string) 上一个网页链接的文本。默认为上一个网页。(在WordPress1.5及以后的版本中有效)
- pagelink
- (string) 网页数字的格式字符串。字符串中的 % % 会被数字取代,因此Page %会产生"第 1页", "第2页",等等。默认为%。
- more_file
- (string) 链接指向的而网页。默认为当前网页。