本文介绍了如何在 Handlebars 模板中使用自定义助手函数，从数据集中提取指定列的唯一值。通过结合 `map` 和 `Set`，可以高效地实现数据去重，并将结果传递给 `#each` 块助手进行渲染。本文提供了详细的代码示例和解释，帮助你更好地理解和应用这一技术。
在 Handlebars 模板中，有时我们需要从数据集中提取特定列的唯一值，并将其渲染到页面上。直接使用 #each 块助手会输出所有值，包括重复项。本文将介绍如何通过自定义 Handlebars 助手函数，实现提取唯一值的功能。
核心思路
核心思路是创建一个自定义助手函数，该函数接收数据集和列名作为参数，然后：
- 使用 map 函数提取指定列的值。
- 使用 Set 数据结构去除重复项。
- 将去重后的结果返回。
- 将去重后的结果传递给 #each 块助手进行渲染。
实现步骤
下面是一个具体的实现示例：
- 注册 Handlebars 助手函数：
Handlebars.registerHelper("unique", (context, key) => {
return [...new Set(context.map(item => item[key]))];
});这段代码定义了一个名为 unique 的助手函数。它接收两个参数：
* `context`: 要处理的数据集（一个数组）。 * `key`: 要提取的列名。
函数内部，context.map(item => item[key]) 使用 map 函数遍历数据集，并提取每个对象的 key 属性值，生成一个新的数组。然后，new Set(...) 将这个数组转换为一个 Set 对象，Set 对象会自动去除重复项。最后，[...new Set(...)] 将 Set 对象转换回数组。
- 创建 Handlebars 模板：
<script src="https://cdnjs.cloudflare.com/ajax/libs/handlebars.js/4.7.7/handlebars.min.js"></script>
<div>{{#each (unique data "hostname.keyword")}}{{this}}{{/each}}</div>这个模板使用了我们刚刚注册的 unique 助手函数。{{unique data "hostname.keyword"}} 会调用 unique 函数，并将 data 数据集和 "hostname.keyword" 列名作为参数传递给它。unique 函数返回去重后的数组，然后 #each 块助手遍历这个数组，并将每个值渲染到 <div> 元素中。
- 准备数据：
const data = [
{
"hostname.keyword": "a"
},
{
"hostname.keyword": "b"
},
{
"hostname.keyword": "a"
}
];这里定义了一个包含重复数据的 data 数组。
- 编译并渲染模板：
const template = Handlebars.compile('<div>{{#each (unique data "hostname.keyword")}}{{this}}{{/each}}</div>');
const output = template({ data });
document.body.innerHTML = output;
console.log(output);这段代码首先使用 Handlebars.compile 函数编译模板，然后将 data 数据传递给编译后的模板，生成最终的 HTML 字符串。最后，将 HTML 字符串插入到 document.body 中，并打印到控制台。
完整代码示例
<!DOCTYPE html>
<html>
<head>
<title>Handlebars Unique Helper</title>
</head>
<body>
<script src="https://cdnjs.cloudflare.com/ajax/libs/handlebars.js/4.7.7/handlebars.min.js"></script>
<script>
Handlebars.registerHelper("unique", (context, key) => {
return [...new Set(context.map(item => item[key]))];
});
const template = Handlebars.compile('<div>{{#each (unique data "hostname.keyword")}}{{this}}{{/each}}</div>');
const data = [
{
"hostname.keyword": "a"
},
{
"hostname.keyword": "b"
},
{
"hostname.keyword": "a"
}
];
const output = template({ data });
document.body.innerHTML = output;
console.log(output);
</script>
</body>
</html>注意事项
- 确保引入 Handlebars 库。
- key 参数必须是字符串，并且是 context 中对象的有效属性名。
- 如果 context 中的对象缺少 key 属性，item[key] 将返回 undefined，Set 对象会将 undefined 视为一个唯一值。
- 该方法适用于简单数据类型的去重。如果需要对复杂对象进行去重，需要自定义比较函数。
总结
通过自定义 Handlebars 助手函数，我们可以灵活地处理数据，并将其渲染到模板中。本文介绍的提取唯一值的方法，可以应用于各种场景，例如：显示不同的类别、过滤重复的标签等。掌握这种技巧，可以帮助你更好地利用 Handlebars 模板引擎，提高开发效率。
