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

「関数リファレンス/image downsize」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(英語版をコピペ。)
 
(中サイズの添付画像を選択する機能)
 
(他の1人の利用者による、間の1版が非表示)
1行目: 1行目:
{{Languages|
+
<div id="Description">
{{en|Function Reference/image downsize}}
+
== 説明 ==
{{ja|Function Reference/image downsize}}
+
</div>
}}
+
画像の大きさを特定のもの (<code>'thumb'</code> や <code>'medium'</code>等) へフィットさせる関数です。
== Description ==
+
  
Scale an image to fit a particular size (such as <code>'thumb'</code> or <code>'medium'</code>).
+
[[Function_Reference/add_image_size#Reserved_Image_Size_Names|予約語]]の<code>$max_/$min_width</code> は常に管理画面の「設定」→「メディア」で定義されたものです。これについては、[[image_constrain_size_for_editor#Description|image_constrain_size_for_editor()]] に詳しく書かれています。
  
The <code>$max_/$min_width</code> for the [http://codex.wordpress.org/Function_Reference/add_image_size#Reserved_Image_Size_Names Reserved Names] will always be what you defined under "admin UI" » "Settings" » "Media". You may go and blame the internals of [http://codex.wordpress.org/Function_Reference/image_constrain_size_for_editor#Description image_constrain_size_for_editor()] for it.
+
<div id="Parameters">
 
+
== パラメータ ==
== Parameters ==
+
</div>
 
+
{{Parameter|$id|integer|画像のID}}
;'''$id'''
+
{{Parameter|$size|string|画像のサイズ。<tt> thumbnail </tt> または <tt> medium </tt>。|optional|medium}}
:(integer) The ID of the image. Required.
+
 
+
;'''$size'''
+
:(string) Size of image, can be 'thumbnail' or 'medium'. Default is 'medium'.
+
 
+
== Returns ==
+
 
+
:(bool|array) False on failure, array on success. Array with image url, width, height, and whether is intermediate size, in that order is returned on success is returned. <tt>$is_intermediate</tt> is <tt>true</tt> if <tt>$url</tt> is a resized image, false if it is the original.
+
 
+
== Defined ==
+
  
 +
<div id="Return_value">
 +
== 戻り値 ==
 +
</div>
 +
:失敗の場合は <tt>False</tt> を、成功の場合は文字列を返します。文字列は画像のURL、幅、高さ、中間サイズであるか否か (<tt>$is_intermediate</tt>) の順番で構成されます。もし画像のURLがリサイズされたモノであった場合、 <tt>$is_intermediate</tt> が <tt>true</tt> に、オリジナルサイズの場合は <tt>false</tt> になります。
  
 +
<div id="Source_file">
 +
== ソースファイル ==
 +
</div>
 
<tt>image_downsize()</tt> is located in {{Trac|wp-includes/media.php}}.
 
<tt>image_downsize()</tt> is located in {{Trac|wp-includes/media.php}}.
  
[[Category:Functions]]
+
<div id="Examples">
[[Category:New_page_created]]
+
== 用例 ==
 +
</div>
  
== Examples ==
+
<div id="Add a function to select medium attachment images">
 +
=== 中サイズの添付画像を選択する機能 ===
 +
</div>
 +
<tt>wp_get_attachment_thumb_url();</tt> についてすでにご存知かと思います。ここでは中サイズの添付画像を選択するにはどうすればよいのかをお見せしましょう。
  
 
=== Add a function to select medium attachment images ===
 
 
Maybe you already know <tt>wp_get_attachment_thumb_url();</tt>. Now I'm showing how to do the same thing to return the url for the medium sized attachment.
 
 
<pre>
 
<pre>
 
function wp_get_attachment_medium_url( $id )
 
function wp_get_attachment_medium_url( $id )
45行目: 41行目:
 
</pre>
 
</pre>
  
<tt>$id</tt> is the ID of the attachment
+
<tt>$id</tt> は添付のIDです。
  
This can be really useful for plugins like WP-Choose-Thumb. With this function you can get the medium sized previews.
+
WP-Choose-Thumbのようなプラグインには便利な機能です。この機能を用いれば、中サイズのプレビューを得ることが出来るでしょう。
  
{{原文|Function Reference/image downsize|133130}}<!-- 11:23, 14 July 2013 Djkaz  -->
+
{{原文|Function Reference/image downsize|133133}}<!--   12:39, 14 July 2013 Djkaz  -->
  
 
{{Tag Footer}}
 
{{Tag Footer}}
 
[[Category:Functions]]
 

2015年5月18日 (月) 09:05時点における最新版

画像の大きさを特定のもの ('thumb''medium'等) へフィットさせる関数です。

予約語$max_/$min_width は常に管理画面の「設定」→「メディア」で定義されたものです。これについては、image_constrain_size_for_editor() に詳しく書かれています。

パラメータ

$id
integer) (必須) 画像のID
初期値: なし
$size
string) (optional) 画像のサイズ。 thumbnail または medium
初期値: medium

戻り値

失敗の場合は False を、成功の場合は文字列を返します。文字列は画像のURL、幅、高さ、中間サイズであるか否か ($is_intermediate) の順番で構成されます。もし画像のURLがリサイズされたモノであった場合、 $is_intermediatetrue に、オリジナルサイズの場合は false になります。

ソースファイル

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

用例

中サイズの添付画像を選択する機能

wp_get_attachment_thumb_url(); についてすでにご存知かと思います。ここでは中サイズの添付画像を選択するにはどうすればよいのかをお見せしましょう。

function wp_get_attachment_medium_url( $id )
{
    $medium_array = image_downsize( $id, 'medium' );
    $medium_path = $medium_array[0];

    return $medium_path;
}

$id は添付のIDです。

WP-Choose-Thumbのようなプラグインには便利な機能です。この機能を用いれば、中サイズのプレビューを得ることが出来るでしょう。

最新英語版: WordPress Codex » Function Reference/image downsize最新版との差分


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