Zion 参数用法详解

在 Zion 应用开发中，参数用于实现页面、组件、行为流之间的数据传递。常见场景包括页面跳转、组件间通信等。

路径参数与查询参数

参数可通过页面 URL 进行传递，分为路径参数和查询参数：

• 路径参数：直接影响页面 URL 结构，适合 SEO 友好型页面。
• 查询参数：以 ?key=value 形式附加在 URL 末尾，适合临时性或筛选类数据传递。

举例说明：访问 Zion 官网某篇博客文章 
https://www.functorz.com/blog_article/blog/zion-feature-zion-ai?utm_source=zion_doc
URL 结构如下：

• https://www.functorz.com：网站协议与域名
• /blog_article：博客页面路径
• /blog/zion-feature-zion-ai：路径参数，此处 blog 的值为 zion-feature-zion-ai
• ?utm_source=zion_doc：查询参数，此处 utm_source 的值为 zion_doc

可以看到，路径参数会影响页面的主路径结构，而查询参数则用于传递附加信息，不改变页面主路径。

适用场景

• 查询参数：常用于筛选、分页、临时数据传递。
• 路径参数：适用于内容详情页、SEO 优化页面。

配置与使用

两种参数均需先声明再赋值，可被引用。以博客页面为例：

• 定义路径参数 blog 用于远程数据的筛选条件，以获取博客文章。该参数为必填项。
• 定义多个查询参数用于传递用户信息。这些参数可以为空。

赋值

在跳转到该页面的行为上，给它们赋值。例如在搜索结果页，跳转博客页的行为上，将搜索到的 blog id 赋值给路径参数 blog。

引用

页面上的路径参数、查询参数都可以在当前页面内被引用，一般用于配置筛选条件。例如在博客页，在远程数据中，用路径参数 blog 作为筛选获取博客文章。

行为输入

行为输入用于在行为流、AI 行为等场景下传递数据。其使用方式与变量类似，分为声明、引用和赋值三个步骤。

声明

在行为配置内声明所需的输入参数。

引用

在行为配置内部可直接引用已声明的参数。

赋值

在调用行为时为参数赋值。