单行文本发布组件
名扬银河数字官网系统的后台单行文本发布组件文档:
一、组件名称:单行文本发布组件。
二、组件作用:可快速在网站管理后台页面表单中构建单行文本输入框功能,提供名称、输入、字数限制、备注、是否必填等功能。同时对接了表单提交处理流程。
三、使用范围:仅在所在的页面中有效,在同一页面中可放置多个此组件,请结合实际需要安排。常用于输入字数不多的表单项应用。
四、组件写法:[sys.text #id @name {备注说明} maxlen=50 must=1 ]$bind.data数据查询组件的外部调用名.字段名$[/sys.text]。
1、[sys.text - 开头部分。
2、#id - 表示唯一名称码部分,用于定义该文本项在页面中的唯一性,id后名称只能使用英文字母、数字、下划线、短横线。比如:#news_title。
3、@name - 表示唯一中文名称部分,用于定义该文本项在当前页面中的唯一中文名称,应尽量简洁化,须8个字以内。以@号开头,@后名称只能使用中文、字母、数字、下划线、短横线。比如:@文章标题。
4、{备注说明} - 表示该文本项的备注说明:以{开头,以}结尾,在其间为备注说明内容,备注内容只能使用中文、字母、数字、下划线、短横线、中文特殊符号。比如:{请填写文章标题,最多100个字}。如果不需要备注说明,请去掉{...}
5、maxlen - 表示最多可输入的字数。比如:maxlen=100。
6、must=1 表示此项为必填项,如果不是必填项,请去掉must=1
7、前段闭合符:]。
8、$bind.data数据查询组件的外部调用名.字段名$:用于修改数据记录时初始化绑定旧值使用。比如:修改文章时,绑定初始化值为所改那一条文章运用数据查询组件[data....]...[/data]的外部调用名newsinfo,获得的文章标题使用$bind.newsinfo.news_title$。
9、结尾:[/sys.text]
五、单行文本发布组件应用实例:
1、在管理后台的后台页面代码的文章发布页的页面代码中放置:
[sys.text #news_title @文章标题 maxlen=100 must=1]$bind.newsinfo.news_title$[/sys.text]。
该文章标题的写法中省去了“备注说明”部分。
2、文章标题 - 单行文本发布组件。#news_title:表单参数项的id为news_title;@文章标题:表单项名称为文章标题;maxlen=100:最多可输入100个字符;must=1:必填项;$bind.newsinfo.news_title$:修改文章时,绑定初始化值为所改那一条文章运用数据查询组件[data....]...[/data]的外部调用名newsinfo,获得的文章标题。
3、实例的输出结果形式:包含有完整左侧名称显示、右侧输入框的表单项模块。其页面中呈现的css样式都定义在通用的/res/c/m.css中。
4、对实例中修改文章信息时,单行文本发布组件初始化绑定旧文章标题的说明:
(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).将查询到的文章数据,初始化绑定到表示文章标题的单行文本发布组件中,绑定发布型组件的值,请使用$bind.数据外部调用名.字段名$方式:
[sys.text #news_title @文章标题 maxlen=100 must=1]$bind.newsinfo.news_title$[/sys.text]。
(4).管理后台文章发布页,加载初始化需要修改的文章资讯信息时,文章标题的结果: