# 通用方法

通用方法,提供给所有组件调用的方法

在组件使用id标记 id 属性后,开发者可通过this.$element('idName')获取 dom 节点,再调用以下列举的通用方法

id属性赋值可以查看此文档入门

this.$element可以查看此文档入门

# getBoundingClientRect(Object object) 2+

返回元素的大小及其相对于视窗的位置

# 参数

Object object

属性 类型 默认值 必填 描述
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# object.success 回调函数

# 参数

Object rect

属性 类型 描述
left number 元素的左边界坐标
right number 元素的右边界坐标
top number 元素的上边界坐标
bottom number 元素的下边界坐标
width number 元素的宽度
height number 元素的高度

# 示例代码

<template>
  <div>
    <div id="box1" class="box-normal"></div>
    <div id="box2" class="box-normal"></div>
  </div>
</template>
<script>
  export default {
    onShow() {
      this.$element('box1').getBoundingClientRect({
        success: function (data) {
          const { top, bottom, left, right, width, height } = data
          prompt.showToast({
            message: `getBoundingClientRect结果: width:${width}, height:${height},
                         top:${top}, bottom:${bottom}, left:${left}, right:${right}`,
          })
        },
        fail: (errorData, errorCode) => {
          prompt.showToast({
            message: `错误原因:${JSON.stringify(errorData)}, 错误代码:${errorCode}`,
          })
        },
        complete: function () {
          console.info('complete')
        },
      })
    },
  }
</script>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29