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

「テンプレートタグ/the excerpt」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(2 版)
(テンプレートタグ/the excerpt no)
1行目: 1行目:
 
* 書式: <?php the_excerpt(); ?>  
 
* 書式: <?php the_excerpt(); ?>  
* 説明: 記事の概要を出力。画像などは取り除かれる。抜粋されずに長文となるときは[[日本語・マルチバイト特有の問題]]を参照。
+
* 説明: 記事の概要を出力。画像などは取り除かれる。
 
* 位置: ループ内
 
* 位置: ループ内
 
* 引数: なし
 
* 引数: なし
8行目: 8行目:
 
</div>
 
</div>
  
Displays the excerpt of the current post with [...] at the end, which is not a "read more" link.  If you do not provide an explicit excerpt to a post (in the post editor's optional excerpt field), the first 55 words of the post's content are used. Also in the latter case, [[用語集#HTML|HTML]] tags and graphics are stripped from the excerpt's content. This tag must be within [[The Loop]].
+
投稿の抜粋を最後に三点リーダ (…) をつけて表示します。この三点リーダは "続きを読む" リンクではありません。投稿作成/編集ページの抜粋文入力欄に抜粋を入力していない場合、投稿内容の最初の55 個の単語が使用されます。ただしこれは英語のように単語間を半角スペースで区切る言語の場合で、日本語のように半角スペースを通常使用しない言語ではすべての内容が出力されてしまうことがあります。WordPress 日本語版ではこの問題を含むマルチバイト関連の問題に対処するために [http://eastcoder.com/code/wp-multibyte-patch WP Multibyte Patch] プラグインを同梱していて、このプラグインを使用するとデフォルトでは110文字までを抜粋文として出力することができます。また、抜粋のコンテンツからは [[用語集#HTML|HTML]] タグと画像は取り除かれます。このタグは[[The Loop|ループ]]内で使用します。
  
 
<div id="Usage">
 
<div id="Usage">
24行目: 24行目:
 
</div>
 
</div>
  
Displays the post excerpt. Used on non-single/non-permalink posts as a replacement for [[テンプレートタグ/the_content|the_content()]] to force excerpts to show within the Loop.
+
投稿の抜粋を表示します。個別投稿を表示する時以外に [[テンプレートタグ/the_content|the_content()]] の代わりにループ内で強制的に抜粋を表示するときに使用します。
  
 
  <?php the_excerpt(); ?>
 
  <?php the_excerpt(); ?>
  
 
<div id="Use_with_Conditional_Tags">
 
<div id="Use_with_Conditional_Tags">
=== Use with Conditional Tags ===
+
=== 条件分岐タグとの使用 ===
 
</div>
 
</div>
  
Replaces [[テンプレートタグ/the_content|the_content()]] tag with the_excerpt() when on archive (tested by <tt>is_archive()</tt>) or category ([[Conditional Tags#カテゴリーページ|<tt>is_category()</tt>]]) pages.
+
アーカイブ (<tt>is_archive()</tt>) もしくはカテゴリー ([[Conditional Tags#カテゴリーページ|<tt>is_category()</tt>]]) ページ表示時に [[テンプレートタグ/the_content|the_content()]] タグを the_excerpt() と入れ替える。
  
Both the examples below work for versions 1.5 and above.
+
以下の例はバージョン 1.5 以上で動作する。
  
 
  <?php if(is_category() || is_archive()) {
 
  <?php if(is_category() || is_archive()) {
42行目: 42行目:
 
  } ?>
 
  } ?>
  
For versions of WordPress prior to 1.5, only the following will work :  
+
1.5 より以前のバージョンでは以下のコードで動作する :  
  
 
  <?php if($cat || $m) {
 
  <?php if($cat || $m) {
54行目: 54行目:
 
</div>
 
</div>
  
This tag has no parameters.
+
このタグはパラメータをとりません。
 +
 
 +
== the_excerpt() と the_content() の比較 ==
 +
 
 +
[[テンプレートタグ/the_content|the_content()]] 関数のみを使用したほうがいい場合もあります。[[テンプレートタグ/the_content|the_content()]] は <!--More--> タグが使用されているかどうかによって何を表示するかを決定できます。
 +
<tt><!--More--></tt> タグは投稿/ページを二つに分割して、一覧表示時このタグの前までの部分だけを表示します。
 +
単一の投稿/ページを表示するときには <tt><!--More--></tt> は (もちろん) 無視されます。
  
 
<div id="Related">
 
<div id="Related">

2008年5月31日 (土) 20:56時点における版

  • 書式: <?php the_excerpt(); ?>
  • 説明: 記事の概要を出力。画像などは取り除かれる。
  • 位置: ループ内
  • 引数: なし

投稿の抜粋を最後に三点リーダ (…) をつけて表示します。この三点リーダは "続きを読む" リンクではありません。投稿作成/編集ページの抜粋文入力欄に抜粋を入力していない場合、投稿内容の最初の55 個の単語が使用されます。ただしこれは英語のように単語間を半角スペースで区切る言語の場合で、日本語のように半角スペースを通常使用しない言語ではすべての内容が出力されてしまうことがあります。WordPress 日本語版ではこの問題を含むマルチバイト関連の問題に対処するために WP Multibyte Patch プラグインを同梱していて、このプラグインを使用するとデフォルトでは110文字までを抜粋文として出力することができます。また、抜粋のコンテンツからは HTML タグと画像は取り除かれます。このタグはループ内で使用します。

使い方

<?php the_excerpt(); ?>

用例

初期設定での使用

投稿の抜粋を表示します。個別投稿を表示する時以外に the_content() の代わりにループ内で強制的に抜粋を表示するときに使用します。

<?php the_excerpt(); ?>

条件分岐タグとの使用

アーカイブ (is_archive()) もしくはカテゴリー (is_category()) ページ表示時に the_content() タグを the_excerpt() と入れ替える。

以下の例はバージョン 1.5 以上で動作する。

<?php if(is_category() || is_archive()) {
	the_excerpt();
} else {
	the_content();
} ?>

1.5 より以前のバージョンでは以下のコードで動作する :

<?php if($cat || $m) {
	the_excerpt();
} else {
	the_content();
} ?>

パラメータ

このタグはパラメータをとりません。

the_excerpt() と the_content() の比較

the_content() 関数のみを使用したほうがいい場合もあります。the_content() は タグが使用されているかどうかによって何を表示するかを決定できます。 タグは投稿/ページを二つに分割して、一覧表示時このタグの前までの部分だけを表示します。 単一の投稿/ページを表示するときには は (もちろん) 無視されます。


投稿タグ: 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 » Template Tags/the_excerpt最新版との差分

このページ「テンプレートタグ/the excerpt」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています