用色彩区分 SharePoint 2010 Calendar 的日历项


 

今天有美女问我:可不可以在 SharePoint 的 Calendar 中给不同的日历项以不同的颜色?我说用 Overlay,结果马上就被否定了,她不想搞出来很多个日历。好吧,那就只有在放置日历的页面上,先通过脚本找到日历项,然后分析其内容,最后按照预先订好的规则给这些日历项着色了。这应该又是一个 JS(jQuery)+ CSS 的应用。

其实,我本来计划今天写写 Adventure 系列第 4 篇的的,不过这个应用需求也挺有趣,所以,我打算先处理这件事。

jonyzhu 的原创

最常见的面试题

“如果遇到你不会的事情,你怎么处理?”“我会先去网上或者书上找,如果没有,就去问周围的人,如果还是没有,就只好自己研究了。” 多么经典的面试问答啊 :)

我就是这么实践的。先 Google 了一下,搜索第一屏里面只有一个中文链接,Erucy 的 按条件决定SharePoint 2010日历颜色。看了看,应用场景和这次的要求很匹配,基本思路就是通过 jQuery 找到 SharePoint 日历项所特有的样式标识(div.ms-acal-item),然后读取放在 div 的 title 属性中的用半角括号所包含的日历项地点(Location)信息,再到一个预先定义的“地点:颜色”对象中取出颜色作为 div 的背景色。

 

移植

不过,在 copy & paste 前,我需要自己检查一下,这是习惯。搞电子电路也是,上电前都需要检查的么(我现在连焊接前都要检查)。于是,我建了几个测试用的日历项,随机选了几天,其中有一天加了2个日历项。通过分析HTML的内容,发现了有趣的事情。

如果一天只有一个日历项,那么,div.ms-acal-item 里面会包含 div.ms-acal-sdiv,接着下面是 div.ms-acal-time 和 div.ms-acal-title。div.ms-acal-title 里面是一个链接,链接的里面是现实日历项的标题。

image

 

但是,如果一天有多个日历项,那么 SharePoint 组织当天的日历项的时候,结构会有不同。最外面还是 div.ms-acal-item,里面会包含 div.ms-acal-sdiv,不过,接下去,就没有 div.ms-acal-time 和 div.ms-acal-title 了,而是直接以文本显示日历项的时间,以链接显示日历项的标题。

image

当然,无论哪种情况,Erucy 的代码都可以运行的,因为其查找的是 div.ms-acal-item。

不过,如果直接给 div.ms-acal-item 设置背景颜色,会有一个问题。事情是这样的,SharePoint 的日历项,当你把鼠标移到上面的时候,有一个高亮效果,如果覆盖了div.ms-acal-item 的背景颜色,那么,这个高亮效果就看不到了。可是,如果只是给 div.ms-acal-item 下面的 div.ms-acal-sdiv 设置背景颜色,那么,上层的 div.ms-acal-item 会露出一点儿边,从而使得高亮效果仍然可以保持,就像下面这样(后面一张是鼠标移到上面的效果):

image --> image

(Jonyzhu 的 博客链接

好了,略微整理以后,JS 代码如下:

 1: <script type="text/javascript">
 2:     var _color_calendar_mapping = {
 3:         "Office":"#00ff00",
 4:         "Home":"#6CA6CD",
 5:         "Gim":"#FFB6C1"
 6:     };
 7:     function _color_calendar_process(){
 8:         var reg = new RegExp("\\(([^()]+)\\)$","gi");
 9:         $('div.ms-acal-item').each(function(){
 10:             var title = $(this).attr("title");
 11:             if(typeof(title) != 'undefined' && title != null){
 12:                 var calendar_location;
 13:                 var res = reg.exec(title); if(res==null){return;}else{ calendar_location = res[1]; }
 14:                 $(this).children("div.ms-acal-sdiv").css('background-color', _color_calendar_mapping[calendar_location]);
 15:             }
 16:         });
 17:         setTimeout(_color_calendar_process,500);
 18:     }
 19:     ExecuteOrDelayUntilScriptLoaded(_color_calendar_process, "SP.UI.ApplicationPages.Calendar.js");
 20: </script>

上面的代码先找出日历项的地点信息(在日历项的“地点”属性里面写好),然后和预定义的颜色对象组(_color_calendar_mapping)进行匹配。修改 _color_calendar_mapping 以适应你自己的定义的地点和颜色的匹配。关于网页配色,可以去 Google 一下,找一些自己觉得比较舒服的颜色。

找个 Content Editor Web Part 把上面代码放进去看看效果,如下所示:

image

还行 :)

 

增强

下面这些要求不是美女提的,是我自己想的。做到上面那样,美女已经可以接受了 :)

这个增强的要求主要应该怪微软。SharePoint 2010 Calendar 日历里面,除了地点以外,还有一个分类“Category”,里面可以选会议、休假、生日什么的,偏偏微软自家的 Outlook 里面,日历项是可以按照这个类型来用不同颜色呈现的。所以问题在于:为什么不是按照日历项类型来显示不同的颜色,而是地点啊!而且,地点信息在 SharePoint 2010 的日历项里面是手动输入的,这个很容易出错以及产生在颜色映射组之外的地方的。

 

