xt-element-ui 2.2.3 → 2.2.4

package/lib/xt-scroll-arrow/xt-scroll-arrow.common.js

@@ -94,6 +94,13 @@ module.exports =
 
 /***/ }),
 
+/***/ "f699":
+/***/ (function(module, exports, __webpack_require__) {
+
+// extracted by mini-css-extract-plugin
+
+/***/ }),
+
 /***/ "fb15":
 /***/ (function(module, __webpack_exports__, __webpack_require__) {
 
@@ -123,32 +130,465 @@ if (typeof window !== 'undefined') {
 // EXTERNAL MODULE: ./src/components/xt-scroll-arrow/style/index.scss
 var style = __webpack_require__("4e56");
 
-// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"d8e97dbc-vue-loader-template"}!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--5!./node_modules/cache-loader/dist/cjs.js??ref--1-0!./node_modules/vue-loader/lib??vue-loader-options!./src/components/xt-scroll-arrow/index.vue?vue&type=template&id=3d6a271c
-var render = function render(){var _vm=this,_c=_vm._self._c;return _c('div',{staticClass:"xt-scroll-arrow",class:[`xt-scroll-arrow--${_vm.direction}`],style:(_vm.containerStyle)},[(_vm.showLeftArrow)?_c('div',{staticClass:"xt-scroll-arrow__btn xt-scroll-arrow__btn--left",on:{"click":_vm.scrollLeft}},[_c('i',{staticClass:"el-icon-arrow-left"})]):_vm._e(),_c('div',{ref:"scrollContainer",staticClass:"xt-scroll-arrow__content",on:{"scroll":_vm.handleScroll,"click":_vm.handleClick}},[_vm._t("default")],2),(_vm.showRightArrow)?_c('div',{staticClass:"xt-scroll-arrow__btn xt-scroll-arrow__btn--right",on:{"click":_vm.scrollRight}},[_c('i',{staticClass:"el-icon-arrow-right"})]):_vm._e(),(_vm.showTopArrow && _vm.direction === 'vertical')?_c('div',{staticClass:"xt-scroll-arrow__btn xt-scroll-arrow__btn--top",on:{"click":_vm.scrollTop}},[_c('i',{staticClass:"el-icon-arrow-up"})]):_vm._e(),(_vm.showBottomArrow && _vm.direction === 'vertical')?_c('div',{staticClass:"xt-scroll-arrow__btn xt-scroll-arrow__btn--bottom",on:{"click":_vm.scrollBottom}},[_c('i',{staticClass:"el-icon-arrow-down"})]):_vm._e()])
+// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"1d9e3ae5-vue-loader-template"}!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--5!./node_modules/cache-loader/dist/cjs.js??ref--1-0!./node_modules/vue-loader/lib??vue-loader-options!./src/components/xt-scroll-arrow/index.vue?vue&type=template&id=6d59f4e4
+var render = function render(){var _vm=this,_c=_vm._self._c;return _c('div',{staticClass:"xt-scroll-arrow",class:[`xt-scroll-arrow--${_vm.direction}`],style:(_vm.containerStyle)},[(_vm.showLeftArrow)?_c('div',{staticClass:"xt-scroll-arrow__btn xt-scroll-arrow__btn--left",on:{"click":_vm.scrollLeft}},[_c('i',{staticClass:"el-icon-arrow-left"})]):_vm._e(),(_vm.showTopArrow && _vm.direction === 'vertical')?_c('div',{staticClass:"xt-scroll-arrow__btn xt-scroll-arrow__btn--top",on:{"click":_vm.scrollTop}},[_c('i',{staticClass:"el-icon-arrow-up"})]):_vm._e(),_c('xt-scroll',{ref:"scrollRef",class:['xt-scroll-arrow__content', _vm.scrollClass],attrs:{"v-scroll":_vm.vScroll,"data":_vm.vScrollData,"item-size":_vm.itemSize,"key-field":_vm.keyField,"buffer-size":_vm.bufferSize,"scroll-direction":_vm.direction,"loading":_vm.vScrollLoading,"load-more":_vm.loadMore,"load-more-text":_vm.loadMoreText,"load-more-loading":_vm.loadMoreLoading},on:{"scroll":_vm.onScroll,"load-more":function($event){return _vm.$emit('load-more')}},scopedSlots:_vm._u([(_vm.vScroll)?{key:"item",fn:function({ item, index }){return [_vm._t("vitem",function(){return [_c('div',{staticClass:"xt-scroll-arrow__vitem"},[_vm._v(_vm._s(item))])]},{"item":item,"index":index})]}}:{key:"default",fn:function(undefined){return _vm._t("default")}}],null,true)}),(_vm.showRightArrow)?_c('div',{staticClass:"xt-scroll-arrow__btn xt-scroll-arrow__btn--right",on:{"click":_vm.scrollRight}},[_c('i',{staticClass:"el-icon-arrow-right"})]):_vm._e(),(_vm.showBottomArrow && _vm.direction === 'vertical')?_c('div',{staticClass:"xt-scroll-arrow__btn xt-scroll-arrow__btn--bottom",on:{"click":_vm.scrollBottom}},[_c('i',{staticClass:"el-icon-arrow-down"})]):_vm._e()],1)
 }
 var staticRenderFns = []
 
 
-// CONCATENATED MODULE: ./src/components/xt-scroll-arrow/index.vue?vue&type=template&id=3d6a271c
+// CONCATENATED MODULE: ./src/components/xt-scroll-arrow/index.vue?vue&type=template&id=6d59f4e4
+
+// EXTERNAL MODULE: ./src/components/xt-scroll/style/index.scss
+var xt_scroll_style = __webpack_require__("f699");
+
+// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"1d9e3ae5-vue-loader-template"}!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--5!./node_modules/cache-loader/dist/cjs.js??ref--1-0!./node_modules/vue-loader/lib??vue-loader-options!./src/components/xt-scroll/index.vue?vue&type=template&id=74170e40
+var xt_scrollvue_type_template_id_74170e40_render = function render(){var _vm=this,_c=_vm._self._c;return _c('div',{staticClass:"xt-scroll",class:[`xt-scroll--${_vm.scrollDirection}`],style:(_vm.containerStyle)},[_c('div',{ref:"scrollWrap",staticClass:"xt-scroll__wrap",class:[`xt-scroll__wrap--${_vm.scrollDirection}`],on:{"scroll":_vm.onScroll}},[(_vm.vScroll)?_c('div',{staticClass:"xt-scroll__virtual",style:(_vm.virtualWrapperStyle)},[(_vm.scrollDirection === 'vertical')?_c('div',{staticClass:"xt-scroll__phantom",style:({ height: _vm.totalSize + 'px' })},[_c('div',{style:({ transform: `translateY(${_vm.offsetStart}px)` })},[_vm._l((_vm.visibleData),function(item,index){return [_c('div',{key:_vm.getItemKey(item, index),staticClass:"xt-scroll__item",class:_vm.itemClassName,style:(_vm.itemStyle)},[_vm._t("item",function(){return [_vm._v(" "+_vm._s(item)+" ")]},{"item":item,"index":_vm.getOriginalIndex(index)})],2)]})],2)]):(_vm.scrollDirection === 'horizontal')?_c('div',{staticClass:"xt-scroll__phantom",style:({ width: _vm.totalSize + 'px' })},[_c('div',{style:({ transform: `translateX(${_vm.offsetStart}px)` })},[_vm._l((_vm.visibleData),function(item,index){return [_c('div',{key:_vm.getItemKey(item, index),staticClass:"xt-scroll__item",class:_vm.itemClassName,style:(_vm.itemStyle)},[_vm._t("item",function(){return [_vm._v(" "+_vm._s(item)+" ")]},{"item":item,"index":_vm.getOriginalIndex(index)})],2)]})],2)]):_vm._e()]):_vm._e(),(_vm.vScroll && (!_vm.data || !_vm.data.length) && !_vm.loading)?_c('div',{staticClass:"xt-scroll__empty"},[_vm._t("empty",function(){return [_c('span',[_vm._v(_vm._s(_vm.emptyText))])]})],2):_vm._e(),(_vm.loading)?_c('div',{staticClass:"xt-scroll__loading"},[_vm._t("loading",function(){return [_c('i',{staticClass:"el-icon-loading"}),_c('span',[_vm._v("加载中...")])]})],2):_vm._e(),(!_vm.vScroll)?_c('div',{staticClass:"xt-scroll__default"},[_vm._t("default")],2):_vm._e(),(_vm.vScroll && _vm.showLoadMore && !_vm.loading)?_c('div',{staticClass:"xt-scroll__loadmore",on:{"click":_vm.onLoadMore}},[_c('el-button',{attrs:{"type":"text","loading":_vm.loadMoreLoading}},[_vm._v(" "+_vm._s(_vm.loadMoreText)+" ")])],1):_vm._e()])])
+}
+var xt_scrollvue_type_template_id_74170e40_staticRenderFns = []
+
+
+// CONCATENATED MODULE: ./src/components/xt-scroll/index.vue?vue&type=template&id=74170e40
+
+// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js??ref--1-0!./node_modules/vue-loader/lib??vue-loader-options!./src/components/xt-scroll/index.vue?vue&type=script&lang=js
+
+/* harmony default export */ var xt_scrollvue_type_script_lang_js = ({
+  name: 'XtScroll',
+
+  props: {
+    // ========== 虚拟滚动配置 ==========
+    /** 是否启用虚拟滚动 */
+    vScroll: { type: Boolean, default: false },
+    /** 数据源 */
+    data: { type: Array, default: () => [] },
+    /** 每个 item 的固定尺寸（px），纵向为高度，横向为宽度 */
+    itemSize: { type: Number, default: 50 },
+    /** item 的唯一键字段名 */
+    keyField: { type: String, default: 'id' },
+    /** 预渲染缓冲区大小（item 数量） */
+    bufferSize: { type: Number, default: 5 },
+    /** 虚拟滚动方向 */
+    scrollDirection: {
+      type: String,
+      default: 'vertical',
+      validator: (v) => ['vertical', 'horizontal'].includes(v)
+    },
+    /** item 的自定义 CSS 类名 */
+    itemClassName: { type: String, default: '' },
+
+    // ========== 容器尺寸 ==========
+    height: { type: [Number, String], default: '' },
+    maxHeight: { type: [Number, String], default: '' },
+    width: { type: [Number, String], default: '' },
+    maxWidth: { type: [Number, String], default: '' },
+
+    // ========== 状态 ==========
+    loading: { type: Boolean, default: false },
+    emptyText: { type: String, default: '暂无数据' },
+
+    // ========== 加载更多 ==========
+    loadMore: { type: Boolean, default: false },
+    loadMoreText: { type: String, default: '加载更多' },
+    loadMoreLoading: { type: Boolean, default: false }
+  },
+
+  data() {
+    return {
+      scrollPos: 0,
+      containerSize: 0,
+      resizeObserver: null,
+      rafId: null
+    }
+  },
+
+  computed: {
+    containerStyle() {
+      const style = {}
+      if (this.height) {
+        style.height = typeof this.height === 'number' ? this.height + 'px' : this.height
+      }
+      if (this.maxHeight) {
+        style.maxHeight = typeof this.maxHeight === 'number' ? this.maxHeight + 'px' : this.maxHeight
+      }
+      if (this.width) {
+        style.width = typeof this.width === 'number' ? this.width + 'px' : this.width
+      }
+      if (this.maxWidth) {
+        style.maxWidth = typeof this.maxWidth === 'number' ? this.maxWidth + 'px' : this.maxWidth
+      }
+      return style
+    },
+
+    virtualWrapperStyle() {
+      const style = {}
+      if (this.scrollDirection === 'horizontal') {
+        style.height = '100%'
+      }
+      return style
+    },
+
+    itemStyle() {
+      return this.scrollDirection === 'vertical'
+        ? { height: this.itemSize + 'px' }
+        : { width: this.itemSize + 'px', display: 'inline-block' }
+    },
+
+    /** 数据总条数 */
+    dataCount() {
+      return (this.data && this.data.length) || 0
+    },
+
+    /** 总滚动尺寸 */
+    totalSize() {
+      return this.dataCount * this.itemSize
+    },
+
+    /** 虚拟滚动：可见范围起始索引 */
+    visibleStartIndex() {
+      if (!this.vScroll) return 0
+      const start = Math.floor(this.scrollPos / this.itemSize)
+      return Math.max(0, start - this.bufferSize)
+    },
+
+    /** 虚拟滚动：可见范围结束索引 */
+    visibleEndIndex() {
+      if (!this.vScroll) return this.dataCount
+      const visibleCount = Math.ceil(this.containerSize / this.itemSize)
+      const end = Math.ceil(this.scrollPos / this.itemSize) + visibleCount
+      return Math.min(this.dataCount, end + this.bufferSize)
+    },
+
+    /** 可见数据 */
+    visibleData() {
+      if (!this.vScroll || !this.data) return this.data || []
+      return this.data.slice(this.visibleStartIndex, this.visibleEndIndex)
+    },
+
+    /** 偏移量（px） */
+    offsetStart() {
+      return this.visibleStartIndex * this.itemSize
+    },
+
+    /** 是否显示加载更多 */
+    showLoadMore() {
+      if (!this.loadMore || !this.dataCount) return false
+      if (this.scrollDirection === 'vertical') {
+        return this.scrollPos + this.containerSize >= this.totalSize - this.itemSize * 2
+      }
+      return false
+    }
+  },
+
+  watch: {
+    data: {
+      handler() {
+        this.$nextTick(() => {
+          this.updateContainerSize()
+        })
+      }
+    },
+    vScroll(val) {
+      if (val) {
+        this.$nextTick(() => {
+          this.updateContainerSize()
+          this.bindResizeObserver()
+        })
+      }
+    }
+  },
+
+  mounted() {
+    this.$nextTick(() => {
+      this.updateContainerSize()
+      if (this.vScroll) {
+        this.bindResizeObserver()
+      }
+    })
+  },
+
+  beforeDestroy() {
+    this.unbindResizeObserver()
+    if (this.rafId && typeof cancelAnimationFrame !== 'undefined') {
+      cancelAnimationFrame(this.rafId)
+      this.rafId = null
+    }
+  },
+
+  methods: {
+    // ========== 虚拟滚动 ==========
+    onScroll() {
+      const wrap = this.$refs.scrollWrap
+      if (!wrap) return
+
+      const pos = this.scrollDirection === 'vertical' ? wrap.scrollTop : wrap.scrollLeft
+      this.scrollPos = pos
+
+      // 对外 emit scroll 事件，传递 scrollTop/scrollLeft 方便父组件使用
+      this.$emit('scroll', {
+        scrollTop: wrap.scrollTop,
+        scrollLeft: wrap.scrollLeft
+      })
+
+      if (this.rafId) return
+      if (typeof requestAnimationFrame === 'undefined') return
+      this.rafId = requestAnimationFrame(() => {
+        this.$forceUpdate()
+        this.rafId = null
+      })
+    },
+
+    getItemKey(item, index) {
+      if (item && typeof item === 'object' && this.keyField && item[this.keyField] != null) {
+        return item[this.keyField]
+      }
+      return `vitem_${this.visibleStartIndex + index}`
+    },
+
+    getOriginalIndex(index) {
+      return this.visibleStartIndex + index
+    },
+
+    // ========== 容器尺寸 ==========
+    updateContainerSize() {
+      const wrap = this.$refs.scrollWrap
+      if (!wrap) return
+
+      this.containerSize = this.scrollDirection === 'vertical'
+        ? wrap.clientHeight
+        : wrap.clientWidth
+    },
+
+    bindResizeObserver() {
+      if (typeof ResizeObserver === 'undefined') return
+      this.unbindResizeObserver()
+
+      const wrap = this.$refs.scrollWrap
+      if (!wrap) return
+
+      this.resizeObserver = new ResizeObserver(() => {
+        this.updateContainerSize()
+      })
+      this.resizeObserver.observe(wrap)
+    },
+
+    unbindResizeObserver() {
+      if (this.resizeObserver) {
+        this.resizeObserver.disconnect()
+        this.resizeObserver = null
+      }
+    },
+
+    // ========== 加载更多 ==========
+    onLoadMore() {
+      this.$emit('load-more')
+    },
+
+    // ========== 对外暴露方法 ==========
+    /** 获取原生滚动容器 DOM 元素 */
+    getScrollContainer() {
+      return this.$refs.scrollWrap
+    },
+
+    /** 滚动到指定位置 */
+    scrollTo(pos, behavior) {
+      const wrap = this.$refs.scrollWrap
+      if (!wrap) return
+
+      const opts = behavior && typeof behavior === 'string'
+        ? { behavior }
+        : { behavior: 'smooth' }
+
+      if (this.scrollDirection === 'vertical') {
+        wrap.scrollTo({ top: pos, ...opts })
+      } else {
+        wrap.scrollTo({ left: pos, ...opts })
+      }
+    },
+
+    /** 滚动到指定索引的 item */
+    scrollToItem(index) {
+      const pos = index * this.itemSize
+      this.scrollTo(pos)
+    },
+
+    /** 滚动到顶部/左侧 */
+    scrollToStart() {
+      this.scrollTo(0)
+    },
+
+    /** 滚动到底部/右侧 */
+    scrollToEnd() {
+      this.scrollTo(this.totalSize)
+    },
+
+    /** 获取当前滚动位置 */
+    getScrollPos() {
+      return this.scrollPos
+    }
+  }
+});
+
+// CONCATENATED MODULE: ./src/components/xt-scroll/index.vue?vue&type=script&lang=js
+ /* harmony default export */ var components_xt_scrollvue_type_script_lang_js = (xt_scrollvue_type_script_lang_js); 
+// CONCATENATED MODULE: ./node_modules/vue-loader/lib/runtime/componentNormalizer.js
+/* globals __VUE_SSR_CONTEXT__ */
+
+// IMPORTANT: Do NOT use ES2015 features in this file (except for modules).
+// This module is a runtime utility for cleaner component module output and will
+// be included in the final webpack user bundle.
+
+function normalizeComponent(
+  scriptExports,
+  render,
+  staticRenderFns,
+  functionalTemplate,
+  injectStyles,
+  scopeId,
+  moduleIdentifier /* server only */,
+  shadowMode /* vue-cli only */
+) {
+  // Vue.extend constructor export interop
+  var options =
+    typeof scriptExports === 'function' ? scriptExports.options : scriptExports
+
+  // render functions
+  if (render) {
+    options.render = render
+    options.staticRenderFns = staticRenderFns
+    options._compiled = true
+  }
+
+  // functional template
+  if (functionalTemplate) {
+    options.functional = true
+  }
+
+  // scopedId
+  if (scopeId) {
+    options._scopeId = 'data-v-' + scopeId
+  }
+
+  var hook
+  if (moduleIdentifier) {
+    // server build
+    hook = function (context) {
+      // 2.3 injection
+      context =
+        context || // cached call
+        (this.$vnode && this.$vnode.ssrContext) || // stateful
+        (this.parent && this.parent.$vnode && this.parent.$vnode.ssrContext) // functional
+      // 2.2 with runInNewContext: true
+      if (!context && typeof __VUE_SSR_CONTEXT__ !== 'undefined') {
+        context = __VUE_SSR_CONTEXT__
+      }
+      // inject component styles
+      if (injectStyles) {
+        injectStyles.call(this, context)
+      }
+      // register component module identifier for async chunk inferrence
+      if (context && context._registeredComponents) {
+        context._registeredComponents.add(moduleIdentifier)
+      }
+    }
+    // used by ssr in case component is cached and beforeCreate
+    // never gets called
+    options._ssrRegister = hook
+  } else if (injectStyles) {
+    hook = shadowMode
+      ? function () {
+          injectStyles.call(
+            this,
+            (options.functional ? this.parent : this).$root.$options.shadowRoot
+          )
+        }
+      : injectStyles
+  }
+
+  if (hook) {
+    if (options.functional) {
+      // for template-only hot-reload because in that case the render fn doesn't
+      // go through the normalizer
+      options._injectStyles = hook
+      // register for functional component in vue file
+      var originalRender = options.render
+      options.render = function renderWithStyleInjection(h, context) {
+        hook.call(context)
+        return originalRender(h, context)
+      }
+    } else {
+      // inject component registration as beforeCreate hook
+      var existing = options.beforeCreate
+      options.beforeCreate = existing ? [].concat(existing, hook) : [hook]
+    }
+  }
+
+  return {
+    exports: scriptExports,
+    options: options
+  }
+}
+
+// CONCATENATED MODULE: ./src/components/xt-scroll/index.vue
+
+
+
+
+
+/* normalize component */
+
+var component = normalizeComponent(
+  components_xt_scrollvue_type_script_lang_js,
+  xt_scrollvue_type_template_id_74170e40_render,
+  xt_scrollvue_type_template_id_74170e40_staticRenderFns,
+  false,
+  null,
+  null,
+  null
+  
+)
+
+/* harmony default export */ var xt_scroll = (component.exports);
+// CONCATENATED MODULE: ./src/components/xt-scroll/index.js
+
+
+
+xt_scroll.install = function (Vue) {
+  Vue.component(xt_scroll.name, xt_scroll)
+}
+
+/* harmony default export */ var components_xt_scroll = (xt_scroll);
 
 // CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js??ref--1-0!./node_modules/vue-loader/lib??vue-loader-options!./src/components/xt-scroll-arrow/index.vue?vue&type=script&lang=js
 
+
+
 /* harmony default export */ var xt_scroll_arrowvue_type_script_lang_js = ({
   name: 'XtScrollArrow',
+
+  components: {
+    XtScroll: components_xt_scroll
+  },
+
   props: {
+    // ========== 滚动方向 ==========
     direction: {
       type: String,
       default: 'horizontal',
       validator: (val) => ['horizontal', 'vertical'].includes(val)
     },
+
+    // ========== 滚动步长 ==========
     scrollStep: {
       type: Number,
       default: 100
     },
+
+    // ========== 箭头显示 ==========
     autoHide: {
       type: Boolean,
       default: true
     },
+
+    // ========== 容器尺寸 ==========
     height: {
       type: [String, Number],
       default: ''
@@ -157,6 +597,8 @@ var staticRenderFns = []
       type: [String, Number],
       default: ''
     },
+
+    // ========== 模式 ==========
     appendMode: {
       type: Boolean,
       default: false
@@ -164,16 +606,65 @@ var staticRenderFns = []
     clickMode: {
       type: Boolean,
       default: false
+    },
+
+    // ========== 虚拟滚动配置 ==========
+    /** 是否启用虚拟滚动 */
+    vScroll: {
+      type: Boolean,
+      default: false
+    },
+    /** 虚拟滚动数据源 */
+    vScrollData: {
+      type: Array,
+      default: () => []
+    },
+    /** 每个 item 的固定尺寸（px） */
+    itemSize: {
+      type: Number,
+      default: 50
+    },
+    /** item 的唯一键字段名 */
+    keyField: {
+      type: String,
+      default: 'id'
+    },
+    /** 预渲染缓冲区大小 */
+    bufferSize: {
+      type: Number,
+      default: 5
+    },
+    /** 虚拟滚动加载状态 */
+    vScrollLoading: {
+      type: Boolean,
+      default: false
+    },
+
+    // ========== 加载更多 ==========
+    loadMore: {
+      type: Boolean,
+      default: false
+    },
+    loadMoreText: {
+      type: String,
+      default: '加载更多'
+    },
+    loadMoreLoading: {
+      type: Boolean,
+      default: false
     }
   },
+
   data() {
     return {
       showLeftArrow: false,
       showRightArrow: false,
       showTopArrow: false,
-      showBottomArrow: false
+      showBottomArrow: false,
+      mutationObserver: null
     }
   },
+
   computed: {
     containerStyle() {
       const style = {}
@@ -184,27 +675,44 @@ var staticRenderFns = []
         style.width = typeof this.width === 'number' ? `${this.width}px` : this.width
       }
       return style
+    },
+    scrollClass() {
+      return this.vScroll ? 'xt-scroll-arrow__content--virtual' : ''
     }
   },
+
   watch: {
     direction() {
       this.$nextTick(() => {
         this.checkScroll()
       })
+    },
+    vScrollData: {
+      handler() {
+        this.$nextTick(() => {
+          this.checkScroll()
+        })
+      }
     }
   },
+
   mounted() {
     this.$nextTick(() => {
       this.checkScroll()
     })
     this.addResizeObserver()
-    this.addMutationObserver()
+    if (!this.vScroll) {
+      this.addMutationObserver()
+    }
   },
+
   beforeDestroy() {
     this.removeResizeObserver()
     this.removeMutationObserver()
   },
+
   methods: {
+    // ========== 尺寸监听 ==========
     addResizeObserver() {
       if (typeof ResizeObserver !== 'undefined') {
         this.resizeObserver = new ResizeObserver(() => {
@@ -212,17 +720,19 @@ var staticRenderFns = []
             this.checkScroll()
           })
         })
-        const container = this.$refs.scrollContainer
+        const container = this.$el
         if (container) {
           this.resizeObserver.observe(container)
         }
       }
     },
+
     removeResizeObserver() {
       if (this.resizeObserver) {
         this.resizeObserver.disconnect()
       }
     },
+
     addMutationObserver() {
       if (typeof MutationObserver !== 'undefined') {
         this.mutationObserver = new MutationObserver(() => {
@@ -233,28 +743,37 @@ var staticRenderFns = []
             }
           })
         })
-        const container = this.$refs.scrollContainer
+        const container = this.$refs.scrollRef
         if (container) {
-          this.mutationObserver.observe(container, {
-            childList: true,
-            subtree: true
-          })
+          const wrap = container.getScrollContainer && container.getScrollContainer()
+          if (wrap) {
+            this.mutationObserver.observe(wrap, {
+              childList: true,
+              subtree: true
+            })
+          }
         }
       }
     },
+
     removeMutationObserver() {
       if (this.mutationObserver) {
         this.mutationObserver.disconnect()
       }
     },
+
+    // ========== 滚动检测 ==========
     checkScroll() {
-      const container = this.$refs.scrollContainer
-      if (!container) return
+      const scrollRef = this.$refs.scrollRef
+      if (!scrollRef) return
+
+      const wrap = scrollRef.getScrollContainer && scrollRef.getScrollContainer()
+      if (!wrap) return
 
       if (this.direction === 'horizontal') {
-        const scrollLeft = container.scrollLeft
-        const scrollWidth = container.scrollWidth
-        const clientWidth = container.clientWidth
+        const scrollLeft = wrap.scrollLeft
+        const scrollWidth = wrap.scrollWidth
+        const clientWidth = wrap.clientWidth
         const maxScroll = scrollWidth - clientWidth
 
         this.showTopArrow = false
@@ -262,15 +781,15 @@ var staticRenderFns = []
 
         if (this.autoHide) {
           this.showLeftArrow = scrollLeft > 0
-          this.showRightArrow = maxScroll > 0 && scrollLeft < maxScroll
+          this.showRightArrow = maxScroll > 0 && scrollLeft < maxScroll - 1
         } else {
           this.showLeftArrow = maxScroll > 0
           this.showRightArrow = maxScroll > 0
         }
       } else {
-        const scrollTop = container.scrollTop
-        const scrollHeight = container.scrollHeight
-        const clientHeight = container.clientHeight
+        const scrollTop = wrap.scrollTop
+        const scrollHeight = wrap.scrollHeight
+        const clientHeight = wrap.clientHeight
         const maxScroll = scrollHeight - clientHeight
 
         this.showLeftArrow = false
@@ -278,181 +797,83 @@ var staticRenderFns = []
 
         if (this.autoHide) {
           this.showTopArrow = scrollTop > 0
-          this.showBottomArrow = maxScroll > 0 && scrollTop < maxScroll
+          this.showBottomArrow = maxScroll > 0 && scrollTop < maxScroll - 1
         } else {
           this.showTopArrow = maxScroll > 0
           this.showBottomArrow = maxScroll > 0
         }
       }
     },
-    handleScroll() {
+
+    onScroll() {
       this.checkScroll()
-      this.$emit('scroll', this.$refs.scrollContainer)
-    },
-    handleClick(e) {
-      if (!this.clickMode) return
-      const container = this.$refs.scrollContainer
-      if (!container) return
-      
-      const target = e.target
-      if (!target || target === container) return
-      
-      const containerRect = container.getBoundingClientRect()
-      const targetRect = target.getBoundingClientRect()
-      
-      const isVisible = (
-        targetRect.left >= containerRect.left &&
-        targetRect.right <= containerRect.right &&
-        targetRect.top >= containerRect.top &&
-        targetRect.bottom <= containerRect.bottom
-      )
-      
-      if (!isVisible) {
-        if (this.direction === 'horizontal') {
-          const scrollLeft = target.offsetLeft - (container.clientWidth - targetRect.width) / 2
-          container.scrollTo({ left: scrollLeft, behavior: 'smooth' })
-        } else {
-          const scrollTop = target.offsetTop - (container.clientHeight - targetRect.height) / 2
-          container.scrollTo({ top: scrollTop, behavior: 'smooth' })
-        }
-      }
+      this.$emit('scroll', this.$refs.scrollRef)
     },
+
+    // ========== 滚动操作 ==========
     scrollLeft() {
-      const container = this.$refs.scrollContainer
-      if (container) {
-        container.scrollBy({ left: -this.scrollStep, behavior: 'smooth' })
-      }
+      this._scrollBy(-this.scrollStep)
     },
+
     scrollRight() {
-      const container = this.$refs.scrollContainer
-      if (container) {
-        container.scrollBy({ left: this.scrollStep, behavior: 'smooth' })
-      }
+      this._scrollBy(this.scrollStep)
     },
+
     scrollTop() {
-      const container = this.$refs.scrollContainer
-      if (container) {
-        container.scrollBy({ top: -this.scrollStep, behavior: 'smooth' })
-      }
+      this._scrollBy(-this.scrollStep, 'vertical')
     },
+
     scrollBottom() {
-      const container = this.$refs.scrollContainer
-      if (container) {
-        container.scrollBy({ top: this.scrollStep, behavior: 'smooth' })
+      this._scrollBy(this.scrollStep, 'vertical')
+    },
+
+    _scrollBy(delta, dir) {
+      const direction = dir || this.direction
+      const scrollRef = this.$refs.scrollRef
+      if (!scrollRef) return
+
+      const wrap = scrollRef.getScrollContainer && scrollRef.getScrollContainer()
+      if (!wrap) return
+
+      if (direction === 'horizontal') {
+        wrap.scrollBy({ left: delta, behavior: 'smooth' })
+      } else {
+        wrap.scrollBy({ top: delta, behavior: 'smooth' })
       }
     },
+
     scrollToEnd() {
-      const container = this.$refs.scrollContainer
-      if (!container) return
+      const scrollRef = this.$refs.scrollRef
+      if (!scrollRef) return
+      const wrap = scrollRef.getScrollContainer && scrollRef.getScrollContainer()
+      if (!wrap) return
+
       if (this.direction === 'horizontal') {
-        container.scrollTo({ left: container.scrollWidth, behavior: 'smooth' })
+        wrap.scrollTo({ left: wrap.scrollWidth, behavior: 'smooth' })
       } else {
-        container.scrollTo({ top: container.scrollHeight, behavior: 'smooth' })
+        wrap.scrollTo({ top: wrap.scrollHeight, behavior: 'smooth' })
       }
+    },
+
+    // ========== 对外暴露方法 ==========
+    /** 获取滚动位置 */
+    getScrollPos() {
+      const scrollRef = this.$refs.scrollRef
+      if (!scrollRef) return 0
+      const wrap = scrollRef.getScrollContainer && scrollRef.getScrollContainer()
+      if (!wrap) return 0
+      return this.direction === 'horizontal' ? wrap.scrollLeft : wrap.scrollTop
+    },
+
+    /** 获取 xt-scroll 组件实例 */
+    getScrollInstance() {
+      return this.$refs.scrollRef
     }
   }
 });
 
 // CONCATENATED MODULE: ./src/components/xt-scroll-arrow/index.vue?vue&type=script&lang=js
  /* harmony default export */ var components_xt_scroll_arrowvue_type_script_lang_js = (xt_scroll_arrowvue_type_script_lang_js); 
-// CONCATENATED MODULE: ./node_modules/vue-loader/lib/runtime/componentNormalizer.js
-/* globals __VUE_SSR_CONTEXT__ */
-
-// IMPORTANT: Do NOT use ES2015 features in this file (except for modules).
-// This module is a runtime utility for cleaner component module output and will
-// be included in the final webpack user bundle.
-
-function normalizeComponent(
-  scriptExports,
-  render,
-  staticRenderFns,
-  functionalTemplate,
-  injectStyles,
-  scopeId,
-  moduleIdentifier /* server only */,
-  shadowMode /* vue-cli only */
-) {
-  // Vue.extend constructor export interop
-  var options =
-    typeof scriptExports === 'function' ? scriptExports.options : scriptExports
-
-  // render functions
-  if (render) {
-    options.render = render
-    options.staticRenderFns = staticRenderFns
-    options._compiled = true
-  }
-
-  // functional template
-  if (functionalTemplate) {
-    options.functional = true
-  }
-
-  // scopedId
-  if (scopeId) {
-    options._scopeId = 'data-v-' + scopeId
-  }
-
-  var hook
-  if (moduleIdentifier) {
-    // server build
-    hook = function (context) {
-      // 2.3 injection
-      context =
-        context || // cached call
-        (this.$vnode && this.$vnode.ssrContext) || // stateful
-        (this.parent && this.parent.$vnode && this.parent.$vnode.ssrContext) // functional
-      // 2.2 with runInNewContext: true
-      if (!context && typeof __VUE_SSR_CONTEXT__ !== 'undefined') {
-        context = __VUE_SSR_CONTEXT__
-      }
-      // inject component styles
-      if (injectStyles) {
-        injectStyles.call(this, context)
-      }
-      // register component module identifier for async chunk inferrence
-      if (context && context._registeredComponents) {
-        context._registeredComponents.add(moduleIdentifier)
-      }
-    }
-    // used by ssr in case component is cached and beforeCreate
-    // never gets called
-    options._ssrRegister = hook
-  } else if (injectStyles) {
-    hook = shadowMode
-      ? function () {
-          injectStyles.call(
-            this,
-            (options.functional ? this.parent : this).$root.$options.shadowRoot
-          )
-        }
-      : injectStyles
-  }
-
-  if (hook) {
-    if (options.functional) {
-      // for template-only hot-reload because in that case the render fn doesn't
-      // go through the normalizer
-      options._injectStyles = hook
-      // register for functional component in vue file
-      var originalRender = options.render
-      options.render = function renderWithStyleInjection(h, context) {
-        hook.call(context)
-        return originalRender(h, context)
-      }
-    } else {
-      // inject component registration as beforeCreate hook
-      var existing = options.beforeCreate
-      options.beforeCreate = existing ? [].concat(existing, hook) : [hook]
-    }
-  }
-
-  return {
-    exports: scriptExports,
-    options: options
-  }
-}
-
 // CONCATENATED MODULE: ./src/components/xt-scroll-arrow/index.vue
 
 
@@ -461,7 +882,7 @@ function normalizeComponent(
 
 /* normalize component */
 
-var component = normalizeComponent(
+var xt_scroll_arrow_component = normalizeComponent(
   components_xt_scroll_arrowvue_type_script_lang_js,
   render,
   staticRenderFns,
@@ -472,7 +893,7 @@ var component = normalizeComponent(
   
 )
 
-/* harmony default export */ var xt_scroll_arrow = (component.exports);
+/* harmony default export */ var xt_scroll_arrow = (xt_scroll_arrow_component.exports);
 // CONCATENATED MODULE: ./src/components/xt-scroll-arrow/index.js