项目升级&填坑

说明

时隔大半年（错，应该是有生之年），我决定重启这个造轮子项目，原因有几点：

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

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

注：旧项目已废弃，请直接使用新项目！

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

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

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

填坑

架构优化

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

组件重写

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

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

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

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

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

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

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

拜读了element-ui、iview、ant-design、bootstrap这些比较大型成熟的 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 重构

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

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