于是,SharePoint 2010 的客户端对象模型就用上了。通过日历项的ID,去日历列表里面,把对应的类型“Category”字段值查出来,然后,就可以按照这个类型来设置日历项的颜色了。

代码如下:

   1: <script type="text/javascript">
 2:     /* Script for the Color Calendar 
 3:  I don't think you'll need any comment for the code :) 
 4:  Created by Jony Zhu. v1.3. 4/27/2013. http://www.cnblogs.com/jonyzhu */
 5:  
 6:     /* Begin
 7:  * You can change settings in this section */
 8:     var _color_calendar_mapping = {
 9:         "Holiday":"#00ff00",
 10:         "Business":"#6CA6CD",
 11:         "Meeting":"#FFB6C1"
 12:     };
 13:     var _color_calendar_timeout = 2000;
 14:     /* End */
 15:  
 16:     /* Do no change anything in this section, unless you know what you are doing. */
 17:     var _color_calendar_initialized = 0;
 18:     var _color_calendar_context;
 19:     var _color_calendar_list_item;
 20:     function _color_calendar_process(){
 21:         $('div.ms-acal-sdiv a').each(function(){
 22:             var href = $(this).attr('href');
 23:  
 24:             var list_title,item_id;
 25:             var reg = new RegExp("/Lists/(.*)/DispForm\.aspx","gi");
 26:             var res = reg.exec(href); if(res==null){return;}else{ list_title = res[1]; }
 27:             reg = new RegExp("ID\=(\\d+)","gi");  
 28:             res = reg.exec(href); if(res==null){return;}else{ item_id = res[1]; }
 29:  
 30:             _color_calendar_context = new SP.ClientContext.get_current();
 31:             var web = _color_calendar_context.get_web();
 32:             var list = web.get_lists().getByTitle(list_title);
 33:             this._color_calendar_list_item = list.getItemById(item_id);
 34:             _color_calendar_context.load(this._color_calendar_list_item,'ID','Category');
 35:             _color_calendar_context.executeQueryAsync(Function.createDelegate(this, _color_calendar_succeeded), Function.createDelegate(this, _color_calendar_failed));
 36:         });
 37:         if(_color_calendar_initialized==0){
 38:             setTimeout(_color_calendar_process,_color_calendar_timeout);
 39:         }
 40:     }
 41:     function _color_calendar_succeeded(sender, args){
 42:         var id = this._color_calendar_list_item.get_item('ID');
 43:         if(id!=null){
 44:             var category = this._color_calendar_list_item.get_item('Category');
 45:             $("div.ms-acal-sdiv a[href$='ID="+id+"']").each(function(){    
 46:                 $(this).parent().parent().css('background-color', _color_calendar_mapping[category]);
 47:             });
 48:             _color_calendar_initialized = 1;
 49:         }
 50:     }
 51:     function _color_calendar_failed(sender, args){
 52:         // TODO: I don't know what to do here, just do it yourself.
 53:         // alert(args);
 54:     }
 55:     ExecuteOrDelayUntilScriptLoaded(_color_calendar_process, "SP.UI.ApplicationPages.Calendar.js");
 56: </script>

效果如下(其实没有变化啦,但是,此时已经是根据日历项的类型来改变现实颜色了)。修改上面代码的 _color_calendar_mapping 数组,就可以改变日历项类型对应的背景颜色。

image

嗯,好多了,至少自己心里这么觉得 :)  IE、火狐都测了一遍以后,放心了。

 

这里还有一个小问题要说一下。Erucy 的方案里面用了 setTimeout 以便定期检查日历项的加载情况,在纯 jQuery + CSS 的时候,这个没有什么性能问题的。但是,如果像后面那样用了 SCOM 去查询日历项的类型字段,那么,就有问题了。所以,我增加了一个 _color_calendar_initialized 变量来记录是否已经完成了一次色彩设置了(等于1),如果完成,就不要再去读列表了。

下面是 _color_calendar_initialized 添加前后的CPU占用记录。前面不停振动的就是没有加 _color_calendar_initialized  前的,最后一段很低的 CPU 占用的,就是加了 _color_calendar_initialized  以后的,差距明显啊!(CPU 占用降低前有一个高峰,那是我重刷整个页面引起的)

image

 

还有一个可以改进的地方。

上面的方案都是直接给 div.ms-acal-sdiv 设置 background-color 属性,效果比较单调,如果改成 addClass 来给个样式类的话,就能实现更丰富的效果了。这个大家结合自己的工作需要去调整把。

 

最后看个好玩的:FireFox 的 3D 页面显示。

image

调休的这一天也就过去了,Adventure 系列只能后面再找时间写了。


免责声明!

本站转载的文章为个人学习借鉴使用,本站对版权不负任何法律责任。如果侵犯了您的隐私权益,请联系本站邮箱yoyou2525@163.com删除。



 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM