跳转到内容

模块碎片入门

使用碎片模板他涉及到主模板与碎片子模板。


重要提示: 制作碎片模块,请尽量忘记 qb:tag 全部使用 qb:hy 否则你容易混乱,他们的使用方法是一样的


下面的图片就是主模板,比如是网站主页或者列表页或者是内容页等等。他必须使用 qb:hy标签来引入碎片子模板 type="labelmodel" 是告诉系统标签我要引入碎片子模板 where="index_style/default/index/index_mod/rollpic,index_style/default/index/index_mod/head_menu" 这个参数就告诉系统,我要使用哪些碎片子模板,一般是私有子模板(路径可随意,但必须指定详细的路径),也可以是公共子模板,公共子模板也要指定详细路径,无论是公共还是私人模板,都不需要.htm后缀。模板虽然要详细路径,但不要加上/template/ val="datas" 这个参数是固定的,因为标签里边要用到。

子模板就是一个普通的标签模板,里边也可以没标签。没有特别的要求。随便一个页面都可以当子模板使用,没任何求。 对于私有模板,最好在头部加一段注释说明这个是什么功能的模板,当然也可以不加。

img 代码如下图,把下面的代码放在模板中去,就代表使用模块碎片化功能了。同一个页面可以放多个,WAP可能用不到,PC就会用到,比如1200像素一个,800像素的左边栏一个。400像素的右边栏一个

{qb:hy name="wap_index_model" where="index_style/default/index/index_mod/rollpic,index_style/default/index/index_mod/head_menu" val="datas" type="labelmodel"}
{$datas}
{/qb:hy}

where参数指定了默认的模板,仅仅是推荐给用户使用而已,用户还可以随意删除或添加其它的模板,当然也可以复制。也可以重新排序。所以where仅仅是给开发者对用户使用碎片模板的一个推荐而已。 公共模板是可以随意选择的。你也可以做很多私有模板给用户备选,而不用全部一起加载出来。 要想私用模板可供用户备选,但又不想在where参数里边默认加载显示的话,你只需要在当前目录给他命名的文件名是model_开头即可。这个时候where参数里边的第一个子模板路径必须跟备选子模板同一个目录。而不能是其它路径,第一个如果是公共子模板,那没影响。

img

img

img

子模块就是普通的标签模板,里边也可以不放标签代码。不放的话,用户就不能修改里边的内容而已。 目录可以跟当前的主模板同一个目录,如果太多的话, 也可以给他一个子目录。 子模板你可以做多一点给用户备选,默认不用全放进去。这个时候就需要子模块的文件名必须是model_开头,并且要保证备选的模板与当前设置的第一个子模板同一个目录(注意是第一个,系统只认第一个,逗号后面的其它路径不受影响)。