在WSSv3中通过Javascript和创建Feature扩展站点的动作菜单

一、示例应用
1.1、定义Site Actionss
      在SharePoint中通过创建一个带CustomAction元素的功能（Feature）添加一个自定义菜单项到默认的站点动作（Site Actions）菜单中。

　　Feature.xml

<Feature 
  Id="AA929AFF-4602-4d7f-A501-B80AC9A4BB52" 
  Title="A Sample Feature: Item Auditing"
  Description="A sample feature with an ECB menu item"
  Scope="Site" 
  xmlns="http://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="elements.xml" />
  </ElementManifests>
</Feature>

 　　Elements.xml　　

<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <CustomAction 
    Id="ApplicationPage1"
    GroupId="SiteActions"
    Location="Microsoft.SharePoint.StandardMenu"
    Sequence="2000"
    Title="Hello World Application Page"
    Description="Getting up and going with inline code"
    RequireSiteAdministrator="True" >
     <UrlAction Url="~site/_layouts/Litware/ApplicationPage1.aspx"/>
  </CustomAction>
</Elements>

      当添加了RequireSiteAdministrator属性后，如果用户不具有管理权限时SharePoint就不会显示该菜单项了。对于一个在网站集范围内的CustomAction元素，该菜单项就会仅在当前用户是网站集所有者或管理员时才会出现。对于一个在网站范围内的Feature指向的CustomAction元素，这个菜单项只能在具有当前网站管理权限的用户页面中出现。 

 1.2、其他位置的菜单

二、Elements中元素说明
Location、GroupID

三、Javascript定制列表文档库菜单
3.1、定义列表库下拉菜单
Custom_AddListMenuItems方法：

<script language='javascript'>
function Custom_AddListMenuItems(m, ctx){ 
　　var menuOption; 
　　strDisplayText="Show Hoho"; 
　　strAction="javascript:alert('hoho')"; 
　　strImagePath=ctx.imagesPath+"exptitem.gif"; 
　　menuOption=CAMOpt(m, strDisplayText, strAction, strImagePath, null, 550); 
　　menuOption.id="ID_Custom"; 
　　return true;
}
<script>

3.2、 自定义文档库下拉菜单
Custom_AddDocLibMenuItems方法：

<script type="text/javascript">
function Custom_AddDocLibMenuItems(m, ctx)
{
    strDisplayText = "我的菜单";
    var rootMenu = CASubM(m,strDisplayText,"","",500);

    strDisplayText = "我的菜单还是我的菜单";
    strAction = "STSNavigate('http://www.cnblogs.com')";
    strImagePath=ctx.imagesPath+"oisweb.gif";
    menuOption = CAMOpt(rootMenu,strDisplayText,strAction,strImagePath);
    menuOption.id = "ID_MySubMenu";
    return false;
}

function Custom_AddDocLibMenuItems(m, ctx)
{
    strDisplayText = "我的菜单";
    rootMenuImagePath=ctx.imagesPath+"REPLY.GIF";
    var rootMenu = CASubM(m,strDisplayText,rootMenuImagePath,"",500);
    strDisplayText = "嵌套菜单";
    strAction = "STSNavigate('javascript:windows.alert('windpole!')')";
    strImagePath=ctx.imagesPath+"DOC32.GIF";
    menuOption = CAMOpt(rootMenu,strDisplayText,strAction,strImagePath);
    menuOption.id="ID_TheSubMenu";
    strDisplayText = "我的菜单还是我的菜单";
    strAction = "STSNavigate('http://windpole:7777?ItemIndex="+currentItemID+"&ListGuid="+ctx.listName+"&HttpRootUrl="+ctx.HttpRoot+"')";
    strImagePath=ctx.imagesPath+"Repair.ico";
    menuOption = CAMOpt(m,strDisplayText,strAction,strImagePath);
    menuOption.id = "ID_MyMenu";
    return false;
}

function Custom_AddDocLibMenuItems(m, ctx) {
    var otype = currentItemFSObjType = GetAttributeFromItemTable(itemTable, "OType", "FSObjType");
    if (otype != 1) {
        var itemId = GetAttributeFromItemTable(itemTable, "ItemId", "Id");
        var listId = ctx.listName;

        var action = 'Go_To_Page("' + ctx.HttpRoot + '/_layouts/custom/PAGES/mycustompage.aspx?ListId=' + listId + '&ListItemID=' + itemId + 

');';
        CAMOpt(m, 'Custom Menu Item', action, '/_layouts/custom/IMAGES/action.gif', '', 110);
        CAMSep(m);
    }
    return false;
}

function Go_To_Page(page) {
    window.location = page;
}
</script>

 3.3、js介绍

这个方法会去掉下面webpart的默认菜单项, 并且添加一个Show Hoho菜单项, 点击后alert
CAMOpt是内置的创建菜单项的方法
第二个参数指定名称, 第三个指定一个action(javascript函数), 第三个指定image(没有写"")
第四个指定image的alt属性(我猜), 第五个是菜单项的顺序编号(我继续猜)
如果Custom_AddListMenuItems返回true, 那么不会创建默认的那些菜单项
如果返回false或者不些return语句, 默认的那些菜单项还在

这样我们就可以几乎完全自己定制这个菜单了
有几个地方目前我没想好怎么解决:
1. 这个只适用于普通列表和文档库
    如果是文档或者列表条目的版本的话, 好像没有接口
    如果列表是Meeting(template=200), 好像也没有接口
2. 通过feature加的菜单项没有提供接口把它去掉
3. 如果页面中有多个webpart, 会比较麻烦(其实也能区分出来,见后文)

创建菜单项还有很多乱七八糟的东西
有几个内置的js文件可以参考一下, 它们都在layouts/2052下
ows.js: 创建菜单项主要是在这里完成的, 在4400行左右的那一大片函数
menu.js: 实际创建出菜单项是在这里, 比如上面那个CAMOpt方法
init.js: 这里面包含context的定义(1308行), 这个context就是Custom_AddListMenuItems参数的那个ctx, 里面有很多可以用到的属性, 比如列表, 视图等(但是是GUID而不是名称), 可以根据这两个东西把页面上的多个webpart区分出来, 另外还包含当前用户的id,查看编辑页面的Url等等

如果需要在创建过程中判断权限, 可以使用HasRights方法
参数是权限的高4字节和低4字节(这个数字我没有核实, 但是我猜和SPBasePermission枚举里的数字是一致的)
权限这个数字是long(8字节)类型的, full permission mask是0x7fffffffffffffff
需要注意的是, 当前用户在这个列表条目上的permission mask是直接写在页面的html里的, 在菜单容器那个table的Perm属性
这个table还包括了很多很多属性, 比如用的是哪一个context, 它的内容类型, 列表条目的id, 它的url, 还有一些我不知道是什么东西的东西
 

四、通过SharePoint Designer定制

 SharePoint 2010