1.1 通用事件
名称 | 参数 | 描述 |
click | - | 组件被点击时触发 |
longpress | - | 组件被长按时触发 |
focus | - | 组件获得焦点时触发,只针对input,textarea等用户输入的组件有效。 |
blur | - | 组件失去焦点时触发,只针对input,textarea等用户输入的组件有效。 |
appear | - | 屏幕划入,组件出现时触发 |
disappear | - | 屏幕划出,组件消失时触发 |
swipe | direction:String | swipe 事件在用户在某个元素上快速滑动时被触发,元素本身消耗触摸事件以及有手势事件的场景不支持,其中上下滑动事件只支持list。 ● left:向左滑动 ● right:向右滑动 ● up:向上滑动 ● down:向下滑动 |
1.2 通用属性
常规属性
名称 | 类型 | 默认值 | 描述 |
id | - | 唯一标识 | |
style | - | 样式声明 | |
class | - | 引用样式表 | |
disabled | false | 表明当前组件是否可用 |
渲染属性
名称 | 类型 | 默认值 | 描述 |
for | - | 根据数据列表,循环展开当前标签 | |
if | - | 根据数据boolean值,添加或移除当前标签 | |
show | - | 根据数据boolean值,显示或隐藏当前标签,相当于控制{ display: flex | none } |
渲染属性工作方式详见“template模板”。
注意:属性和样式不能混用,不能在属性字段中进行样式设置。
1.3 通用样式
名称 | 类型 | 默认值 | 描述 |
width | - | 未设置时使用组件自身内容需要的宽度。 | |
height | - | 未设置时使用组件自身内容需要的高度。 | |
padding | 0 | 简写属性,在一个声明中设置所有的内边距属性,该属性可以有1到4个值。 | |
padding-[left|top|right|bottom] | 0 | ||
| margin | 0 | 简写属性,在一个声明中设置所有的外边距属性,该属性可以有1到4个值。 | |
margin-[left|top|right|bottom] | 0 | ||
| border | - | 0 | 简写属性,在一个声明中设置所有的边框属性,可以按顺序设置属性width style color,不设置的值为默认值。 |
border-style | dotted | dashed | solid | solid | 暂时仅支持1个值,为元素的所有边框设置样式。 |
border-width | 0 | 简写属性,在一个声明中设置元素的所有边框宽度,或者单独为各边边框设置宽度。 | |
border-[left|top|right|bottom]-width | 0 | ||
| border-color | black | 简写属性,在一个声明中设置元素的所有边框颜色,或者单独为各边边框设置颜色。 | |
border-[left|top|right|bottom]-color | black | ||
| border-radius | 0 | ● 圆角时只使用border-width,border-[left|top|right|bottom]-width ● 无效圆角时只使用border-color,border-[left|top|right|bottom]-color无效 | |
border-[top|bottom]-[left|right]-radius | 0 | ||
| background | - | 支持渐变样式,暂时不能与background-color、background-image同时使用。 | |
background-color | - | ||
| background-image | - | 暂时不支持与background-color,border-color同时使用;不支持网络图片资源,请使用本地图片资源 | |
background-size | contain|cover|auto| | 100% | 设置背景图片大小 |
background-repeat | repeat|repeat-x|repeat-y|no-repeat | repeat | 设置是否及如何重复背景图像,背景图像默认在水平和垂直方向上重复 |
opacity | 0xff | ||
| display | flex | none | flex | |
| visibility | visible | hidden | visible | |
| flex | - | 父容器为 、 | |
flex-grow | 0 | 父容器为 、 | |
flex-shrink | 1 | 父容器为 、 | |
flex-basis | -1 | 父容器为 、 | |
position | none | fixed | none | |
| [left|top|right|bottom] | - |
注意:通用样式都不是必填项。
1.4 动画样式
| 名称 | 类型 | 默认值 | 描述 |
transform-origin | 0px 0px | 变换原点位置,单位目前仅支持px,格式为:50px 100px。 | |
transform | - | 详见表1-1。 | |
animation-name | 0 | 与@keyframes的name相呼应,详见表1-2。 | |
animation-delay | 0 | 目前支持的单位为[ s(秒) | ms(毫秒) ]。 | |
animation-duration | 0 | 目前支持的单位为[ s(秒) | ms(毫秒) ]。 | |
animation-iteration-count | 1 | ||
animation-timing-function | linear | ease | ease-in | ease-out | ease-in-out | ease | |
animation-fill-mode | none | forwards | none |
表1-1 transform操作说明
名称 | 类型 |
translateX | |
translateY | |
scaleX | |
scaleY | |
rotate | |
rotateX | |
rotateY |
表1-2 @keyframes属性说明
名称 | 类型 | 默认值 | 描述 |
background-color | - | ||
opacity | - | ||
width/height | - | 暂不支持百分比 | |
transform | - |
暂时不支持起始值(0%)或终止值(100%)缺省的情况,通过from和to显示指定起始和结束。示例:
@keyframes Go
{
from {background-color:#f76160;}
to {background-color: #09ba07;}
}
1.5 渐变样式
渐变 (gradients) 可以在两个或多个指定的颜色之间显示平稳的过渡,用法与CSS渐变一致。
当前框架支持以下渐变效果:
● 线性渐变 (linear-gradient)
● 重复线性渐变 (repeating-linear-gradient)
1.5.1 线性渐变 / 重复线性渐变
创建一个线性渐变,需要定义两类数据:1) 过渡方向;2) 过渡颜色,因此需要指定至少两种颜色。1、过渡方向:通过direction或者angle两种形式指定
2、过渡颜色:支持后面三种方式:red、#FF0000、rgb(255, 0, 0)、rgba(255, 0, 0, 1)
● direction:方向渐变
background: linear-gradient(direction, color-stop1, color-stop2, ...);
background: repeating-linear-gradient(direction, color-stop1, color-stop2, ...);
● angle:角度渐变
background: linear-gradient(angle, color-stop1, color-stop2);
background: repeating-linear-gradient(angle, color-stop1, color-stop2);
参数
名称 | 类型 | 默认值 | 必填 | 描述 |
direction | to | to bottom (从上到下渐变) | 否 | 例如:to right (从左向右渐变); 例如:to bottom right (从左上角到右下角)。 |
angle | 否 | 以图形几何中心为原点水平为X轴建立坐标,渐变线与Y轴的夹角(按顺时针计算)。 | ||
color-stop | 是 | 从起点到stop的区域显示的背景色为color。 |
示例
#gradient {height: 100px;
width: 200px;
}
/* 从顶部开始渐变。起点是红色,慢慢过渡到蓝色 */
background: linear-gradient(red, blue);
图1-1 从顶部渐变
/* 45度夹角,从红色渐变到蓝色 */background: linear-gradient(45deg, rgb(255,0,0),rgb(0, 0, 255));
图1-2 45度夹角渐变
/* 从左向右渐变,在距离左边90px和距离左边120px (200*0.6) 之间30px宽度形成渐变*/background: linear-gradient(to right, rgb(255,0,0) 90px, rgb(0, 0, 255) 60%);
图1-3 从左向右渐变
/* 从左向右渐变,重复渐变区域10px(20-10)透明度0.5 */background: repeating-linear-gradient(to right, rgba(255, 0, 0, .5) 10px,rgba(0, 0, 255, .5) 20px);
图1-4 从左向右渐变,重复渐变
2 容器组件2.1 div
概述
基本容器。子组件
支持。属性
支持通用属性。样式
支持通用样式。名称 | 类型 | 默认值 | 必填 | 描述 |
flex-direction | column | row | row | 否 | |
flex-wrap | nowrap | wrap | wrap-reverse | nowrap | 否 | |
justify-content | flex-start | flex-end | center | space-between | flex-start | 否 | |
align-items | stretch | flex-start | flex-end | center | stretch | 否 | |
align-content | stretch | flex-start | flex-end | center | space-between | space-around | stretch | 否 |
事件
支持通用事件。2.2 list-item
概述
- 的子组件,用来展示列表具体item,宽度默认充满list组件。
子组件
支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
type | - | 是 | list-item类型,同一list支持多种type的list-itemtype,相同的list-item需要确保渲染后的视图布局也完全相同,当type固定时,使用show属性代替if属性,确保视图布局不变。 |
样式
支持样式。
不支持position样式,支持通用样式。
2.3 list
2.4 refresh
2.5 richtext
文本内容直接写在标签内容区,内容格式需与type相匹配,只支持静态内容,由于需要实时编译,文本内容尽量不要频繁改变,否则可能导致性能问题。
不支持position样式,支持通用样式。
名称 | 类型 | 默认值 | 必填 | 描述 |
column-span | 1 | 否 | list-item在list中所占列数,一般用于list多列显示时。 |
事件
支持通用事件。2.3 list
概述
列表视图容器。子组件
仅支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
scrollpage | boolean | false | 否 | 是否将list顶部页面中非list部分随list一起滑出可视区域,开启该属性会降低list渲染性能。 |
样式
支持通用样式。名称 | 类型 | 默认值 | 必填 | 描述 |
flex-direction | column | row | column | 否 | |
columns | number | 1 | 否 | list显示列数 |
事件
名称 | 参数 | 描述 |
scroll | {scrollX:scrollXValue, scrollY:scrollYValue} | 列表滑动 |
scrollbottom | - | 列表滑动到底部 |
scrolltop | - | 列表滑动到顶部 |
方法
名称 | 参数 | 描述 |
scrollTo | {index: number(指定位置)} | list滚动到指定item位置 |
2.4 refresh
概述
下拉刷新容器。子组件
支持。属性
名称 | 类型 | 默认值 | 必填 | 描述 |
offset | 132px | 否 | 刷新组件静止时距离顶部距离。 | |
refreshing | false | 否 | 刷新组件是否正在刷新。 |
样式
名称 | 类型 | 默认值 | 必填 | 描述 |
background-color | white | 否 | 刷新组件背景颜色 | |
progress-color | black | 否 | 刷新组件loading颜色 |
事件
名称 | 参数 | 描述 |
refresh | {refreshing: refreshingValue} | 下拉refresh组件,触发刷新操作 |
2.5 richtext
概述
富文本容器。文本内容直接写在标签内容区,内容格式需与type相匹配,只支持静态内容,由于需要实时编译,文本内容尽量不要频繁改变,否则可能导致性能问题。
子组件
不支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
type | html | html | 否 | html格式支持标准的h5标签与样式,用于静态页面的展现,复杂的富文本需求尽量采用html格式富文本,内容只支持静态内容,不支持数据绑定,渲染指令等功能 |
样式
支持样式,height样式设置无效。
支持通用样式。
2.6 stack
支持通用样式。
事件
支持通用事件,不支持swipe事件。2.6 stack
概述
基本容器,子组件排列方式为层叠排列,每个直接子组件按照先后顺序依次堆叠,覆盖前一个子组件。子组件
支持。属性
支持通用属性。样式
支持样式。
支持通用样式。
2.7 swiper
2.8 tab-bar
的子组件,用来展示tab的标签区,子组件排列方式为横向排列。
2.9 tab-content
的子组件,用来展示tab的内容区,高度默认充满tabs剩余空间,子组件排列方式为横向排列。
2.10 tabs
2.11 popup
3 基础组件
3.1 a
文本内容写在标签内容区,支持转义字符"\",假如存在文本内容则不支持子组件。
样式。
支持通用样式。
3.2 image
3.3 progress
horizontal progress 底色为#f0f0f0。
circular progress 默认宽高为32px,宽高设置不一致时,circular图标为宽高的较小值。
3.4 span
与的子组件。
子组件 不支持。
属性名称类型默认值必填描述id-否唯一标识style-否样式声明class-否引用样式表for-否根据数据列表,循环展开当前标签if-否根据数据boolean值,添加或移除当前标签
样式名称类型默认值必填描述color0x8a000000否文本颜色font-size30px否文本尺寸font-stylenormal | italicnormal否font-weightnormal | boldnormal否text-decorationunderline | line-through | nonenone否
事件 不支持。
3.5 text
概述 文本。
文本内容写在标签内容区,支持转义字符"\",假如存在文本内容则不支持子组件。
子组件 仅支持与。
属性 支持通用属性。
3.6 web
this.$element('web').canForward({
callback: function(e){
if(e){
// 加载历史列表中的下一个 URL
this.$element('web').forward();
}else{
// TODO
}
}.bind(this)
})
3.7 rating
4 表单组件
4.1 input
支持change事件,input组件的值、checked状态发生变化时触发。
4.2 label
支持text样式。
4.3 option
支持通用样式。
事件
支持通用事件,不支持swipe事件。2.7 swiper
概述
滑块视图容器。子组件
支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
index | 0 | 否 | 当前显示的子组件索引。 | |
autoplay | false | 否 | 渲染完成后,是否自动进行播放。 | |
interval | 3000 | 否 | 自动播放时的时间间隔,单位毫秒。 | |
indicator | true | 否 | 是否启用indicator,默认true。 |
样式
支持通用样式。名称 | 类型 | 默认值 | 必填 | 描述 |
indicator-color | 0x7f000000 | 否 | indicator填充颜色 | |
indicator-selected-color | 0xff33b4ff | 否 | indicator选中时的颜色 | |
indicator-size | 20px | 否 | indicator组件的直径大小 |
事件
支持通用事件,不支持swipe事件。名称 | 参数 | 描述 |
change | {index:currentIndex} | 当前显示的组件索引变化时触发 |
方法
名称 | 参数 | 描述 |
swipeTo | {index: number(指定位置)} | swiper滚动到index位置 |
2.8 tab-bar
概述
子组件
支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
mode | scrollable | fixed | fixed | 否 | ● mode为scrollable时,子组件宽度为设置宽度,当宽度之和大于tab-bar宽度,子组件可以横向滚动; ● mode为fixed时,子组件宽度均分tab-bar宽度,当宽度之和大于tab-bar宽度,子组件依旧均分宽度 |
样式
支持通用样式。名称 | 类型 | 默认值 | 必填 |
height | 100px | 否 |
事件
支持通用事件,不支持swipe事件。2.9 tab-content
概述
子组件
支持。属性
支持通用属性。样式
支持通用样式。事件
支持通用事件,不支持swipe事件。2.10 tabs
概述
tab容器。子组件
仅支持最多一个和最多一个。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
index | 0 | 否 | 当前active tab索引。 |
样式
支持通用样式。事件
支持通用事件,不支持swipe事件。名称 | 参数 | 描述 |
change | {index: indexValue} | tabs子组件active变化时触发。 |
2.11 popup
概述
Popup组件。在点击控件或者某个区域后,浮出一个气泡来引导用户,气泡内容通过子组件来定义。如果设置了遮罩层,可通过点击遮罩层的任意位置退出,否则点击气泡外任意区域退出。子组件
仅支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
target | String | 是 | 目标元素选择器。 | |
placement | String | bottom | 否 | 弹出窗口位置。 {'left','right','top','bottom','topLeft','topRight','bottomLeft', 'bottomRight'} |
样式
支持通用样式。名称 | 类型 | 默认值 | 必填 | 描述 |
mask-color | 0x00000000 | 否 | 遮罩背景层的颜色,缺省为全透明。 假如只设置了颜色,透明度默认为30%。 |
事件
支持通用事件,不支持appear,disappear事件。名称 | 参数 | 描述 |
visibilitychange | {visible: boolean} | 当显隐状态变化时回调函数。 |
3 基础组件
3.1 a
概述
超链接(默认不带下划线)。文本内容写在标签内容区,支持转义字符"\",假如存在文本内容则不支持子组件。
子组件
仅支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
href | - | 否 | 支持的格式参见页面路由中的uri参数。额外的: ● href还可以通过"?param1=value1"的方式添加参数,参数可以在页面中通过this.param1的方式使用 ● href还支持http和https开头的网址,点击后会打开webview加载网页 示例: |
样式
支持支持通用样式。
事件
支持通用事件。3.2 image
概述
渲染图片。子组件
不支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
src | - | 否 | 图片的uri,同时支持本地和云端路径,支持的图片格式包括静态类型(png, jpg)和动态类型(gif)。 | |
alt | - | 否 | 加载时显示的占位图。 |
样式
支持通用样式。名称 | 类型 | 默认值 | 必填 | 描述 |
resize-mode | cover | contain | stretch | center | cover | 否 | 图片的缩放类型。 |
表3-1 resize-mode 类型
类型 | 说明 |
cover | 保持宽高比缩小或放大,使得两边都大于或等于显示边界,居中显示。 |
contain | 保持宽高比,缩小或者放大,使得图片完全显示在显示边界内,居中显示。 |
stretch | 不保存宽高比,填充满显示边界。 |
center | 居中,无缩放。 |
事件
支持通用事件。3.3 progress
概述
进度条子组件
不支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
percent | 0 | 否 | 当前进度(type为circular时不生效) | |
type | horizontal | circular | horizontal | 否 | 进度条类型,不支持动态修改 |
样式
支持通用样式。horizontal progress 底色为#f0f0f0。
circular progress 默认宽高为32px,宽高设置不一致时,circular图标为宽高的较小值。
名称 | 类型 | 默认值 | 必填 | 描述 |
color | #33b4ff 或者 rgb(51, 180, 255) | 否 | 进度条的颜色 | |
stroke-width | 32px | 否 | 进度条的宽度(type为circular时不生效) |
事件
支持通用事件,不支持swipe事件。3.4 span
概述
格式化的文本,只能作为样式
支持通用样式。名称 | 类型 | 默认值 | 必填 | 描述 |
lines | -1 | 否 | 文本行数,-1代表不限定行数 | |
color | 0x8a000000 | 否 | 文本颜色 | |
font-size | 30px | 否 | 文本尺寸 | |
font-style | normal | italic | normal | 否 | |
font-weight | normal | bold | normal | 否 | |
text-decoration | underline | line-through | none | none | 否 | |
text-align | left | center | right | left | 否 | |
line-height | - | 否 | 文本行高 | |
text-overflow | clip | ellipsis | clip | 否 | 在设置了行数的情况下生效 |
事件
支持通用事件。3.6 web
3.6.1 概述
用于显示在线的html页面在webview的useragent后追加内容,格式是hap/<平台版本号>/<厂商标识> <平台应用包名>/<平台应用版本号> <应用包名>/<应用版本号> (<来源信息>)。“来源信息”与app接口的getInfo方法返回结果中的source字段相同。3.6.2 子组件
不支持。3.6.3 属性
名称 | 类型 | 默认值 | 必填 | 描述 |
src | - | 否 | 需要加载的页面地址 |
3.6.4 事件
支持通用事件,不支持swipe事件。名称 | 参数 | 描述 |
pagestart | {url: urlString} | 开始加载网页时触发 |
pagefinish | {url: urlString, canBack: true/false, canForward: true/false} | 网页加载完成时触发 |
titlereceive | {title: title} | 收到网页标题时触发 |
error | {errorMsg: errorMsg} | 网页加载出现错误时触发 |
3.6.5 方法
名称 | 参数 | 描述 |
reload | 重新加载页面 | |
forward | 浏览历史页面中的前一个页面 | |
back | 浏览历史页面中的后一个页面 | |
canForward | {callback: Function} | 是否可以向前浏览 |
canBack | {callback: Function} | 是否可以向后浏览 |
canForward回调函数返回参数
参数 | 返回值类型 | 描述 |
canForward | Boolean | 是否可以向前浏览 |
canBack回调函数返回参数
参数 | 返回值类型 | 描述 |
canBack | Boolean | 是否可以向后浏览 |
示例
this.$element('web').canForward({
callback: function(e){
if(e){
// 加载历史列表中的下一个 URL
this.$element('web').forward();
}else{
// TODO
}
}.bind(this)
})
3.7 rating
概述
星级评分。子组件
不支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
numstars | 5 | 否 | 星级总数 | |
rating | 0 | 否 | 评星数 | |
stepsize | 0.5 | 否 | 评星步长 | |
indicator | false | 否 | 是否作为一个指示器(用户不可操作) |
样式
支持通用样式。名称 | 类型 | 默认值 | 必填 | 描述 |
star-background | 否 | 仅支持本地路径 | ||
star-foreground | 否 | 仅支持本地路径 | ||
star-secondary | 否 | 仅支持本地路径 | ||
width | numstars*star资源的宽度 | 否 | 默认为numstars*star资源的宽度 | |
height | star资源的宽度 | 否 | 默认为star资源的宽度 |
事件
支持通用事件,不支持click和 longpress事件,不支持swipe事件。名称 | 参数 | 描述 |
change | {rating: current rating} | 评星数发生改变时触发。 |
4 表单组件
4.1 input
概述
提供可交互的界面,接收用户的输入,默认为单行。子组件
不支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
type | button | checkbox | radio | text | email | date | time | number | password | text | 否 | 不支持动态修改。 |
checked | false | 否 | 当前组件的checked状态,可触发checked伪类,type为checkbox时生效 | |
name | - | 否 | input组件名称 | |
value | - | 否 | input组件的值 | |
placeholder | 37.5px | 否 | 提示文本的内容,type为text|email|date|time时生效 |
样式
支持通用样式。名称 | 类型 | 默认值 | 必填 | 描述 |
color | 0xde000000 | 否 | 文本颜色 | |
font-size | 37.5px | 否 | 文本尺寸 | |
placeholder-color | 0x61000000 | 否 | 提示文本的颜色,type为text|email|date|time时生效 | |
width | - | 否 | type为button时,默认值为128px | |
height | - | 否 | type为button时,默认值为70px |
事件
支持通用事件。支持change事件,input组件的值、checked状态发生变化时触发。
参数 | text | email | date | time | number | checkbox | radio | 备注 |
name | √ | √ | ||
value | √ | √ | √ | |
checked | √ |
方法
名称 | 参数 | 描述 |
focus | {focus:true|false},focus不传默认为true | 使组件获得或者失去焦点,可触发focus伪类,type为text|email|date|time|number|password时,可弹出或收起输入法 |
4.2 label
概述
为input、textarea组件定义标注。子组件
不支持。属性
支持通用属性。名称 | 类型 | 默认值 | 必填 | 描述 |
target | - | 否 | 目标input组件id |
样式
支持通用样式。支持text样式。
事件
无。4.3 option
概述





































苏公安网备 32011402010933号