# ch04 · 与用户交互：表单、校验、上传、富文本

> 来源：教材配套 PPT《第四章 与用户交互.pptx》，共 67 页。本节只摘录**知识点与关键文字**，图取自 PPT 原页。

## 第 1 页 · 讲师：谢福财

- 讲师：谢福财
- Flask课程——
- **第四章**
- 如何与用户进行交互

![第1页图](media/ch04/slide01_img1.png)

## 第 2 页 · 了解消息反馈的基本操作

- 了解消息反馈的基本操作
- 掌握Flask-WTF表单模块
- 的使用方法
- 掌握Flask-CKEditor模块
- 的使用方法
- 学习目标

![第2页图](media/ch04/slide02_img1.png)

## 第 3 页 · 消息反馈

- 消息反馈
- 表单
- Flask-WTF
- Flask-CKEditor
- 小结

## 第 4 页 · 表单

- 表单
- 01

## 第 5 页 · 概念解释

- 概念解释
- 网页的交互是什么？
- 网页的交互是指用户通过与网页上的元素（如按钮、表单、链接等）进行互动，以触发和响应网页的动态行为或功能。这种互动性是现代网页应用程序的关键组成部分，它使用户能够与网页进行实时通信、提交表单、加载新内容、执行操作等。

## 第 6 页 · 表单

- 表单
- 在网页中，如果需要与用户进行交互，则需要为交互页面设计一种特定的消息类型（表单），用于接收用户输入的信息。将用户输入的信息传递到服务器中进行处理，如需要返回消息给用户，则需要将消息内容显示到网页内容中。一次完整的交互，不止是有前端的页面显示，还要有后端的程序参与进来。
- 数据的交互会有GET请求和POST请求。这两种请求方法在 Web 开发中广泛使用，用于在客户端（浏览器）和服务器之间传递数据。

## 第 7 页 · GET请求

- GET请求
- 用途： GET 请求用于从服务器获取数据。它通常用于请求获取页面、图像、文档等静态资源，或者从服务器获取特定数据。
- 数据传递： 数据通过 URL 查询字符串传递，附加在 URL 后面，以问号（?）分隔。例如：http://example.com/page?param1=value1&param2=value2
- 安全性： GET 请求在 URL 中明文传递数据，因此不适合传递敏感信息，因为信息可以在浏览器历史记录、服务器日志等地方可见。
- 缓存： GET 请求可以被浏览器缓存，因此可以加快页面加载速度。
- 幂等性： 多次发送相同的 GET 请求不会对服务器产生副作用，即多次请求不会改变服务器状态。

## 第 8 页 · POST请求

- POST请求
- 用途： POST 请求用于向服务器提交数据，通常用于提交表单、发送用户输入数据等。
- 数据传递： 数据通过 HTTP 请求的消息体传递，不会显示在 URL 中。因此，POST 请求适合传递敏感信息。
- 安全性： POST 请求对数据进行加密，相对更安全，适合传递敏感信息。
- 缓存： POST 请求不会被浏览器缓存。
- 幂等性： 一般情况下，多次发送相同的 POST 请求可能会对服务器产生副作用，即多次请求可能会改变服务器状态。但在某些情况下，可以通过设计来使 POST 请求具有幂等性。

## 第 9 页 · 基本交互

- 基本交互
- 举一个从表单获取信息的例子，用于用于接收GET、POST消息并显示，视图函数代码如下。
- @app.route('/form', methods=['GET', 'POST'])
- def form():
- # args用于获取GET方式提交的数据
- msg_get = request.args.get('msg_get')
- # form用于获取POST方式提交的数据
- msg_post = request.form.get('msg_post')
- return render_template('form.html', msg_get=msg_get, msg_post= msg_post)
- 视图函数处理了/from的路由请求，让它同时支持GET和POST请求方法，然后用两种获取指定参数的值方法，将从 GET 和 POST 请求中获取的数据作为参数传递给模板进行渲染。

## 第 10 页 · 基本交互

