使用vue jsx写新手引导层组件e-guide-layer

使用场景

用户第一次进入页面,引导用户进行操作,并对引导区域进行说明,从而让用户更快速的了解产品功能。

引导层的实现方式

对目标dom节点进行镂空层覆盖,通过getBoundingClientRect获取dom的位置大小信息,从而设置镂空层的大小。

演示

源码

guide-layer

为什么使用jsx

配置render函数

对于大多数react组件配置项都带有自定义render项,但是使用vue并不能做到,而是通过slot来自定义内容,但这并不是我们想要的,所以我们需要借助jsx让一切可配置。

render: () => {
            return (
              <div
                style="background-color:#fff;"
                onClick={this.step1ClickHandle}
              >
                自定义引导层区域
              </div>
            )
          }

完整的配置示例

{
          confirmBtnText: '下一步',
          targetDom: '.step2',
          clickHandle: () => {
            this.guideActiveIndex = 2
            console.log(this)
          },
          render: () => {
            return (
              <div
                style="background-color:#fff;"
                onClick={this.step1ClickHandle}
              >
                自定义引导层区域
              </div>
            )
          }
        }

直观

render() {
    let currentIndex = this.current
    let currentActiveGuideItemData = this.guideList[currentIndex]
    // console.log('currentIndex', currentIndex, currentActiveGuideItemData)
    return (
      <div>
        {currentActiveGuideItemData && (
          <GuideItem
            key={currentIndex}
            targetDom={currentActiveGuideItemData.targetDom}
            confirmBtnText={currentActiveGuideItemData.confirmBtnText}
            direction={currentActiveGuideItemData.direction}
            vOn:confirm={currentActiveGuideItemData.clickHandle}
          >
            {currentActiveGuideItemData.render &&
              currentActiveGuideItemData.render()}
          </GuideItem>
        )}
      </div>
    )
  }

从代码中很容易理解如何展示当前的引导层。

使用

npm install e-guide-layer --save
import 'e-guide-layer/dist/e-guide-layer.css'
import eGuideLayer from 'e-guide-layer'

Vue.use(eGuideLayer)

基础代码示例

<e-guide-layer
      :current-index.sync="guideActiveIndex"
      :guide-list="guideList"
/>

export default {
    data() {
    return {
      guideActiveIndex: 0,
      guideList: [
        {
          confirmBtnText: '下一步',
          targetDom: '.step1',
          clickHandle: () => {
            this.guideActiveIndex = 1
          }
        },
        {
          confirmBtnText: '下一步',
          targetDom: '.step2',
          clickHandle: () => {
            this.guideActiveIndex = 2
          },
          render: () => {
            return (
              <div
                style="background-color:#fff;"
                onClick={this.step1ClickHandle}
              >
                自定义引导层区域
              </div>
            )
          }
        },
        {
          confirmBtnText: '知道了',
          targetDom: '.step3',
          direction: 'down',
          clickHandle: () => {
            this.guideActiveIndex = 3
          }
        }
      ],
    }
  },

  methods: {

  },
};

API 配置说明

e-guide-layer Props

参数说明类型默认值
guide-list引导层配置集合Array[]
current-index当前激活的引导层Number0
z-index引导层最小的z-index值Number999

guide-list的GuideItem 配置项

参数说明类型默认值
targetDom引导层指向的节点(class,id,dom)Stringnull
confirmBtnText引导层确定按钮String下一步
padding覆盖指向节点的paddng,使产生空隙Number6
guideImgSrc指向节点与确认按钮之间的图片String默认箭头图片
guideImgHeight指引图片的高度String30px
direction引导指示实在目标的上面还是下面 (up down)Stringup
clickHandle点击引导层确定按钮的事件functionnull
render使用jsx自定义的内容functionnull

资料

镂空遮盖层效果的研究
vue jsx官方文档
guide-layer

原文链接:segmentfault.com

上一篇:typography-breakpoint-constants
下一篇:parcel-plugin-bundle-visualiser

相关推荐

官方社区

扫码加入 JavaScript 社区