经常会在别人的简历中看到,做过什么高大上的项目。说实话,有时候看到一些大牛的简历,会感到非常的自卑,入行前端也一年多的时间了,但真正的‘懂行’或许也就半年的时间吧。真正大的前端项目没有做过,一些小的个人项目大多都托管在 GitHub,前段时间酝酿了一个展示 GitHub 项目的一个小 Project,今天就来说说这个东西。
以前学前端,就只是学 HTML,CSS 和 JS,看书,看视频,大概这样的日子持续了好几个月,不能说没有一点效果,至少一些前端的基本概念都有所了解。慢慢地,开始接触到 GitHub,发现这里真是前端学习的一个高效场所。一个前端er,如果不逛 GitHub,必定是一个失败的前端,因为在 GitHub,视野可以得到很大的扩展。后来索性把浏览器主页也设置成了 GitHub。
发现好多大公司在招实习生和应届生的时候,也开始慢慢的关注应聘者的 GitHub 的信息,有时候在做一些网测题的时候,会看到输入 GitHub 地址或博客地址,其实,有时候你不够优秀的原因是因为你不会 show yourself。
偶然间看到了一个精美博客的一个 项目展示页面 ,感觉很不错。看了下它的源码,不是很复杂,通过 JavaScript 从 api.github.com 获取 json 数据,动态的渲染到页面中。于是,依葫芦画瓢,把整个展示页面的代码模仿 copy 下来,然后加入了扩展的元素。
GitHub 项目地址在这 , Demo 地址在这 。
想来想去,还是准备用 Jquery,本来想写原生的,但是考虑到 ajax 操作和 html 操作,想想还是算了。首先用一个闭包,避免全局变量污染,把 JQuery 对象传进来:
(function($){ var showProjects = function(option){ ... } // 把函数扔给 prototype $.prototype.showProjects = showProjects; })($) |
使用也很简单,设置了一个 option 配置对象,参数可选,如下:
//html <div class="projects"></div> <script src="https://cdn.bootcss.com/jquery/3.1.1/jquery.min.js"></script> <script src="showProjects.js"></script> //js $('.projects').showProjects({ name : 'songjinzhong', //your github url name maxNum : 12, // max Num you want show your projects loading : '<h3>加载中...</h3>', //loading informtion filter : { // filter for your projects, can be id or name id : [66267751], name : ['7studying.com'] } }); |
只要是一个 JQuery 对象都可以使用 showProjects 函数,但是之前必须要引入 JQuery 库。
参数中,name 表示 github 的名称,maxNum 表示是否限制显示的条目,默认显示全部,如果 maxNum 超过最大项目数,也显示全部。因为这个 js 是动态从 GitHub 加载的,访问速度很慢的时候,loading 相当于提示作用,也可以设置成其他内容。filter 是一个过滤器,表示一些不想显示的项目,可选 id 和 name 两种方式。
来看看 showProjects 函数中的内容,以下是一些参数设置:
var projects = this; // no github name if(!option || !option.name){ projects.html('<div><h3>参数错误</h3><p>请设置 GitHub 用户名</p></div>'); return; } // defaultSetting option.maxNum = option.maxNum || 0; option.loading = option.loading || '<h3>加载中...</h3>'; var name = (option.filter && option.filter.name) || [], id = (option.filter && option.filter.id) || []; |
在查看 github 返回的 json 数据之前,建议先自己访问一下 https://api.github.com/users/songjinzhong/repos?type=owner ,了解数据格式。其中会用到的数据格式有 html_url
, name
, description
, language
, stargazers_count
, forks_count
。
// 先设置 loading,然后 $.get projects.length > 0 && projects.html(option.loading) && $.get("https://api.github.com/users/"+ option.name +"/repos?type=owner", function(data){ if(data){ // 成功返回后删除 loading projects.html(""); // 过滤操作,用于去掉没有 description 和 fork 项目 data = data.filter(function(a){ return null != a.description && a.fork == false && name.indexOf(a.name) == -1 && id.indexOf(a.id) == -1; }); // 排序操作,安装 star 数和 fork 数排序 data = data.sort(function(a, b){ return b.stargazers_count - a.stargazers_count|| b.forks_count - a.forks_count; }) var item = ""; // 实现如果设置 maxNum 的情况 if(option.maxNum > 0 && option.maxNum < data.length){ data = data.slice(0,option.maxNum); } // 对剩下的 data 每一项都添加到 html 中 data.forEach(function(repo){ // language underfined 问题,改成字符串 null repo.language = repo.language || 'null'; // 替换 template 模版中的字符串 item = template.replace(//[(.*?)/]/g, function(){ return eval(arguments[1]); }); projects.append(item); }); }else{ projects.html('<div><h3>加载失败</h3><p>请刷新或稍后再试...</p></div>'); } }) |
template 是字符串模版,巧妙的通过 replace 来替换关键字中的正则,然后执行 eval:
var template = '<div class="p-item">'+ '<div class="p-header"><a href="[repo.html_url]"><h3>[repo.name]</h3></a></div>'+ '<div class="p-body"><p>[repo.description]</p></div>'+ '<div class="p-footer"><span>L:[repo.language]</span><span>S:[repo.stargazers_count]</span><span>F:[repo.forks_count]</span></div>'+ '</div>'; |
这个时候连显示的样式也 copy 过来了,不过那个博客中用的是浮动,我用的是 flex 作为基本布局。具体请参考 demo 中的样式吧。
这个样式并不是固定的,可以根据自己的需求来改变。下图是生成 project 的 html 图:
然后我把它应用到我的博客,projects 地址在这我的项目 | 渔人。改了点东西,比如 loading 图标变了,language star fork 全被我换成图标。