Jekyll场景下如何将Liquid数组转换为适配Chart.js的Javascript数组?
解决Jekyll Liquid数组转Chart.js可用JS结构的方法
你之前尝试失败的核心原因
- 数据路径书写错误:Jekyll加载
_data目录下的文件时,会自动移除文件后缀作为数据键,因此stocks.yml对应的正确访问路径是site.data.stocks,而非你写的site.data.stocks.yml——后者会返回空值,自然无法得到预期结果。 - 对
json过滤器的作用存在误解:这个过滤器本身就支持处理Liquid的集合、对象等复杂结构,并非仅能处理单个字符串/变量,只要传入的Liquid值有效,它会直接输出完全符合语法规范的JSON内容,而JSON本身和JS数组、对象是100%兼容的,可直接作为JS变量值使用。
简便实现方案
结合你提供的YAML数据结构,有两种常用实现方式,可按需选择:
方式1:直接转换整个原始数据源
不需要提前拆分字段,直接把整个Liquid集合转成JS数组,后续在JS逻辑中自行提取需要的字段即可,写法非常简单:
// 直接赋值得到完整的结构化数组 const rawStockData = {{ site.data.stocks | json }};
这行代码最终渲染到页面的实际效果为:
const rawStockData = [ {"month":"Jan '20","portfolio":"-4.5","spy":"-0.16"}, {"month":"Feb '20","portfolio":"-19.2","spy":"-8.41"}, {"month":"Mar '20","portfolio":"-19.1","spy":"-12.51"} ];
完全是Chart.js可直接使用的标准数组结构。
方式2:提前拆分好Chart.js需要的独立数组
如果不想在JS端做字段提取,可以直接在Liquid层通过内置过滤器提前拆分好标签、各数据集的独立数组,再分别通过json过滤器转成JS可用结构:
- 先在Liquid逻辑中把不同字段映射为独立列表:
注意:你的YAML文件中{% assign month_labels = site.data.stocks | map: "month" %} {% assign portfolio_values = site.data.stocks | map: "portfolio" | map: "to_number" %} {% assign spy_values = site.data.stocks | map: "spy" | map: "to_number" %}portfolio、spy字段的值是字符串类型,需要通过map: "to_number"转成数字类型,避免Chart.js计算数值时出现类型问题。 - 把拆分好的列表直接转成JS变量即可:
const chartLabels = {{ month_labels | json }}; const portfolioData = {{ portfolio_values | json }}; const spyData = {{ spy_values | json }};
完整的Chart.js接入示例
把上述逻辑整合后,可直接在页面中嵌入如下代码完成图表初始化:
<script> // Liquid层预拆分数据 {% assign month_labels = site.data.stocks | map: "month" %} {% assign portfolio_values = site.data.stocks | map: "portfolio" | map: "to_number" %} {% assign spy_values = site.data.stocks | map: "spy" | map: "to_number" %} new Chart(document.getElementById("stock-trend-chart"), { type: "line", data: { labels: {{ month_labels | json }}, datasets: [ { label: "投资组合收益率(%)", data: {{ portfolio_values | json }}, borderWidth: 2 }, { label: "SP500收益率(%)", data: {{ spy_values | json }}, borderWidth: 2 } ] } }); </script>
优势:相比手动循环拼接JS数组的写法,
json过滤器会自动处理特殊字符转义、引号配对、逗号分隔等细节,不会出现常见的JS语法错误,开发效率和稳定性都更高。
内容的提问来源于stack exchange,提问作者johnpitchko
相关产品推荐
相关产品推荐

