图文并茂发布组件
名扬银河数字官网系统的后台图文并茂发布组件文档:
一、组件名称:图文并茂发布组件。
二、组件作用:可快速在后台页面表单中构建支持文本段落和图片的处理功能,提供名称、输入、备注、是否必填、图片发布等功能。同时对接了表单提交处理流程。
三、使用范围:仅在所在的页面中有效,在同一页面中可放置多个此组件,请结合实际需要安排。常用于处理网站用户需要提交丰富的图文资料的表单项应用。
四、组件写法:[sys.textpicbox #id @name {备注说明} must=1 ]$bind.data数据查询组件的外部调用名.字段名$[/sys.textpicbox]。
1、[sys.textpicbox - 开头部分。
2、#id - 表示唯一名称码部分,用于定义该项在页面中的唯一性,id后名称只能使用英文字母、数字、下划线、短横线。比如:#news_con。
3、@name - 表示唯一中文名称部分,用于定义该项在当前页面中的唯一中文名称,应尽量简洁化,须8个字以内。以@号开头,@后名称只能使用中文、字母、数字、下划线、短横线。比如:@内容详情。
4、{备注说明} - 表示该项的备注说明:以{开头,以}结尾,在其间为备注说明内容,备注内容只能使用中文、字母、数字、下划线、短横线、中文特殊符号。比如:{请编辑内容详情}。
5、must=1 表示此项为必填项,如果不是必填项,请去掉must=1。
6、前段闭合符:]。
7、$bind.data数据查询组件的外部调用名.字段名$:用于修改数据记录时初始化绑定旧值使用。比如:修改文章时,绑定初始化值为所改那一条文章运用数据查询组件[data....]...[/data]的外部调用名newsinfo,获得的文章内容详情使用$bind.newsinfo.news_con$。
8、结尾:[/sys.textpicbox]
9、完整示例: [sys.textpicbox #news_con @内容详情 {请编辑内容详情} must=1 ]$bind.newsinfo.news_con$[/sys.textpicbox]。
10、输出结果形式:包含有完整左侧名称显示、右侧多行文本输入框和图片信息操作。第9点的实例输出html结果为:其中的css样式都定义在通用的/res/c/m.css中。用户可在特定组件外层嵌套重定义css,也可直接重定义原css。
五、组件使用实例讲解,对实例中修改资讯文章信息时,图文并茂发布组件初始化绑定旧文章内容详情的说明:
1、在管理后台文章发布页的页面代码中, 使用[req=eid=int]先定义一个用于获取当前需要修改的那一条文章的编号;
2、页面代码中判断如果获取到的eid参数值大于0,则表示当前是需要准备修改文章信息,初始化加载文章编号eid值所对应的一条文章的数据内容。使用[data...]...[/data]数据查询组件。[data...]查询组件外部的数据调用名称为newsinfo。
[if={$req.eid$}d{0}=int]
[data=news_list]
[0]
[out=newsinfo]
[num=1]
[get]
[col=news_title][col=news_typeid][col=news_flag][col=news_con][col=news_des][col=news_faceurl]
[/get]
[where]
[col=news_id][way]=[/way][val]$req.eid$[/val][/col]
[col=news_isdel][way]=[/way][val]0[/val][/col]
[/where]
[/0]
[/data]
[/if]
3、页面代码的表单项中加入:
[sys.textpicbox #news_con @内容详情 {请编辑内容详情} must=1 ]$bind.newsinfo.news_con$[/sys.textpicbox]
4、在管理后台发布文章页面可以看到修改一条资讯文章信息时,内容详情的呈现效果:
六、网站后台图文并茂发布组件的文本段落中,可以使用独立一行的方式,将某些html标签运用于详情内容的SEO和布局效果中。支持在文本段落中独立一行的布局html标签有div、ul、li、ol。用法说明:
1、独立html标签的开始行,使用格式以{开头,再标签名称,结尾用}。比如:{div},{ul},{li},{ol}
2、.....中间的文本内容等信息。
3、独立html标签的结束行,使用格式以{开头,再/标签名称,结尾用}。比如:{/div},{/ul},{/li},{/ol}
重要一点:必须独立一行存在,否则无效!
如果需要在内容文本段落中对某些内容区域使用自定义的css样式类,可以通过格式:{div=自定义的css样式类名称}....{/div},css样式类名称只支持英文字母 数字 下划线 短横线。
写法举例:
{h3}图文并茂页面信息设置组件的注意事项有哪些?{/h3}
{ul}
{li}
第一点、该组件只能用于网站前台的页面代码中。
{/li}
{li}
第二点、该组件支持文本段落、图片信息的处理。
{/li}
{/ul}
实战前台页面效果,注意图文并茂发布组件存储的字段数据内容,在前台呈现需要结合[show]...[/show]方式处理:
七、在网站前台页面代码中,如果调用呈现的是保存为详情类型的字段的数据内容时,请使用[show]...[/show]方式处理字段数据内容的呈现效果,具体操作用法请详见【前台单条或多条数据查询组件文档】的show处理部分。