页面数据功能更新事件
前台页面数据功能更新事件文档
一、目前针对官网系统前台，还没有涉及到需要数据进行用户修改提交更新的场景需求。先提供针对栏目详情页中涉及的更新阅读量或浏览量的文档。
网站前台详情页的阅读量一般采用自动更新方式，不会让用户点击按钮进行提交触发。
二、前台页面的数据自动更新事件主要包括三个步骤：
1、页面代码中引用网站系统基础js文件，支持组件功能处理的/res/j/p.js。
2、在页面中定义数据更新的事件信息。
3、在页面中设置更新操作的自定义参数，完成数据提交更新的功能。
三、在页面中定义数据自动更新事件信息：
1、核心项，引擎要求页面数据更新事件中必须放置的4个隐藏域项：
<input type="hidden" id="k0" value="[k0]" />
<input type="hidden" id="k1" value="[k1]" />
<input type="hidden" id="k2" value="[k2]" />
<input type="hidden" id="k3" value="[k3]" />
2、前台页面操作功能事件讲解：
(1).定义更新事件区域：[event=自定义事件的名称,本页面中不可重复]....[/event]。事件的名称只支持英文字母、数字、下划线。
(3).在[event=...]...[/event]区域内容定义需要用于更新条件的参数及值信息。接收动态参数值，请用[req=参数名=参数类型]，参数类型三种：int表示数字，varchar表示英文字母等非中文，nvarchar表示中文信息。
(2).定义更新事件的执行区域：[action=保存数据的数据表名称=执行方式add或update]..区域内定义需要操作的数据字段信息....h]/action]。数据表名称只支持英文字母、数字、下划线。执行方式为update，表示修改更新数据。
(2.1).事件的执行区域[action...]...[/action]内，可定义一个[dbn=对接名称]，用于当需要在本站中扩展处理其他MS SQL Server数据库的数据时，可定义非本站的数据库链接的对接名称。不需要时，此部分可去掉。具体操作详情，请参考【单条或多条数据查询组件文档】中的[dbn=...]定义部分。
(2.2).事件的执行区域[action...]...[/action]内，定义需要操作的数据字段信息，使用[cols]....[/cols]界定字段信息区域。其中每个字段的信息定义，请用[col=字段名]....[/col]。字段值的定义[val]...[/val]，由于是更新阅读量，需要在原有字段值上累加数字1：@字段名+1，比如：@news_hits+1。
(3).一个完整的数据更新事件定义实例：在前台资讯详情页处理一篇资讯信息的阅读量的更新，实例名称定义为setnewshits；通过页面请求访问的资讯id编号作为条件进行更新；事件执行操作的数据表为news_list；操作的方式为update，更新阅读量。操作的字段为news_hits，字段值为@news_hits+1。
[event=setnewshits]
[req=id=int]
[action=news_list=update]
[cols]
[col=news_hits] [val]@news_hits+1[/val][/col]
[/cols]
[where]
[col=news_id]][way]=[/way][val]$req.id$[/val][/col]
[/where]
[/action]
[/event]
(4).设置自动提交更新操作信息：实例中直接修改红色部分后即可使用。
addorupdate("","setnewshits","id=$req.id$","",false);
3、一个前台页面的数据更新事件实例：在前台资讯详情页自动更新资讯信息的阅读量。
[event=setnewshits]
[req=id=int]
[action=news_list=update]
[cols]
[col=news_hits] [val]@news_hits+1[/val][/col]
[/cols]
[where]
[col=news_id]][way]=[/way][val]$req.id$[/val][/col]
[/where]
[/action]
[/event]
<input type="hidden" id="k0" value="[k0]" />
<input type="hidden" id="k1" value="[k1]" />
<input type="hidden" id="k2" value="[k2]" />
<input type="hidden" id="k3" value="[k3]" />
<script type="text/javascript">
$(function () {
addorupdate("","setnewshits","id=$req.id$","",false);
});
</script>
4、前台资讯详情页自动更新资讯阅读量的事件操作图解：
四、更多页面数据更新事件的用法实战操作，请下载名扬银河数字官网系统后获得更好的实践代码与文档的查阅体验，下载网站系统请【名扬银行数字官网系统的最新版本】