例程:让HelpBalloons飘在你的GSP上空!

在进行网页开发的时候,常常需要显示提示或者帮助信息,实现方法有很多种。这里介绍一种简单易用的Gails插件--HelpBalloon。可以把这个可爱的气球放在GSP的任何地方。

要使用HelpBalloon,请先做好如下两项准备工作:

  1. 安装HelpBalloon插件,执行:grails install-plugin help-balloons ;
  2. 在需要使用HelpBalloon的GSP的中添加 ,它会将Prototype的JS库以及HelpBalloon相关的JS库引入到GSP中,如果你的Prototype的JS库不是在缺省位置,可以使用这个标签的base属性来指定JS库的位置,比如: ;

下面就开始HelpBalloon之旅了!

  • 在GSP中写入:

    
        
          
         
  • ${c.fullName}
  • 下图是上述代码的效果图:

  • 上图中显示的图标都是HelpBalloon的缺省值,如果需要使用自定义的图标,可以设置中的 标签的icon、button、balloonPrefix属性,比如:

    	
        
    

    如下是使用自定义图标的效果图:

  • HelpBalloon要显示的信息也可以由message文件进行统一管理,比如message.properties文件中:“codename.suffixname= help content!!”,就可以使用HelpBalloon的code、suffix属性来显示,如下:

    
        
    

    读者需要注意,suffix为可选内容,缺省值为“.help”,如果代码中没有设置suffix,HelpBalloon将message文件中codename.help的内容显示出来

    效果图如下:

  • 对于HelpBalloon中的内容,可以类似上述示例中的用法,也可以从对象中获取到,请看如下代码:

    	
        
    

    上述代码的意思是,可以通过book的moreInfo()方法将更多的book信息显示在HelpBalloon中,如下是book的代码:

    	class Book {
    	  String name
    	  String descript
    	  String author="Magnolia"
    	  Date dateCreated=new Date()
    	  int pages=100
    	  String isbn="ISBN 2010-03-06"
    	  String shortname
    
    	  String moreInfo(){
    		"""$name 

    by $author /pg: $pages /ISBN: $isbn
    published in $dateCreated
    """ } }

    下图是如上代码的效果图:

文章中的源代码可以从这里下载。

你可能感兴趣的:(例程:让HelpBalloons飘在你的GSP上空!)