组件总览

WARNING

请注意,当前域名 https://dev.weixin.qq.com/docs/framework 文档已不维护,请前往微信文档中心open in new window 找到对应的新文档继续使用

视图容器

名称功能说明备注
cover-imageopen in new window覆盖在原生组件之上的图片视图已废弃
cover-viewopen in new window覆盖在原生组件之上的文本视图支持
match-mediaopen in new windowmedia query 匹配检测节点支持
movable-areaopen in new windowmovable-viewopen in new window的可移动区域支持
movable-viewopen in new window可移动的视图容器,在页面中可以拖拽滑动支持
page-containeropen in new window页面容器支持
root-portalopen in new window使整个子树从页面中脱离出来,类似于在 CSS 中使用 fixed position 的效果支持
scroll-viewopen in new window可滚动视图区域支持
share-elementopen in new window共享元素支持
swiperopen in new window滑块视图容器支持
swiper-itemopen in new window仅可放置在swiperopen in new window组件中,宽高自动设置为100%支持
viewopen in new window视图容器支持

基础内容

名称功能说明备注
iconopen in new window图标组件支持
progressopen in new window进度条支持
rich-textopen in new window富文本支持
textopen in new window文本支持

表单组件

名称功能说明备注
buttonopen in new window按钮支持,但 open-type 涉及的微信开放能力中,仅支持 open-type=share
checkboxopen in new window多选项目支持
checkbox-groupopen in new window多项选择器,内部由多个checkboxopen in new window组成支持
editoropen in new window富文本编辑器,可以对图片、文字进行编辑支持
formopen in new window表单支持
inputopen in new window输入框支持
keyboard-accessoryopen in new window设置 input / textarea 聚焦时键盘上方 cover-view / cover-image 工具栏视图暂不支持
labelopen in new window用来改进表单组件的可用性支持
pickeropen in new window从底部弹起的滚动选择器支持
picker-viewopen in new window嵌入页面的滚动选择器支持
picker-view-columnopen in new window滚动选择器子项支持
radioopen in new window单选项目支持
radio-groupopen in new window单项选择器,内部由多个 radioopen in new window组成支持
slideropen in new window滑动选择器支持
switchopen in new window开关选择器支持
textareaopen in new window多行输入框支持

导航

名称功能说明备注
functional-page-navigatoropen in new window仅在插件中有效,用于跳转到插件功能页不支持
navigatoropen in new window页面链接支持

媒体组件

  • 注意:在 Android 端使用 camera 组件,需将「XWeb Embed SDK」或者「XWeb SDK」勾上
名称功能说明备注
audioopen in new window音频已废弃
cameraopen in new window系统相机支持
imageopen in new window图片支持,但是长按识别的功能尚不支持
live-playeropen in new window实时音视频播放(v2.9.1 起支持同层渲染open in new windowAndroid 已支持,SDK 需 ≥ 1.2.9
live-pusheropen in new window实时音视频录制(v2.9.1 起支持同层渲染open in new windowAndroid 已支持,SDK 需 ≥ 1.2.10
videoopen in new window视频(v2.4.0 起支持同层渲染open in new window支持
voip-roomopen in new window多人音视频对话暂不支持

地图

名称功能说明备注
mapopen in new window地图(v2.7.0 起支持同层渲染open in new window支持

画布

名称功能说明备注
canvasopen in new window画布支持

开放能力

名称功能说明备注
web-viewopen in new window承载网页的容器支持,且无需进行域名配置和校验
adopen in new windowBanner 广告暂不支持
ad-customopen in new window原生模板 广告暂不支持
official-accountopen in new window公众号关注组件暂不支持
open-dataopen in new window用于展示微信开放的数据暂不支持

原生组件说明

名称功能说明备注
native-componentopen in new window小程序中的部分组件是由客户端创建的原生组件支持

无障碍访问

名称功能说明备注
aria-componentopen in new window满足视障人士对于小程序的访问需求暂不支持

导航栏

名称功能说明备注
navigation-baropen in new window页面导航条配置节点,用于指定导航栏的一些属性支持

页面属性配置节点

名称功能说明备注
page-metaopen in new window页面属性配置节点,用于指定页面的一些属性、监听页面事件支持