Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

hexo-butterfly-wowjs

Akilarlxh831Apache-2.01.0.5

An animate plugin for theme-butterfly

hexo, renderer, wowjs, animate.css, butterfly, theme-butterfly, plugins

readme

hexo-butterfly-wowjs

hexo-theme-butterfly添加 wowjs特效

安装

  1. 安装插件,在博客根目录[Blogroot]下打开终端,运行以下指令:

    npm install hexo-butterfly-wowjs --save
  2. 添加配置信息,以下为写法示例 在站点配置文件_config.yml或者主题配置文件_config.butterfly.yml中添加

    wowjs:
     enable: true #控制动画开关。true是打开,false是关闭
     priority: 10 #过滤器优先级
     mobile: false #移动端是否启用,默认移动端禁用
     animateitem:
       - class: recent-post-item #必填项,需要添加动画的元素的class
         style: animate__zoomIn #必填项,需要添加的动画
         duration: 2s #选填项,动画持续时间,单位可以是ms也可以是s。例如3s,700ms。
         delay: 1s #选填项,动画开始的延迟时间,单位可以是ms也可以是s。例如3s,700ms。
         offset: 100 #选填项,开始动画的距离(相对浏览器底部)
         iteration: 2 #选填项,动画重复的次数
       - class: card-widget
         style: animate__zoomIn
     animate_css: https://unpkg.zhimg.com/hexo-butterfly-wowjs/lib/animate.min.css
     wow_js: https://unpkg.zhimg.com/hexo-butterfly-wowjs/lib/wow.min.js
     wow_init_js: https://unpkg.zhimg.com/hexo-butterfly-wowjs/lib/wow_init.js
  3. 参数释义

    |参数|备选值/类型|释义| |:--|:--|:--| |enable|true/false|【必选】控制开关| |priority|number|【可选】过滤器优先级,数值越小,执行越早,默认为10,选填| |mobile|true/false|控制移动端是否启用,默认移动端禁用| |animateitem.class|class|【可选】添加动画类名,只支持给class添加| |animateitem.style|text|【可选】动画样式,具体类型参考animate.css| |animateitem.duration|time,单位为s或ms|【可选】动画持续时间,单位可以是ms也可以是s。例如3s,700ms。| |animateitem.delay|time,单位为s或ms|【可选】动画开始的延迟时间,单位可以是ms也可以是s。例如3s,700ms。| |animateitem.offset|number,单位为px|【可选】开始动画的距离(相对浏览器底部)。| |animateitem.iteration|number,单位为s或ms|【可选】动画重复的次数| |animate_css|URL|【可选】animate.css的CDN链接,默认为https://unpkg.zhimg.com/hexo-butterfly-wowjs/lib/animate.min.css| |wow_js|URL|【可选】wow.min.js的CDN链接,默认为https://unpkg.zhimg.com/hexo-butterfly-wowjs/lib/wow.min.js| |wow_init_js|URL|【可选】wow_init.js的CDN链接,默认为https://unpkg.zhimg.com/hexo-butterfly-wowjs/lib/wow_init.js|

  4. 更多动画样式可以查看animate.css参考文档。

外挂标签用法

您也可以在您的文章中应用动画效果。动画样式可以查看animate.css参考文档

  1. 外挂标签语法
    {% wow [animete],[duration],[delay],[offset],[iteration] %}
    {% endwow %}
  2. 写法示例
    • flip动画效果。
      {% wow animate__flip %}
      {% note green 'fas fa-fan' modern%}
      `flip`动画效果。
      {% endnote %}
      {% endwow %}
    • zoomIn动画效果,持续5s,延时5s,离底部100距离时启动,重复10次。
      {% wow animate__zoomIn,5s,5s,100,10 %}
      {% note blue 'fas fa-bullhorn' modern%}
      `zoomIn`动画效果,持续`5s`,延时`5s`,离底部`100`距离时启动,重复`10`次
      {% endnote %}
      {% endwow %}
    • slideInRight动画效果,持续5s,延时5s
      {% wow animate__slideInRight,5s,5s %}
      {% note orange 'fas fa-car' modern%}
      `slideInRight`动画效果,持续`5s`,延时`5s`。
      {% endnote %}
      {% endwow %}
    • heartBeat动画效果,延时5s,重复10次。此处注意不用的参数位置要留空,用逗号间隔。
      {% wow animate__heartBeat,,5s,,10 %}
      {% note red 'fas fa-battery-half' modern%}
      `heartBeat`动画效果,延时`5s`,重复`10`次。
      {% endnote %}
      {% endwow %}