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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(英語版をコピペ)
 
(関連資料: 最新のマージ)
 
(3人の利用者による、間の3版が非表示)
1行目: 1行目:
== Description ==
+
<div id="Description">
Outputs an HTML hyperlink to an [[Using_Image_and_File_Attachments|attachment]] file or page, containing either
+
== 説明 ==
# A full size image or thumbnail for image attachments; or
+
</div>
# The attachment's title (as text) for non image attachments
+
以下のいずれかを含んだ、[[Using_Image_and_File_Attachments|添付]] ファイルまたはページへのHTMLリンクを返す関数です。
  
If no attachment can be found, the function displays the string <tt>Missing Attachment</tt>.
+
# 画像の場合、フルサイズ画像またはサムネイル。
 +
# 画像以外の場合は、テキストで添付のタイトル。
  
== Usage ==
+
そのような添付が存在しない場合、関数は <tt>Missing Attachment</tt> の文字列を返します。
  
%%%<?php the_attachment_link( $id, $fullsize, $deprecated, $permalink ); ?>%%%
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
 +
<?php the_attachment_link( $id, $fullsize, $deprecated, $permalink ); ?>
  
== Default Usage ==
+
<div id="Default_usage">
+
== デフォルトの使い方 ==
 +
</div>
 
  <?php the_attachment_link( 7 ); ?>
 
  <?php the_attachment_link( 7 ); ?>
  
== Parameters ==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
{{Parameter|$id|整数|所望する添付のID。|Optional|[[ループ]] で使われる場合は、現状の投稿ID。(添付だけを表示するループである必要があります)}}
 +
{{Parameter|fullsize|boolean|画像の場合、オリジナルの画像 (<var>true</var>) またはWordPressが生成したサムネイル (<var>false</var>)。もし <var>false</var> にセットされながらもサムネイルが見つからなかった場合は、フルサイズの画像が代わりに用いられます。|オプション|'False'}}
  
{{Parameter|$id|integer|ID of the desired attachment.|Optional|The current post ID, when used in [[The Loop]] (Must be a loop showing only attachments).}}
+
{{Parameter|$max_dims|配列|イメージもしくはアイコンの縦横最大値。関数によって出力されたイメージエレメント (<tt>img</tt>) <var>width</var> <var>height</var> に適用されます。アスペクト比は保たれます。|[[Version 2.3]]にて廃止されました。|not used}}
{{Parameter|fullsize|boolean|For an image attachment, use the original image (<var>true</var>) or Wordpress-generated thumbnail (<var>false</var>). If set to <var>false</var> and the thumbnail can't be found, the full-size image may be used instead. |Optional|'False'}}
+
{{Parameter|$permalink|boolean|添付ファイルもしくは画像への直リンク (<tt>Default</tt>)、または添付ページヘのリンク。|オプション|'False'}}
:* <tt>1 (True)</tt>  
+
:* <tt>0 (False)</tt> - Default
+
{{Parameter|$max_dims|array|Maximum width and height of the image or icon, applied to the <var>width</var> and <var>height</var> attributes of the image element (<tt>img</tt>) output by the function. The aspect ratio is kept constant|Deprecated parameter since [[Version 2.3]]|not used}}
+
{{Parameter|$permalink|boolean|Link directly to the attachment file/image (<tt>Default</tt>), or to the attachment page. |Optional|'False'}}
+
:* <tt>1 (True)</tt>
+
:* <tt>0 (False)</tt> - Default
+
  
==Examples==
+
 
 +
<div id="Examples">
 +
 
 +
== 用例 ==
 +
</div>
 
<pre><?php
 
<pre><?php
  
// Show an image at full size linked to the attachment file
+
// フルサイズ画像への直リンクを表す。
 
the_attachment_link( 4, true );
 
the_attachment_link( 4, true );
  
// Show a thumbnail linked to the attachment page
+
// 添付ページヘのサムネイルリンクを表す。
 
the_attachment_link( 4, false, false, true );
 
the_attachment_link( 4, false, false, true );
  
 
?></pre>
 
?></pre>
  
== Notes ==
+
<div id="Notes">
 +
== 注釈 ==
 +
</div>
 +
画像ではなくリンクだけが欲しい場合は、 [[Function Reference/wp_get_attachment_link|wp_get_attachment_link()]] を用いてください。
  
Use [[Function Reference/wp_get_attachment_link|wp_get_attachment_link()]] instead if you just want to get the hyperlink, not print it.
+
<div id="Change_log">
 +
== 変更履歴 ==
 +
</div>
 +
2.0.0にて導入されました。
  
== Change Log ==
+
<div id="Source_file">
Since: 2.0.0
+
== ソースファイル ==
 +
</div>
 +
<tt>the_attachment_link()</tt> は {{Trac|wp-includes/post-template.php}} にあります。
  
== Source File ==
+
<div id="Related">
 
+
== 関連資料 ==
<tt>the_attachment_link()</tt> is located in {{Trac|wp-includes/post-template.php|tags/3.4.2|1123}}.
+
</div>
 
+
== Related ==
+
 
{{Attachment Tags}}
 
{{Attachment Tags}}
  
[[Category:Attachments]]
+
{{原文|Function Reference/the attachment link|138148}}<!-- 14:14, 17 November 2013‎ Mistercat -->
[[Category:Template_Tags]]
+
 
 +
{{DEFAULTSORT:The_attachment_link}}
 +
[[Category:添付ファイル]]

2015年6月17日 (水) 10:43時点における最新版

以下のいずれかを含んだ、添付 ファイルまたはページへのHTMLリンクを返す関数です。

  1. 画像の場合、フルサイズ画像またはサムネイル。
  2. 画像以外の場合は、テキストで添付のタイトル。

そのような添付が存在しない場合、関数は Missing Attachment の文字列を返します。

使い方

<?php the_attachment_link( $id, $fullsize, $deprecated, $permalink ); ?>

デフォルトの使い方

<?php the_attachment_link( 7 ); ?>

パラメータ

$id
整数) (Optional) 所望する添付のID。
初期値: ループ で使われる場合は、現状の投稿ID。(添付だけを表示するループである必要があります)
fullsize
boolean) (オプション) 画像の場合、オリジナルの画像 (true) またはWordPressが生成したサムネイル (false)。もし false にセットされながらもサムネイルが見つからなかった場合は、フルサイズの画像が代わりに用いられます。
初期値: 'False'
$max_dims
配列) (Version 2.3にて廃止されました。) イメージもしくはアイコンの縦横最大値。関数によって出力されたイメージエレメント (img) の widthheight に適用されます。アスペクト比は保たれます。
初期値: not used
$permalink
boolean) (オプション) 添付ファイルもしくは画像への直リンク (Default)、または添付ページヘのリンク。
初期値: 'False'


用例

<?php

// フルサイズ画像への直リンクを表す。
the_attachment_link( 4, true );

// 添付ページヘのサムネイルリンクを表す。
the_attachment_link( 4, false, false, true );

?>

注釈

画像ではなくリンクだけが欲しい場合は、 wp_get_attachment_link() を用いてください。

変更履歴

2.0.0にて導入されました。

ソースファイル

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

添付ファイル関数: get_children(), get attached media(), the_attachment_link(), get_attachment_link(), wp_get_attachment_link(), wp_get_attachment_image(), wp_get_attachment_image_src(), wp_get_attachment_url(), wp_get_attachment_thumb_file(), wp_get_attachment_thumb_url(), is_attachment(), wp_get_attachment_metadata()


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