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>

 

posted @ 2012-07-12 06:27  wsdj  阅读(2026)  评论(3编辑  收藏  举报