Malla文档

变量

由绑定读取、由工作流写入的页面和站点状态,可保存在 URL 或浏览器中。

用户指南

变量保存页面或整个站点的状态:当前标签页、搜索词、筛选条件、购物车。绑定通过 vars.name 读取变量,工作流通过 Set variable 和 Reset variable 修改变量。

创建变量

打开 Data 工作区添加变量,或在绑定中点击 Create variable。选择一个名称(camelCase)、类型和默认值。类型可以是 string、number、boolean、object 或 array。

页面还是站点

  • 页面变量只存在于一个页面中,访客离开页面时会被重置。
  • 站点变量由站点的所有页面共享。
  • 如果两者同名,在该页面上以页面变量为准。

持久化

持久化方式保存位置适用场景
none仅内存界面状态,例如展开的菜单
url查询字符串可以分享或收藏的搜索和筛选条件
locallocalStorage跨访问保留的购物车或偏好设置
sessionsessionStorage仅当前标签页的状态
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。

下一步:把变量传入查询,这样变量变化时数据会重新获取。