Day 8 - 構建前端 · 廖雪峰 JavaScript Python Git 教程

# Day 8 - 構建前端雖然我們跑通了一個最簡單的MVC，但是頁面效果肯定不會讓人滿意。對于復雜的HTML前端頁面來說，我們需要一套基礎的CSS框架來完成頁面布局和基本樣式。另外，jQuery作為操作DOM的JavaScript庫也必不可少。從零開始寫CSS不如直接從一個已有的功能完善的CSS框架開始。有很多CSS框架可供選擇。我們這次選擇[uikit](http://getuikit.com/)這個強大的CSS框架。它具備完善的響應式布局，漂亮的UI，以及豐富的HTML組件，讓我們能輕松設計出美觀而簡潔的頁面。可以從[uikit首頁](http://getuikit.com/)下載打包的資源文件。所有的靜態資源文件我們統一放到`www/static`目錄下，并按照類別歸類： ``` static/ +- css/ | +- addons/ | | +- uikit.addons.min.css | | +- uikit.almost-flat.addons.min.css | | +- uikit.gradient.addons.min.css | +- awesome.css | +- uikit.almost-flat.addons.min.css | +- uikit.gradient.addons.min.css | +- uikit.min.css +- fonts/ | +- fontawesome-webfont.eot | +- fontawesome-webfont.ttf | +- fontawesome-webfont.woff | +- FontAwesome.otf +- js/ +- awesome.js +- html5.js +- jquery.min.js +- uikit.min.js ``` 由于前端頁面肯定不止首頁一個頁面，每個頁面都有相同的頁眉和頁腳。如果每個頁面都是獨立的HTML模板，那么我們在修改頁眉和頁腳的時候，就需要把每個模板都改一遍，這顯然是沒有效率的。常見的模板引擎已經考慮到了頁面上重復的HTML部分的復用問題。有的模板通過include把頁面拆成三部分： ``` <html> <% include file="inc_header.html" %> <% include file="index_body.html" %> <% include file="inc_footer.html" %> </html> ``` 這樣，相同的部分`inc_header.html`和`inc_footer.html`就可以共享。但是include方法不利于頁面整體結構的維護。jinjia2的模板還有另一種“繼承”方式，實現模板的復用更簡單。 “繼承”模板的方式是通過編寫一個“父模板”，在父模板中定義一些可替換的block（塊）。然后，編寫多個“子模板”，每個子模板都可以只替換父模板定義的block。比如，定義一個最簡單的父模板： ```  <html> <head> <title>{% block title%} 這里定義了一個名為title的block {% endblock %}</title> </head> <body> {% block content %} 這里定義了一個名為content的block {% endblock %} </body> </html> ``` 對于子模板`a.html`，只需要把父模板的`title`和`content`替換掉： ``` {% extends 'base.html' %} {% block title %} A {% endblock %} {% block content %} <h1>Chapter A</h1> <p>blablabla...</p> {% endblock %} ``` 對于子模板`b.html`，如法炮制： ``` {% extends 'base.html' %} {% block title %} B {% endblock %} {% block content %} <h1>Chapter B</h1> <ul> <li>list 1</li> <li>list 2</li> </ul> {% endblock %} ``` 這樣，一旦定義好父模板的整體布局和CSS樣式，編寫子模板就會非常容易。讓我們通過uikit這個CSS框架來完成父模板`__base__.html`的編寫： ``` <!DOCTYPE html> <html> <head> <meta charset="utf-8" /> {% block meta %}{% endblock %} <title>{% block title %} ? {% endblock %} - Awesome Python Webapp</title> <link rel="stylesheet" href="/static/css/uikit.min.css"> <link rel="stylesheet" href="/static/css/uikit.gradient.min.css"> <link rel="stylesheet" href="/static/css/awesome.css" /> <script src="/static/js/jquery.min.js"></script> <script src="/static/js/md5.js"></script> <script src="/static/js/uikit.min.js"></script> <script src="/static/js/awesome.js"></script> {% block beforehead %}{% endblock %} </head> <body> <nav class="uk-navbar uk-navbar-attached uk-margin-bottom"> <div class="uk-container uk-container-center"> <a href="/" class="uk-navbar-brand">Awesome</a> <ul class="uk-navbar-nav"> <li data-url="blogs"><a href="/"><i class="uk-icon-home"></i> 日志</a></li> <li><a target="_blank" href="#"><i class="uk-icon-book"></i> 教程</a></li> <li><a target="_blank" href="#"><i class="uk-icon-code"></i> 源碼</a></li> </ul> <div class="uk-navbar-flip"> <ul class="uk-navbar-nav"> {% if user %} <li class="uk-parent" data-uk-dropdown> <a href="#0"><i class="uk-icon-user"></i> {{ user.name }}</a> <div class="uk-dropdown uk-dropdown-navbar"> <ul class="uk-nav uk-nav-navbar"> <li><a href="/signout"><i class="uk-icon-sign-out"></i> 登出</a></li> </ul> </div> </li> {% else %} <li><a href="/signin"><i class="uk-icon-sign-in"></i> 登陸</a></li> <li><a href="/register"><i class="uk-icon-edit"></i> 注冊</a></li> {% endif %} </ul> </div> </div> </nav> <div class="uk-container uk-container-center"> <div class="uk-grid">  {% block content %} {% endblock %}  </div> </div> <div class="uk-margin-large-top" style="background-color:#eee; border-top:1px solid #ccc;"> <div class="uk-container uk-container-center uk-text-center"> <div class="uk-panel uk-margin-top uk-margin-bottom"> <p> <a target="_blank" href="#" class="uk-icon-button uk-icon-weibo"></a> <a target="_blank" href="#" class="uk-icon-button uk-icon-github"></a> <a target="_blank" href="#" class="uk-icon-button uk-icon-linkedin-square"></a> <a target="_blank" href="#" class="uk-icon-button uk-icon-twitter"></a> </p> <p>Powered by <a href="#">Awesome Python Webapp</a>. Copyright © 2014\. [<a href="/manage/" target="_blank">Manage</a>]</p> <p><a href="http://www.liaoxuefeng.com/" target="_blank">www.liaoxuefeng.com</a>. All rights reserved.</p> <a target="_blank" href="#"><i class="uk-icon-html5" style="font-size:64px; color: #444;"></i></a> </div> </div> </div> </body> </html> ``` `__base__.html`定義的幾個block作用如下：用于子頁面定義一些meta，例如rss feed： ``` {% block meta %} ... {% endblock %} ``` 覆蓋頁面的標題： ``` {% block title %} ... {% endblock %} ``` 子頁面可以在標簽關閉前插入JavaScript代碼： ``` {% block beforehead %} ... {% endblock %} ``` 子頁面的content布局和內容： ``` {% block content %} ... {% endblock %} ``` 我們把首頁改造一下，從`__base__.html`繼承一個`blogs.html`： ``` {% extends '__base__.html' %} {% block title %}日志{% endblock %} {% block content %} <div class="uk-width-medium-3-4"> {% for blog in blogs %} <article class="uk-article"> <h2><a href="/blog/{{ blog.id }}">{{ blog.name }}</a></h2> <p class="uk-article-meta">發表于{{ blog.created_at}}</p> <p>{{ blog.summary }}</p> <p><a href="/blog/{{ blog.id }}">繼續閱讀 <i class="uk-icon-angle-double-right"></i></a></p> </article> <hr class="uk-article-divider"> {% endfor %} </div> <div class="uk-width-medium-1-4"> <div class="uk-panel uk-panel-header"> <h3 class="uk-panel-title">友情鏈接</h3> <ul class="uk-list uk-list-line"> <li><i class="uk-icon-thumbs-o-up"></i> <a target="_blank" href="#">編程</a></li> <li><i class="uk-icon-thumbs-o-up"></i> <a target="_blank" href="#">讀書</a></li> <li><i class="uk-icon-thumbs-o-up"></i> <a target="_blank" href="#">Python教程</a></li> <li><i class="uk-icon-thumbs-o-up"></i> <a target="_blank" href="#">Git教程</a></li> </ul> </div> </div> {% endblock %} ``` 相應地，首頁URL的處理函數更新如下： ``` @view('blogs.html') @get('/') def index(): blogs = Blog.find_all() # 查找登陸用戶: user = User.find_first('where email=?', 'admin@example.com') return dict(blogs=blogs, user=user) ``` 往MySQL的`blogs`表中手動插入一些數據，我們就可以看到一個真正的首頁了。但是Blog的創建日期顯示的是一個浮點數，因為它是由這段模板渲染出來的： ``` <p class="uk-article-meta">發表于{{ blog.created_at }}</p> ``` 解決方法是通過jinja2的filter（過濾器），把一個浮點數轉換成日期字符串。我們來編寫一個`datetime`的filter，在模板里用法如下： ``` <p class="uk-article-meta">發表于{{ blog.created_at|datetime }}</p> ``` filter需要在初始化jinja2時設置。修改`wsgiapp.py`相關代碼如下： ``` # wsgiapp.py: ... # 定義datetime_filter，輸入是t，輸出是unicode字符串: def datetime_filter(t): delta = int(time.time() - t) if delta < 60: return u'1分鐘前' if delta < 3600: return u'%s分鐘前' % (delta // 60) if delta < 86400: return u'%s小時前' % (delta // 3600) if delta < 604800: return u'%s天前' % (delta // 86400) dt = datetime.fromtimestamp(t) return u'%s年%s月%s日' % (dt.year, dt.month, dt.day) template_engine = Jinja2TemplateEngine(os.path.join(os.path.dirname(os.path.abspath(__file__)), 'templates')) # 把filter添加到jinjia2，filter名稱為datetime，filter本身是一個函數對象: template_engine.add_filter('datetime', datetime_filter) wsgi.template_engine = template_engine ``` 現在，完善的首頁顯示如下： ![home-with-uikit](https://box.kancloud.cn/2016-01-15_56988a2adba94.png)