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, and this page is available as Markdown at /apps-plugin/docs/components/index.md.

组件概述

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

什么是组件

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

<button text="确定" />

组件特性

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

组件列表

基础

组件说明
text文本渲染组件,是展示文字内容的基础元件,支持文字样式配置。

视图容器

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

表单

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

媒体

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

反馈

组件说明
popup浮层弹出组件,从屏幕边缘滑入的容器,支持顶部、底部、左侧、右侧等方向。

地图

组件说明
map地图展示组件,支持标记点、路线、多边形等覆盖物,以及平移、缩放等交互。
map-marker地图标记点组件,作为 Map 的子组件使用,支持自定义图标和动画。

画布

组件说明
canvas画布组件,提供 2D/WebGL 绘图上下文,用于图形绘制、动画渲染等场景。

开放能力

组件说明
web-view网页视图组件,用于在应用插件页面内承载 H5 页面。

主题

组件说明
theme-provider主题配置组件,为其包裹的子组件统一指定豆包的浅色 / 深色模式。