W3cubDocs

/WordPress

next_image_link( string|array $size = 'thumbnail', string $text = false )

Displays next image link that has the same post parent.

Description

See also

Parameters

$size

(string|array) (Optional) Image size. Accepts any valid image size, an array of width and height values in pixels (in that order), 0, or 'none'. 0 or 'none' will default to 'post_title' or $text.

Default value: 'thumbnail'

$text

(string) (Optional) Link text.

Default value: false

More Information

  • Whenever a series of images are linked to the attachment page, it will put a ‘next image link’ with the images when viewed in the attachment page.
  • Typically uses in attachment.php. In the WordPress default theme Twenty Eleven and Twenty Twelve, it is used in image.php. 
    next_image_link( $size, $text );

Source

File: wp-includes/media.php 

function next_image_link( $size = 'thumbnail', $text = false ) {
	adjacent_image_link( false, $size, $text );
}

Uses

Uses Description
wp-includes/media.php: adjacent_image_link()

Displays next or previous image link that has the same post parent.

Changelog

Version Description
2.5.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/next_image_link