::-- ZoomQuiet [2005-12-11 04:50:15]

Contents

K3日:发现！

1. K3日:发现！

Cheetah 只能组织有模板的页面输出，但是……

对于动态变化的表单，有什么更好的方式来组织？

1.1. Karrigell_QuickForm

Karrigell_QuickForm 真的是想要什么就来什么！

刚刚从订阅的karrigell-main 列表中看到有人完成了一个 Pear 中 quickform的Karrigell 实现
即有之，则用之！
示例：

   1 from Karrigell_QuickForm import Karrigell_QuickForm
   2 
   3 p = Karrigell_QuickForm('teste','POST','foo.py','Authentication')
   4 p.addElement('text','login')
   5 p.addElement('text','password')
   6 p.addRule('login','required',"Login is required!")
   7 p.addGroup(["submit","botao_enviar","submit","Send"]
   8            ,["reset","botao_limpar","reset","Clear"])
   9 """根据习惯hack! 原先的自动生成 value 的为指定按钮文字。
  10 p.addGroup(["submit","botao_enviar","Send"]
  11            ,["reset","botao_limpar","Clear"])
  12 """
  13 p.display()

6行完成一个标准的登录表单！！！哈哈哈！赞！

1.1.1. 改造

毕竟是 alpha 版本，居然还是全面的table 结构！

代码也很ugly 哪！使用Leo整理后
立即改造！

   1 def addRadioGroup(self,name,value):
   2         """add a radio element - addRadioGroup('genre',{'male':'Male','female':'Female'})"""
   3         self.form_list.append("<tr><td align='right' valign='top'><b>"+name.title().replace('_',' ')+":</b></td> <td valign='top' align='left'>")
   4         radio = ""
   5         t = value.items()
   6         for a,b in t:
   7             radio = radio + "<input type='radio' name='"+name+"' value='"+a+"'>"+"<label><font face=verdana size=2>"+b+"</font></label><br>"
   8         self.form_list.append(radio+"</td>")
   9         self.form_list.append("</tr>")

増补为:

   1 def addRadioList(self,name,desc,value,id=""):
   2     """add a radio element export as UL LI group
   3     """
   4     htm = """
   5         <li id='%s'><b>%s:</b>
   6             <ul>"""
   7     self.form_list.append(htm%(id,desc))
   8     radio = ""
   9     t = value.items()
  10     tmpl = """<li>
  11         <input type='radio' 
  12         name='%s' 
  13         value='%s'>  
  14         <label>%s</label>      
  15         """        
  16     for a,b in t:
  17         radio = radio + tmpl%(name,a,b)
  18     self.form_list.append(radio+"</ul></li>")

1.1.2. 利用

直接将昨天的展示函式修改一下子就应该好用的！

def expage(dict): 对应的修改为:

   1 def qpubish(dict):
   2     exp = ""
   3     p = Karrigell_QuickForm('fm_kq','POST','#',dict.desc.desc)
   4     
   5     p.addElement('node','<ul>','')
   6     # 深入数据 基本和昨天的一样，仅仅是输出时使用 Karrigell_QuickForm 对象而已
   7     qli = {}
   8     k = [int(i) for i in dict.ask.keys()]
   9     k.sort()
  10     for i in k:
  11         ask = dict.ask[str(i)]
  12         qk = [j for j in ask.keys()]
  13         qk.sort()
  14         for q in qk:
  15             if 1==len(q):
  16                 qli[q] = ask[q]
  17             else:
  18                 pass        
  19         p.addRadioList("cr_ask%s"%i
  20                    ,ask["question"]
  21                    ,qli)
  22     p.addElement('node','</ul>','')
  23     p.addGroup(["submit","btn_submit","提交"]
  24                ,["reset","btn_reset","重写"])

注意到原先的 Karrigell_QuickForm 只有display()，要求直接输出，但是你需要进一步的HTML 处理

所以有了

   1 def export(self):
   2     """ export the html form code so people can do something for them self
   3     """
   4     exp = ""
   5     ...
   6     for c in self.css_list:
   7         exp += c+"\n"
   8     for i in self.form_list:
   9         exp += i+"\n"
  10     return exp

基本上就是将原先的 print 替换为 exp+= 记录为字串对象然后返回

还有def addElement(self,element,name,options=None): 中追加更自由的任何HTML 节点输出:
```
        elif element == 'node':
            self.form_list.append(name)
```

1.2. JS 问题

一切顺心，表单正确生成了，但是，Karrigell_QuickForm 提供的JS检验不支持Radio列表的！

呜乎哀哉！！这是个问题哪！如果不是所有问题回答完就提交的话
- 交给服务端检验，浪费带宽！你还要记录上次的问题情况，返回/提示/重答
- 不检验，则没有办法进行统计

