> For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt.

# 组件概述

豆包应用插件框架提供了覆盖界面布局、内容展示、用户交互、表单提交等核心场景的内置组件库，帮助开发者快速构建结构规范、交互流畅的应用插件界面。组件遵循统一设计标准，支持灵活配置，降低开发复杂度。

## 什么是组件

组件是框架内置的小写标签，可直接在 `.tsx` 文件中使用，无需通过 `import` 导入。属性用于配置组件，内容可以写在开始标签和结束标签之间。

```tsx
<button text="确定" />
```

## 组件特性

- **统一设计标准**：所有组件遵循 Doubao 设计系统规范
- **响应式设计**：适配不同屏幕尺寸和设备
- **高度可定制**：支持通过 CSS 变量自定义样式
- **类型安全**：完整的 TypeScript 类型支持

## 组件列表

## 基础

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="basic/text">text</a></td><td>文本渲染组件，是展示文字内容的基础元件，支持文字样式配置。</td></tr>
</tbody>
</table>

## 视图容器

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="view-container/list">list</a></td><td>高性能列表组件，适用于渲染大量数据，支持垂直滚动和按需渲染。</td></tr>
<tr><td><a href="view-container/movable-area">movable-area</a></td><td>可移动区域组件，定义子视图可拖拽移动的范围边界。</td></tr>
<tr><td><a href="view-container/movable-view">movable-view</a></td><td>可移动视图组件，支持拖拽移动、双指缩放、惯性滑动、越界回弹等交互。</td></tr>
<tr><td><a href="view-container/scroll-view">scroll-view</a></td><td>可滚动容器，支持垂直和水平方向内容滚动，适用于内容超出可视区域的场景。</td></tr>
<tr><td><a href="view-container/swiper">swiper</a></td><td>轮播容器组件，支持自动播放、循环、自定义动画等功能。子节点须为 SwiperItem 组件。</td></tr>
<tr><td><a href="view-container/swiper-item">swiper-item</a></td><td>轮播项组件，用于包裹单个轮播内容，必须作为 Swiper 的直接子组件使用。</td></tr>
<tr><td><a href="view-container/view">view</a></td><td>基础布局容器，用于组织和嵌套其他组件，支持 Flexbox 布局。</td></tr>
</tbody>
</table>

## 表单

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="form/button">button</a></td><td>按钮组件。</td></tr>
<tr><td><a href="form/input">input</a></td><td>单行文本输入组件，支持多种输入类型（文本、数字、密码等）及受控/非受控模式。</td></tr>
<tr><td><a href="form/picker-column">picker-column</a></td><td>滚轮选择列，单列数据选择，通常作为 PickerView 的子组件使用。</td></tr>
<tr><td><a href="form/picker-divider">picker-divider</a></td><td>滚轮选择器分隔线组件，用于在 PickerColumn 之间展示文字或自定义内容。</td></tr>
<tr><td><a href="form/picker-view">picker-view</a></td><td>滚轮选择器容器，支持多列组合选择。</td></tr>
<tr><td><a href="form/radio">radio</a></td><td>单选按钮，需配合 RadioGroup 使用。</td></tr>
<tr><td><a href="form/radio-group">radio-group</a></td><td>单选按钮组，管理一组互斥的 Radio 选项，提供统一的值控制。</td></tr>
<tr><td><a href="form/slider">slider</a></td><td>滑块组件，支持在指定范围内选择连续或离散数值。</td></tr>
<tr><td><a href="form/switch">switch</a></td><td>开关切换组件，用于二元状态（开/关）的交互控制。</td></tr>
<tr><td><a href="form/text-area">text-area</a></td><td>多行文本输入组件，支持自动高度、字数限制等功能。</td></tr>
</tbody>
</table>

## 媒体

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="media/audio">audio</a></td><td>音频播放组件，提供不占用页面布局的音频播放与实例控制能力。</td></tr>
<tr><td><a href="media/camera">camera</a></td><td>相机预览与拍摄组件，提供拍照和录像能力。</td></tr>
<tr><td><a href="media/image">image</a></td><td>图片展示组件，支持加载本地或网络图片资源，提供多种裁剪和缩放模式。</td></tr>
<tr><td><a href="media/long-image">long-image</a></td><td>长图加载与展示组件，支持分段懒加载，适用于超长图片的高性能渲染。</td></tr>
<tr><td><a href="media/markdown">markdown</a></td><td>Markdown 渲染组件，用于渲染 Markdown 内容，支持打字机动画、文本选择和文本标注。</td></tr>
<tr><td><a href="media/rich-text">rich-text</a></td><td>富文本组件，支持 HTML 字符串或结构化节点，并自动同步内容高度。写法与小程序 rich-text 兼容。</td></tr>
<tr><td><a href="media/svg">svg</a></td><td>SVG 图形渲染组件，支持内联展示 SVG 格式图片。</td></tr>
<tr><td><a href="media/video">video</a></td><td>视频播放组件，支持本地和网络视频资源的播放控制。</td></tr>
</tbody>
</table>

## 反馈

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="feedback/popup">popup</a></td><td>浮层弹出组件，从屏幕边缘滑入的容器，支持顶部、底部、左侧、右侧等方向。</td></tr>
</tbody>
</table>

## 地图

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="map/map">map</a></td><td>地图展示组件，支持标记点、路线、多边形等覆盖物，以及平移、缩放等交互。</td></tr>
<tr><td><a href="map/map-marker">map-marker</a></td><td>地图标记点组件，作为 Map 的子组件使用，支持自定义图标和动画。</td></tr>
</tbody>
</table>

## 画布

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="canvas/canvas">canvas</a></td><td>画布组件，提供 2D/WebGL 绘图上下文，用于图形绘制、动画渲染等场景。</td></tr>
</tbody>
</table>

## 开放能力

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="open/web-view">web-view</a></td><td>网页视图组件，用于在应用插件页面内承载 H5 页面。</td></tr>
</tbody>
</table>

## 主题

<table>
<thead>
<tr><th width="200">组件</th><th width="560">说明</th></tr>
</thead>
<tbody>
<tr><td><a href="theme/theme-provider">theme-provider</a></td><td>主题配置组件，为其包裹的子组件统一指定豆包的浅色 / 深色模式。</td></tr>
</tbody>
</table>
