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

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

関数リファレンス/wp get attachment image src

提供: WordPress Codex 日本語版
< 関数リファレンス
2013年6月30日 (日) 12:50時点におけるDjkaz (トーク | 投稿記録)による版 (英語版をコピペ)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

Description

Returns an array with the image attributes "url", "width" and "height", of an image attachment file.
Note: For just the image src, use the first element in the returned array.

Usage

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

Parameters

$attachment_id
integer) (必須) ID of the desired attachment.
初期値: なし
$size
string/array) (optional) Size of the image shown for an image attachment: either a string keyword (thumbnail, medium, large or full) or a 2-item array representing width and height in pixels, e.g. array(32,32). As of Version 2.5, this parameter does not affect the size of media icons, which are always shown at their original size.
初期値: thumbnail
$icon
bool) (optional) Use a media icon to represent the attachment.
初期値: false

Return Value

(array)
An array containing:
  • [0] => url
  • [1] => width
  • [2] => height

or false, if no image is available.

Examples

Default Usage

<?php 
$attachment_id = 8; // attachment ID

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

Change Icon Directory

WordPress can use media icons to represent attachment files on your blog and in the Admin interface, if those icons are available. For images it returns the thumbnail. For other media types It looks for image files named by media type (e.g. audio.jpg) in the directory: wp-includes/images/crystal/.

This example shows how you can change this directory to a folder called "images" in your theme: wp-content/themes/yourtheme/images. Create the folder and put the "media type images" in there. To tell WordPress the directory has changed put this in the current theme's functions.php file:

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'; 
}

Show the first image of the post

find the full code here get_children().

Change Log

Since: 2.5.0

Source File

wp_get_attachment_image_src() is located in wp-includes/media.php.

Description

Returns an array with the image attributes "url", "width" and "height", of an image attachment file.
Note: For just the image src, use the first element in the returned array.

Usage

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

Parameters

$attachment_id
integer) (必須) ID of the desired attachment.
初期値: なし
$size
string/array) (optional) Size of the image shown for an image attachment: either a string keyword (thumbnail, medium, large or full) or a 2-item array representing width and height in pixels, e.g. array(32,32). As of Version 2.5, this parameter does not affect the size of media icons, which are always shown at their original size.
初期値: thumbnail
$icon
bool) (optional) Use a media icon to represent the attachment.
初期値: false

Return Value

(array)
An array containing:
  • [0] => url
  • [1] => width
  • [2] => height

or false, if no image is available.

Examples

Default Usage

<?php 
$attachment_id = 8; // attachment ID

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

Change Icon Directory

WordPress can use media icons to represent attachment files on your blog and in the Admin interface, if those icons are available. For images it returns the thumbnail. For other media types It looks for image files named by media type (e.g. audio.jpg) in the directory: wp-includes/images/crystal/.

This example shows how you can change this directory to a folder called "images" in your theme: wp-content/themes/yourtheme/images. Create the folder and put the "media type images" in there. To tell WordPress the directory has changed put this in the current theme's functions.php file:

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'; 
}

Show the first image of the post

find the full code here get_children().

Change Log

Since: 2.5.0

Source File

wp_get_attachment_image_src() is located in 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最新版との差分


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