在模板中渲染表单
为了能够在模板中渲染表单，我们需要把表单类实例传入模板。首先在视图函数里实例化表单类LoginForm，然后再render_template()函数中使用关键脑子参数form将表单实例传入模板，例如：form/app.py
#传入表单类实例 from forms import LoginForm @app.route('/basic') def basic(): form=LoginForm() return render_template('login.html',form=form)
在模板中，需要调用表单类的属性即可获取字段对应的HTML代码，如果需要传入参数，也可以添加括号，如form/templates/basic.html：在模板中渲染表单
<form method="post"> {{ form.csrf_token }}<!-- 渲染CSRF令牌隐藏字段 --> {{ form.username.label }}{{ form.username }}<br> {{ form.password.label }}{{ form.password }}<br> {{ form.remember }}{{ form.remember.label }}<br> {{ form.submit }}<br> </form>
在上面的代码中，除了渲染各个字段的标签和字段本身，还调用了form.csrf_token属性渲染Flask-WTF为表单类自动创建的CSRF令牌字段。form.csrf_token字段包含了自动生成的CSRF令牌值，在提交表单后会自动被验证，为了确保表单通过验证，我们必须在表单中手动渲染这个字段。
Flask_WTF为表单类实例提供了一个form.hidden_tag()方法，这个方法会依次渲染表单中所有的隐藏字段。因为csrf_token字段也是隐藏字段，所有当这个方法被调用时也会渲染csrf_token字段。
渲染后获得的实际HTML代码如下：
<form method="post"> <input id="csrf_token" name="csrf_token" type="hidden" value="ImE1M2QxNDEyNDA2YTE5NGI3NmU1NGY1M2U2ZDkxNjQ2NDc5NTI3ZjYi.XH0xaQ.RvNFnjwMfAiUyiv58pU2xJkQ42g"><!-- 渲染CSRF令牌隐藏字段 --> <label for="username">Username</label><input id="username" name="username" required type="text" value=""><br> <label for="password">Password</label><input id="password" name="password" required type="password" value=""><br> <input id="remember" name="remember" type="checkbox" value="y"><label for="remember">Remember me</label><br> <input id="submit" name="submit" type="submit" value="Log in"><br> </form>
运行该程序，访问127.0.0.1:5000/basic可以看到渲染后的表单，页面中的表单和我们在上面使用HTML编写的表单相同
在前面介绍过，使用render_kw字典或是在调用字段时传入参数来定义字段的额外HTML属性，可以通过这种方式添加CSS类，我们编写一个Bootstrap风格的表单：
form/templates/bootstrap.html
{% extends 'base.html' %} {% block styles %} <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}"> {% endblock %} {% block content %} <h1 class="display-4">Bootstrap Style Form</h1> <form method="post"> {{ form.csrf_token }} <div class="form-group"> {{ form.username.label }} {{ form.username(class='form-control') }} </div> <div class="form-group"> {{ form.password.label }} {{ form.password(class='form-contrl') }} </div> <div class="form-check"> {{ form.remember(class='form-check-input') }} {{ form.remember.label }} </div> {{ form.submit(class='btn btn-primary') }} <form/> {% endblock content %}
页面上访问127.0.0.1:5000/bootstrap
base.html:
<!DOCTYPE html> <html lang="en"> <head> {% block head %} {% block metas %} <meta charset="utf-8"> {% endblock metas %} <title> {% block title %} Form - HelloFlask {% endblock title %} </title> <link rel="stylesheet" type="text/css" href="{{ url_for('static', filename='favicon.ico') }}"> {% block styles %} <link rel="stylesheet" type="text/css" href="{{ url_for('static', filename='style.css') }}"> {% endblock styles %} {% endblock head %} </head> <body> <nav> {% block nav %} <ul> <li><a href="{{ url_for('basic') }}">Home</a></li> </ul> {% endblock %} </nav> <main> {% for message in get_flashed_messages() %} <div class="alert"> {{ message }} </div> {% endfor %} {% block content %}{% endblock %} </main> <footer> {% block footer %} <small> © 2019 <a href="https://www.cnblogs.com/xiaxiaoxu/" title="xiaxiaoxu's blog">夏晓旭的博客</a> / <a href="https://github.com/xiaxiaoxu/hybridDrivenTestFramework" title="Contact me on GitHub">GitHub</a> / <a href="http://helloflask.com" title="A HelloFlask project">Learning from GreyLi's HelloFlask</a> </small> {% endblock %} </footer> {% block scripts %}{% endblock %} </body> </html>
style.css文件：
body{ margin:auto; width:750px; } img{ max-width:710px; } nav ul{ list-style-type:none; margin:0; padding:0; overflow:hidden; background-color:#333; } nav li{ float:left; } nav li.a{ display:block; color:white; text-align:center; padding:14px 16px; text-decoration:none; } h1{ color:red; text-align:center; padding:14px 16px; text-decoration:none; } label{width:200px;display:inline-block;} nav li a:hover{ background-color:#111; } main{ padding:10px 20px; } footer{ font-size:13px; color:#888; border-top:1px solid #666; margin-top:25px; text-align:center; padding:10px; } .alert{ position:relative; padding:0.75rem 1.25rem; margin-bottom:1rem; border:1px solid #b8daff; border-radius:0.25rem; color:#004085; background-color: #cce5ff; } .error{ color:red; }
app.py:
#encoding=utf-8 from flask import Flask,render_template,flash,redirect,url_for,session import os app = Flask(__name__) app.secret_key = os.getenv('SECRET_KEY','secret string') @app.route('/html',methods=['GET','POST']) def html(): return render_template('pure_html.html') from forms import LoginForm #传入表单类实例 @app.route('/basic') def basic(): form=LoginForm() return render_template('basic.html',form=form) @app.route('/bootstrap',methods=['GET','POST']) def bootstrap(): form = LoginForm() if form.validate_on_submit(): username = form.username.data flash('welcome home,%s!'% username) return redirect(url_for('basic')) return render_template('bootstrap.html', form=form) if __name__ == '__main__': app.run(debug=True)
forms.py:
#encoding=utf-8 from flask_wtf import FlaskForm from wtforms import StringField, PasswordField, BooleanField, SubmitField from wtforms.validators import DataRequired, Length class LoginForm(FlaskForm): username = StringField('Username', validators=[DataRequired()]) password = PasswordField('Password', validators=[DataRequired(), Length(8, 128)]) remember = BooleanField('Remember me') submit = SubmitField('Log in') from flask import Flask,render_template,flash,redirect,url_for,session import os app = Flask(__name__) app.secret_key = os.getenv('SECRET_KEY','secret string') if __name__ == '__main__': app.run(debug=True)
如果想手动编写HTML表单的代码，需要注意表单字段的name属性值必须和表单类的字段名称相同，这样在提交表单时WTForms才能正确地获取数据并进行验证。