路由

Workshop 路由使模块的特定状态或视图可以写入 URL，从而使用户能够通过链接共享轻松与他人共享这些视图。

启用路由

以启用 Workshop 模块的路由，导航到左侧 设置 面板中的 页面 部分，并打开 启用路由 选项。

页面 部分显示了使用路由的页面概览，并提供了一个显示正在使用的变量的附加面板，如下所示。

页面路由

启用路由后，当前页面的 ID 将被写入 URL。对于没有定义页面 ID 的页面，不会将页面 ID 写入 URL；用户将在页面加载时返回到模块的默认页面。

变量路由

您还可以使用路由来保存和共享为模块界面配置的变量值。启用路由后，配置有路由 URL 更新行为的变量的当前值将直接作为 URL 查询参数写入。

要在 URL 中包含模块界面变量，请使用以下配置选项之一。

• 当被可见微件或设计使用时在 URL 中: 只有当以下条件为 true 时，URL 才会包含变量的值：
  • 值不是变量的默认值
  • 变量用于当前视图中显示的微件或设计。
• 始终在 URL 中: 如果值不是变量的默认值，URL 将始终包含变量的值。
• 从不在 URL 中: 如果禁用路由切换，URL 将永远不会包含变量的值。

如果查询参数键与模块界面变量的外部 ID 匹配，则查询参数的值将用作变量的初始值，而不管配置的 URL 包含行为。

限制

URL 中不支持的变量类型

以下变量类型无法在 URL 中使用：

• 对象集筛选变量
• 对象集变量 限制为单个对象，由其 RID 指定

但是，您可以通过其他路由变量间接定义上述变量类型。例如，您可以创建一个用于路由的字符串变量，并使用此字符串变量定义对象集筛选变量的 默认值。

嵌入模块不继承路由配置

嵌入 Workshop 模块 不会携带嵌入模块的路由配置。要使用嵌入模块中路由的变量值，请将所需的变量添加到子模块的模块界面中，并在嵌入模块配置中从父模块传入路由变量。

移动兼容性

路由当前与 Workshop 移动端 不兼容。