wp_get_attachment_image_sizes()

Примеры использования

Получение значения атрибута ‘sizes’ для изображения

/**
 * Retrieves the value for an image attachment’s ‘sizes’ attribute.
 *
 * @param int $attachment_id Required. Image attachment ID.
 * @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order). Default 'medium'.
 * @param array $image_meta Optional. The image meta data as returned by 'wp_get_attachment_metadata()'. Default: null.
 * @return string|false A valid source size value for use in a 'sizes' attribute or false.
 */
function get_attachment_sizes( $attachment_id, $size = 'medium', $image_meta = null ) {
    $sizes = wp_get_attachment_image_sizes( $attachment_id, $size, $image_meta );
    return $sizes;
}
// Example usage
$attachment_id = 123;
$sizes = get_attachment_sizes( $attachment_id );
echo $sizes;

Результат:

"(max-width: 300px) 100vw, 300px"

Функция wp_get_attachment_image_sizes() возвращает значение атрибута ‘sizes’ для указанного изображения. В примере выше, функция get_attachment_sizes() принимает ID изображения и возвращает значение атрибута ‘sizes’ для него. Значение атрибута ‘sizes’ представляет собой строку, содержащую медиа-запрос и ширину изображения. В данном случае, значение атрибута ‘sizes’ равно «(max-width: 300px) 100vw, 300px», что означает, что изображение будет отображаться на экранах с максимальной шириной 300 пикселей, занимая 100% ширины экрана, и имея фиксированную ширину 300 пикселей.

Определение размера изображения

/**
 * Retrieves the value for an image attachment’s ‘sizes’ attribute.
 *
 * @param int $attachment_id Required. Image attachment ID.
 * @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order). Default 'medium'.
 * @param array $image_meta Optional. The image meta data as returned by 'wp_get_attachment_metadata()'. Default: null.
 * @return string|false A valid source size value for use in a 'sizes' attribute or false.
 */
function get_attachment_sizes( $attachment_id, $size = 'medium', $image_meta = null ) {
    $sizes = wp_get_attachment_image_sizes( $attachment_id, $size, $image_meta );
    return $sizes;
}
// Example usage
$attachment_id = 123;
$size = array( 600, 400 );
$sizes = get_attachment_sizes( $attachment_id, $size );
echo $sizes;

Результат:

"(max-width: 600px) 100vw, 600px"

Функция wp_get_attachment_image_sizes() также позволяет определить размер изображения, указав массив с шириной и высотой в пикселях в качестве значения параметра $size. В примере выше, функция get_attachment_sizes() принимает ID изображения и массив с размером 600×400 пикселей и возвращает значение атрибута ‘sizes’ для него. Значение атрибута ‘sizes’ равно «(max-width: 600px) 100vw, 600px», что означает, что изображение будет отображаться на экранах с максимальной шириной 600 пикселей, занимая 100% ширины экрана, и имея фиксированную ширину 600 пикселей.

Использование регистрированных размеров изображений

/**
 * Retrieves the value for an image attachment’s ‘sizes’ attribute.
 *
 * @param int $attachment_id Required. Image attachment ID.
 * @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order). Default 'medium'.
 * @param array $image_meta Optional. The image meta data as returned by 'wp_get_attachment_metadata()'. Default: null.
 * @return string|false A valid source size value for use in a 'sizes' attribute or false.
 */
function get_attachment_sizes( $attachment_id, $size = 'medium', $image_meta = null ) {
    $sizes = wp_get_attachment_image_sizes( $attachment_id, $size, $image_meta );
    return $sizes;
}
// Example usage
$attachment_id = 123;
$size = 'thumbnail';
$sizes = get_attachment_sizes( $attachment_id, $size );
echo $sizes;

Результат:

"(max-width: 150px) 100vw, 150px"

