CHANGELOG.md

v1.9.0

此版本配套快应用平台版本为 v1090

框架

• 新增: 页面$page对象新增setSecure方法, 增加控制是否允许页面截屏示例
• 优化: deeplink　支持唤起web,　增加唤起h5页面示例

组件

• 新增: 新增对transition过渡动画的支持
• 新增: 新增section-list列表分组组件, 对列表的分组示例
• 新增: 新增slide-view组件, 增加侧滑操作示例
• 新增: 新增refresh2组件, 扩展refresh组件的能力
• 优化: 增加heif/heic图片的支持
• 优化: camera组件增加支持录像
• 优化: web组件文件选择支持Capture属性

样式

• 新增: image组件新增 filter属性, 增加blur模糊滤镜示例
• 新增: 增加animation-direction动画属性, 控制动画的播放方向
• 优化: image样式加入alt-object-fit属性, 配置占位图的缩放模式

接口

• 新增: 新增keyguard接口, 增加获取当前锁屏状态示例

v1.8.0

此版本配套快应用平台版本为 v1080

框架

• 新增: 框架新增TextDecoder全局类, 用于将字节流解码为字符串
• 新增: 异步加载js
• 新增: 框架新增onReachTop、onReachBottom、onPageScroll生命周期,监听页面滚动

组件

• 新增: image组件新增动画播放控制能力,通过startAnimation和stopAnimation来控制动画播放
• 新增: div组件新增enablevideofullscreencontainer属性,在直接子组件为video时,开启全屏显示自定义组件特性
• 新增: video新增playcount属性,控制播放次数
• 新增: swiper组件新增enableswipe属性,控制swiper是否允许沿着其内容的排列方向滑动
• 新增: swiper组件新增过渡动画配置
• 新增: 新增drawer组件,满足抽屉布局,增加侧边导航页面配置
• 新增: drawer组件可以通过openDrawer和closeDrawer来控制抽屉打开状态,通过change和scroll事件来获取状态
• 新增: 新增drawer-navigation组件,为drawer子组件，支持通用属性direction
• 新增: refresh组件新增enable-refresh属性,控制是否允许刷新组件下拉刷新示例
• 新增: slider组件与rating组件change事件新增isFromUser参数,判断是否为用户行为触发
• 新增: camera组件新增setSceneMode方法,设置当前拍照的场景模式
• 新增: camera组件新增setExposureCompensation方法,设置曝光值示例
• 新增: camera组件新增getExposureCompensationRange方法,获取相机曝光值范围示例
• 新增: camera组件新增getExposureCompensation方法,获取当前设置的曝光值示例
• 新增: camera组件新增setPreviewFpsRange方法,设置预览帧率的最大和最小值示例
• 新增: camera组件新增getSupportedPreviewFpsRange方法,获取支持的预览帧率范围示例
• 新增: camera组件新增getPreviewFpsRange方法,获取设置的预览帧率范围示例
• 新增: camera组件新增framesize属性,设置相机帧数据尺寸示例
• 新增: camera组件新增autoexposurelock属性,设置曝光锁定
• 新增: camera组件新增autowhitebalancelock属性,设置白平衡锁定
• 新增: camera组件新增cameraframe事件,获取图像像素点
• 新增: camera组件新增camerainitdone事件,相机初始化完成时触发
• 新增: web组件新增isSupportWebRTC事件,判断是否支持webrtc功能

样式

• 新增: progress组件type为horizontal增加layer-color样式,设置滑轨颜色示例
• 优化： animation-timing-function支持steps与cubic-bezier,控制动画曲线示例

接口

• 新增: geolocation接口新增geocodeQuery方法,进行地理编码示例
• 新增: geolocation接口新增reverseGeocodeQuery方法,通过地理编码获得位置信息示例
• 新增: telecom接口新增getTelecomInfo方法,获取设备通信相关信息示例
• 新增: media接口新增saveToPhotosAlbum方法folderName参数,可自定义保存在相册中文件夹的名称
• 新增: texttoaudio接口新增speak方法,可进行语音播报,输入需要播报的文本内容，实时播报
• 新增: texttoaudio接口新增textToAudioFile方法,可进行语音合成,输入需要合成的文本内容，生成本地音频文件
• 新增: texttoaudio接口新增isLanguageAvailable方法,判断是否支持语言类型
• 新增: texttoaudio接口新增onttsstatechange方法,注册状态监听，监听每个操作的状态，通过id区分
• 新增: texttoaudio接口新增stop方法,停止当前接口
• 新增: texttoaudio接口新增isSpeaking方法,判断语音是否正在播放或者合成