1.2.1. 继续发现！

现在的问题是有什么现成的可以模式化的定义表单测验的JS组件？

TiosnG ![ti'aosn'gu]
- There is one site named Google! -- 哈哈哈！！
- JavaScript Validation Framework 国人作品！

致力于 Python 的Ajax框架开发的 AMOWA团队作品，值得期待！使用之！

1.2.2. 迁就,先！

与KarriGell 配合¹，当前需要:
1. jvf=%(base)s/karriweb/questionnaire/js 这样的专门虚拟目录发布，以便，其它各种应用也可以享受
2. var ValidationRoot = "/jvf/"; JVF 实际运行的 validation-framework.js 本身也要声明所在目录
3. ```
ValidateMethodFactory.validateRequired = function(field, params) {
        ...
        window.location.replace("#errorDiv");
```
  使用replace 来减少不必要的页面刷新
4. 使用p.saveJSRule("../js/validation-config.xml") 时要对应的修正写入的正确目标文件
KQF 对JVF 的迁就:

1.2.2.1. 关键代码

JVF的使用很有个性，使用外部的XML 文件进行设置，标准的J2EE行为哪！

所以，对应的增补Karrigell_QuickForm

addJSRule() 追加专门的JVF 规则

   1     def addJSRule(self,name,message):
   2         """add a xml rule for javascript checking
   3         """
   4         exp = self.JSvMXLnode%(name,message)
   5         self.JSvRules.append(exp)

addJSValidation() 追加调用JVF的页面行为

   1     def addJSValidation(self):
   2         """add a javascript rule in order to validate a form field  
   3         - addRule('elem_name','required','Name is required!')
   4         """
   5         orig = "enctype='multipart/form-data'"
   6         repl = """
   7             onsubmit='return doValidate("%s");'
   8             """ 
   9         begin_form=self.form_list[0].replace(orig
  10                                      ,repl%self.name) 
  11         self.form_list[0] = begin_form

saveJSRule() 记录规则集合为JVF需要的XML

   1     def saveJSRule(self,xml):
   2         """exp and save a xml rule for javascript checking
   3         """
   4         exp = ""
   5         for node in self.JSvRules:
   6             exp+= node
   7         #exp = self.JSvXMLtmpl%(form,exp)
   8         open(xml,'w').write(self.JSvXMLtmpl%(self.name
   9                                              ,exp)
  10                                              )

对应的KQF中有预设对象

self.JSvXMLtmpl="""<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE validation-config SYSTEM "validation-config.dtd">
<validation-config lang="auto"> 
        <form id="%s" show-error="errorMessage" onfail="" 
        show-type="first">
    %s
        </form>
</validation-config>
"""
self.JSvMXLnode = """
                <field name="%s" 
                display-name="%s" onfail="">
                        <depend name="required" />
                </field>
"""
self.JSvRules = []

1.2.3. 果然不出所料

仅仅追加少量代码就完成所想的客户端JS验证功能

def qpubish(dict):
    ...
    ## 具体问题解析
    k.sort()
    for i in k:
        ...
        p.addJSRule("cr_ask%s"%i,"问题%s "%i)
    ## 整体行为处理
    p.addJSValidation()
    p.saveJSRule("js/validation-config.xml")
    
    p.addElement('node','</ul>','')

果然不出所料没有任何悬念的完成任务！

1.3. 滥用Leo

到现在页面都是白丁！不能忍了！加载CSS！

不清楚KarriGell 的页面引用效率，直接将CSS，写入页面好了，反正有Leo来维护

1.3.1. CSS设计技巧

复用以前自个儿的积累是非常好的事儿！

颜色的设计是个问题，不过有好工具来偷！
Red Alt - I Like Your Colors

1.3.2. CSS

每一需要CSS美化的页面都加<<k_base>> 引用，
引用都是从复用代码 中clone 过来的同一节点
包含的就是k_base.css 你以往积累的一个通用的CSS整体设计,少量修改后，套用中意的颜色系统

1.4. 小节

今天发现并引入了 KQF和 JVF好象有点复杂的样子……

当然在故事中,这不是最终接受的方案，精彩还要继续……
现在所有的基本功能都有了，接下来的就是要实用化:
1. 有用户验证，要登录
2. 多问卷选择/回答/编辑

1.5. 实例下载

使用 SVN 下载:

KwDay3实例
注意有在外部安置的 JS-JVF 目录

1.6. 讨论

返回 KarrigellWebDev -- 快速体验K开发

测试JS 成功引用否的小技巧:alert("Include KO!"); JS 中加入强制提示看刷页面见分晓！ (1)

KwDay3