web.py 表单
介绍 web.py的表单模块允许生成html表单,获取用户输入,并在处理或将其添加到数据库之前对其进行验证。
表单模块定义了2个主要类:Form类和Input类。表单使用一个或多个输入和可选验证器进行实例化。输入使用名称变量以及可选参数和验证器进行实例化。Input类被子类化为以下html输入(parens中的html类型):
- 文本框 - 自由格式单行输入(输入类型=“文本”)
- 密码 - 隐藏输入的单行代码(输入类型=“密码”)
- Textarea - 自由形式多线输入(textarea)
- 下拉列表 - 列表的互斥输入(选择和选项)
- 无线电 - 几个选项的互斥输入(输入类型=“无线电”)
- 复选框 - 二进制输入(输入类型=“复选框”)
- 按钮 - 提交表单(按钮) 基本登录表单如下所示:
login = form.Form(
form.Textbox('username'),
form.Password('password'),
form.Button('Login'),
)
这定义了一个基本形式。一旦定义,你应该再次调用它来获取一个复制的实例,然后你可以在其上调用render方法,如下所示:
f = login()
print f.render()
这将输出以下HTML:
<table>
<tr><th><label for="username">username</label></th><td><input type="text" id="username" name="username"/><div class="post" style="display: none;"></div></td></tr>
<tr><th><label for="password">password</label></th><td><input type="password" id="password" name="password"/><div class="post" style="display: none;"></div></td></tr>
<tr><th><label for="Login"></label></th><td><button id="Login" name="Login">Login</button><div class="post" style="display: none;"></div></td></tr>
</table>
输入功能 表单输入支持几个附加属性。例如:
form.textbox("firstname",
form.notnull, #put validators first followed by optional attributes
class_="textEntry", #gives a class name to the text box -- note the underscore
pre="pre", #directly before the text box
post="post", #directly after the text box
description="please enter your name", #describes field, defaults to form name ("firstname")
value="bob", #default value
id="nameid", #specify the id
)
除了上述属性之外,还可以以相同的方式输入任何html属性。例如:
myform2 = form.Form(
form.textbox('phonenumber',
size="12",
maxlength="12" )
)
下拉列表
下拉输入允许下拉列表中每个项目的唯一描述和值。为此,使用如下所示的元组创建下拉列表:
form.Dropdown('mydrop', [('value1', 'description1'), ('value2', 'description2')])
表格特征 除了单独的输入验证器,form.py还支持整个表单验证,允许比较字段。验证器作为变量'validators'作为列表传递。例如:
signup = form.Form(
form.Textbox('username'),
form.Password('password'),
form.Password('password_again'),
validators = [form.Validator("Passwords didn't match.", lambda i: i.password == i.password_again)]
)
表单数据发布后,可以轻松地将其放入数据库(如果数据库方案的名称与您的webpy表单一致)。例如:
def POST(self):
f = myform()
if f.validates():
web.insert('data_table', **f.d)
#don't do web.insert('data_table', **web.input()) because malicious data could be submitted too
else:
render.foo(f)
例
import web
from web import form
render = web.template.render('templates/')
urls = ('/', 'index')
app = web.application(urls, globals())
myform = form.Form(
form.Textbox("boe"),
form.Textbox("bax",
form.notnull,
form.regexp('\d+', 'Must be a digit'),
form.Validator('Must be more than 5', lambda x:int(x)>5)),
form.Textarea('moe'),
form.Checkbox('curly'),
form.Dropdown('french', ['mustard', 'fries', 'wine']))
class index:
def GET(self):
form = myform()
# make sure you create a copy of the form by calling it (line above)
# Otherwise changes will appear globally
return render.formtest(form)
def POST(self):
form = myform()
if not form.validates():
return render.formtest(form)
else:
# form.d.boe and form['boe'].value are equivalent ways of
# extracting the validated arguments from the form.
return "Grrreat success! boe: %s, bax: %s" % (form.d.boe, form['bax'].value)
if __name__=="__main__":
web.internalerror = web.debugerror
app.run()
并示例formtest.html(将其放在templates子目录中):
$def with (form)
<form name="main" method="post">
$if not form.valid: <p class="error">Try again, AmeriCAN:</p>
$:form.render()
<input type="submit" /> </form>