用 jQuery 和 Bootstrap 在 WordPress 中添加进度条

需求

昨天整理了一下Genesis的系列教程的翻译进度,汇总成了一个页面 神级 WordPress 主题框架 Genesis 从入门到精通 。今天突然想放一个进度条,可以直观看下显示一下翻译了几篇。

思路

手动更新肯定是不行的,程序员就是要懒。思路其实挺简单的,就是动态获取到已经翻译了几篇,除以总数得到百分比,并让页面上的进度条部分根据这个百分比变化就行了。方法还是有挺多的,很多JavaScript的库都可以实现这个功能,但是因为WordPress里已经自动加载了jQuery了,所以就不想再引入其他库了,而且这个需求也很简单,用jQuery就足够了。

第一步

原作者一共写了15篇,这是定死了的, 只需要获取到我已经在丘壑博客上翻译了几篇就可以了,除以总数15篇就得到了百分比。本想自己写个 WP_Query 查出来,发现有个插件可以很方便的获取到,就不用重复造轮子了 Display Posts – Easy lists, grids, navigation, and more, 很强大,可以用各种过滤条件动态查找文章并显示出来

页面上加上如下的 shortcode,就可以把所有标签为 genesis-explained 的文章按顺序查出来并显示(默认显示10篇, 多于10的话可以自己设置数量,或者用posts_per_page=”-1″不限制)

display-posts的查询很强大,支持各种条件

第二步

因为用display-posts显示出来的列表自带了一个css样式,所以可以很容易用jQuery选择器来获取到文章数量:

display-posts的样式

var completed=$(".display-posts-listing li").size() 

var progress= parseInt((completed / 15) *100) + "%"

第三步

数据有了,那么还需要在页面上加一个div区域,可以让jQuery来动态更新区域的内容,很简单,编辑页面,插入一段html

<div class="progress progress-striped active">
      
      <p class="alert alert-success completed"><strong></strong> </p>

      <p class="alert alert-success goal"><strong>共: 15 篇</strong></p>
      
      <div class="progress-bar" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 0%;">
        <span class="sr-only"> </span>
      </div>
 </div>

现在,再把上面的 JavaScript代码再补充一下,用来更新进度条里的文字内容,完整版的如下:

( function( $ ) {
	'use strict';

    var completed=$(".display-posts-listing li").size() 
     
    var progress= parseInt((completed / 15) *100) + "%"
    
    $('p.completed strong').text("已完成: "+completed+" 篇")
    $('span.sr-only').text( progress+" 已完成")
    $('div[role=progressbar]').width(progress)

})( jQuery );

第四步

现在是光秃秃的,太丑了,再加入一点CSS,穿件衣服。写CSS是我的弱项,所以我就选择了Bootstrap,完整版的太臃肿了,包含了太多不需要的东西,完整引入也有可能会把现有主题搞乱,所以在 Bootstrap官网上定制化下载了一个最简版的,只包含alertprogress部分,其他部分都不要。然后再加上一点自定义的样式:

.progress {
  position:relative;
  height:70px;
}
.completed {
  position:absolute;
  top:10px;
  left:10px;
  padding: 10px;
}
.goal {
  position:absolute;
  top:10px;
  right:10px;
  padding: 10px;

}

第五步

现在基本上就已经可以达到效果了,最后,我只想在这一个页面上显示这个进度,其他页面上都不需要,所以,新建一个针对这个页面的模板 page-genesis-explained.php,放在子主题的目录下。为什么叫这个名字呢?可以参看这里 Template Hierarchy。因为这是一个页面,slug是genesis-explained,所以就叫page-genesis-explained.php,加入以下代码,作用就是用add_action()把上面的JavaScript脚本和CSS注册进入WordPress,添加动作的方法可以参考这篇文章

当然要先把需要用的文件FTP上传到对应的目录下,我就全扔到wp-content/themes/genesis-sample/js 这里了。

<?php

add_action('wp_enqueue_scripts','child_bootstrap_processbar');

function child_bootstrap_processbar(){
wp_enqueue_style(
    'child_bootstrap_processbarCSS', 
    get_stylesheet_directory_uri().'/js/bootstrap-processbar.css');

wp_enqueue_style(
        'child_bootstrap_processbar_goalCSS', 
        get_stylesheet_directory_uri().'/js/bootstrap-processbar-goal.css');

wp_enqueue_script(
        'child_bootstrap_processbarJS', 
        get_stylesheet_directory_uri().'/js/bootstrap-processbar.js',
        array( 'jquery' ),
        CHILD_THEME_VERSION,
        true
    );
};

genesis();

最终效果在这里 神级 WordPress 主题框架 Genesis 从入门到精通

结语

不知不觉都已经翻译一大半了,60%了才想起来做个进度表?,翻译过程其实还是有收获的,细嚼慢咽的也可以消化的更好一点,希望早点到达100%吧

参考资料

See the Pen Bootstrap Goal Progress Bar by Justin Cron (@justincron) on CodePen.

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

扫码关注云+社区

领取腾讯云代金券