WordPress.org网站
获取WordPress
WordPress.org网站

WordPress开发人员资源

post_thumbnail（）

post缩略图(字符串|int[] $大小 = '后缩略图',字符串|数组 $属性 = ” )

在本文中

返回页首

显示文章缩略图。

描述

当主题添加“后缩略图”支持时，会注册一个特殊的“后缩略图”图像大小，这与通过“设置”>“媒体”屏幕管理的“缩略图”图像尺寸不同。

使用时post_thumbnail（）或相关功能，默认使用“后缩略图”图像大小，但可以根据需要指定不同的大小。

另请参见

参数

$大小一串|整数[]可选择的
图像大小。接受任何注册的图像大小名称，或以像素为单位的宽度和高度值数组（按此顺序）。违约'后缩略图'.

违约：'后缩略图'

$属性一串|阵列可选择的
查询字符串或属性数组。

违约：''

来源

函数the_post_thumbnail（$size='post-thumbnal'，$attr=''）{echo get_the_post_thumbnail（空，$size，$attr）；}

查看所有引用 在Trac上查看 在GitHub上查看

使用描述
get_the_post_thumbnail（）wp-includes/post-thumbnail模板.php

检索帖子缩略图。

变更日志

版本描述
2.9.0介绍。

用户贡献的笔记

  1. 跳到注释14内容
    shramee公司
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：50你必须登录才能对这个便条的帮助进行投票

    帖子缩略图大小：

    //默认WordPresspost_thumbnail（“缩略图”）；//缩略图（150 x 150硬裁剪）post_thumbnail（'中等'）；//中等分辨率（300 x 300最大高度300px）post_thumbnail（'medium_large'）；//中大型（添加在WP 4.4中）分辨率（768 x 0无限高）post_thumbnail（'large'）；//大分辨率（1024 x 1024最大高度1024px）post_thumbnail（'完整'）；//全分辨率（上传原始大小）//与WooCommerce合作post_thumbnail（'shop_thumbnail'）；//商店缩略图（180 x 180硬裁剪）post_thumbnail（'shop_catalog'）；//商店目录（300 x 300硬裁）the_post_thumbnail（'shop_single'）；//商店单间（600 x 600硬裁）

    硬裁尺寸具有固定的高度和宽度

  2. 跳到注释15内容
    绵羊60
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：31你必须登录才能对这个便条的帮助进行投票

    下面是使用数组的attr参数示例：

    the_post_tumbnail（'post-tumbnail'，['class'=>'img-responsive responsibility--full'，'title'=>'功能图像']）；

    使用数组的键和值填充不同的属性。您可以使用它将类添加到帖子缩略图中。

  3. 跳到注释16内容
    芭芭拉·福特
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：10你必须登录才能对这个便条的帮助进行投票

    发布缩略图链接到发布永久链接

    注意：不要在同一主题中同时使用这两个示例。

    示例1。要在特定循环中将帖子缩略图链接到帖子永久链接，请在主题的模板文件中使用以下内容：

    <?php if（has_post_thumbnail（））：？>“title=”<？php the_permalink（）；？>“><?php the_post_thumbnail（）；？></a><?php-endif；？>

    示例2。要将网站上的所有帖子缩略图链接到帖子固定链接，请将其放在当前主题的functions.php文件中：

    /***将所有帖子缩略图链接到帖子永久链接。**@param string$html发布缩略图html。*@param int$post_id帖子id。*@param int$post_image_id发布图像id。*@return string过滤后的图片HTML。*/函数wpdocs_post_image_html（$html，$post_id，$post-image_id）{$html='<a href=“'.get_permink（$post_id）.'”alt=“'.esc_attr（get_the_title（$post_id））.'”>'$html。'</a> '；返回$html；}add_filter（'post_thumbnail_html'，'wpdocs_post_image_html'，10，3）；
  4. 跳到注释17内容
    芭芭拉·福特
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：9你必须登录才能对这个便条的帮助进行投票

    缩略图大小

    WordPress的默认图像大小为“缩略图”、“中等”、“大”和“完整”（即您上传的图像的大小）。可以在“设置”>“媒体”下的“WordPress管理媒体”面板中配置这些图像大小。这就是如何将这些默认大小与post_thumbnail（）:

    post_thumbnail（）；//无参数-&gt；'张贴缩略图'post_thumbnail（“缩略图”）；//缩略图（默认150px x最大150px）post_thumbnail（'中等'）；//中等分辨率（默认300px x 300px max）post_thumbnail（'large'）；//大分辨率（默认640像素x 640像素最大值）post_thumbnail（'完整'）；//全分辨率（上传原始大小）post_thumbnail（数组（100100））；//其他决议

    使用以下项注册文章缩略图的新图像大小：添加图像大小（）.
    要设置文章缩略图的默认大小，请参见：set_post_thumbnail_size（）.

  5. 跳到注释18内容
    布列塔尔顿
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：5你必须登录才能对这个便条的帮助进行投票

    如果您想删除缩略图图像上“height”和“width”属性的硬编码，这通常会影响自适应/响应性/流动性CSS样式表，您可以将此片段添加到您的函数.php,

    //从图像中删除宽度和高度属性//函数remove_img_attr（$html）{return preg_replace（'/（width|height）=“\d+”\s/'，“”，$html）；}add_filter（'post_thumbnail_html'，'remove_img_attr'）；
  6. 跳到注释19内容
    芭芭拉·福特
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：4你必须登录才能对这个便条的帮助进行投票

    设置帖子缩略图的样式

    PostThumbnails被赋予一个类“wp-Post-image”，还可以根据显示的缩略图的大小获得一个类。您可以使用以下CSS选择器设置输出样式：

    img.wp-post-image（图片）img.附件-缩略图img.附件介质img.附件-大图片附件-完整

    你也可以给贴子缩略图提供他们自己的类。
    使用类“alignleft”显示文章缩略图：

    post_thumbnail（‘缩略图’，数组（‘class’=>‘alignleft’））；
  7. 跳到注释20内容
    小丑
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：4你必须登录才能对这个便条的帮助进行投票

    如果您担心大小属性对于您的使用来说太大，可以这样做：

    the_post_thumbnail（'large'，数组（'sizes'=>'（最大宽度：320px）145px，（最大宽度：425px）220px，500px'））；

    这个“大小”数组由媒体查询组成，因此第一个参数是您的媒体查询，第二个参数（如果图像的大小和宽度）应该以该viewportsize呈现。如果给定的media查询都不适用，则最后一个参数是默认大小。

    如果使用基于列的栅格，则很有用，因为在这种栅格中，您不希望在较小的视口上以100vw的速度渲染图像。

  13. 跳到注释26内容
    芭芭拉·福特
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：-1你必须登录才能对这个便条的帮助进行投票

    发布缩略图链接到大图像大小

    此示例链接到“大”Post Thumbnail图像大小，必须在the Loop中使用。

    if（has_post_thumbnail（））{$large_image_url=wp_get_attachment_image_src（get_post_thumbnail_id（），'large'）；if（！空（$large_image_url[0]）{printf（'<a href=“%1$s”alt=“%2$s”>%3$s</a>'，esc_url（$large_image_url[0]），esc_attr（get_the_title_attribute（'echo=0'）），get_the_post_thumbnail（）);}}

你必须登录在能够发表注释或反馈之前。