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>