前端每日实战：162# 视频演示如何用原生 JS 创做一个查询 github 用户的应用（内含 2 个视频）

时间  2019-11-05
标签 前端 每日 实战 视频 演示 如何 原生 一个 查询 github 用户 应用 内含 栏目 JavaScript 繁體版
原文   原文链接

图片描述

效果预览

按下右侧的“点击预览”按钮能够在当前页面预览，点击连接能够全屏预览。javascript

https://codepen.io/comehope/pen/oQGqaGcss

可交互视频

此视频是能够交互的，你能够随时暂停视频，编辑视频中的代码。html

请用 chrome, safari, edge 打开观看。前端

第 1 部分：
https://scrimba.com/p/pEgDAM/cEPkVUgjava

第 2 部分：
https://scrimba.com/p/pEgDAM/crp63TRgit

（由于 scrimba 不支持 web animation api，第 2 部分末尾的动画效果在视频中看不到，请参考 codepen）github

源代码下载

每日前端实战系列的所有源代码请从 github 下载：web

https://github.com/comehope/front-end-daily-challengeschrome

代码解读

这是一个读取 github 用户的应用，在搜索框内输入用户名，点击搜索后，就会经过 github 的 open api 取得用户信息，填写到下方的卡片中。json

整个应用分红 3 个步骤开发：静态的页面布局、从 open api 读取数据并绑定到页面中、增长动画效果。

1、页面布局

定义 dom，总体结构分红上部的表单和下部的用户卡片：

<div class="app">
    <form>
        <!-- 暂略 -->
    </form>
    <div class="profile">
        <!-- 暂略 -->
    </div>
</div>

居中显示：

body {
    margin: 0;
    height: 100vh;
    display: flex;
    align-items: center;
    justify-content: center;
    background-color: #383838;
}

定义应用容器的尺寸：

.app {
    width: 320px;
    height: 630px;
    font-family: sans-serif;
    position: relative;
}

这是表单的 dom 结构，2 个表单控件分别是文本输入框 #username 和搜索按钮 #search，由于后面的脚本要引用这 2 个控件，因此为它们定义了 id 属性，接下来在 css 中也使用 id 选择器：

<form>
    <input placeholder="Who are you looking for?" id="username">
    <input type="button" value="Search" id="search">
</form>

令 2 个表单控件横向排列：

form {
    height: 50px;
    background-color: rgba(255, 255, 255, 0.2);
    border-radius: 2px;
    box-sizing: border-box;
    padding: 8px;
    display: flex;
}

分别设置 2 个表单控件的样式：

input {
    border: none;
    font-size: 14px;
    outline: none;
    border-radius: inherit;
    padding: 0 8px;
}
  
#username {
    flex-grow: 1;
    background-color: rgba(255, 255, 255, 0.9);
    color: #42454e;
}
  
#search {
    background-color: rgba(0, 97, 145, 0.75);
    color: rgba(255, 255, 255, 0.8);
    font-weight: bold;
    margin-left: 8px;
    cursor: pointer;
}

为按钮增长悬停和点击的交互效果：

#search:hover {
    background-color: rgba(0, 97, 145, 0.45);
}

#search:active {
    transform: scale(0.98);
    background-color: rgba(0, 97, 145, 0.75);
}

至此，表单布局完成，接下来作用户卡片布局。
用户卡片的 dom 结构以下，卡片分红上半部分 .header 和下半部分 .footer，上半部分包括头像 .avatar、名字 .name 和位置 .location，下半部分包括一组详细的数据 .details 和一个跳到 github 的连接 .to-github：

<div class="profile">
    <div class="header">
        <div class="avatar"></div>
        <h2 class="name">Octocat</h2>
        <h3 class="location">San Francisco</h3>
    </div>
    <div class="footer">
        <ul class="details">
            <li>Repositories<span>111</span></li>
            <li>Followers<br><span>222</span></li>
            <li>Following<br><span>333</span></li>
        </ul>
        <a href="#" class="to-github">go to github</a>
    </div>
</div>

令卡片的上半部分和下半部分竖向排列，并分别设置两部分的高度，大约是上半部分占卡片高度的三分之二，下半部分占卡片高度的三分之一，此时能够看出卡片的轮廓了：

.profile {
    width: 320px;
    position: absolute;
    margin: 20px 0 0 0;
    display: flex;
    flex-direction: column;
    border-radius: 5px;
}

.header {
    height: 380px;
    background-color: rgba(0, 97, 145, 0.45);
}

.footer {
    height: 180px;
    background-color: rgba(0, 97, 145, 0.75);
}

令卡片上半部分的子元素竖向排列：

.header {
    display: flex;
    flex-direction: column;
    align-items: center;
}

