当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

テンプレートタグ/wp link pages

提供: WordPress Codex 日本語版
< テンプレートタグ
2010年12月21日 (火) 13:07時点におけるMizuno (トーク | 投稿記録)による版 (日本語の元記事が古いので、全面的に書き換え)

移動先: 案内検索

説明

(<!--nextpage--> Quicktag を1つ以上含む)分割された投稿でページリンクを表示します。link_pages() (廃止予定) とほぼ同様に動作しますが、引数がクエリストリングフォーマットである点が異なります。このタグは、The_Loop内で使用する必要があります。

使い方

<?php wp_link_pages( $args ); ?> 

デフォルトの使い方

<?php $args = array(
	'before'           => '<p>' . __('Pages:'),
	'after'            => '</p>',
	'link_before'      => '',
	'link_after'       => '',
	'next_or_number'   => 'number',
	'nextpagelink'     => __('Next page'),
	'previouspagelink' => __('Previous page'),
	'pagelink'         => '%',
	'more_file'        => '',
	'echo'             => 1 ); ?> 

パラメータ

before 
(文字列) リンクの前のテキスト。デフォルトは <p>Pages:
after 
(文字列) リンクの後のテキスト。デフォルトは</p>
link_before 
(文字列) リンクテキストの前のテキスト。デフォルト(blank)。 バージョン 2.7 以降。
link_after 
(文字列) リンクテキストの後のテキスト。デフォルト(blank)。 バージョン 2.7 以降。
next_or_number 
(文字列) ページ番号を使用するかどうかを指定する。有効な値は、
  • number (デフォルト)
  • next (1.5 以降で有効)
nextpagelink 
(文字列) 次のページへのリンクのテキスト。デフォルトはNext page。 (WordPress 1.5 以降で有効)
previouspagelink
(文字列) 前のページへのリンクのテキスト。デフォルトPrevious page。 (WordPress 1.5 以降で有効)
pagelink 
(文字列) ページ番号のフォーマット。文字列内の  % が番号に置き換えられる。例えばPage % は"Page 1", "Page 2", 等を生成する。デフォルトは%
more_file 
(文字列) リンクが指すページ。デフォルトは現在のページ。
echo 
(真偽値) HTML 出力する(true)か、変数として返す(false)か。デフォルトは true。有効な値は、
  • 1 (True) - デフォルト
  • 0 (False)

用例

デフォルトの使い方

デフォルトでは、ページリンクを段落(p)タグで囲い、Next pagePrevious page を仕様し、ページ番号を Page 1, Page 2 のように表示します。

<?php wp_link_pages(); ?>

段落(p)タグで囲って表示

ページリンクを段落(p)タグで囲って表示します。

<?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?>

DIV タグで囲って表示

ページリンクを DIV タグで囲い、CSS 参照用に <div id="page-links"> として表示します。

<?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?>

変更履歴

  • version 0.71から
  • 2.7 : パラメータに link_beforelink_after が追加されました。

ソースファイル

wp_link_pages()wp-includes/post-template.php にあります。


投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/wp link pages最新版との差分