手把手教你用原生JavaScript造轮子(三)——项目升级&填坑&重写组件

2020/4/9 5:01:22

本文主要是介绍手把手教你用原生JavaScript造轮子(三)——项目升级&填坑&重写组件,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

项目升级&填坑

说明

时隔大半年(错,应该是有生之年),我决定重启这个造轮子项目,原因有几点:

  1. 老项目结构太过臃肿
  2. 组件的一些实现思路存在比较大的问题
  3. 打包方式比较麻烦

所以我重新建立了一个叫 tiny-wheels 的项目,初衷和旧项目是一样的,主要是个人对于技术的学习、研究、总结,其次是探索使用原生 JavaScript 实现一些复杂组件的方法

注:旧项目已废弃,请直接使用新项目!

由于现在还未完成每个组件的单元测试,无法确保组件的稳定性,所以暂时不推荐在生产环境使用

本项目的源码:源码
关于各个组件的详细使用方式和效果可以查看本项目的文档:文档

求点赞,求 star~(✪ω✪)

填坑

架构优化

由于老项目的打包方式不太方便,所以这次的项目重新使用最新版本的WebpackBabel构建,采用UMD的模块化规范打包,同时兼容多种引入方式,不管是开发和使用都方便了不少,具体的使用方法可以查看文档中的相关说明

组件重写

有了 Webpack 这个强大的工具,我们就不需要使用旧语法编写代码了,所以新项目直接使用最新语法编写。

老项目中分页和轮播的实现较为臃肿,而且轮播图的实现思路存在很多问题,这次也重新把这两个组件实现了一遍,目前组件的基本功能已经实现完毕,可以查看文档中的效果以及源码

Pager

Pager

这个组件以前的逻辑没有太大的问题,核心原理是一样的,只是使用了一种更简单的方法实现

页码为 1,显示 1 2 3 ... 10
页码为 2,显示 1 2 3 4 ... 10
页码为 3,显示 1 2 3 4 5 ... 10
页码为 4,显示 1 2 3 4 5 6 ... 10
页码为 5,显示 1 ... 3 4 5 6 7 ... 10
页码为 6,显示 1 ... 4 5 6 7 8 ... 10
页码为 7,显示 1 ... 5 6 7 8 9 10
页码为 8,显示 1 ...6 7 8 9 10
页码为 9,显示 1 ... 7 8 9 10
页码为 10,显示 1 ... 8 9 10

要得到上面这种结构,老项目中使用的方法是:

function showPages (page, total, show) {
  var str = page + ''
  for (var i = 1; i <= show; i++) {
    if (page - i > 1) {
      str = page - i + ' ' + str
    }
    if (page + i < total) {
      str = str + ' ' + (page + i)
    }
  }
  if (page - (show + 1) > 1) {
    str = '... ' + str
  }
  if (page > 1) {
    str = 1 + ' ' + str
  }
  if (page + show + 1 < total) {
    str = str + ' ...'
  }
  if (page < total) {
    str = str + ' ' + total
  }
  return str
}

这样写,if-else 结构太多,很不利于维护,可以利用 es6 提供的reduce方法优化这段代码逻辑:

getPager () {
    const pages = [
        1,
        this.pageCount,
        this.pageCurrent,
        this.pageCurrent - 1,
        this.pageCurrent - 2,
        this.pageCurrent + 1,
        this.pageCurrent + 2
    ]
    const pageNumbers = [
        ...new Set(
        pages.filter(n => n >= 1 && n <= this.pageCount).sort((a, b) => a - b)
        )
    ]
    const pageItems = pageNumbers.reduce((items, current, index, array) => {
        items.push(current)
        if (array[index + 1] && array[index + 1] - array[index] > 1) {
            items.push('···')
        }
        return items
    }, [])
    return pageItems
}

原理是一模一样的,只是多了去重、排序等几步操作,但是代码得到了极大的简化
如果有更好的实现思路,欢迎给我提建议~

Carousel

Carousel

老项目中轮播组件的实现思路大概是这样的:

  1. 使用 JavaScript 计算子元素的序号
  2. 使用 position: absolute + left 或者 transform 控制父元素的位置,达到移动的动画效果

这种办法也是你能在网上找到的最常见的实现思路,但是稍微测试一下就会发现这种算法有很多缺陷:

  1. 频繁的 DOM 操作,性能低
  2. 在部分浏览器渲染下会出现闪烁的问题
  3. 动画算法不利于维护与功能拓展

拜读了element-uiiviewant-designbootstrap这些比较大型成熟的 UI 框架的源码后,发现它们都使用了另外一种更“先进”聪明的做法

其实要实现轮播的动画效果,根本不需要去计算每个子元素的序号以及对应的顺序变化,因为不管哪个方向,自始至终我们看到的都是两个子元素的移动效果而已,所以只需要给这两个移动中的元素添加对应的样式即可