v1.7.0

此版本配套快应用平台版本为 v1070

框架

• 新增: 新增动态组件
• 新增: 页面对象 $page 新增scrollTo、scrollBy方法,用于控制页面进行滚动
• 新增：页面对象 $page 新增 getMenuBarRect方法, 可以获取 menuBar 的布局位置信息
• 新增：APP新增onRequest、onShow、onHide生命周期
• 新增：manifest.json中display新增 themeMode 字段，用于配置快应用主题模式
• 新增：manifest.json中display新增 forceDark 字段，用于配置应用级别的夜间模式自动反色开关
• 新增：manifest.json中router.pages新增 forceDark 字段，用于配置页面级别的夜间模式自动反色开关
• 新增：manifest.json中display新增 menuBarData 字段，设置悬浮窗样式
• 新增： onConfigurationChanged生命周期增加 type:"themeMode"，在系统更改主题模式时触发，详情请参考官网文档

组件

• 新增: map组件新增setMaxAndMinScaleLevel方法，设置地图缩放级别
• 新增: map组件新增heatmaplayer属性，用于热力图配置
• 新增: map组件新增showscale属性和setScalePosition方法,设置默认比例尺控件展示与位置
• 新增: map组件新增showzoom属性和setZoomPosition方法,设置放大缩小功能控件展示与位置
• 新增: map组件新增setCompassPosition方法,设置地图指南针位置
• 新增: video组件新增titlebar、title属性,设置视频组件在全屏时是否显示顶栏和要显示的顶栏标题
• 新增： video组件新增orientation属性，用于控制视频的布局方向
• 新增: list组件新增scrollBy方法，可以控制list从当前位置进行滑动
• 新增: 组件新增通用方法getBoundingClientRect,可以获取节点的位置信息
• 新增: 组件新增通用方法toTempFilePath,可以将组件内容保存为图片
• 新增: web组件新增showloadingdialog属性,设置 web 组件是否展示加载框
• 新增: 除video、camera、map、custommarker、canvas、span以外的全部组件新增通用属性forcedark，用于配置组件级别的夜间模式自动反色开关
• 新增: web组件新增supportzoom属性,设置网页是否支持缩放
• 新增: richtext新增start、complete事件,监测richtext开始加载和完成加载示例

样式

• 新增: progress组件type为horizontal增加layer-color样式,设置滑轨颜色示例
• 新增: switch组件新增thumb-color、track-color样式,可自定义小球和滑轨颜色
• 新增: list组件新增layout-type属性,可控制子元素网格展示和交错展示
• 新增： list-item组件新增column-span属性,控制list-item在list中所占列数
• 新增： 动画新增animationstart、animationiteration 和 animationend回调事件,监听动画事件
• 优化: 动画样式animation-name支持多个keyframe定义的动画
• 优化： border-radius支持percent单位
• 新增： 新增支持media-query媒体查询，需 hap-toolkit 版本在0.6.15以上

接口

• 新增: package接口新增getInfo方法,获取应用版本号、版本名
• 新增: package接口新增getSignatureDigests方法,获取应用签名摘要信息
• 新增: geolocation接口新增chooseLocation方法,打开地图选择位置
• 新增: geolocation接口新增openLocation方法,查看地图对应位置
• 新增: router接口新增getPages,返回当前页面栈列表和路径
• 新增: router接口push方法,params新增参数___PARAM_PAGE_ANIMATION___，可分别对openEnter、closeEnter、openExit、closeExit进行配置,来进行页面跳转动画定制
• 新增: network接口新增getSimOperators,获取 Sim 卡的运营商信息
• 新增：network接口getType新增5g,bluetooth,others网络类型
• 新增：app接口新增createQuickAppQRCode,可生成当前快应用信息的分享二维码
• 新增：account接口新增getPhoneNumber方法,获取用户的手机号码
• 新增： configuration接口新增getThemeMode方法,获取应用当前的主题模式
• 新增： webview接口loadUrl新增showloadingdialog参数,控制是否展示默认加载框
• 新增： device接口新增host,获取宿主信息

v1.6.0

此版本配套快应用平台版本为 v1060

框架

