## 图片
>[warning] 注意:本节介绍媒体库中图像的处理。 如果要显示位于主题目录中的图像文件,只需使用img标签指定位置,并使用CSS进行样式化。
```
<img src="<?php echo get_template_directory_uri() . '/images/logo.png'; ?>" />
```
## 获取图片代码
要在媒体库中显示图像,请使用wp_get_attachment_image()函数。
```
echo wp_get_attachment_image( $attachment->ID, 'thumbnail' );
```
您将获得具有所选缩略图大小的以下HTML输出
```
<img width="150" height="150" src="http://example.com/wordpress/wp-content/uploads/2016/11/sample-150x150.jpg" class="attachment-thumbnail size-thumbnail" ... />
```
您可以为管理屏幕中的“设置”>“媒体”中设置的尺寸或任何一对宽度和高度指定其他尺寸,例如原始图像的“full”或“medium”和“large”。 您还可以使用add_image_size()设置自定义大小的字符串;
```
echo wp_get_attachment_image( $attachment->ID, Array(640, 480) );
```
## 获取图像的URL
如果要获取图像的URL,请使用wp_get_attachment_image_src()。 如果没有图像可用,它返回一个数组(URL,width,height,is_intermediate)或false。
```
$image_attributes = wp_get_attachment_image_src( $attachment->ID );
if ( $image_attributes ) : ?>
<img src="<?php echo $image_attributes[0]; ?>" width="<?php echo $image_attributes[1]; ?>" height="<?php echo $image_attributes[2]; ?>" />
<?php endif; ?>
```
## 对齐
在您的站点中添加图像时,可以将图像对齐方式指定为右,左,中心或无。 WordPress核心自动添加CSS类来对齐图像:
- alignright
- alignleft
- aligncenter
- alignnone
这是当选择中心对齐时的采样输出
```
<img class="aligncenter size-full wp-image-131" src= ... />
```
为了利用这些CSS类用于对齐和文本换行,您的主题必须包含样式表中的样式,如主样式表文件。 您可以使用与官方主题捆绑的style.css,如Twenty Seventeen为参考。
## 标题
如果在媒体库中指定了图像图像,则HTML img元素由短代码`[caption]`和`[/ caption]`括起来。
```
<div class="mceTemp"><dl id="attachment_133" class="wp-caption aligncenter" style="width: 1210px"><dt class="wp-caption-dt"><img class="size-full wp-image-133" src="http://example.com/wordpress/wp-content/uploads/2016/11/sample.jpg" alt="sun set" width="1200" height="400" /></dt><dd class="wp-caption-dd">Sun set over the sea</dd></dl></div>
```
而且,它将像HTML代码一样呈现为图形标签:
```
<figure id="attachment_133" style="width: 1200px" class="wp-caption aligncenter">
<img class="size-full wp-image-133" src="http://example.com/wordpress/wp-content/uploads/2016/11/sample.jpg" alt="sun set" width="1200" height="400" srcset= ... />
<figcaption class="wp-caption-text">Sun set over the sea</figcaption>
</figure>
```
与排列类似,您的主题必须包含以下样式。
- wp-caption
- wp-caption-text
## 参考文献
wp_get_attachment_image()
wp_get_attachment_image_src()
- 简介
- 主题开发
- WordPress许可证
- 什么是主题
- 开发环境
- 主题开发示例
- 主题基础
- 模板文件
- 主样式表(style.css)
- 文章类型
- 规划主题文件
- 模板层级
- 模板标签
- 循环
- 主题函数
- 连接主题文件和目录
- 使用CSS和JavaScript
- 条件标签
- 类别,标签和自定义分类
- 模板文件
- 内容模板文件
- 页面模板文件
- 附件模板文件
- 自定义内容类型
- 部分和其他模板文件
- 评论模板
- 分类模板
- 404页面
- 主题功能
- 核心支持的功能
- 管理菜单
- 自定义Headers
- 自定义Logo
- 文章格式
- 置顶文章
- Sidebars
- Widgets
- 导航菜单
- 分页
- 媒体
- Audio
- Images
- Galleries
- Video
- 精选图片和缩略图
- 国际化
- 本地化
- 辅助功能
- 主题选项 – 自定义API
- 定制对象
- 改进用户体验的工具
- 定制JavaScript API
- JavaScript / Underscore.js渲染的自定义控件
- 高级用法
- 主题安全
- 数据消毒/逃避
- 数据验证
- 使用随机数
- 常见漏洞
- 高级主题
- 子主题
- UI最佳实践
- JavaScript最佳做法
- 主题单元测试
- 验证你的主题
- Plugin API Hooks
- 发布你的主题
- 所需的主题文件
- 测试
- 主题评论指南
- 写文档
- 提交你的主题到WordPress.org
- 参考文献
- 模板标签列表
- 条件标签列表
- 编码标准
- HTML编码标准
- CSS编码标准
- JavaScript编码标准
- PHP编码标准
- 插件开发
- 插件开发简介
- 什么是插件
- 插件基础
- 头部要求
- 包括软件许可证
- 启用 / 停用 Hooks
- 卸载方法
- 最佳做法
- 插件安全
- 检查用户功能
- 数据验证
- 保护输入
- 保护输出
- 随机数
- Hooks
- Actions
- Filters
- 自定义Hooks
- 高级主题
- 管理菜单
- 顶级菜单
- 子菜单
- 短代码
- 基本短码
- 封闭短码
- 带参数的短代码
- TinyMCE增强型短码
- 设置
- 设置API
- 使用设置API
- 选项API
- 自定义设置页面
- 元数据
- 管理帖子元数据
- 自定义元数据
- 渲染元数据
- 自定义文章类型
- 注册自定义文章类型
- 使用自定义文章类型
- 分类
- 使用自定义分类
- 在WP 4.2+中使用“split术语”
- 用户
- 创建和管理用户
- 使用用户元数据
- 角色和功能
- HTTP API
- JavaScript
- jQuery
- Ajax
- 服务器端PHP和入队
- Heartbeat API
- 概要
- 计划任务
- 了解WP-Cron计划
- 安排WP-Cron 事件
- 将WP-Cron挂接到系统任务计划程序中
- WP-Cron简单测试
- 国际化
- 本地化
- 如何国际化您的插件
- 国际化安全
- WordPress.org
- 详细插件指南
- 规划您的插件
- 如何使用Subversion
- 插件开发者常见问题
- 开发工具
- Debug Bar 和附加组件
- 辅助插件
- REST API手册
- 资源
- 文章
- 文章修订
- 文章类型
- 文章状态
- 类别
- 标签
- 页面
- 评论
- 分类
- 媒体
- 用户
- 设置
- 使用REST API
- 全局参数
- 分页
- 链接和嵌入
- 发现
- 认证
- 经常问的问题
- 骨干JavaScript客户端
- 客户端库
- 扩展REST API
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类