设置头像图片，样式为描边的圆形，由于头像图片在后面还会用到，因此把它存储到变量 --avatar 中：

.profile {
    --avatar: url('https://avatars3.githubusercontent.com/u/583231?v=4');
}

.avatar {
    width: 140px;
    height: 140px;
    background-image: var(--avatar);
    margin: 70px 0 0 0;
    background-position: center;
    background-size: cover;
    border-radius: 50%;
    box-shadow: 
        0 0 0 0.8em rgba(0, 0, 0, 0.2),
        0 0 0 1em rgba(161, 220, 255, 0.35);
}

设置名字和位置信息的样式，文字为白色：

.name {
    margin: 50px 0 0 0;
    color: white;
    font-size: 28px;
    font-weight: normal;
    text-shadow: 0 1px 2px rgba(0, 0, 0, 0.15);
}

.location {
    margin: 5px 0 0 0;
    color: rgba(255, 255, 255, 0.75);
    font-weight: normal;
}

至此，上半部分的布局完成，接下来布局下半部分。
令下半部分的子元素竖向排列：

.footer {
    display: flex;
    flex-direction: column;
    align-items: center;
}

横向排列三组数据，每项之间加入细分隔线：

.details {
    list-style-type: none;
    padding: 0;
    display: flex;
    margin: 40px 0 0 0;
}

.details li {
    color: rgba(255, 255, 255, 0.6);
    text-align: center;
    padding: 0 6px;
}

.details li span {
    display: block;
    color: rgba(255, 255, 255, 0.8);
}

.details li:not(:first-child) {
    border-left: 2px solid rgba(255, 255, 255, 0.15);
}

设置跳转到 github 的连接样式和悬停效果：

.to-github {
    width: 200px;
    height: 40px;
    background-color: rgba(255, 255, 255, 0.5);
    text-align: center;
    line-height: 40px;
    color: rgba(0, 0, 0, 0.75);
    text-decoration: none;
    text-transform: uppercase;
    border-radius: 20px;
    transition: 0.3s;
}

.to-github:hover {
    background-color: rgba(255, 255, 255, 0.8);
}

至此，下半部分布局完成。
接下来用伪元素把头像图片做为总体背景：

.profile {
    position: relative;
    overflow: hidden;
}

.profile::before {
    content: '';
    position: absolute;
    width: calc(100% + 20px * 2);
    height: calc(100% + 20px * 2);
    background-image: var(--avatar);
    background-size: cover;
    z-index: -1;
    margin: -20px;
    filter: blur(10px);
}

到这里，总体的静态布局就完成了。

2、绑定数据

为了绑定数据，咱们引入一个羽量级的模板库：

<script src="https://blueimp.github.io/JavaScript-Templates/js/tmpl.min.js"></script>

把卡片 .profile 包含的 dom 结构改写为 html 模板 #template，其中的 o 表明绑定的数据数据对象：

<script type="text/x-tmpl" id="template">
    <div class="header">
        <div class="avatar"></div>
        <h2 class="name">{%= o.name %}</h2>
        <h3 class="location">{%= o.location %}</h3>
    </div>
    <div class="footer">
        <ul class="details">
            <li>Repositories<span>{%= o.public_repos %}</span></li>
            <li>Followers<br><span>{%= o.followers %}</span></li>
            <li>Following<br><span>{%= o.following %}</span></li>
        </ul>
        <a href="{%= o.html_url %}" class="to-github">go to github</a>
    </div>
</script>

声明一个假数据对象 mockData，它的数据结构与 github open api 的数据结构是一致的：

let mockData = {
    "avatar_url": "https://avatars3.githubusercontent.com/u/583231?v=4",
    "name": "The Octocat",
    "location": "San Francisco",
    "public_repos": 111,
    "followers": 222,
    "following": 333,
    "html_url": "https://github.com/octocat",
}

定义一个把数据绑定到 html 模板的函数 render(container, data)，第 1 个参数 container 表示 dom 容器，模板内容将填充在此容器中；第 2 个参数是数据对象。在页面载入时调用 render() 方法，把 mockData 做为参数传入，此时看到的效果和纯静态的效果一致，但用户卡片已经改成动态建立了：

window.onload = render(document.getElementsByClassName('profile')[0], mockData)

function render(container, data) {
    container.innerHTML = tmpl('template', data)
    container.style.setProperty('--avatar', `url(${data.avatar_url})`)
}

定义一个从 github open api 读取用户信息的方法 getData(username)，而后调用 render() 方法把用户信息绑定到 html 模板。同时，把 window.onload 绑定的事件改成调用 getData() 方法，此时看到的效果仍和纯静态的效果一致，但数据已经变成动态读取了：