Функция wp_get_attachment_image_sizes() также позволяет использовать зарегистрированные размеры изображений в качестве значения параметра $size. В примере выше, функция get_attachment_sizes() принимает ID изображения и имя зарегистрированного размера изображения «thumbnail» и возвращает значение атрибута ‘sizes’ для него. Значение атрибута ‘sizes’ равно «(max-width: 150px) 100vw, 150px», что означает, что изображение будет отображаться на экранах с максимальной шириной 150 пикселей, занимая 100% ширины экрана, и имея фиксированную ширину 150 пикселей.

Получение значения ‘sizes’ атрибута для нескольких изображений

/**
 * Retrieves the value for an image attachment’s ‘sizes’ attribute.
 *
 * @param int $attachment_id Required. Image attachment ID.
 * @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order). Default 'medium'.
 * @param array $image_meta Optional. The image meta data as returned by 'wp_get_attachment_metadata()'. Default: null.
 * @return string|false A valid source size value for use in a 'sizes' attribute or false.
 */
function get_attachment_sizes( $attachment_id, $size = 'medium', $image_meta = null ) {
    $sizes = wp_get_attachment_image_sizes( $attachment_id, $size, $image_meta );
    return $sizes;
}
// Example usage
$attachment_ids = array( 123, 456, 789 );
$size = 'large';
foreach ( $attachment_ids as $attachment_id ) {
    $sizes = get_attachment_sizes( $attachment_id, $size );
    echo $sizes . "n";
}

Результат:

"(max-width: 1024px) 100vw, 1024px"
"(max-width: 1024px) 100vw, 1024px"
"(max-width: 1024px) 100vw, 1024px"

Функция wp_get_attachment_image_sizes() также может быть использована для получения значения атрибута ‘sizes’ для нескольких изображений. В примере выше, функция get_attachment_sizes() принимает массив с ID изображений и имя зарегистрированного размера изображения «large» и возвращает значения атрибута ‘sizes’ для каждого изображения. Значения атрибута ‘sizes’ равны «(max-width: 1024px) 100vw, 1024px», что означает, что каждое изображение будет отображаться на экранах с максимальной шириной 1024 пикселей, занимая 100% ширины экрана, и имея фиксированную ширину 1024 пикселей.

Изменение значения ‘sizes’ атрибута для изображения

/**
 * Retrieves the value for an image attachment’s ‘sizes’ attribute.
 *
 * @param int $attachment_id Required. Image attachment ID.
 * @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order). Default 'medium'.
 * @param array $image_meta Optional. The image meta data as returned by 'wp_get_attachment_metadata()'. Default: null.
 * @return string|false A valid source size value for use in a 'sizes' attribute or false.
 */
function get_attachment_sizes( $attachment_id, $size = 'medium', $image_meta = null ) {
    $sizes = wp_get_attachment_image_sizes( $attachment_id, $size, $image_meta );
    return $sizes;
}
// Example usage
$attachment_id = 123;
$size = 'medium';
$image_meta = array(
    'sizes' => array(
        'medium' => array(
            'file' => 'image-300x200.jpg',
            'width' => 300,
            'height' => 200,
            'mime-type' => 'image/jpeg',
        ),
        'large' => array(
            'file' => 'image-1024x768.jpg',
            'width' => 1024,
            'height' => 768,
            'mime-type' => 'image/jpeg',
        ),
    ),
);
$sizes = get_attachment_sizes( $attachment_id, $size, $image_meta );
echo $sizes;

Результат:

"(max-width: 300px) 100vw, 300px"

Функция wp_get_attachment_image_sizes() также может быть использована для изменения значения атрибута ‘sizes’ для изображения. В примере выше, функция get_attachment_sizes() принимает ID изображения, имя зарегистрированного размера изображения «medium» и массив с метаданными изображения, включая размеры изображений. Значение атрибута ‘sizes’ равно «(max-width: 300px) 100vw, 300px», что означает, что изображение будет отображаться на экранах с максимальной шириной 300 пикселей, занимая 100% ширины экрана, и имея фиксированную ширину 300 пикселей.