Google Gadgets (5) :使用 setprefs 主动改变用户设置

Widgets 专栏收录该内容
5 篇文章 0 订阅

根据 Gadget 的设计,我们可能会需要在用户不用手动改变设置的情况下,主动地改变某些用户的设置(比如在 "推箱子" 这个 Gadget 中,每过一关就自动更新 "从指定关卡开始" 这个属性)。

要使用 setprefs 功能,我们需要在 Gadget 中包含以下内容:

  • 在 <ModulePrefs> 标签中添加一个 <Require feature="setprefs"/> 标签,这使得 Gadget 读取 setprefs 库;
  • 一个需要被用来改变的用户设置(废话),如果不想让用户随意改动,那么可以使用 hidden 类型(这和 HTML 中是一样的);
  • 一个 JavaScript 函数,比如 set() ,用来改变这个用户设置。

需要注意的是,每个用户设置的长度会受到 URL 长度的限制,根据 Google 的说法,每个用户设置不能超过 2KB。

我们来看下面的例子:这个 Gadget 包含了一个计数器和两个按钮,其中一个按钮将计数器的值增加1,另一个按钮将计数器的值恢复到0。计数器的值被存储在 "counter" 这个用户设置中。为了防止 Gadget 的用户更改这个值,"counter" 的属性被设为 "hidden" 。

<? xml version="1.0" encoding="UTF-8"  ?>
  
< Module >
    
< ModulePrefs  title ="Set Userprefs Demo" >
      
< Require  feature ="setprefs"   />
    
</ ModulePrefs >
  
< UserPref  name ="counter"
    default_value
="0"
    datatype
="hidden" />
  
< Content  type ="html" >
    
<![CDATA[
      <script type="text/javascript">
        // 获得用户设置
        var prefs = new _IG_Prefs();
        
        // 将 "counter" 加 1 
        function incrementCounter() {
          var count = prefs.getInt("counter");
          alert("The count is " + count + ".");
          prefs.set("counter", count + 1);
        } 
        
        // 将 "counter" 的值恢复为 0
        function resetCounter(){
          prefs.set("counter", 0);
          alert("Count reset to " + prefs.getInt("counter") + ".");
        }
      </script>

      <input type="button" value="加1" name="count" onClick="incrementCounter();">
      <input type="button" value="恢复" name="reset" onClick="resetCounter();">

    
]]>  
  
</ Content >
  
</ Module >

PS: 如果有多于一个设置需要改变,那么建议使用 JSON 字符串来把这些属性合成一个。这里 有一个实例。
另外,在 http://www.json.org/json.js 这个JavaScript 文件中,提供了一些封装好的 JSON 方法供我们使用。

  • 0
    点赞
  • 0
    评论
  • 0
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值