- 基本交互
- form.html的内容按照书上4.1.1的去写就好，最后的效果如下图所示。
- GET表单提交测试示例图
- POST表单提交测试示例图

![第10页图](media/ch04/slide10_img1.png)

![第10页图](media/ch04/slide10_img2.png)

## 第 11 页 · 文件上传

- 文件上传
- 表单除了可以提交消息以外，还可以上传文件。在Flask中上传文件只需要定义两个视图函数即可：一个用于上传文件，另一个用于获取上传的文件。首先定义获取上传文件的视图函数，代码如下：
- import os
- # 定义上传文件所存放的位置，此处定义为项目目录下的"uploads"目录
- basedir = os.path.abspath(os.path.dirname(__file__))
- app.config['UPLOADED_PATH'] = os.path.join(basedir, 'uploads')
- os.makedirs(app.config['UPLOADED_PATH'], exist_ok=True)
- # 用于获取上传的文件
- @app.route('/files/<filename>')
- def uploaded_files(filename):
- path = app.config['UPLOADED_PATH']
- return send_from_directory(path, filename)

## 第 12 页 · 文件上传

- 文件上传
- 定义上传文件的视图函数。代码如下：
- # 用于上传文件
- @app.route('/upload', methods=['GET', 'POST'])
- def upload():
- if request.method == 'POST':
- f = request.files.get('upload')
- f.save(os.path.join(app.config['UPLOADED_PATH'], f.filename))
- # 将上传目录下的文件展示到页面中
- files = os.listdir(app.config['UPLOADED_PATH'])
- return render_template('upload.html', files=files)

## 第 13 页 · 文件上传

- 文件上传
- 以下是相应模板页面（upload.html）的内容
- {% extends ' bootstrap/base.html' %}
- {% block title %}文件上传{% endblock %}
- {% block content %}
- <div class="container">
- <form role="form" method="post" enctype="multipart/form-data">
- <p>文件上传</p>
- <label>
- 文件：
- <input type="file" name="upload" class="form-control">
- </label>
- <input type="submit" class="btn btn-primary">
- </form>
- <ul>
- {% for file in files %}
- <li><a href="{{ url_for('uploaded_files', filename= file) }}">{{ file }}</a></li>
- {% endfor %}
- </ul>
- </div>
- {% endblock %}

## 第 14 页 · 文件上传

- 文件上传
- 效果如下图所示。
- 选择文件示例图
- 提交成功示例图

![第14页图](media/ch04/slide14_img1.png)

![第14页图](media/ch04/slide14_img2.png)

## 第 15 页 · Flask-WTF

- Flask-WTF
- 02

## 第 16 页 · 01

- 01
- 02
- Flask-WTF是什么？
- 为什么要用Flask-WTF？
- 问题思考

![第16页图](media/ch04/slide16_img1.png)

## 第 17 页 · 概念解释

- 概念解释
- Flask-WTF
- Flask-WTF 是一个用于集成 WTForms 表单库到 Flask 应用中的扩展。WTForms 是一个用于创建和处理 Web 表单的库，它提供了一种简单而强大的方式来定义、验证和呈现表单。

## 第 18 页 · “

- “
- 表单的结构在模板中定义。而HTML形式的表单由于标签之间层层嵌套，并不便于管理。Flask-WTF（WTForms）提供了将表单抽象为类的开发方式，有效地降低了表单维护的难度。
- WTForms带有数据验证功能，便于服务器端对数据进行验证；同时还带有跨站请求伪造（Cross-Site Request Forgery，CSRF）保护功能，能有效防止用户受到黑客攻击。
- ”
- 为什么要用Flask-WTF

## 第 19 页 · 与安装Flask的操作一致，打开命令提示符窗口，输入以下命令。

- 与安装Flask的操作一致，打开命令提示符窗口，输入以下命令。
- pip install flask-wtf==0.14.2
- 执行上述命令之后，能看到“Successfully installed…”提示信息，没有提示红色的报错信息，即安装成功，此时，Flask-WTF的依赖包便安装完成了，如下图所示。
- 安装依赖

