Sharepoint学习笔记—Ribbon系列-- 9.如何让用户定义的Ribbon引用外部Javascript文件

  在使用Sharepoint2010的Ribboon编程的领域内,我们必然要遇到如何编写Ribbon内控件的Javascript代码。
  下面是Ribbon定义的一段常见代码:

  < CommandUIHandlers >
    < CommandUIHandler  Command =”Ribbon.MyTab.MyGroup.Button_CMD”  CommandAction =”javascript:alert('RibbonJs  Invoke!');'  />
   </ CommandUIHandlers >

  这段代码中的CommandAction中定义了此Ribbon控件将要执行的Javascript功能。问题是,在实际应用中,我们的Javascript远不只一个alert函数这么简单,而我们又不可能在这个Ribbon的定义中嵌入非常复杂的大量Javascript代码,我们需要做的应该像下面的代码定义段一样:

  < CommandUIHandlers >
    < CommandUIHandler  Command =”Ribbon.MyTab.MyGroup.Button_CMD”  CommandAction =”javascript:RibbonButtonHandler();”  />
   </ CommandUIHandlers >

  在CommandAction中潜入一个Javascript的Function,这个Funcation是在一个外部Javascript文件中定义的。所以接下来的问题是,如何让Ribbon的定义段知道它该使用哪一个外部Javascript文件引用?
  好在Sharepoint中提供了这样一个途径,我们只需要加入下面的代码就能解决这个问题。

< CustomAction  Id =”Ribbon.Library.Actions.Scripts”
  
Location  ="ScriptLink"   ScriptSrc ="/_layouts/SharePointProject1/RibbonActions.js"   />

此代码的ScriptSrc指明了外部需要引用的Javascript文件位置以及文件名,当然我们需要在/_layouts/SharepointProjects1/目录下创建这个名为RibbonActions.js的javascript代码文件。
  所以相对完整的代码应该如下 : 

< CommandUIHandlers >
    < CommandUIHandler  Command =”Ribbon.MyTab.MyGroup.Button_CMD”  CommandAction =”javascript:RibbonButtonHandler();”  />
   </ CommandUIHandlers >
< Elements  xmlns =”http://schemas.microsoft.com/sharepoint/” >
   < CustomAction
    
Id =”Ribbon.MyTab”
    
Title =”Ribbon  Sample”
    RegistrationType
=”List”
    
RegistrationId =”100″
    
Location =”CommandUI.Ribbon.ListView” >
  < CommandUIExtension >
   < CommandUIDefinitions ></ CommandUIDefinitions >
   < CommandUIHandlers >
    < CommandUIHandler  Command =”Ribbon.MyTab.MyGroup.Button_CMD”  CommandAction =”javascript:RibbonButtonHandler();”  />
   </ CommandUIHandlers >
  </ CommandUIExtension >
  </ CustomAction >
 
< CustomAction  Id =”Ribbon.Library.Actions.Scripts”
  
Location  =”ScriptLink”
  
ScriptSrc =”/_layouts/SharePointProject1/RibbonActions.js”  />
  </ Elements >

 

你可能感兴趣的:(JavaScript)