小程序click-scroll组件设计

一. 背景

有些业务需求，要求前端展示的内容多时可以通过scroll的形式拖拉查看，但是太多的滚动条又造成页面太乱，于是封装了这个click-scroll 组件。在组件上设定好展示的位置和空间大小，在组件内部放置实际要展示的内容，实际展示的内容宽度或长或短都由此组件来控制。

二. 功能

组件内的内容宽度超过组件宽度时，组件两侧会自动出现『左右移动』交互。

当内部展示的内容超过组件的可见区域时，可以在组件的可见区域单击拖动查看内容

三. 背景知识，元素大小的测量

1.偏移量（offset dimension）:

元素在屏幕上占用的可见的所有空间，元素的可见大小由其高度、宽度决定，包括所有内边距、滚动条和边框大小。由四个值决定：offsetHeight、offsetWidth、offsetLeft和offsetRight。

2.客户区大小（client dimension）

元素内容及其内边距所占据空间的大小，滚动条占用的空间不计算在内。

3.滚动大小（scroll dimension）

包含滚动内容的元素的大小。

四. 组件设计思路

五. 使用文档

slot：

<click-scroll>
 <template slot="content">
 <div>
 我是实际要展示的内容啊啊啊啊啊……
 </div>
 </template>
</click-scroll>

六. 组件源码

<template>
 <div class="hui-hui" :id="domId.compID">
 <!--向左滑动-->
 <div class="hui-drag-left"
 :class="{'hui-drag-action': drag.isLeft}"
 v-if="drag.isShow"
 @click="onClickLeft">
 </div>

 <!--展示的内容-->
 <div :id="domId.containerID"
 class="hui-container"
 v-show="hasContent"
 ref='container'
 @mousedown="onMouseDown">
 <slot name="content"></slot>
 </div>
 <div v-show="!hasContent" class="hui-no-data">暂无数据</div>

 <!--向右滑动-->
 <div class="hui-drag-right"
 :class="{'hui-drag-action': drag.isRight}"
 v-if="drag.isShow"
 @click="onClickRight">
 </div>
 </div>
</template>

<script>
import store from '@/store'
export default {
 name: 'cards-container',
 data () {
 return {
 hasContent: false,
 domId: {
 compID: `hui-comp-${+new Date()}`,
 containerID: `hui-container-${+new Date()}`
 },
 drag: {
 isShow: false,
 isLeft: false,
 isRight: false
 }
 }
 },
 methods: {
 judgeHasContent () {
 this.hasContent = this.$slots.hasOwnProperty('content')
 },

 judgeDragIsShow () {
 const compWidth = this.getCompWidth()
 const contextMaxWidth = this.getContextMaxWidth()

 if (compWidth >= contextMaxWidth) {
 this.drag.isShow = false
 } else {
 this.drag.isShow = true
 }
 return this.drag.isShow
 },
 judgeIsLeft () {
 const containerDom = this.getContainerDom()
 const contentWidth = this.getContextMaxWidth()

 if (!containerDom && !contentWidth) this.drag.isLeft = false
 if (containerDom.offsetWidth + containerDom.scrollLeft >= contentWidth) {
 this.drag.isLeft = false
 } else {
 this.drag.isLeft = true
 }
 },
 judgeIsRight () {
 const containerDom = this.getContainerDom()

 if (!containerDom) this.drag.isRight = false
 if (containerDom.scrollLeft === 0) {
 this.drag.isRight = false
 } else {
 this.drag.isRight = true
 }
 },

 getCompDom () {
 return document.getElementById(this.domId.compID) || null
 },
 getCompWidth () {
 const compDom = this.getCompDom()
 if (!compDom) {
 return 0
 } else {
 return compDom.offsetWidth
 }
 },
 getContainerDom () {
 return document.getElementById(this.domId.containerID) || null
 },
 getContextMaxWidth () {
 if (!this.$refs.hasOwnProperty('container')) {
 return 0
 } else {
 const widthArr = []
 for(let e of this.$refs['container'].childNodes) {
 widthArr.push(e.offsetWidth)
 }
 return Math.max(...widthArr)
 }
 },

 onMouseDown (e) { // 手动滑动
 const containerDom = this.getContainerDom()
 if (!containerDom) return

 let scrollLeft = containerDom.scrollLeft
 const containerLeft = containerDom.offsetLeft
 let ev = e || window.event
 let offsetLeft = ev.clientX - containerLeft

 document.onmousemove = (e) => {
 let ev = e || window.event
 let nowOffsetLeft = ev.clientX - containerLeft
 containerDom.scrollLeft = scrollLeft + (offsetLeft - nowOffsetLeft)

 this.judgeIsLeft()
 this.judgeIsRight()
 }

 document.onmouseup = () => {
 document.onmousemove = null
 document.onmouseup = null
 }
 },

 onClickLeft () { // 向左滑动
 if (!this.hasContent && !this.drag.isLeft) return

 const containerDom = this.getContainerDom()
 if (!containerDom) return

 const scrollWidth = containerDom.offsetWidth
 containerDom.scrollLeft += scrollWidth

 this.judgeIsLeft()
 this.judgeIsRight()
 },

 onClickRight () { // 向右滑动
 if (!this.hasContent && !this.drag.isRight) return

 const containerDom = this.getContainerDom()
 if (!containerDom) return

 const scrollWidth = containerDom.offsetWidth
 containerDom.scrollLeft -= scrollWidth

 this.judgeIsLeft()
 this.judgeIsRight()
 }
 },
 updated () {
 this.$nextTick(() => {
 this.judgeHasContent()
 const isShow = this.judgeDragIsShow()
 if (isShow) {
 this.judgeIsLeft()
 this.judgeIsRight()
 }
 })
 },
 mounted () {
 this.judgeHasContent()
 const isShow = this.judgeDragIsShow()
 if (isShow) {
 this.judgeIsLeft()
 this.judgeIsRight()
 }
 }
}
</script>