![第19页图](media/ch04/slide19_img1.png)

## 第 20 页 · 在使用Flask-WTF表单之前，需要定义表单类。所有表单类都需要继承“FlaskForm”表单类，这是Flask-WT

- 在使用Flask-WTF表单之前，需要定义表单类。所有表单类都需要继承“FlaskForm”表单类，这是Flask-WTF对WTForms表单的封装。表单类用于描述表单的结构，表单字段使用类变量进行描述。
- 表单类

## 第 21 页 · 下面是一个具有登录功能的表单类。代码如下：

- 下面是一个具有登录功能的表单类。代码如下：
- from flask_wtf import FlaskForm
- from wtforms import StringField, PasswordField, SubmitField
- from wtforms.validators import DataRequired
- class LoginForm(FlaskForm):
- username = StringField(label='用户名')
- password = PasswordField(label='密码')
- submit = SubmitField(label='登录')
- 表单类
- 登录表单包含用户名、密码的输入，因此此处使用了“StringField”与“PasswordField”两种字段类。“SubmitField”则用于提交表单。

## 第 22 页 · 拿书本上的例子来讲解，来带大家更好的去了解WTForms是如何使用的，以及对项目的一些初始化的概念。

- 拿书本上的例子来讲解，来带大家更好的去了解WTForms是如何使用的，以及对项目的一些初始化的概念。
- 首先是项目的初始化，引入Flask-bootstrap等等，代码如下
- from flask import Flask, render_template, request
- app = Flask(__name__)
- # 使用表单前须定义csrf_token密钥（任意字符串，通常是随机生成的）
- app.config['SECRET_KEY'] = 'Chapter4'
- # 初始化Flask-Bootstrap的代码
- from flask_bootstrap import Bootstrap
- bootstrap = Bootstrap()
- bootstrap.init_app(app)
- bootstrap_cdns = app.extensions['bootstrap']['cdns']
- bootstrap_cdns['bootstrap'] = bootstrap_cdns['local']
- bootstrap_cdns['jquery'] = bootstrap_cdns['local']
- 表单类

## 第 23 页 · 接着是视图代码，如下所示。

- 接着是视图代码，如下所示。
- @app.route('/login', methods=['GET', 'POST'])
- def login():
- form = LoginForm()
- if request.method == 'POST' and form.validate_on_submit():
- return 'Hello %s!<br>你所输入的密码为：%s' % (form.username.data, form.password.data)
- else:
- return render_template('login.html', form=form)
- 这里的loginForm()就是前面定义的具有登录功能的表单类
- 表单类

## 第 24 页 · 接着是模板页面代码

- 接着是模板页面代码
- {% extends 'bootstrap/base.html' %}
- {% import 'bootstrap/wtf.html' as wtf %}
- {% block title %}登录表单{% endblock %}
- {% block content %}
- <div class="container">
- {{ wtf.quick_form(form) }}
- </div>
- {% endblock %}
- 这里用了快速渲染表单的功能，快速渲染表单在后面会有详细解释。
- 表单类

## 第 25 页 · 效果如下图所示。

- 效果如下图所示。
- 表单类
- 表单类演示效果图-1
- 表单类演示效果图-2

![第25页图](media/ch04/slide25_img1.png)

![第25页图](media/ch04/slide25_img2.png)

## 第 26 页 · 这是一个典型的登录表单，使用WTForms后，免去了在模板页面中编写表单代码的烦琐过程，且表单类可以在多个视图函数中复用

- 这是一个典型的登录表单，使用WTForms后，免去了在模板页面中编写表单代码的烦琐过程，且表单类可以在多个视图函数中复用，便于管理。
- WTForms常见的表单字段类型如下表所示。
- 表单类

## 第 27 页 · 前面有提到渲染表单这方面的内容，渲染表单即根据表单类所描述的结构来生成相应HTML代码的过程。

