AVM(Application-View-Model)前端组件化开发模式基于标准 Web Components 组件化思想,提供包含虚拟 DOM 和 Runtime 的编程框架 avm.js 以及多端统一编译工具,完全兼容 Web Components 标准,同时兼容 Vue 和 React 语法糖编写代码,编译工具将 Vue 和 React 相关语法糖编译转换为 avm.js 代码。
基于标准 Web Components 组件化思想,兼容 Vue / React 语法特性,通过一次编码,分别编译为 App、小程序代码,实现多端开发。
组件功能介绍
滑动单元格组件原理是主题部分把按钮进行遮挡,按钮通过绝对定位,定位在最右边,通过监听触摸事件(touch),判断滑动的方向和计算滑动的距离以此来判定显示和隐藏按钮。显示和隐藏按钮是通过对主体部分进行 css 的 transform 属性对主体元素进行移动,以达到显示和隐藏按钮的效果。
示例展示
组件开发
组件文件
easy-swipe-cell.stml
<template>
<view class="easy-swipe-cell_container" data-id={itemId} @touchstart="start" @touchmove="move" @touchend="end">
<view class="easy-swipe-cell_content" :style="itemId == touchIdNow?handleSwipe:'transform:translateX(0px)'">
<text>{itemContent}</text>
</view>
<view class="easy-swipe-cell_btn" id="btn">
<view class="easy-swipe-cell_btn-item" style="background-color: #ee0a24;" data-id={itemId} data-type='delete' @click="clickItem">
<text class="easy-swipe-cell_btn-item-label">删除</text>
</view>
<view class="easy-swipe-cell_btn-item" style="background-color: #07c160;" data-id={itemId} data-type='read' @click="clickItem">
<text class="easy-swipe-cell_btn-item-label">已读</text>
</view>
</view>
</view>
</template>
<script>
export default {
name: 'easy-swipe-cell',
props:{
itemId:String,
itemContent:String,
touchIdNow:String
},
data() {
return{
startX:0, //触摸位置
endX:0, //结束位置
moveX: 0, //滑动时的位置
disX: 0, //移动距离
handleSwipe: '',//滑动时的效果,动态绑定
touchId:''
}
},
mounted (){
},
methods: {
start(e){
// console.log(JSON.stringify(e.detail)+'开始');
this.data.startX = e.detail.x;
this.data.touchId = e.currentTarget.dataset.id;
this.fire('touch',this.data.touchId);
},
move(e){
// console.log(JSON.stringify(e.detail)+'移动');
let wd=document.getElementById('btn').offsetWidth;
this.data.moveX = e.detail.x;
this.data.disX = this.data.startX - this.data.moveX;
console.log(this.data.disX);
// 如果是向右滑动或者不滑动,不改变滑块的位置
if(this.disX < 0 || this.disX == 0) {
this.data.handleSwipe = "transform:translateX(0px)";
// 大于0,表示左滑了,此时滑块开始滑动
}else if (this.disX > 0) {
//具体滑动距离我取的是 手指偏移距离*5。
this.data.handleSwipe = "transform:translateX(-" + this.disX*5 + "px)";
// 最大也只能等于按钮宽度
if (this.disX*5 >=wd) {
this.handleSwipe = "transform:translateX(-" +wd+ "px)";
}
}
this.fire('touch',this.data.touchId);
},
end(e){
//console.log(JSON.stringify(e.detail)+'结束');
let wd=document.getElementById('btn').offsetWidth;
let endX = e.detail.x;
this.disX = this.data.startX - endX;
//如果距离小于按钮一半,强行回到起点
if ((this.disX*5) < (wd/2)) {
this.data.handleSwipe = "transform:translateX(0px)";
}else{
//大于一半 滑动到最大值
this.data.handleSwipe = "transform:translateX(-"+wd+ "px)";
}
this.fire('touch',this.data.touchId);
},
clickItem(e){
this.data.handleSwipe = "transform:translateX(0px)";
this.fire('clickBtn',{type:e.currentTarget.dataset.type,id:e.currentTarget.dataset.id});
}
}
}
</script>
<style>
.easy-swipe-cell_content{
justify-content: center;
background-color: #ffffff;
position: relative;
width: 100%;
left: 0;
right: 0;
top: 0;
bottom: 0;
z-index: 1000;
transition: 0.6s;
min-height: 50px;
padding: 10px;
}
.easy-swipe-cell_btn{
position: absolute;
right: 0;
top: 0;
display: flex;
flex-flow: row nowrap;
height: 100%;
z-index: 1;
}
.easy-swipe-cell_btn-item{
height: 100%;
justify-content: center;
}
.easy-swipe-cell_btn-item-label{
color: #ffffff;
font-size: 15px;
padding: 0 20px;
}
</style>
复制代码
组件使用说明
本组件是基于 AVM.js 开发的多端组件,通常同时适配 Android、iOS、小程序、H5 , 具体支持情况还要看每个组件的说明文档。
首先需要登录开发平台,http://www.apicloud.com。 通过控制平台右上方的模块 Store 进入,然后选择 AVM 组件。
找到对应模块点击进入。
也可通过搜索栏,通过组件名称关键字进行检索。
点击立即下载下载完整的组件安装包。
组件压缩包的文件目录如下
也可通过查看模块文档 来了解模块的具体参数,引用的原生模块,注意事项等。
具体在项目中的使用步骤是,第一步将压缩文件中的 easy-swiper-cell.stml 文件拷贝到项目的 components 目录,通过阅读 readme.md 文档和查看 demo 示例文件 demo-easy-swipe-cell.stml 在需要开发的 stml 文件中,引入组件文件,完成页面的开发。
demo-easy-swipe-cell.stml
<template>
<scroll-view class="page">
<safe-area></safe-area>
<view v-for="(item,index) in list">
<easy-swipe-cell
:itemId="item.id"
:itemContent="item.content"
:touchIdNow="touchID"
ontouch="getTouchID"
onclickBtn="getClickTyeAndId"
>
</easy-swipe-cell>
</view>
</scroll-view>
</template>
<script>
import '../../components/easy-swipe-cell.stml'
export default {
name: 'demo-easy-swipe-cell',
apiready(){//like created
},
data() {
return{
list:[{
id:'1',
content:'关于开展什么活动的通知'
},{
id:'2',
content:'这是一条新的系统通知'
},{
id:'3',
content:'您有一条新的消息提醒,请及时查看'
}],
touchID:''
}
},
methods: {
getTouchID(e){
console.log(JSON.stringify(e));
this.data.touchID = e.detail;
},
getClickTyeAndId(e){
console.log(JSON.stringify(e));
api.toast({
msg:'当前点击的是'+e.detail.type+'按钮,记录ID是'+e.detail.id
})
}
}
}
</script>
<style>
.page {
height: 100%;
}
</style>
复制代码
如果在 AVM 组件库中,没有找到实际项目中需要的组件,可以自己尝试封装组件。
这是组件化开发的在线文档地址
评论