2008年2月28日

formencode.htmlfill

ユーザー入力をチェックしたら、フォームを復元することはよくある話で、エラーメッセージとかも出さないといけないよねと。
Pylonsを含むWSGI派の入力チェックといえば、formencode。
チェックするだけじゃなくて、フォームへの値入れやエラーメッセージ表示に便利なhtmlfillがついている。
htmlに対して適用するから、どんなテンプレートでもOK。


import os
import webob
import tempita
import selector
import formencode
from formencode import validators
from formencode import htmlfill

paths = tempita.bunch()
paths.root = os.path.dirname(__file__)
paths.templates = os.path.join(paths.root, 'templates')

class PersonSchema(formencode.Schema):
name = validators.UnicodeString(not_empty=True)
email = validators.Email(not_empty=True)
blog = validators.URL(not_empty=True)


def form(environ, start_response):
request = webob.Request(environ)
response = webob.Response(request=request, content_type="text/html", charset="utf-8")
tmpl = tempita.HTMLTemplate.from_filename(os.path.join(paths.templates, 'form.html'))
response.body = tmpl.substitute()
return response(environ, start_response)

def submit(environ, start_response):
request = webob.Request(environ)
response = webob.Response(request=request, content_type="text/html", charset="utf-8")
schema = PersonSchema()
try:
params = schema.to_python(request.params)
except formencode.Invalid, e:
errors = e.error_dict
tmpl = tempita.HTMLTemplate.from_filename(os.path.join(paths.templates, 'form.html'))
response.body = htmlfill.render(tmpl.substitute(), defaults=request.params, errors=errors)
else:
tmpl = tempita.HTMLTemplate.from_filename(os.path.join(paths.templates, 'person.html'))
response.body = tmpl.substitute(params=params)
return response(environ, start_response)

application = selector.Selector()
application.add("/", GET=form, POST=submit)


form.htmlはこちら。


<html>
<body>
<form method="post">
<ul>
<li><label for="person-name">Name:</label>
<input id="person-name" type="text" name="name">
<li><label for="person-email">Email:</label>
<input id="person-email" type="text" name="email">
<li><label for="person-blog">Blog:</label>
<input id="person-blog" type="text" name="blog">
</ul>
<button type="submit">Save</button>
</form>
</body>
</html>


form:error というタグを使えば出力位置を調節できる。
対応するform:error がなければ、inputタグの直後にエラーメッセージを表示。
checkboxはboolだけ対応のようだ。