---
title: "Spatial Widgets"
type: concept
tags: []
sources: [visionos-spatial-engineer]
last_updated: 2026-04-25
---

## Definition
visionOS 26 引入的小组件系统，可吸附于 3D 空间中的墙面、桌面等表面，并持久化放置在物理位置，无需应用处于前台运行即可展示。

## Core Characteristics
- **Spatial Placement（空间放置）**：通过 SwiftUI API 定义 widget 在 3D 空间中的精确位置
- **Surface Snapping（表面吸附）**：自动识别并吸附到墙面、桌面等物理表面
- **Persistent Presence（持久化存在）**：Widget 保留在设定位置，用户返回时仍然可见
- **Cross-App Usage（跨应用使用）**：作为系统级功能，所有应用可共享 widget 展示

## Implementation Technologies
- **WidgetKit for visionOS**：Apple Widget 框架的 visionOS 扩展
- **SwiftUI Volumetric Widgets**：支持 volumetric 展示模式的 widget 类型
- **3D Positioning API**：定义 widget 在空间中的精确位置和朝向

## Related Concepts
- [[Liquid Glass Design System]]：Widget 的视觉呈现采用 Liquid Glass 风格
- [[Multi-Window Architecture]]：Widget 与主应用窗口的协同模式
- [[Spatial Layouts]]：Widget 在 3D 空间中的布局管理

## Sources
- [[visionos-spatial-engineer]] — visionOS Spatial Engineer Agent 角色定义