具体实现思路是使用 CSS3 的transform属性来控制子元素的位置变化,配合transition添加过渡动画,在 JS 代码中只需要在合适的时机添加对应的类名,然后移出对应的类名

首先还是需要计算出当前正在过渡的两个元素的序号:

getCurrentIndex () {
    return [...this.$$dots].indexOf(
        this.$container.querySelector('.carousel-dot.active')
    )
}

getPrevIndex () {
    return (
        (this.getCurrentIndex() - 1 + this.$$dots.length) % this.$$dots.length
    )
}

getNextIndex () {
    return (this.getCurrentIndex() + 1) % this.$$dots.length
}

计算方法如上,非常简单,不再赘述
然后就可以给这两个元素加上对应的类名了:

setCarouselPanel ($from, $to, direction) {
    this.isAnimate = true
    window.requestAnimationFrame(() => {
        const { fromClass, toClass } = this.resetCarouselPanel($to, direction)
        window.requestAnimationFrame(() => {
        this.moveCarouselPanel(fromClass, toClass, $from, $to)
        })
    })
}
resetCarouselPanel ($to, direction) {
    let fromClass = ''
    let toClass = ''
    const type = direction === 'left' ? 'next' : 'prev'
    $to.setAttribute('class', `carousel-panel ${type}`)
    fromClass = `carousel-panel active ${direction}`
    toClass = `carousel-panel ${type} ${direction}`
    return { fromClass, toClass }
}
moveCarouselPanel (fromClass, toClass, $from, $to) {
    $from.setAttribute('class', fromClass)
    $to.setAttribute('class', toClass)
    setTimeout(() => {
        $from.setAttribute('class', 'carousel-panel')
        $to.setAttribute('class', 'carousel-panel active')
        this.isAnimate = false
    }, this.duration)
}

这里会遇到一个非常难解决的问题,因为我们的思路是先把两个元素的样式给重置,再添加新的样式,所以需要添加两次类名,然后让它们的样式依次作用到对应元素身上,最开始我是这样实现的:

let fromClass = ''
let toClass = ''
const type = direction === 'left' ? 'next' : 'prev'
$to.setAttribute('class', `carousel-panel ${type}`)
fromClass = `carousel-panel active ${direction}`
toClass = `carousel-panel ${type} ${direction}`
setTimeout(() => {
    $from.setAttribute('class', fromClass)
    $to.setAttribute('class', toClass)
}, 0)
setTimeout(() => {
    $from.setAttribute('class', 'carousel-panel')
    $to.setAttribute('class', 'carousel-panel active')
    this.isAnimate = false
}, 400)

第一个setTimeout是防止浏览器自动合并样式,第二个setTimeout是当动画结束后清除样式,而400ms刚好就是transition的时间,乍看上去好像没什么太大的问题,但是实际测试的时候发现会有很多诡异的Bug,检查了很久,最后定位到是第一个setTimeout的问题

原因就是使用setTimeout并不能100%的确保样式不会被自动合并,在一些很特殊的情况下浏览器仍然会自动合并样式,比如这种需要加载动画的情况,虽然大部分情况下是可行的。具体原理初步猜测和浏览器的渲染机制有关,查阅了很久的资料,先是在layui源码中发现了它的处理办法,直接给第一个setTimeout的延时设置为50ms,虽然不知道为什么要设置为这个值,但是经过我实际测试后发现确实解决了这个问题,后来继续搜索其他方案,最后还是在stackoverflow上找到了靠谱的解决方案

window.requestAnimationFrame(function(){
document.getElementById("two").setAttribute("style", "height: 0px");
 window.requestAnimationFrame(function(){
    document.getElementById("two").setAttribute("style", "height:  200px");
  });
});

使用了两次requestAnimationFrame方法,把改变样式的代码放入其中依次执行,经过我在多种浏览器上测试后,发现这种方案明显比setTimeout的办法更稳定可靠,所以最终我采用了这种办法处理浏览器自动合并样式的问题,具体的一些原因可以参考这个stackoverflow帖子里的答案

如果大家有更完美的避免样式合并的办法,或者更优雅高效的轮播算法,也欢迎分享给我~

关于分页和轮播组件的填坑差不多就这些了,基本功能都实现了,效果经过初步测试也没有太大的问题,一些更复杂的功能会在后续的更新里添加进去

进度

  • [x] Tabs-选项卡
  • [x] Collapse-折叠面板
  • [x] Pager-分页
  • [x] Carousel-走马灯
  • [ ] Calendar-日历
  • [ ] Tree-树形控件
  • [ ] 单元测试
  • [ ] TypeScript 重构

目前 TabsCollapsePagerCarousel 等四个组件的基本功能已经初步完成了,TabsCollapse以及后续更新组件的教程文章会陆续发布,敬请期待

本套教程会优先在我的博客更新,欢迎关注我的 个人网站Github



这篇关于手把手教你用原生JavaScript造轮子(三)——项目升级&填坑&重写组件的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!


扫一扫关注最新编程教程