组件

优质
小牛编辑
129浏览
2023-12-01

基础组件

框架为开发者提供了一系列基础组件,开发者可以通过组合这些基础组件进行快速开发。

什么是组件:

  • 组件是视图层的基本组成单元。

  • 组件自带一些功能与京东风格的样式。

  • 一个组件通常包括开始标签和结束标签,属性用来修饰这个组件,内容在两个标签之内。

<tagname property="value">
  内容
</tagname>

注意:所有组件与属性都是小写,以连字符-连接

属性类型

类型描述注解
Boolean布尔值组件写上该属性,不管该属性等于什么,其值都为true,只有组件上没有写该属性时,属性值才为 false。如果属性值为变量,变量的值会被转换为 Boolean 类型
Number数字1
String字符串"string"
Array数组[ 1, "string" ]
Object对象{ key: value }
EventHandler事件处理函数名"handlerName" 是 Page 中定义的事件处理函数名
Any任意属性

共同属性类型

所有组件都有的属性:

属性名类型描述注解
idString组件的唯一标示保持整个页面唯一
classString组件的样式类在对应的 JXSS 中定义的样式类
styleString组件的内联样式可以动态设置的内联样式
hiddenBoolean组件是否显示所有组件默认显示
data-*Any自定义属性组件上触发的事件时,会发送给事件处理函数
bind / catchEventHandler组件的事件详见事件

特殊属性

几乎所有组件都有各自定义的属性,可以对该组件的功能或样式进行修饰,请参考各个组件的定义。

组件列表

基础组件分为以下七大类:

视图容器(View Container):

组件名说明
view视图容器
scroll-view可滚动的视图容器
swiper滑块、轮播视图容器

基础内容(Basic Content):

组件名说明
icon图标
text文字
progress进度条

表单(Form):

标签名说明
button按钮
form表单
input输入框
checkbox多项选择器
radio单项选择器
picker列表选择器
picker-view内嵌列表选择器
slider滚动选择器
switch开关选择器
label标签

导航(Navigation):

组件名说明
navigator应用链接

多媒体(Media):

组件名说明
image图片
live-player直播
video视频
camera相机

地图(Map):

组件名说明
map地图

画布(Canvas):

组件名说明
canvas画布