# HUD viewfinder frame

https://fieldbook.lizardi.mx/zh/components/hud-viewfinder-frame

分类：布局
![Fieldbook 的 HUD viewfinder frame 组件静态图，属于布局界面组件。](https://fieldbook.lizardi.mx/thumbs/hud-viewfinder-frame.webp)
Preview video: https://ejpqcxcjbiyabxkx.public.blob.vercel-storage.com/previews/hud-viewfinder-frame-e204d0ed6e.mp4 (5 s, silent)

HUD viewfinder frame：适用于任意内容的相机取景框，配有迅速归位的四角标记、运行中的时间码、小标签和显示进度的滑动条。

## 框架

react、vue、svelte、astro、html

## 预览控件

这些控件会传给演示组件。默认值和限制描述的是预览；完整的属性接口请查看实现代码。

| 名称 | 类型 | 默认值 | 选项或限制 |
| --- | --- | --- | --- |
| label | text | fb / motion reel | 最多 32 个字符 |
| code | text |  | 最多 24 个字符 |
| footer | text | easing study, take 3 | 最多 32 个字符 |
| fps | select | 24 | 选项：24、25、30 |
| loopSeconds | number | 12 | 范围 4 至 60；步长 1 |
| accent | color | #FF3A22 | 元数据未列出其他限制。 |
| recording | boolean | true | 元数据未列出其他限制。 |
| crosshair | boolean | false | 元数据未列出其他限制。 |

## 使用说明

HUD viewfinder frame 的预览采用「宽幅」布局，主题设置为「浅色/深色」。

### HUD viewfinder frame 提供哪些框架版本？

HUD viewfinder frame 提供 React、Vue、Svelte、Astro、HTML 版本。实时预览使用 React；以下代码观察仅针对 index.tsx。使用其他版本前，请确认其交互行为。

### HUD viewfinder frame 有哪些依赖？

React 元数据未列出 React 之外的 npm 依赖。

### HUD viewfinder frame 的代码中有哪些无障碍细节？

HUD viewfinder frame 的 React 代码包含：属性与事件处理器（aria-hidden）。这些信息来自代码观察。请在组合后的页面中验证无障碍名称、焦点顺序和键盘行为。

### HUD viewfinder frame 如何处理减少动态效果的偏好？

HUD viewfinder frame 的 React 代码通过 matchMedia(prefers-reduced-motion) 读取动态效果偏好。index.tsx 中随偏好变化的表达式：armed \|\| moving \|\| advancing ? -1 : runtime.focusWait；u: armed && !reduced ? clamp((entrance - i \* 0.05) / 0.44) : 1。请启用减少动态效果，检查完整实现、共享样式和所选框架版本；这些观察不能证明所有动画都会停止。

## 通过 MCP 安装

连接客户端，调用 get_component 获取实现，再调用 get_install_command 获取安装说明。选择已列出的框架，将源代码集成到应用中并验证功能。

```json
{
  "tool": "get_component",
  "arguments": {
    "slug": "hud-viewfinder-frame",
    "framework": "react"
  }
}
```

[面向智能体](https://fieldbook.lizardi.mx/zh/docs/agents)
[MCP](https://fieldbook.lizardi.mx/api/mcp)

## 相关开放组件

- [Curved Scroll Wall](https://fieldbook.lizardi.mx/zh/components/curved-scroll-wall)
- [Drag split panels](https://fieldbook.lizardi.mx/zh/components/drag-split-panels)
- [Focus scroll list](https://fieldbook.lizardi.mx/zh/components/focus-scroll-list)
- [Masked reveal disclosure](https://fieldbook.lizardi.mx/zh/components/masked-reveal-disclosure)
- [Masonry flow](https://fieldbook.lizardi.mx/zh/components/masonry-flow)
- [Overlay scroll panel](https://fieldbook.lizardi.mx/zh/components/overlay-scroll-panel)