变量保存页面或整个站点的状态:当前标签页、搜索词、筛选条件、购物车。绑定通过 vars.name 读取变量,工作流通过 Set variable 和 Reset variable 修改变量。
创建变量
打开 Data 工作区添加变量,或在绑定中点击 Create variable。选择一个名称(camelCase)、类型和默认值。类型可以是 string、number、boolean、object 或 array。
页面还是站点
- 页面变量只存在于一个页面中,访客离开页面时会被重置。
- 站点变量由站点的所有页面共享。
- 如果两者同名,在该页面上以页面变量为准。
持久化
| 持久化方式 | 保存位置 | 适用场景 |
|---|---|---|
none | 仅内存 | 界面状态,例如展开的菜单 |
url | 查询字符串 | 可以分享或收藏的搜索和筛选条件 |
local | localStorage | 跨访问保留的购物车或偏好设置 |
session | sessionStorage | 仅当前标签页的状态 |
json
// A search variable kept in the URL (?search=…)
{ "name": "search", "type": "string", "default": "", "persist": "url" }
// A cart kept in localStorage across visits
{ "name": "cart", "type": "array", "default": [], "persist": "local" }
嵌套值
使用点号路径(例如 filters.category)设置对象变量中的单个字段。输入框也可以双向绑定到路径:vars.filters.category。
下一步:把变量传入查询,这样变量变化时数据会重新获取。