• 新增：manifest.json中display新增textSizeAdjust 属性示例
• 新增：manifest.json中config新增 network 属性示例
• 新增：manifest.json中dispaly新增 fitCutout 属性, 适配异形屏示例
• 新增：页面对象 $page 新增 query 属性，获取页面参数示例
• 新增: manifest.json中 router 新增 errorPage 字段，可以自定义错误页面；如果不配置的话，在页面跳转异常时，会跳转到系统默认的错误页
• 新增: app.ux 新增 onPageNotFound生命回调，在页面跳转异常时会触发回调，回调参数为一个对象，里有错误地址uri

组件

• 新增: 新增组件 marquee,可设置 文本的跑马灯功能示例示例
• 新增: 组件新增属性 aria-label,无障碍模式示例
• 新增: canvas 组件新增 shadowBlur 、shadowColor 、 shadowOffsetX 、 shadowOffsetY 属性示例
• 新增: list 组件，scrollTo 方法新增 smooth 属性,设置页面平滑滚动示例
• 新增: textarea 组件，新增 onlinechange 事件,监听输入框行数变化示例
• 优化：map子组件custommarker示例
• 优化：image 组件alt优化，可以传入字符串 blank ，在不传入值的时候系统会设置默认灰色占位图

样式

• 新增: input 组件自定义光标颜色示例
• 新增： relative，absolute, fixed 定位示例Demo
• 新增: position属性新增relative和absolute,默认值现在为relative

接口

• 新增: device 接口的 getId ,参数 type 新增 oaid 类型,返回参数新增 oaid 及 device新增oaid 值,获取匿名设备标识符示例
• 新增: device 接口的 getDeviceId,返回参数 deviceId 新增 oaid 值,获取匿名设备标识符示例
• 新增: device 接口的 getInfo 方法,新增 异形区域参数 cutout 示例
• 新增: file 接口新增 mkdir 方法,创建目录示例
• 新增: file 接口新增 rmdir 方法,删除目录示例
• 新增: prompt 接口的 showDialog 方法,新增是否在点击遮罩时关闭对话框的参数 autocancel示例
• 新增: webview 接口打开的网页中,新增 deeplink 打开快应用示例
• 新增: bluetooth 接口新增状态码 10010示例
• 新增: brightness 接口新增 setKeepScreenOn 设置常亮状态示例
• 新增: 新增 zip 解压压缩文件示例
• 新增: sensor 接口的 subscribeAccelerometer 新增监听加速度数据回调函数的执行频率 参数 interval 示例
• 新增: media 接口的 takePhoto 、takeVideo 、 pickImage 、 pickVideo 、 pickFile方法,返回参数新增 name，size 示例
• 新增: media 接口的 pickImages 、pickVideos 方法,返回参数新增 选取的文件列表files示例
• 新增: cipher 接口的 aes 方法,支持 AES 加解密能力示例
• 新增: configuration 接口配置多语言环境

v1.5.0

此版本配套快应用平台版本为 v1050

框架

• 新增 通用事件resize示例
• 新增 组件绑定data属性示例
• 新增 自定义组件支持onInit,onReady,onDestory生命周期示例
• 新增 computed属性 示例
• 新增 自定义过滤器 示例
• 新增 $page对象的 windowHeight,windowWidth 属性示例

组件

• 优化 span组件嵌套span组件示例
• 新增 input 组件支持tel 类型示例
• 新增 stack组件 fullscreenchange 事件示例
• 新增：slot 组件，默认内容设置 示例
• 新增：slot 组件，具名插槽 示例

接口

• 为 geolocation 接口的subscribe方法新增preserved参数，设置是否持久化订阅示例
• 为 geolocation 接口的新增getSupportedCoordTypes方法，获取支持的坐标系类型示例
• 为 image 接口的editImage方法 新增aspectRationX,aspectRationY参数，裁剪图片示例
• 为 sms 接口 新增 readSafely 方法，获取手机短信内容示例
• 为 storage 接口 新增 key 方法，返回键名 示例
• 为 contact 接口 增加 list 方法，获取通讯录所有联系人列表 示例

样式

• 为 span 组件，font-weight 样式新增 lighter、 bolder 、数值设置示例
• 为 text 组件，font-weight 样式新增 lighter、 bolder 、数值设置示例

v1.4.1

新增快应用常见功能及场景示例

框架

• 新增样式与布局相关的示例 4 个
  1. 样式示例
  2. less 示例
  3. flex 布局示例
  4. 动态修改样式
• 新增指令相关的示例 4 个
  1. 指令 for
  2. 指令 if 和指令 show
  3. 组件 block
  4. 组件 slot
