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

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

「関数リファレンス/wp get attachment image src」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(optional => オプション)
(関連資料)
 
(2人の利用者による、間の3版が非表示)
24行目: 24行目:
 
== 戻り値 ==
 
== 戻り値 ==
 
</div>
 
</div>
; (配列): 配列は以下を含みます:
+
{{Return||配列|配列は以下を含みます:}}
 
* [0] => url
 
* [0] => url
 
* [1] => width
 
* [1] => width
30行目: 30行目:
 
* [3] => 真偽値: リサイズされいている場合は true、元のサイズの場合は false
 
* [3] => 真偽値: リサイズされいている場合は true、元のサイズの場合は false
  
画像でない場合は、 <tt>false</tt> を返します。
+
{{Return||true/false|画像でない場合は、 <tt>false</tt> を返します。}}
 +
 
  
 
<div id="Examples">
 
<div id="Examples">
 +
 
== 用例 ==
 
== 用例 ==
 
</div>
 
</div>
38行目: 40行目:
 
=== デフォルトの使い方 ===
 
=== デフォルトの使い方 ===
 
</div>
 
</div>
 +
 
<pre><?php  
 
<pre><?php  
 
$attachment_id = 8; // 添付ID
 
$attachment_id = 8; // 添付ID
  
$image_attributes = wp_get_attachment_image_src( $attachment_id ); // 配列を返す
+
$image_attributes = wp_get_attachment_image_src( $attachment_id ); // returns an array
 +
if( $image_attributes ) {
 
?>  
 
?>  
+
<img src="<?php echo $image_attributes[0]; ?>" width="<?php echo $image_attributes[1]; ?>" height="<?php echo $image_attributes[2]; ?>">
<img src="<?php echo $image_attributes[0]; ?>" width="<?php echo $image_attributes[1]; ?>" height="<?php echo $image_attributes[2]; ?>"></pre>
+
<?php } ?></pre>
  
 
<div id="Change Icon Directory">
 
<div id="Change Icon Directory">
 +
 
=== アイコンディレクトリを変更する ===
 
=== アイコンディレクトリを変更する ===
 
</div>
 
</div>
83行目: 88行目:
 
== 関連資料 ==
 
== 関連資料 ==
 
</div>
 
</div>
{{Attachment Tags}}
 
{{原文|Function Reference/wp get attachment image src|133178}}<!--  21:33, 15 July 2013  Here  -->
 
  
 +
{{Attachment Tags}}
 
{{Tag Footer}}
 
{{Tag Footer}}
  
[[Category:Functions]]
+
{{原文|Function Reference/wp get attachment image src|152007}}<!--  16:34, 10 June 2015‎ Ninnypants    -->
[[Category:New page created]]
+
 
 +
{{DEFAULTSORT:Wp_get_attachment_image_src}}
 +
[[Category:添付ファイル]]

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

添付された画像ファイルの"url"、"width"、"height"属性を配列として返す関数です。
注: 画像ソースのみの場合は、一番最初のエレメントを使ってください。

使い方

<?php wp_get_attachment_image_src( $attachment_id, $size, $icon ); ?>


パラメータ

$attachment_id
整数) (必須) 所望する添付のID
初期値: なし
$size
文字列/配列) (オプション) 画像の大きさ。キーワードとなる文字列 (thumbnail, medium, large, full)または2つのアイテムを持つ配列が幅と高さをピクセルで、array(32,32)という形で表します。Version 2.5以降、このパラメーターはメディアアイコンの大きさを変えることができなくなりました。これは常に元の大きさで表示されるためです。
初期値: thumbnail
$icon
真偽値) (オプション) 添付を表すメディアアイコンを使用する。
初期値: false

戻り値

(配列) 
配列は以下を含みます:
  • [0] => url
  • [1] => width
  • [2] => height
  • [3] => 真偽値: リサイズされいている場合は true、元のサイズの場合は false
(true/false) 
画像でない場合は、 false を返します。


用例

デフォルトの使い方

<?php 
$attachment_id = 8; // 添付ID

$image_attributes = wp_get_attachment_image_src( $attachment_id ); // returns an array
if( $image_attributes ) {
?> 
<img src="<?php echo $image_attributes[0]; ?>" width="<?php echo $image_attributes[1]; ?>" height="<?php echo $image_attributes[2]; ?>">
<?php } ?>

アイコンディレクトリを変更する

WordPressはブログや管理インターフェイス上で、メディアアイコンを使って添付ファイルを表すことができます。画像の場合はサムネイルが表示されますが、その他のメディアタイプはその種類の名前がついたイメージファイル (例: audio.jpg) を wp-includes/images/crystal/ ディレクトリから検索します。

この例は、先のディレクトリをどのように"images"フォルダーへ変更するのかという手順を、wp-content/themes/yourtheme/imagesというテーマを例に説明しています。フォルダを作成し、 "media type images" を記載してください。WordPressにディレクトリが変更したことを通知するためには、使用中であるテーマの functions.php ファイルにこれを書き込んでください。

add_filter( 'icon_dir', 'my_theme_icon_directory' );
add_filter( 'icon_dir_uri', 'my_theme_icon_uri' );

function my_theme_icon_directory( $icon_dir ) {
	return get_stylesheet_directory() . '/images';
}

function my_theme_icon_uri( $icon_dir ) {
	return get_stylesheet_directory_uri() . '/images'; 
}

投稿最初の画像を表示する

関数リファレンス/get_children()を参照してください。

変更履歴

2.5.0で導入されました。

ソースファイル

wp_get_attachment_image_src()wp-includes/media.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/wp get attachment image src最新版との差分