- 前面有提到渲染表单这方面的内容，渲染表单即根据表单类所描述的结构来生成相应HTML代码的过程。
- 主要讲解一下几种表单渲染方式，以及如何同时把他们放在一块去选择。这里就直接讲模板页面的代码，视图函数可以参照书本4.2.2小节的内容。在模板代码里面用mode来控制在不同模式下模板页面所显示的内容。
- 先来看mode1的代码，如下所示，效果如右图所示。
- {% if mode == 1 %}
- <form role="form" method="post">
- {{ form.username }}
- {{ form.password }}
- {# csrf_token用于保证用户提交表单的安全性 #}
- {{ form.csrf_token }}
- {{ form.submit }}
- </form>
- {% endif %}
- 渲染表单

![第27页图](media/ch04/slide27_img1.png)

## 第 28 页 · mode2的代码如下，效果如右图所示。

- mode2的代码如下，效果如右图所示。
- {% if mode == 2 %}
- <form role="form" method="post">
- {# 使用flask_bootstrap提供的宏指令逐个字段生成表单 #}
- {{ wtf.form_field(form.username) }}
- {{ wtf.form_field(form.password) }}
- {# csrf_token是隐藏字段，使用默认方法生成即可 #}
- {{ form.csrf_token }}
- {{ wtf.form_field(form.submit) }}
- </form>
- {% endif %}
- 渲染表单

![第28页图](media/ch04/slide28_img1.png)

## 第 29 页 · mode3的代码如下，效果如右图所示。

- mode3的代码如下，效果如右图所示。
- {% if mode == 3 %}
- {# 使用flask_bootstrap提供的宏指令快速生成表单 #}
- {{ wtf.quick_form(form) }}
- {% endif %}
- 渲染表单

![第29页图](media/ch04/slide29_img1.png)

## 第 30 页 · 上面只是展示了每个渲染的代码，总体的逻辑还是按照下面代码风格去写。才能实现效果的测试。

- 上面只是展示了每个渲染的代码，总体的逻辑还是按照下面代码风格去写。才能实现效果的测试。
- 渲染表单
- {% block content %}
     <div class="container">
          {% if mode == 1 %}
- ......
          {% elif mode == 2 %}
- ......
          {% elif mode == 3 %}
- ......
          {% endif %}
     </div>
{% endblock %}
- 由上面的内容可见，在使用Flask-Bootstrap的情况下，如果要渲染结构简单的表单，单独渲染与快速渲染所呈现的效果是一致的，但使用快速渲染表单指令可大幅减少代码量。

## 第 31 页 · 在前面的例子中，表单字段都比较少，如果要对数据进行验证，例如，限制用户名或密码不为空，只需要直接通过if语句进行判断即可

- 在前面的例子中，表单字段都比较少，如果要对数据进行验证，例如，限制用户名或密码不为空，只需要直接通过if语句进行判断即可（不推荐）。而在表单字段相当多的情况下，这种方法便不再适用了。
- 处理表单
- WTForms包含数据验证功能。通常情况下，WTForms所提供的数据验证器可以满足大部分的需求。要使用数据验证器，只需要在表单类的字段中添加validators参数，并指定相应的数据验证器即可（该参数为list类型，可添加多种类型的数据验证器）。

## 第 32 页 · 常见的数据验证器类型如下表所示。

- 常见的数据验证器类型如下表所示。
- 处理表单

## 第 33 页 · 举个例子，注册用户需要用到大量的信息，那么我们首先先写表单类。安装书上的例子表单类的具体代码过长这里就不全部放上，只放两

- 举个例子，注册用户需要用到大量的信息，那么我们首先先写表单类。安装书上的例子表单类的具体代码过长这里就不全部放上，只放两个不同类型的来举例，代码如下。
- from flask_wtf import FlaskForm
- from wtforms import StringField,RadioField
- from wtforms.validators import DataRequired, Email
- class RegisterForm(FlaskForm):
- username = StringField(label='用户名', validators=[DataRequired()])
- sex = RadioField(label='性别', validators=[DataRequired()], coerce=int, choices=list(
- {
- 1: '男',
- 2: '女',
- }.items()
- ))
- submit = SubmitField(label='注册')
- 这里只是表单类的一部分，其他的内容参考书上的代码。
- 处理表单

## 第 34 页 · 模板页面代码如下

- 模板页面代码如下
- {% extends 'bootstrap/base.html' %}
- {% import 'bootstrap/wtf.html' as wtf %}
- {% block title %}注册表单{% endblock %}
- {% block content %}
- <div class="container">
- {# 在存在大量表单字段的情况下，快速渲染表单的优势便显现出来了 #}
- {{ wtf.quick_form(form) }}
- </div>
- {% endblock %}
- 处理表单

## 第 35 页 · 在同时需要获取多个表单字段的情况下，直接通过“form.xx.data”的方式获取数据便不再合适了。在需要处理结构复杂的

- 在同时需要获取多个表单字段的情况下，直接通过“form.xx.data”的方式获取数据便不再合适了。在需要处理结构复杂的表单的情况下，可以通过“form.data”的方式获取“dict”类型的表单数据，以便于处理大量数据。代码如下所示。
- 处理表单
- @app.route('/register', methods=['GET', 'POST'])
def register():
     form = RegisterForm()
     # 此处的validate_on_submit()方法用于对表单数据进行验证
     if request.method == 'POST' and form.validate_on_submit():
           # 展示表单所包含的所有数据
           info = ''
           for k, v in form.data.items():
                info += '%s: %s<br>' % (k, v)
           return info
     else:
           return render_template('register.html', form=form)

## 第 36 页 · 效果如下图所示。

- 效果如下图所示。
- 处理表单
- 如果仔细观察，会发现表单的最后一项“csrf_token”是不存在于前面定义的表单类当中的。前文提到，WTForms带有CSRF保护功能，“csrf_token”表单字段就是用于防止CSRF攻击的。感兴趣的同学可以自行了解

![第36页图](media/ch04/slide36_img1.png)

![第36页图](media/ch04/slide36_img2.png)

## 第 37 页 · 消息反馈

- 消息反馈
- 03

## 第 38 页 · 概念解释

- 概念解释
- 消息反馈
- 消息反馈是指在 Web 应用中，通过文本、图标、颜色等方式向用户传达操作结果、状态变化或需要注意的信息。它用于向用户提供操作成功、操作失败、警告或其他相关信息，以帮助用户了解当前状态并做出适当的响应。

## 第 39 页 · 消息反馈

- 消息反馈
- 确认操作结果： 用户提交表单、执行操作或发起请求后，消息反馈可以告知用户操作是否已成功完成。这有助于用户确认他们的操作结果。
- 提醒警告： 某些操作可能涉及风险或需要特别注意。消息反馈可以警告用户可能遇到的问题或后果。
- 错误提示： 如果用户的操作存在错误，消息反馈可以清楚地说明错误的原因，帮助用户理解并纠正错误。
- 增强用户体验： 良好的消息反馈可以提升用户体验，让用户感受到应用程序的响应性和友好性。
- 避免混淆： 当用户执行某些需要时间的操作时，消息反馈可以避免用户的重复操作，因为他们会知道应用正在处理请求。
- 我们从闪现消息和自定义错误页来讲解。
- 为什么要有消息反馈？

## 第 40 页 · 闪现消息

- 闪现消息
- 在前面几个表单交互的例子中，所有消息都是直接通过文本内容返回到浏览器中进行展示的。而在实际项目中，消息通常会在页面中的一小部分区域展示，如弹框等。闪现消息便是Flask对这种消息反馈功能的实现。下面是闪现消息的简单例子，代码如下。
- 此处使用了flash()函数发送了4种不同状态的消息，如果需要将消息显示出来，则需要在模板页面中使用for语句进行输出。
- from flask import Flask, render_template, flash
- @app.route('/flash')
- def flash_message():
- flash('这是一条测试消息', 'success')
- flash('这是一条测试消息', 'danger')
- flash('这是一条测试消息', 'info')
- flash('这是一条测试消息', 'warning')
- return render_template('flash.html')

## 第 41 页 · 闪现消息

- 闪现消息
- 模板代码如下，效果如下图所示。
- {% extends 'bootstrap/base.html' %}
- {% block title %}闪现消息{% endblock %}
- {% block content %}
- {% for category, message in get_flashed_messages(with_categories=true) %}
- <h5>[{{ category }}] - {{ message }}</h5>
- {% endfor %}
- {% endblock %}

![第41页图](media/ch04/slide41_img1.png)

## 第 42 页 · 闪现消息

- 闪现消息
- 从上面的例子可以看出，闪现消息的可定制性非常高，其在页面中的展示方式取决于前端页面如何编写。Flask-Bootstrap也提供了相应的消息渲染宏指令。
- 使用Flask-Bootstrap提供的消息渲染宏指令展示上例闪现消息的模板页面代码如下所示。效果图也如下所示。
- {% extends 'bootstrap/base.html' %}
- {% import 'bootstrap/utils.html' as utils %}
- {% block title %}flash消息{% endblock %}
- {% block content %}
- {{ utils.flashed_messages() }}
- {% endblock %}
- 闪现消息示例图

![第42页图](media/ch04/slide42_img1.png)

## 第 43 页 · 自定义错误页

- 自定义错误页
- 当用户访问到不存在的页面时，通常会跳转到404页面；又或是当用户访问网页出错时，会跳转到500错误页。在Flask中，默认错误页如下图所示。

![第43页图](media/ch04/slide43_img1.png)

## 第 44 页 · 自定义错误页

- 自定义错误页
- 可以看出，这是一个纯文字的页面，如果网站带有自定义的风格设计，那么这些默认的错误页面则无法与网站整体的风格相匹配。
- 在Flask中使用自定义错误页与绑定视图函数类似，但需要使用特殊的路由函数errorhandler()，以下是代码演示。
- # app.errorhandler装饰器用于绑定错误页面的视图函数，与路由函数相似
@app.errorhandler(404)
def not_found_page(e):
     return render_template('custom_error.html', title='Emmmm, 404!', description='搞错url了吧：%s' % request.path), 404

## 第 45 页 · 自定义错误页

- 自定义错误页
- 模板页面代码如下。效果如下图所示。
- {% extends 'bootstrap/base.html' %}
- {% block title %}自定义错误页{% endblock %}
- {% block content %}
- <div class="container">
- <h1>{{ title }}</h1>
- <pre>{{ description }}</pre>
- </div>
- {% endblock %}

![第45页图](media/ch04/slide45_img1.png)

## 第 46 页 · 自定义错误页

- 自定义错误页
- 仔细观察会发现错误页面是使用“app.errorhandler”装饰器，根据响应状态码进行绑定的。
- 实际上，还可以在视图函数中触发404页面。代码如下所示。
- from flask import abort
- @app.route('/error_404')
- def error_404():
- abort(404)

## 第 47 页 · 自定义错误页

- 自定义错误页
- 与404页面相似，如果需要绑定500错误页面，仅需将“app.errorhandler”装饰器中的状态码参数修改为500即可。
- 500错误通常是程序出错导致的。在Flask中，即Python运行出现异常时会出现500页面。那么为了方便调试，可以将异常内容在网页中显示出来（但在投入使用时，考虑到安全性，则不可以展示相关错误信息，应以日志方式将错误信息保存）。自定义的视图函数代码如下所示。
- from io import StringIO
- from traceback import print_exc
- @app.errorhandler(500)
- def error_page(e):
- # 以下代码用于获取程序抛出异常的内容
- with StringIO() as io:
- print_exc(file=io)
- io.seek(0)
- error = io.read()
- return render_template('custom_error.html', title='Oops, 500!', description=error), 500

## 第 48 页 · 自定义错误页

- 自定义错误页
- 同样是使用先前自定义错误页面的模板，但500页面只有在程序发生错误时才会展示，所以，在这里通过“编写错误代码”的方式进行演示。
- 以下是一个会发生错误的视图函数。
- from flask import abort
- @app.route('/error_500')
- @app.route('/error_500/<int:mode>')
- def error_500(mode=None):
- if mode == 1:
- # 调用abort()函数可终止后续运行，并跳转到相应错误页面
- abort(500)
- else:
- raise Exception('引发了一个异常')

## 第 49 页 · 自定义错误页

- 自定义错误页
- 这里使用两种不同的方式触发500响应，其效果如下图所示。
- 500错误演示（abort触发）
- 500错误演示（引发异常触发）

![第49页图](media/ch04/slide49_img1.png)

![第49页图](media/ch04/slide49_img2.png)

## 第 50 页 · Flask-CKEditor

- Flask-CKEditor
- 04

## 第 51 页 · 概念解释

- 概念解释
- Flask-CKEditor
- Flask-CKEditor 是 Flask 框架中的一个扩展，它集成了 CKEditor 富文本编辑器到 Flask 应用中，使您可以在 Web 应用中轻松地添加富文本编辑功能。CKEditor 是一个流行的富文本编辑器，具有强大的功能，可以让用户在浏览器中创建和编辑富文本内容，如格式化文本、插入图像、创建表格等。

## 第 52 页 · 安装依赖

- 安装依赖
- 与安装Flask的操作一致，打开命令提示符窗口，输入以下命令。
pip install flask-ckeditor==0.4.3
执行上述命令之后，能看到“Successfully installed…”提示信息，没有提示红色的报错信息，即安装成功，此时，Flask-CKEditor的依赖包便安装完成了，如下图所示。

![第52页图](media/ch04/slide52_img1.png)

## 第 53 页 · 基本使用

- 基本使用
- 安装完成后，便可以在程序中使用CKEditor。其初始化代码与其他模块（如Flask-WTF、Flask-Bootstrap）的相似。代码如下所示。
- from flask_ckeditor import CKEditor
- # 使用本地资源文件
- app.config['CKEDITOR_SERVE_LOCAL'] = True
- ckeditor = CKEditor()
- # 初始化Flask-CKEditor
- ckeditor.init_app(app)
- 此时CKEditor的初始化完成，可以在程序中使用了。接下来便是定义表单类、视图函数，以及相应的模板。

## 第 54 页 · 基本使用

- 基本使用
- （1）表单类的实现代码如下。
- from flask_ckeditor import CKEditorField
- from flask_wtf import FlaskForm
- from wtforms import StringField, SubmitField
- from wtforms.validators import DataRequired
- class ArticleForm(FlaskForm):
- title = StringField(label='标题', validators=[DataRequired()])
- content = CKEditorField(label='内容', validators=[DataRequired()])
- submit = SubmitField(label='查看')
- 上述代码实现的是一个简单的表单类，其中使用了“CKEditorField”，Flask-CKEditor的使用方式与其他表单字段类的基本一致。

## 第 55 页 · 基本使用

- 基本使用
- （2）视图函数的实现代码如下。
- @app.route('/ckeditor_article', methods=['GET', 'POST'])
- def ckeditor_article():
- form = ArticleForm()
- if request.method == 'POST' and form.validate_on_submit():
- return render_template('ckeditor_view.html', form=form)
- else:
- return render_template('ckeditor_edit.html', form=form)
- 视图函数相当简洁，仅创建了表单类实例，并将其注入模板页面中进行渲染。此例中包含两个模板页面：文章编辑模板页和文章查看模板页。

## 第 56 页 · 基本使用

- 基本使用
- （3）以下是文章编辑模板页（ckeditor_edit.html）的代码实现。
- {% extends 'base.html' %}
- {% import 'bootstrap/wtf.html' as wtf %}
- {% block title %}CKEditor基本使用{% endblock %}
- {% block content %}
- <div class="container">
- {{ wtf.quick_form(form) }}
- </div>
- {# 加载CKEditor资源 #}
- {{ ckeditor.load() }}
- {# 配置CKEditor控件，此处name与表单类字段的content对应 #}
- {{ ckeditor.config(name='content', height=320) }}
- {% endblock %}
- 同样是使用快速渲染表单功能，不同之处在于CKEditor需要使用ckeditor.load()方法以及ckeditor.config()方法进行加载。

## 第 57 页 · 基本使用

- 基本使用
- （4）以下是文章查看模板页（ckeditor_view.html）的代码实现。
- {% extends 'base.html' %}
- {% import 'bootstrap/wtf.html' as wtf %}
- {% block title %}{{ form.title.data }}{% endblock %}
- {% block content %}
- <div class="container">
- <h1>{{ form.title.data }}</h1>
- <hr>
- {{ form.content.data | safe }}
- </div>
- {% endblock %}
- 文章查看页的结构较为简单，但在注入表单中的“内容”数据（即文章）时，由于CKEditor提供的数据为HTML格式，所以此处需要使用“safe”变量过滤器（关闭HTML转义）。

## 第 58 页 · 基本使用

- 基本使用
- 文章编辑的页面效果如下图所示。

![第58页图](media/ch04/slide58_img1.png)

## 第 59 页 · 基本使用

- 基本使用
- 文章查看页面效果如下图所示。

![第59页图](media/ch04/slide59_img1.png)

## 第 60 页 · 资源上传

- 资源上传
- 上面简单地演示了CKEditor的富文本编辑功能，但还不够全面。在常见的使用场景中，编辑内容需要插入图像，但前面的例子中，仅支持添加在线图像，使用起来并不方便。为此，接下来需要实现图像（资源）上传功能。
- 实现资源上传功能需要为CKEditor指定文件上传所使用的视图函数及用于获取已上传的文件视图函数。
- 与4.1.2小节的“文件上传”有所不同，上传文件的视图函数需要使用Flask-CKEditor中所提供的API返回响应内容。

## 第 61 页 · 资源上传

- 资源上传
- 以下是上传功能的代码实现。
- import os
- from flask import send_from_directory, url_for
- from flask_ckeditor import upload_fail, upload_success
- # 指定文件上传所使用的视图函数
- app.config['CKEDITOR_FILE_UPLOADER'] = 'upload_ckeditor'
- # CKEditor用于上传文件的视图函数
- @app.route('/upload_ckeditor', methods=['POST'])
- def upload_ckeditor():
- f = request.files.get('upload')
- # 检查文件扩展名
- extension = f.filename.split('.')[1].lower()
- if extension not in ['jpg', 'gif', 'png', 'jpeg', 'zip']:
- return upload_fail(message='不支持的文件！')
- f.save(os.path.join(app.config['UPLOADED_PATH'], f.filename))
- # 上传完成后返回相应链接
- return upload_success(url=url_for('uploaded_files', filename=f. filename))
- 此处使用了4.1.2小节中用于获取上传文件的视图函数uploaded_files()。

## 第 62 页 · 资源上传

- 资源上传
- 上传功能的演示效果如下图所示。
- 上传功能示例图

![第62页图](media/ch04/slide62_img1.png)

## 第 63 页 · 资源上传

- 资源上传
- 上传功能的演示效果如下图所示。
- 上传功能演示图

![第63页图](media/ch04/slide63_img1.png)

## 第 64 页 · 小结

- 小结
- 05

## 第 65 页 · 小结

- 小结
- 本章通过表单交互、消息反馈的形式，简单介绍了在Flask中与用户进行交互的方法，以及CKEditor的使用方法。

## 第 66 页 · 课后作业

- 课后作业
- 今日作业
- 课后习题4.6
- 选做（创建一个 Flask Web 应用。
- 在应用中定义一个表单类，包含用户名和密码字段，以及一个提交按钮。
- 使用 Flask-WTF 扩展快速渲染表单，并在表单提交后，验证用户输入，如果验证通过，向用户显示成功消息，否则向用户显示错误消息。
- 在模板中显示消息反馈，确保消息对用户可见。）

![第66页图](media/ch04/slide66_img1.jpg)

## 第 67 页 · 谢谢聆听

- 谢谢聆听
