辅助函数(Helper)

辅助函数帮助您在模板中快速插入内容,建议您把复杂的代码放在辅助函数而非模板中。

概要

hexo.extend.helper.register(name, function(){
});

范例

hexo.extend.helper.register('js', function(path){
return '<script src="' + path + '"></script>';
});
<%- js('script.js') %>
// <script src="script.js"></script>

常见问题

定制 helper 应该放在哪里?

放置在 scripts/themes/<yourtheme>/scripts/ 目录中。

如何在我的定制 helper 中使用另外一个已经注册的 helper?

All helpers are executed in the same context. For example, to use url_for() inside a custom helper:

hexo.extend.helper.register('lorem', function(path) {
return '<script src="' + this.url_for(path) + '"></script>';
});

如何在其他插件中使用已经注册的 helper?

hexo.extend.helper.get 会返回一个指定名字的 helper,但是你还需要一个 bind(hexo),就像这样:

const url_for = hexo.extend.helper.get('url_for').bind(hexo);