• 新增事件监听与触发相关的示例 2 个
  1. 自定义事件
  2. 原生组件事件
• 新增优化技巧相关的示例 2 个
  1. 代理 JSON.parse
  2. 回调函数
• 新增父子组件通信和兄弟组件通信示例

场景

• 新增细粒度划分 list-item 示例
• 新增页签内容懒加载示例

v1.4.0

此版本配套快应用平台版本为 v1040

框架

• 新增蓝牙功能示例
• 新增支持 RPK 分包加载示例
• 新增系统闹钟设置示例
• 新增系统铃声示例

组件

• 新增 camera 组件示例
• 为 tab-content 组件增加 scrollable 属性示例
• 为 refresh 组件增加 type 属性示例
• 为 audio 组件增加 streamType 属性示例
• 为 media 组件增加选取图片示例
• 为 list 组件增加 scrollend 、scrolltouchup 事件示例
• 为 canvas 组件增加 setLineDash 方法和 lineDashOffset 属性示例
• 为 map 组件增加指南针、俯视(3D)、缩放、拖动、旋转等功能

接口

• 为 device 接口，增加获取设备序列号方法示例
• 为 media 接口，增加 previewImage 方法示例
• 为 prompt 接口，增加 showLoading 方法和 hideLoading 方法示例
• 为 image 接口，增加 getExifAttributes 方法示例
• 为 media 接口的 pickImages 方法，增加支持选择多张图片示例
• 为 router 接口 push 方法，跳转到短信发送页面时，可以插入短信内容示例

样式

• 增加 通用样式支持 z-index示例
• 增加 flexbox 容器下的元素支持 margin:auto示例
• 增加 text 组件，支持 text-indent 段落缩进示例
• 增加 video、image 组件支持 object-fit 样式示例
• 增加 flex-direction 属性，支持 row-reverse 和 column-reverse示例
• 增加 color 属性，支持 hsl示例

v1.3.0

此版本配套快应用平台版本为 v1030

框架

• 在 app.ux 中新增全局错误监听示例

组件

• 为 input 组件和 textarea 组件新增 selectionchange 事件示例
• 为 image 组件增加 complete, error 事件示例
• 为 video 组件增加 muted 属性示例
• 为 tab-content 组件增加 scrollable 属性示例
• 为 audio 组件增加 stop 方法示例

接口

• 新增在创建图标的对话框中自定义提示信息示例
• 新增短时振动示例
• 为 WebSocket 新增支持 ArrayBuffer 示例

样式

• 新增 font-family, font-face 示例
• 新增 justify-content: space-around 示例
• background-image 支持网络图片地址

v1.0.2

此版本配套快应用平台版本为 v1020

组件

• 新增 map 组件
• 新增 canvas 组件
• web 组件支持文件下载能力
• web 组件支持通信能力

接口

• 新增 wifi 接口
• shortcut 接口允许开启和禁止快应用平台创建快捷方式的弹窗提示

v1.0.1

此版本配套快应用平台版本为 v1010

框架

• 新增$app.exit与$page.finish 方法，退出应用/页面

组件

• input 增加 maxLength 属性
• swiper 增加 loop 开关
• Promise 化接口请求操作
• 文本编辑类组件增加 selection 能力
• list 组件 scroll 事件参数增加 scrollState
• video 组件新增 controls 属性，控制是否显示播放控件
• 首页及 input 组件页新增 active 伪类样式
• div 组件新增 justify-content, align-items, align-self 样式的 demo
• audio 新增控制音频播放通知显隐的 demo
• 新增 multi-picker 组件，支持多列选择器

接口

• 新增本地文件读写接口 demo
• 新增选择本地文件接口 demo
• 新增保存图片、视频到相册 demo
• 新增微信帐号接口、QQ 帐号接口、微博帐号接口 demo
• 新增第三方分享指定渠道 demo
• 新增 fetch 对 contenttype 的处理 demo
• 新增联系人接口 demo
• 新增发送短信接口 demo
• 地理位置增加获取系统当前支持的定位类型的能力
• 扩展 record 接口，支持设置录音时长，采样率，录音通道数，编码码率以及音频格式
• 下载文件时(request.download)可指定 description、filename
• router 接口可直接打开指定快应用

样式动画

• 新增 background-image 支持.9 图 demo
• 新增背景图片支持 background-position 的 demo
• 新增 translate 支持百分比 demo