Widget

Widget

签名

<Widget Name="每日新闻" Version="1.0.0"
        Author="示例" Description="可选说明"
        UpdateUrl="https://example.com/news.qwidget"
        LauncherVersion="1.4.0">
  ...
</Widget>

属性

• Default：使用启动器默认值（更新 6 小时；刷新不自动）
• Immediately：每次组件挂载时执行
• PreLaunch：每次启动器进程只执行一次
• PreLoad：每次切换到主页/重新挂载时执行
• None：不自动执行
• 数字：秒数，例如 30 表示 30 秒

ImageHosts

<Widget ImageHosts="*.example.com,cdn.example.net" ...>

• 支持精确域名、*.example.com 和 *
• 编辑器只需确认一次 ImageHosts，不需要逐张图确认
• 静态 URL 不要求确认
• ImageHosts="*" 表示允许所有 HTTPS 图片/媒体主机

子元素

• 布局/控件节点：Container、Row、Column、Grid、Text、Button、Dialog 等
• Data
• Resources
• Triggers
• Function
• Widget.Using
• Widget.Inputs / Widget.Outputs（组件契约）

属性元素

<Widget>
  <Widget.Name>示例</Widget.Name>
  <Widget.Version>1.0.0</Widget.Version>
  <Text Value="Hello" />
</Widget>

运行时行为

1. 解析并严格校验 XML：未知元素/属性、重复属性、非法 URL/枚举直接报错。
2. 解析 Data 并开始拉取；解析 Resources；解析 Function/Triggers。
3. 执行 Loaded 触发器。
4. 渲染节点；父组件通过 Children 读取快照；声明了 Widget.Outputs 时只暴露 Children.<As>.Outputs。
5. 在线组件按 6 小时 TTL 检查更新。

限制

• XML ≤256KB、深度 ≤16、元素 ≤1000。
• 数据源 ≤8、嵌套实例 ≤20。
• 未命名数据源默认名为 Data。

相关

• QWidget XML 语法
• 数据绑定
• 版本要求