• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。（詳細）

【このWikiはいつでも誰でも編集できます】

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

提供: WordPress Codex 日本語版
移動先: 案内、 検索
(英語版をコピペ)
 
(和訳完了。)
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">
−
 
+
== パラメータ ==
−
{{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).}}
+
</div>
−
{{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|$id|整数|所望する添付のID。|Optional|[[ループ]] で使われる場合は、現状の投稿ID。(添付だけを表示するループである必要があります)}}
 +
{{Parameter|fullsize|boolean|画像の場合、オリジナルの画像 (<var>true</var>) またはWordPressが生成したサムネイル (<var>false</var>)。もし <var>false</var> にセットされながらもサムネイルが見つからなかった場合は、フルサイズの画像が代わりに用いられます。|Optional|'False'}}
 
:* <tt>1 (True)</tt>  
 
:* <tt>1 (True)</tt>  
−
:* <tt>0 (False)</tt> - Default
+
:* <tt>0 (False)</tt> - デフォルト
−
{{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|$max_dims|配列|イメージもしくはアイコンの縦横最大値。関数によって出力されたイメージエレメント (<tt>img</tt>) の <var>width</var> と <var>height</var> に適用されます。アスペクト比は保たれます。|[[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'}}
+
{{Parameter|$permalink|boolean|添付ファイルもしくは画像への直リンク (<tt>Default</tt>)、または添付ページヘのリンク。|Optional|'False'}}
 
:* <tt>1 (True)</tt>  
 
:* <tt>1 (True)</tt>  
−
:* <tt>0 (False)</tt> - Default
+
:* <tt>0 (False)</tt> - デフォルト
  
−
==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">
−
 
+
== 注釈 ==
−
Use [[Function Reference/wp_get_attachment_link|wp_get_attachment_link()]] instead if you just want to get the hyperlink, not print it.
+
</div>
−
 
+
画像ではなくリンクだけが欲しい場合は、 [[Function Reference/wp_get_attachment_link|wp_get_attachment_link()]] を用いてください。
−
== Change Log ==
+
−
Since: 2.0.0
+
  
−
== Source File ==
+
<div id="Change_log">
 +
== 変更履歴 ==
 +
</div>
 +
2.0.0にて導入されました。
  
−
<tt>the_attachment_link()</tt> is located in {{Trac|wp-includes/post-template.php|tags/3.4.2|1123}}.
+
<div id="Source_file">
 +
== ソースファイル ==
 +
</div>
 +
<tt>the_attachment_link()</tt> は {{Trac|wp-includes/post-template.php}} にあります。
  
−
== Related ==
+
<div id="Related">
 +
== 関連資料 ==
 +
</div>
 
{{Attachment Tags}}
 
{{Attachment Tags}}
 +
{{原文|Function Reference/the attachment link|123380}}<!-- 13:57, 25 November 2012 M0r7if3r -->
  
 
[[Category:Attachments]]
 
[[Category:Attachments]]
 
[[Category:Template_Tags]]
 
[[Category:Template_Tags]]

2013年6月30日 (日) 07:00時点における版

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

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

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

使い方

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

デフォルトの使い方

<?php the_attachment_link( 7 ); ?>

パラメータ

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

「http://wpdocs.osdn.jp/wiki/index.php?title=テンプレートタグ/the_attachment_link&oldid=5596」から取得