基于Metronic的Bootstrap开发框架经验总结(12)--页面链接收藏夹功能的实现
在一个系统里面,往往有很多菜单项目,每个菜单项对应一个页面,一般用户只需要用到一些常用的功能,如果每次都需要去各个层次的菜单里面去找对应的功能,那确实有点繁琐。特别是在菜单繁多,而客户又对系统整体不熟悉的情况下,如果有一个类似浏览器的收藏夹模块,把一些常用的菜单连接保存起来,每次从这个收藏夹主页去找对应的页面,那样确实是省事省力,非常方便。本篇随笔就是介绍在基于Metronic的Bootstrap开发框架里面实现这个收藏夹的思路。
1、系统的收藏夹界面处理效果
为了实现这个收藏夹功能,我们也需要在系统页面的明显位置处放置一个收藏夹模块的入口,以及可以为每个页面添加到对应收藏夹的功能。
经过对比,我们把这些入口功能放在页面标题的附近,这样方便进行快速进行收藏夹,如下效果所示。
当我们在页面上单击【添加到收藏夹】按钮,我们就把对应的页面标题和连接加入到收藏夹记录里面了。
在【查看收藏夹】功能里面,我们可以展示我们加入的页面链接,单击其中某个记录,可以快速进入对应的页面,这样就实现了我们快速进入功能模块的需求了。
这里面最为关键的就是对收藏夹记录的排序处理,向上或者向下移动记录,使之能够符合界面的处理。
2、系统收藏夹的实现过程
了解了上面关于系统页面的收藏夹功能界面效果后,我们需要了解它的具体实现过程,首先我们需要设计一个表用来存储收藏夹对应的信息,页面标题、页面地址、排序等信息。
数据库设计界面如下所示。
我们注意到排序记录用Decimal格式进行存储,我们通过一个有经度的数值进行排序,这样我们可以调整的时候,修改它们之间的大小就可以了。
使用代码生成工具Database2Sharp快速生成底层的相关代码和Web的控制器和视图代码,然后整合到框架里面,这样我们就可以具有整个模块的界面和处理代码了。
由于一般情况下,我们对数据的显示编辑界面是相对标准的,对于收藏夹的入口展示的需求不太一样,我们需要参考列表界面增加一个视图,用来展示简单的入口界面,如图介绍所示。
这个界面里面包含了对记录的移动处理,包括向上或者向下。
前面介绍了,我们对记录的排序主要通过decimal类型的Seq字段实现的。
我们在实体类初始化的时候,给排序的赋值为当前时间的Unix时间戳。
其中上面的DateTimeToInt函数代码如下所示,也是我们常用的处理方式。
/// <summary> ///扩展时间接口,可以返回整形数值/// </summary> /// <param name="time"></param> /// <returns></returns> public static int DateTimeToInt(thisDateTime time)
{
System.DateTime startTime= TimeZone.CurrentTimeZone.ToLocalTime(new System.DateTime(1970, 1, 1));return (int)(time -startTime).TotalSeconds;
}
为了实现记录的移动,我们需要在业务BLL层实现一个移动的逻辑处理,方便在控制器里面调用。
/// <summary> ///更新向上或者向下的顺序/// </summary> /// <param name="id">记录的ID</param> /// <param name="moveUp">往上,还是往下移动,往上则为true</param> /// <returns></returns> public bool UpDown(string id, bool moveUp)
实现的函数代码如下所示
/// <summary> ///更新向上或者向下的顺序/// </summary> /// <param name="id">记录的ID</param> /// <param name="moveUp">往上,还是往下移动,往上则为true</param> /// <returns></returns> public bool UpDown(string id, boolmoveUp)
{//设置排序的规则 bool IsDescending = true;bool result = false;
WebFavoriteInfo info=FindByID(id);if (info != null)
{//构建查询的条件 string condition = "";if(IsDescending)
{
condition= string.Format("Seq {0} {1}", moveUp ? ">" : "<", info.Seq);
}else{
condition= string.Format("Seq {0} {1}", moveUp ? "<" : ">", info.Seq);
}var list =baseDal.Find(condition);decimal newSeq =0M;switch(list.Count)
{case 0:
newSeq= info.Seq;//已在顶部或者底部,顺序默认不变 break;case 1://上面或者下面有一个记录 if(IsDescending)
{
newSeq= moveUp ? (list[0].Seq + 1M) : (list[0].Seq -1M);
}else{
newSeq= !moveUp ? (list[0].Seq + 1M) : (list[0].Seq -1M);
}break;case 2://中间区域,取平均值 newSeq = (list[0].Seq + list[1].Seq) /2M;break;default://多于两个的情况 if(moveUp)
{
newSeq= (list[list.Count - 2].Seq + list[list.Count - 1].Seq) /2M;
}else{
newSeq= (list[0].Seq + list[1].Seq) /2M;
}break;
}//统一修改顺序 info.Seq =newSeq;
result=Update(info, info.ID);
}returnresult;
}
这样我们在MVC的控制器里面,对这个BLL层接口进行进一步封装,方便页面前端进行Ajax调用处理即可,封装代码如下所示。
/// <summary> ///移动记录/// </summary> /// <param name="id">记录ID</param> /// <param name="up">向上为true,否则为false</param> /// <returns></returns> [HttpPost]public ActionResult UpDown(string id, boolup)
{
CommonResult result= newCommonResult();if(!string.IsNullOrEmpty(id))
{try{
result.Success= BLLFactory<WebFavorite>.Instance.UpDown(id, up);
}catch(Exception ex)
{
result.ErrorMessage=ex.Message;
}
}returnToJsonContent(result);
}
这样我们在页面前端的界面视图里面,就可以对这个方法进行调用了。
首先在通过JS绑定生成前端HTML代码,如下所示。
$("#grid_body").html("");
$.each(data.rows,function(i, item) {var tr = "<tr>";
tr+= "<td><a class='btn btn-sm blue' href='" + item.Url + "'>" + item.Title + "</a></td>";
tr+= "<td>";
tr+= "<a href='javascript:;' class='btn btn-sm green' onclick=\"Up('" + item.ID + "')\" title='向上移动'><span class='glyphicon glyphicon-arrow-up icon-state-danger'></span></a>";
tr+= "<a href='javascript:;' class='btn btn-sm blue' onclick=\"Down('" + item.ID + "')\" title='向下移动'><span class='glyphicon glyphicon-arrow-down'></span></a>";
tr+= "</td>";
tr+= "</tr>";
$("#grid_body").append(tr);
});
然后通过Up或者Down函数进行处理,向上或者向下移动位置。
var UpDownUrl = "/WebFavorite/UpDown" functionUp(id) {var postData = { id: id, up: true};
$.post(UpDownUrl, postData,function(json) {var data =$.parseJSON(json);if(data.Success) {
showTips("向上移动成功");
Refresh();//刷新页面数据 }else{
showTips(data.ErrorMessage);
}
});
}functionDown(id) {var postData = { id: id, up: false};
$.post(UpDownUrl, postData,function(json) {var data =$.parseJSON(json);if(data.Success) {
showTips("向下移动成功");
Refresh();//刷新页面数据 }else{
showTips(data.ErrorMessage);
}
});
}
这样就实现了我们所需要的移动顺序的操作了,另外添加的时候,我们判断对应用户是否有添加URL了,如果存在则不需要重复添加即可,前端只需要通过Ajax调用,然后响应处理即可。
通过这些代码的实现,我们可以实现收藏夹的快速管理和快速入口,为用户的使用提供了更加友好的体验。