window.onload = getData('octocat')

function getData(username) {
    let apiUrl = `https://api.github.com/users/${username}`
    fetch(apiUrl)
        .then((response) => response.json())
        .then((data) => render(document.getElementsByClassName('profile')[0], data))
}

为表单的 search 按钮绑定点击事件，实现搜索功能。能够查一下本身的 github 账号试试看：

document.getElementById('search').addEventListener('click', () => {
    let username = document.getElementById('username').value.replace(/[ ]/g, '')
    if (username == '') {
        return
    }
    getData(username)
})

3、增长动画效果

为了能让用户感觉到每次搜索后数据的变化过程，咱们增长一点动画效果。建立一个 update(data) 函数来处理动画和渲染逻辑，同时把 getData() 函数的最后一步改成调用 update() 函数：

function getData(username) {
    let apiUrl = `https://api.github.com/users/${username}`
    fetch(apiUrl)
        .then((response) => response.json())
        // .then((data) => render(document.getElementsByClassName('profile')[0], data))
        .then(update)
}

function update(data) {
    let current = document.getElementsByClassName('profile')[0]
    render(current, data)
}

当页面首次载入时，不须要动画，直接渲染默认的用户信息便可。变量 isInitial 表示本次调用是不是在初始化页面时调用的，如果，就直接渲染。若不是，下面会执行动画效果。

function update(data) {
    let current = document.getElementsByClassName('profile')[0]
    let isInitial = (current.innerHTML == '')

    if (isInitial) {
        render(current, data)
        return
    }
}

动画的过程是：建立一张新卡片，把数据绑定到新卡片上，而后把当前卡片移出视图，再把新卡片移入视图。下面的变量 next 表明新建立的卡片，把它定位到当前卡片的右侧：

function update(data) {
    let current = document.getElementsByClassName('profile')[0]
    let isInitial = (current.innerHTML == '')

    if (isInitial) {
        render(current, data)
        return
    }

    let next = document.createElement('div')
    next.className = 'profile'
    next.style.left = '100%'
    render(next, data)
    current.after(next)
}

由于动画分红 2 个动做——当前卡片移出和新卡片移入，因此咱们定义 2 个动画效果，变量 animationOut 表明移出动画的参数，变量 animationIn 表明移入动画的参数。其中，keyframes 属性值至关于写 css 动画时用 @keyframes 定义的关键帧，options 属性值至关于写 css 动画时 animation 语句后面的参数，新卡片移入动画有半秒钟的延时。

function update(data) {
    let current = document.getElementsByClassName('profile')[0]
    let isInitial = (current.innerHTML == '')

    if (isInitial) {
        render(current, data)
        return
    }

    let next = document.createElement('div')
    next.className = 'profile'
    next.style.left = '100%'
    render(next, data)
    current.after(next)

    let animationOut = {
        keyframes: [
            {left: '0', opacity: 1, offset: 0},
            {left: '-100%', opacity: 0, offset: 1}
        ],
        options: {
            duration: 500,
            fill: 'forwards'
        }
    }

    let animationIn = {
        keyframes: [
            {left: '100%', opacity: 0, offset: 0},
            {left: '0', opacity: 1, offset: 1}
        ],
        options: {
            duration: 500,
            fill: 'forwards',
            delay: 500
        }
    }
}

由于动画需异步执行，即在当前卡片移出的动画结束后再执行新卡片移入的动画，因此咱们令当前卡片移出的动画结束后触发 onfinish 事件，而后再执行新卡片移入的动画，同时把旧卡片删除掉：

function update(data) {
    let current = document.getElementsByClassName('profile')[0]
    let isInitial = (current.innerHTML == '')

    if (isInitial) {
        render(current, data)
        return
    }

    let next = document.createElement('div')
    next.className = 'profile'
    next.style.left = '100%'
    render(next, data)
    current.after(next)

    let animationOut = {
        keyframes: [
            {left: '0', opacity: 1, offset: 0},
            {left: '-100%', opacity: 0, offset: 1}
        ],
        options: {
            duration: 500,
            fill: 'forwards'
        }
    }

    let animationIn = {
        keyframes: [
            {left: '100%', opacity: 0, offset: 0},
            {left: '0', opacity: 1, offset: 1}
        ],
        options: {
            duration: 500,
            fill: 'forwards',
            delay: 500
        }
    }

    let animate = current.animate(animationOut.keyframes, animationOut.options)
    animate.onfinish = function() {
        current.remove()
        next.animate(animationIn.keyframes, animationIn.options)
    }
}

最后，限定动画效果仅在 .app 容器中展示：

.app {
    overflow: hidden;
}

大功告成！

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程