文档开发者中心
我的

<如何开发快应用 3>组件

通用
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    = [left | right] || [top | bottom]
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样式,支持通用样式。

名称
类型
默认值
必填
描述
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样式设置无效。
       支持通用样式。

事件
       支持通用事件,不支持swipe事件。
2.6 stack
概述
       基本容器,子组件排列方式为层叠排列,每个直接子组件按照先后顺序依次堆叠,覆盖前一个子组件。
子组件
       支持。
属性
       支持通用属性。
样式
       支持
样式。
       支持通用样式。

事件
       支持通用事件,不支持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
概述
       的子组件,用来展示tab的标签区,子组件排列方式为横向排列。
子组件
       支持。
属性
       支持通用属性。
名称
类型
默认值
必填
描述
mode
scrollable | fixed
fixed
否
● mode为scrollable时,子组件宽度为设置宽度,当宽度之和大于tab-bar宽度,子组件可以横向滚动;
● mode为fixed时,子组件宽度均分tab-bar宽度,当宽度之和大于tab-bar宽度,子组件依旧均分宽度

样式
       支持通用样式。
名称
类型
默认值
必填
height
|
100px
否

事件
       支持通用事件,不支持swipe事件。
2.9 tab-content
概述
       的子组件,用来展示tab的内容区,高度默认充满tabs剩余空间,子组件排列方式为横向排列。
子组件
       支持。
属性
       支持通用属性。
样式
       支持通用样式。
事件
       支持通用事件,不支持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
概述
       格式化的文本,只能作为与的子组件。 子组件       不支持。 属性名称类型默认值必填描述id-否唯一标识style-否样式声明class-否引用样式表for-否根据数据列表,循环展开当前标签if-否根据数据boolean值,添加或移除当前标签 样式名称类型默认值必填描述color0x8a000000否文本颜色font-size30px否文本尺寸font-stylenormal | italicnormal否font-weightnormal | boldnormal否text-decorationunderline | line-through | nonenone否 事件       不支持。 3.5 text 概述       文本。        文本内容写在标签内容区,支持转义字符"\",假如存在文本内容则不支持子组件。 子组件       仅支持与。 属性       支持通用属性。
样式
       支持通用样式。
名称
类型
默认值
必填
描述
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
| lt;percentage>
-
否
type为button时,默认值为128px
height
| lt;percentage>
-
否
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
概述
      
点赞
收藏
回复
分享
举报
浏览1756 发布于2018-04-26 07:04未知归属地
全部评论
最多点赞
最新发布
最早发布
暂无评论
暂无评论
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

了解社区公约,与您携手共创和谐专业的开发者社区。