评论

小程序拖动浮窗组件的一种实现(可二次封装业务组件使用)

本文介绍小程序拖动浮窗组件的一种实现,可通过较为完善的参数配置与二次封装快速实现特定需求。

文档

Fab 浮动按钮

可拖动的悬浮窗按钮

Props

参数 说明 类型 可选值 默认值
position 距离对象 Boolean {left:0,right:0,top:0,bottom:0}
left 左边距离(无需单位) Number 0
right 右边距离(无需单位) Number/String 0
top 顶部距离(无需单位) Number/String 0
bottom 底部距离(无需单位) Number/String 0
h-margin 拖动后的水平方向最小边距(左右边距) Number/String 10px
v-margin 拖动后的垂直方向最小边距(上下边距) Number/String 10px

注:rpx单位对应的是750的屏幕,上述属性取值使用375下的数值,如果是750设计稿在使用时需手动除2传入
浮动按钮位置仅推荐left、top / right 、bottom 两两使用,默认优先使用bottom、right配置

Slots

name 说明
default 悬浮窗默认插槽,用户可自定义内容及大小

Events

Methods

使用示例

  • 支持二次封装业务组件以复用
<!-- 375设计稿下位于右下10rpx、100rpx的浮动按钮 -->
<c-fab bottom="100" right='10'>
  <view class="float" style="width:100rpx;height:100rpx;border-radius: 99em;background:#fad84c;color:#333;display:flex;align-items:center;justify-content: center;">活动</view>
</c-fab>

完整实现代码

<movable-area>
  <movable-view bind:touchend="onTouchend" bind:touchmove="onTouchMove" bind:touchstart="addAnimation" animation="{{animation}}" style="width:{{elementWidth}}px;height:{{elementHeight}}px" x="{{x}}" y="{{y}}" direction="all">
    <view class="float-box" >
      <slot></slot>
    </view>
  </movable-view>
</movable-area>
Component({
  /**
   * 组件的属性列表
   */
  properties: {
    position: {
      type: Object,
      value: {
        left: 0,
        right: 0,
        bottom: 0,
        top: 0
      } // left、top、right、bottom
    },
    left: {
      type: Number,
      value: 0
    },
    right: {
      type: Number,
      value: 0
    },
    top: {
      type: Number,
      value: 0
    },
    bottom: {
      type: Number,
      value: 0
    },
    hMargin: { // 拖动后的水平方向最小边距(左右边距)
      type: Number,
      value: 10
    },
    vMargin: { // 拖动后的垂直方向最小边距(上下边距)
      type: Number,
      value: 10
    }
  },
  data: {
    x: 999,
    y: 999,
    windowWidth: wx.getSystemInfoSync().windowWidth,
    windowHeight: wx.getSystemInfoSync().windowHeight,
    elementWidth: 0,
    elementHeight: 0,
    animation: false,
    isMoved: false // 是否拖动
  },

  lifetimes: {
    attached() {
      // 初始化位置
      wx.createSelectorQuery().in(this).select('.float-box').boundingClientRect().exec((res) => {
        console.log(233, res);
        this.data.elementWidth = res[0].width;
        this.data.elementHeight = res[0].height;
        if (this.properties.position.left || this.properties.left) {
          this.data.x = this.properties.position.left || this.properties.left;
        }
        if (this.properties.position.right || this.properties.right) {
          this.data.x = this.data.windowWidth - this.data.elementWidth - (this.properties.position.right ? this.properties.position.right : this.properties.right);
        }
        if (this.properties.position.top || this.properties.top) {
          this.data.y = this.properties.position.top || this.properties.top;
        }
        if (this.properties.position.bottom || this.properties.bottom) {
          this.data.y = this.data.windowHeight - this.data.elementHeight - (this.properties.position.bottom ? this.properties.position.bottom : this.properties.bottom);
        }

        this.setData({
          elementWidth: this.data.elementWidth,
          elementHeight: this.data.elementHeight,
          x: this.data.x,
          y: this.data.y
        });
      });
    }
  },

  /**
   * 组件的方法列表
   */
  methods: {
    onTouchend(e) {
      console.log(this.data.isMoved, this.data.x, e.changedTouches[0].clientX, this.data.elementWidth);
      if (!this.data.isMoved) return;
      const currentX = e.changedTouches[0].clientX;
      let currentY = e.changedTouches[0].clientY;
      if (currentY <= this.properties.vMargin) {
        currentY = this.properties.vMargin + this.data.elementHeight / 2;
      }
      if (currentY >= this.data.windowHeight - this.properties.vMargin) {
        currentY = this.data.windowHeight - this.properties.vMargin - this.data.elementHeight / 2;
      }
      if (currentX + this.data.elementWidth / 2 > this.data.windowWidth / 2) {
        this.setData({
          x: this.data.windowWidth - this.properties.hMargin - this.data.elementWidth,
          y: currentY - this.data.elementHeight / 2
        });
      }
      if (currentX + this.data.elementWidth / 2 <= this.data.windowWidth / 2) {
        this.setData({
          x: this.properties.hMargin,
          y: currentY - this.data.elementHeight / 2
        });
      }
    },
    addAnimation() {
      this.data.isMoved = false;
      if (!this.data.animation) {
        this.setData({
          animation: true
        });
      }
    },
    onTouchMove() {
      this.data.isMoved = true;
    }
  }
});

movable-area {
	position: fixed;
	top: 0;
	left: 0;
	width: 100vw;
	height: 100vh;
	pointer-events: none;
	z-index: 50;

	movable-view {
		pointer-events: auto; //可以点击
	}
	.float-box {
		display: inline-block;
	}
}

{
  "component": true,
  "usingComponents": {}
}
最后一次编辑于  01-18  
点赞 3
收藏
评论

5 个评论

  • 知行
    知行
    06-18

    写的很好,已经完美使用,给你点个赞

    06-18
    赞同 1
    回复
  • 也
    12-04

    安卓机初始化位置不正确,一直在右下角

    12-04
    赞同
    回复 3
    • simple
      simple
      发表于小程序端
      12-05

      参数设置没反应吗

      12-05
      回复
    • 也
      12-05回复simple
      是的 没反应,苹果机正常,安卓机重新进入小程序就好了
      12-05
      回复
    • simple
      simple
      12-12回复
      好的,感谢反馈,后续会抽空排查更新
      12-12
      回复
  • 谷得(大罗)
    谷得(大罗)
    10-01

    赞一个

    10-01
    赞同
    回复
  • 数学嫁给我
    数学嫁给我
    07-04

    很厉害

    07-04
    赞同
    回复
  • 皮蛋瘦肉粥
    皮蛋瘦肉粥
    03-21

    写的很好,特地登上来给你点个赞

    03-21
    赞同
    回复
登录 后发表内容