1.引用css。这可能是最常见的做法了,对一些特定的元素定义特定的样式。那么使用它,你需要在HTML
页面中加入<link>标签。
2.引入js。许多特效也可以通过javascript来进行处理,比如动态显示效果,或对元素进行封装。使用
它你需要在HTML页面加入<script>标签,必要时还要加一些javascript代码。
3.HTML元素。需要设定一些特殊的属性,比如class=某个属性。这块还相对简单。
因此从上面的分析可以看出,在通常情况下,加入一个好看的web元素可能到许多地方的修改。因此我一
直在思考如何让这个过程可以更简化,麻烦的地方就是如何处理这些资源,如何让这些资源可以与原始的
HTML很好的结合呢?最终我想出的办法就是:代码组装。
对于css,javascript链接和代码,它们可以按调用的顺序依次拼成一段文本,然后插入到</head>元素前
面。然后对于html代码,在模板中直接输出。对于css,javascript的链接可以检查是否重复。
那么如何定义web元素类和如何在模板中对其进行处理?
一个web元素类定义如下:
classSnippet(object):
css=''
csslink=''
jslink=''
html=''
js=''
defrender(self):
return''
def__str__(self):
returnself.render()
定义为类属性的将输出到HTML的头部,而render()的结果将显示在模板中调用类的地方。先看一下在模板
中调用的示例:
<!DOCTYPEhtmlPUBLIC"-//W3C//DTDXHTML1.0Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<htmlxmlns="http://www.w3.org/1999/xhtml">
<head>
<title>HTMLHelper</title>
<scripttype="text/javascript"src="/static/js/jquery.js"></script>
</head>
<body>
{{
htmlbuf<<htmlwidgets.Message('Thisisatest')
}}
</body>
</html>
这里你可以看到htmlbuf,它是什么,它就是用来采集每个Snippet类的类属性的。这里使用<<来将一个
Snippet对象加到htmlbuf中去。同时它还会将Snippet的HTML代码在调用位置输出。
如何输出?首先uliweb的模板将转为python代码,它有一个内置的out对象,可以调用它的方法来输出
HTML代码。那么htmlbuf对象将在调用模板前被创建,在调用模板后被处理,在创建时将传入out的write
属性。这一切都是在SImpleFrame.py中通过plugin方法来实现的,但是这只是定义了一个调用点,如:
fname,code=template.render_file(filename,vars,env,dirs)
out=template.Out()
template._prepare_run(vars,env,out)
callplugin(self,'before_render_template',env,out)
ifisinstance(code,(str,unicode)):
code=compile(code,fname,'exec')
execcodeinenv,vars
text=out.getvalue()
output=execplugin(self,'after_render_template',text,vars,env)
before_render_template会在调用模板前被调用。after_render_template会在调用模板后被调用。因
此你可以通过plugin机制来加入额外的处理。这是在settings.py中定义的,如:
@plugin('before_render_template')
defbefore_render_template(sender,env,out):
fromuliweb.coreimportjs
fromuliweb.core.SimpleFrameimporturl_for
fromuliweb.helpersimporthtmlwidgets
htmlbuf=js.HtmlBuf(write=out.noescape,static_suffix=url_for('Portal.views.static',
filename=''))
env['htmlbuf']=htmlbuf
env['htmlwidgets']=htmlwidgets
这里注入htmlbuf和htmlwidgets到模板的env环境中,所以可以在模板中直接使用。在htmlwidgets中已经
定义了一些Snippet。htmlbuf在创建时,会使用out.noescape方法,它将不会对Snippet中的代码进行转
义。static_suffix表示静态文件的前缀,缺省为/static/,这里由于使用了静态服务,所以通过url_for
来得到静态URL前缀。
@plugin('after_render_template')
defafter_render_template(sender,text,vars,env):
importre
r_links=re.compile('<links.*?shrefs*=s*"?(.*?)["s>]|<scripts.*?ssrcs*=s*"?
(.*?)["s>]',re.I)
if'htmlbuf'inenv:
htmlbuf=env['htmlbuf']
ifhtmlbuf.modified:
b=re.search('(?i)</head>',text)
ifb:
pos=b.start()
#findlinks
links=[xoryforx,yinr_links.findall(text[:pos])]
htmlbuf.remove_links(links)
t=htmlbuf.render()
ift:
return''.join([text[:pos],t,text[pos:]])
else:
returnt+text
returntext
这里将在模板处理完毕后查找生成的HTML文本中的</head>标签,然后将相应的信息插入到它的前面。同
时这里增加了对原HTML中已经存在的链接进行了判断,如果存在则删除之,这是通过remove_links来处理
的。
经过这些的处理,你只要定义一个Snippet,Uliweb将自动为你处理css,js的链接包括代码,和HTML代码
的生成。因此你就可以简单的:
{{
htmlbuf<<htmlwidgets.Message('Thisisatest')
}}
来生成一个消息的提示信息。
我会慢慢扩展这个htmlwidgets库。
再简单描述一下如何配置:
1.在settings.py中
INSTALLED_APPS=['Documents','Examples','Portal','Post',
'uliweb.builtins.auth','uliweb.helpers.htmlwidgets']
这里要加入'uliweb.helpers.htmlwidgets',让static目录生效
2.加入:
@plugin('before_render_template')
defbefore_render_template(sender,env,out):
和
@plugin('after_render_template')
defafter_render_template(sender,text,vars,env):
3.可以使用了。