API 参考 - Handlebars 运行时

优质

小牛编辑

132浏览

2023-12-01

`Handlebars.registerPartial(name, partial)`

注册可以被当前环境内任意模版访问的代码片段。

Handlebars.registerPartial("foo", partial);

同时支持一次性注册多个代码片段。

Handlebars.registerPartial({ foo: partial, bar: partial });

如果导入整个库，代码片段的值可能是按需编译的字符串。如果只是在运行时导入，代码片段必须为通过 Handlebars.template 预编译过的模版。

注销之前注册过的代码片段。

Handlebars.unregisterPartial("foo");

注册可以被当前环境中任意模版访问的助手代码。

Handlebars.registerHelper("foo", function() {});

支持同时注册多个助手代码。

Handlebars.registerHelper({ foo: function() {}, bar: function() {} });

注销之前的注册的助手代码。

Handlebars.unregisterHelper("foo");

弃用警告

自定义装饰器已经被废弃，并且可能会在 Handlebars 的下个主要版本消失。自定义装饰器关联了非常多的内部 API，而这会对导入其他语言造成不便，并且代码也变得难以维护。

注册一个可以被环境内任意模版访问的装饰器。

Handlebars.registerDecorator("foo", function() {});

支持同时注册多个装饰器。

Handlebars.registerDecorator({ foo: function() {}, bar: function() {} });

注销一个之前注册的装饰器。

Handlebars.unregisterDecorator("foo");

创建一个独立的 Handlebars 环境。

var OtherHandlebars = Handlebars.create();

每个环境都有它独立的助手代码和代码片段。本函数只在需要独立的助手代码或代码片段时有用。通常来说，Handlebars 环境已经足够。

在当前环境中创建的模版属于当前环境。这意味着如果想要在多个环境中运行当前模版，必须用 Handlebars.template 对每个环境重新编译或重新构造。以上描述对于代码片段也是一样的。

从全局命名域中删除当前的 Handlebars 实例，重置全局 Handlebars 变量。

var myHandlebars = Handlebars.noConflict();

允许在无视版本冲突的情况下同时应用独立版本的库。