info.yaml清单文件中。
这些字段是插件元数据约定的一部分。它们并非属于特定导航插件的 API。
页面元数据
以下元数据字段定义了一个导航条目:Entry 必须是插件通过 HTTP 或静态传输提供的 URL。
导航 UI 会将此 URL 加载到 iframe 中,因此页面及其资源必须可通过应用程序的 URL 空间访问。
例如,清单文件可以像这样声明页面元数据:
- 插件具有
Entry值。 - 插件状态为
running或degraded。 - 插件名称未被主机导航配置排除。
排序和可见性
当前的导航实现从应用程序配置中的[Plugins.navigator.Params] 读取其行为。
这些设置控制主机如何呈现插件条目;它们不会替换清单文件中的页面元数据。
order 和 ignore 中的名称是插件的 Name 值,而不是显示标签。
逗号分隔值周围的空格将被忽略。空值将被忽略。
如果未配置语言,导航 UI 将使用 en。
order 参数不会隐藏未列出的插件。它只会将已列出的插件移动到其余可见条目的前面。
图标行为
图标通过公共 URL 引用。当前的导航实现对非活动条目使用Icon,对选中条目使用 IconSolid。如果未声明图标,则使用默认导航图标。
使用一个在导航条目可见期间始终有效的图标 URL。图标文件应通过静态挂载或其他稳定的公共资源路径提供。