由于您想将 React 与 Django 模板一起使用,我假设 React 代码只会影响页面的特定部分。以下说明是基于该假设编写的。
首先,您不必将所有 JS 代码都放在模板中——事实上,那会很混乱。
您可以使用 Webpack创建一个单独的基于 JS 的构建过程(查看此操作方法)。这增强了您的客户端代码的功能,允许您在浏览器中使用 CommonJS module,您可以直接从 npm 中提取这些module,包括React。
Webpack 反过来将生成一个包(或多个包,取决于您的应用程序的性质和 Webpack 配置),您需要<script>
像往常一样通过标签将其包含在 Django 模板中。
现在,您需要React.render()
调用以在现有页面布局中的某处呈现您的 React 应用程序。您需要使用具有特定 id/class 名称的空 HTML 元素作为应用程序的挂载点。
但这里有一个警告:你不能直接从浏览器或 Django 模板访问 CommonJS module。所以无论你,
- 将
React
您的应用程序暴露给该window
对象,或
- 创建一个带有胶水代码的module来处理应用程序初始化并将该方法公开给
window
对象。
在任何情况下,您都需要直接从模板调用初始化代码(查看粘合代码示例和对应用程序初始化的调用)。
此初始化步骤还允许您将 Django 模板中可用的变量传递给 JS 代码。
最终的 Django 模板将如下所示:
{% load staticfiles %}
{% extends 'base.html' %}
{% block scripts %}
<script type="text/javascript" src="{% static 'path/to/app.bundle.js' %}"></script>
<script type="text/javascript">
// Initialization glue code
window.MyApp.init({el: '.app-mountpoint'});
</script>
{% endblock %}
{% block content %}
<!-- Your template contents -->
<!-- The mount point of your app -->
<div class="app-mountpoint" />
{% endblock %}
和胶水代码:
var React = require('react');
var MyAppComponent = require('MyAppComponent');
window.MyApp = {
init: function (opts) {
var mountPoint = document.querySelector(opts.el);
React.render(<MyAppComponent />, mountPoint);
}
};
我知道所有这些在一开始听起来可能令人难以抗拒(与您使用 Angular 的几个步骤相比甚至更多),但相信我从长远来看它是值得的。
所以总结一下:
- 在单独的 JS 文件中编写 React 代码
- 使用 Webpack(利用 CommonJS module)来捆绑你的 React 代码
- 在 Django 模板中包含包
- 使用 Django 模板中的胶水代码呈现 React 代码