Django + Vue 单页面应用的开发环境搭建步骤

Django 的特点是有强大的数据库功能和自带的强大的后台功能,但是模板系统又没有目前比较流行的 React / Vue 强大,接下来就告诉大家如何搭建一个 Django + Vue 单页面应用的开发环境,以及 Django 和 Vue 的数据交互、以及 vue-resource 的配置。

如果你不想搭建单页面应用,想使用 Django 的模板系统 + Vue 的混合体,文章底部也介绍了使用方法


开发环境配置

教程非常简单,几步就搞定了:
假设你的电脑已经安装了 Git, Node,

https://github.com/zaxlct/hello-vue-django
  • 需要执行的命令全都写在了 Makefile 里,所以按照 README 里描述的执行一下就好:
make dev
make migrate
make run
  • 浏览器打开 localhost:8000 就能看到正确的页面了

基本原理

一共启动了两个服务,Django 启动了 8000 的端口,WebpackDevServer 启动了 8001 端口,每次frontend目录下的文件发生变化, django-webpack-loader 插件都会把文件映射到 backendtemplates/index.html 里。

templates/index.html 我们一般不会改动它,前端的代码全部都会写在frontend目录下。所以我们也就放弃了 Django 自带的模板系统

项目开发完毕也不需要任何转移文件操作,只需要:

make prod
make build

P.s. Makefile to make your life easy :)

Vue 和 Django 数据交互

假设 views.py 里有这么一段代码:

def index(request):
    return render(request, 'index.html', {
        'test': 123
    })

那么 App.vue 里可以这样拿到数据吗:

<div>{{test}}</div>

答案是不可能的,我们是单页面应用,放弃了 Django 自带的模板系统, Django 的数据只能通过 Ajax 传递给 App.vue

vue-resource 配置

以前我们都是用 jquery 封装过的 Ajax 方法,但是 vue-resource 和 Vue 更配哦!

首先安装 vue-resource

npm install vue-resource --save

POST 请求时,Django 默认加了 CSRF 验证,我们可以在 cookie 里拿到这个 csrftoken ,然后再配置一下 vue-resource ,这样每次发送 POST 请求时都会自动带上 csrftoken 了:

import VueResource from 'vue-resource'
Vue.use(VueResource)

// 取 cookie 
function getCookie(name) {
  let arr,
      reg=new RegExp("(^| )"+name+"=([^;]*)(;|$)")
  if(arr=document.cookie.match(reg)) {
    return decodeURIComponent(arr[2])
  }
}

// 设置 POST 请求时 的 data 格式
Vue.http.options.emulateJSON = true

// 设置 X-CSRFToken
Vue.http.interceptors.push(function(request, next) {
  request.method = 'POST'
  request.headers.set('X-CSRFToken', getCookie('csrftoken'))
  next()
})

POST 请求代码实例

// 在 vue 模板文件里
new Vue({
  data() {
    return {
      name: '隔壁老王' ,
      age: '38',
    }
  },
  methods: {
    fetch() {
       this.$http.post(this.URL, this.data).then(res => {
        // do something
      },res => {
        // do sonmething
      })
   }
  }
})


Django 的模板系统 + Vue 的混合体配置

Django 模板与Vue 的变量都是使用{{ }}包裹起来的,在渲染 Django 模板时会先替代掉所有的{{ }}及被包裹在其中的内容,使得 Vue 没有使用 {{ }} 来绑定变量。

方法一

我们可以改一下 Vue 的配置,使用两个中括号[[ ]] 来代替。

new Vue({
  el: '#app',
  delimiters: ['[[', ']]'],
}}

方法二

禁用 Django 模板渲染,Django 标签 verbatim可以使包裹其中的代码不进行渲染保持原样输出:

{% verbatim %}
    {{ vue }}
{% endverbatim %}

我们可以在需要用于 Vue 的地方使用 {% verbatim %} {% endverbatim %} 包裹。

字典和数组传递到 JS 里

Django 如果想直接把字典、数组传递到到 JS 里 ,需要要这么接收数据,否则 JS 会报错

def index(request):
    return render(request, 'index.html', {
        'list': [{'age': 18},  200],
        'obj': {'name':  '隔壁老王'}
    })
<!doctype html>
<html lang="en">
<head></head>
<body></body>
<script>
  var list = {{ list | safe }}
  var obj = {{ obj | safe }}
</script>
</html>

最后

这种简单的单页面应用架构做个小项目足够用了,但是如果是中型或者大型项目,还是得用类似 Django-RESTful-framework 等解决方案。


如果该文章帮助到了您,请赏个赞:)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容