1. Day 8 - 构建前端
    2. 阅读: 40099
    3. 虽然我们跑通了一个最简单的MVC,但是页面效果肯定不会让人满意。
    4. 对于复杂的HTML前端页面来说,我们需要一套基础的CSS框架来完成页面布局和基本样式。另外,jQuery作为操作DOMJavaScript库也必不可少。
    5. 从零开始写CSS不如直接从一个已有的功能完善的CSS框架开始。有很多CSS框架可供选择。我们这次选择uikit这个强大的CSS框架。它具备完善的响应式布局,漂亮的UI,以及丰富的HTML组件,让我们能轻松设计出美观而简洁的页面。
    6. 可以从uikit首页下载打包的资源文件。
    7. 所有的静态资源文件我们统一放到www/static目录下,并按照类别归类:
    8. static/
    9. +- css/
    10. | +- addons/
    11. | | +- uikit.addons.min.css
    12. | | +- uikit.almost-flat.addons.min.css
    13. | | +- uikit.gradient.addons.min.css
    14. | +- awesome.css
    15. | +- uikit.almost-flat.addons.min.css
    16. | +- uikit.gradient.addons.min.css
    17. | +- uikit.min.css
    18. +- fonts/
    19. | +- fontawesome-webfont.eot
    20. | +- fontawesome-webfont.ttf
    21. | +- fontawesome-webfont.woff
    22. | +- FontAwesome.otf
    23. +- js/
    24. +- awesome.js
    25. +- html5.js
    26. +- jquery.min.js
    27. +- uikit.min.js
    28. 由于前端页面肯定不止首页一个页面,每个页面都有相同的页眉和页脚。如果每个页面都是独立的HTML模板,那么我们在修改页眉和页脚的时候,就需要把每个模板都改一遍,这显然是没有效率的。
    29. 常见的模板引擎已经考虑到了页面上重复的HTML部分的复用问题。有的模板通过include把页面拆成三部分:
    30. <html>
    31. <% include file="inc_header.html" %>
    32. <% include file="index_body.html" %>
    33. <% include file="inc_footer.html" %>
    34. </html>
    35. 这样,相同的部分inc_header.htmlinc_footer.html就可以共享。
    36. 但是include方法不利于页面整体结构的维护。jinjia2的模板还有另一种“继承”方式,实现模板的复用更简单。
    37. “继承”模板的方式是通过编写一个“父模板”,在父模板中定义一些可替换的block(块)。然后,编写多个“子模板”,每个子模板都可以只替换父模板定义的block。比如,定义一个最简单的父模板:
    38. <!-- base.html -->
    39. <html>
    40. <head>
    41. <title>{% block title%} 这里定义了一个名为titleblock {% endblock %}</title>
    42. </head>
    43. <body>
    44. {% block content %} 这里定义了一个名为contentblock {% endblock %}
    45. </body>
    46. </html>
    47. 对于子模板a.html,只需要把父模板的titlecontent替换掉:
    48. {% extends 'base.html' %}
    49. {% block title %} A {% endblock %}
    50. {% block content %}
    51. <h1>Chapter A</h1>
    52. <p>blablabla...</p>
    53. {% endblock %}
    54. 对于子模板b.html,如法炮制:
    55. {% extends 'base.html' %}
    56. {% block title %} B {% endblock %}
    57. {% block content %}
    58. <h1>Chapter B</h1>
    59. <ul>
    60. <li>list 1</li>
    61. <li>list 2</li>
    62. </ul>
    63. {% endblock %}
    64. 这样,一旦定义好父模板的整体布局和CSS样式,编写子模板就会非常容易。
    65. 让我们通过uikit这个CSS框架来完成父模板__base__.html的编写:
    66. <!DOCTYPE html>
    67. <html>
    68. <head>
    69. <meta charset="utf-8" />
    70. {% block meta %}<!-- block meta -->{% endblock %}
    71. <title>{% block title %} ? {% endblock %} - Awesome Python Webapp</title>
    72. <link rel="stylesheet" href="/static/css/uikit.min.css">
    73. <link rel="stylesheet" href="/static/css/uikit.gradient.min.css">
    74. <link rel="stylesheet" href="/static/css/awesome.css" />
    75. <script src="/static/js/jquery.min.js"></script>
    76. <script src="/static/js/md5.js"></script>
    77. <script src="/static/js/uikit.min.js"></script>
    78. <script src="/static/js/awesome.js"></script>
    79. {% block beforehead %}<!-- before head -->{% endblock %}
    80. </head>
    81. <body>
    82. <nav class="uk-navbar uk-navbar-attached uk-margin-bottom">
    83. <div class="uk-container uk-container-center">
    84. <a href="/" class="uk-navbar-brand">Awesome</a>
    85. <ul class="uk-navbar-nav">
    86. <li data-url="blogs"><a href="/"><i class="uk-icon-home"></i> 日志</a></li>
    87. <li><a target="_blank" href="#"><i class="uk-icon-book"></i> 教程</a></li>
    88. <li><a target="_blank" href="#"><i class="uk-icon-code"></i> 源码</a></li>
    89. </ul>
    90. <div class="uk-navbar-flip">
    91. <ul class="uk-navbar-nav">
    92. {% if user %}
    93. <li class="uk-parent" data-uk-dropdown>
    94. <a href="#0"><i class="uk-icon-user"></i> {{ user.name }}</a>
    95. <div class="uk-dropdown uk-dropdown-navbar">
    96. <ul class="uk-nav uk-nav-navbar">
    97. <li><a href="/signout"><i class="uk-icon-sign-out"></i> 登出</a></li>
    98. </ul>
    99. </div>
    100. </li>
    101. {% else %}
    102. <li><a href="/signin"><i class="uk-icon-sign-in"></i> 登陆</a></li>
    103. <li><a href="/register"><i class="uk-icon-edit"></i> 注册</a></li>
    104. {% endif %}
    105. </ul>
    106. </div>
    107. </div>
    108. </nav>
    109. <div class="uk-container uk-container-center">
    110. <div class="uk-grid">
    111. <!-- content -->
    112. {% block content %}
    113. {% endblock %}
    114. <!-- // content -->
    115. </div>
    116. </div>
    117. <div class="uk-margin-large-top" style="background-color:#eee; border-top:1px solid #ccc;">
    118. <div class="uk-container uk-container-center uk-text-center">
    119. <div class="uk-panel uk-margin-top uk-margin-bottom">
    120. <p>
    121. <a target="_blank" href="#" class="uk-icon-button uk-icon-weibo"></a>
    122. <a target="_blank" href="#" class="uk-icon-button uk-icon-github"></a>
    123. <a target="_blank" href="#" class="uk-icon-button uk-icon-linkedin-square"></a>
    124. <a target="_blank" href="#" class="uk-icon-button uk-icon-twitter"></a>
    125. </p>
    126. <p>Powered by <a href="#">Awesome Python Webapp</a>. Copyright &copy; 2014. [<a href="/manage/" target="_blank">Manage</a>]</p>
    127. <p><a href="http://www.liaoxuefeng.com/" target="_blank">www.liaoxuefeng.com</a>. All rights reserved.</p>
    128. <a target="_blank" href="#"><i class="uk-icon-html5" style="font-size:64px; color: #444;"></i></a>
    129. </div>
    130. </div>
    131. </div>
    132. </body>
    133. </html>
    134. __base__.html定义的几个block作用如下:
    135. 用于子页面定义一些meta,例如rss feed
    136. {% block meta %} ... {% endblock %}
    137. 覆盖页面的标题:
    138. {% block title %} ... {% endblock %}
    139. 子页面可以在<head>标签关闭前插入JavaScript代码:
    140. {% block beforehead %} ... {% endblock %}
    141. 子页面的content布局和内容:
    142. {% block content %}
    143. ...
    144. {% endblock %}
    145. 我们把首页改造一下,从__base__.html继承一个blogs.html
    146. {% extends '__base__.html' %}
    147. {% block title %}日志{% endblock %}
    148. {% block content %}
    149. <div class="uk-width-medium-3-4">
    150. {% for blog in blogs %}
    151. <article class="uk-article">
    152. <h2><a href="/blog/{{ blog.id }}">{{ blog.name }}</a></h2>
    153. <p class="uk-article-meta">发表于{{ blog.created_at}}</p>
    154. <p>{{ blog.summary }}</p>
    155. <p><a href="/blog/{{ blog.id }}">继续阅读 <i class="uk-icon-angle-double-right"></i></a></p>
    156. </article>
    157. <hr class="uk-article-divider">
    158. {% endfor %}
    159. </div>
    160. <div class="uk-width-medium-1-4">
    161. <div class="uk-panel uk-panel-header">
    162. <h3 class="uk-panel-title">友情链接</h3>
    163. <ul class="uk-list uk-list-line">
    164. <li><i class="uk-icon-thumbs-o-up"></i> <a target="_blank" href="#">编程</a></li>
    165. <li><i class="uk-icon-thumbs-o-up"></i> <a target="_blank" href="#">读书</a></li>
    166. <li><i class="uk-icon-thumbs-o-up"></i> <a target="_blank" href="#">Python教程</a></li>
    167. <li><i class="uk-icon-thumbs-o-up"></i> <a target="_blank" href="#">Git教程</a></li>
    168. </ul>
    169. </div>
    170. </div>
    171. {% endblock %}
    172. 相应地,首页URL的处理函数更新如下:
    173. @get('/')
    174. def index(request):
    175. summary = 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.'
    176. blogs = [
    177. Blog(id='1', name='Test Blog', summary=summary, created_at=time.time()-120),
    178. Blog(id='2', name='Something New', summary=summary, created_at=time.time()-3600),
    179. Blog(id='3', name='Learn Swift', summary=summary, created_at=time.time()-7200)
    180. ]
    181. return {
    182. '__template__': 'blogs.html',
    183. 'blogs': blogs
    184. }
    185. Blog的创建日期显示的是一个浮点数,因为它是由这段模板渲染出来的:
    186. <p class="uk-article-meta">发表于{{ blog.created_at }}</p>
    187. 解决方法是通过jinja2filter(过滤器),把一个浮点数转换成日期字符串。我们来编写一个datetimefilter,在模板里用法如下:
    188. <p class="uk-article-meta">发表于{{ blog.created_at|datetime }}</p>
    189. filter需要在初始化jinja2时设置。相关代码如下:
    190. def datetime_filter(t):
    191. delta = int(time.time() - t)
    192. if delta < 60:
    193. return '1分钟前'
    194. if delta < 3600:
    195. return '%s分钟前' % (delta // 60)
    196. if delta < 86400:
    197. return '%s小时前' % (delta // 3600)
    198. if delta < 604800:
    199. return '%s天前' % (delta // 86400)
    200. dt = datetime.fromtimestamp(t)
    201. return '%s年%s月%s日' % (dt.year, dt.month, dt.day)
    202. ...
    203. init_jinja2(app, filters=dict(datetime=datetime_filter))
    204. ...
    205. 现在,完善的首页显示如下:
    206. 参考源码
    207. day-08