# 标签插件(Tag)
标签插件帮助开发者在文章中快速插入内容。
## 概要
```
hexo.extend.tag.register(name, functionargs, content{}, options);
```
标签函数会传入两个参数:`args` 和 `content`,前者代表开发者在使用标签插件时传入的参数,而后者则是标签插件所覆盖的内容。
从 Hexo 3 开始,因为新增了非同步渲染功能,而改用 [Nunjucks](http://mozilla.github.io/nunjucks/) 作为渲染引擎,其行为可能会与过去使用的 [Swig](http://paularmstrong.github.io/swig/) 有些许差异。
## 选项
### ends
使用结束标签,此选项默认为 `false`。
### async
开启非同步模式,此选项默认为 `false`。
## 范例
### 没有结束标签
插入 Youtube 影片。
```
hexo.extend.tag.register('youtube'functionargs{ var0
return'<div class="video-container"><iframe width="560" height="315" src="http://www.youtube.com/embed/''" frameborder="0" allowfullscreen></iframe></div>'
});
```
### 有结束标签
插入 pull quote。
```
hexo.extend.tag.register('pullquote'functionargs, content{ var' '
return'<blockquote class="pullquote''">''</blockquote>'
}, {ends: true
```
### 非同步渲染
插入文件。
```
varrequire'hexo-fs'
varrequire'path'
hexo.extend.tag.register('include_code'functionargs{ var0
var
returnfunctioncontent{ return'<pre><code>''</code></pre>'
});}, {asynctrue
```
- 文档
- 开始使用
- 概述
- 建站
- 配置
- 指令
- 迁移
- 基本操作
- 写作
- Front-matter
- 标签插件(Tag Plugins)
- 资源文件夹
- 数据文件
- 服务器
- 生成文件
- 部署
- 自定义
- 永久链接(Permalinks)
- 主题
- 模版
- 变量
- 辅助函数(Helpers)
- 国际化(i18n)
- 插件
- 其他
- 问题解答
- 贡献
- API
- 核心
- 概述
- 事件
- 局部变量
- 路由
- Box
- 渲染
- 文章
- 脚手架(Scaffold)
- 主题
- 扩展
- 控制台(Console)
- 部署器(Deployer)
- 过滤器(Filter)
- 生成器(Generator)
- 辅助函数(Helper)
- 迁移器(Migrator)
- 处理器(Processor)
- 渲染引擎(Renderer)
- 标签插件(Tag)