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

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

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

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

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

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

 1<?xml version="1.0" encoding="UTF-8" ?>
 2  <Module>
 3    <ModulePrefs title="Set Userprefs Demo">
 4      <Require feature="setprefs" />
 5    </ModulePrefs>
 6  <UserPref name="counter"
 7    default_value="0"
 8    datatype="hidden"/>
 9  <Content type="html">
10    <![CDATA[
11      <script type="text/javascript">
12        // 获得用户设置
13        var prefs = new _IG_Prefs();
14        
15        // 将 "counter" 加 1 
16        function incrementCounter() {
17          var count = prefs.getInt("counter");
18          alert("The count is " + count + ".");
19          prefs.set("counter", count + 1);
20        } 
21        
22        // 将 "counter" 的值恢复为 0
23        function resetCounter(){
24          prefs.set("counter", 0);
25          alert("Count reset to " + prefs.getInt("counter") + ".");
26        }
27      </script>
28
29      <input type="button" value="加1" name="count" onClick="incrementCounter()；">
30      <input type="button" value="恢复" name="reset" onClick="resetCounter()；">
31
32    ]]> 
33  </Content>
34  </Module>

PS: 如果有多于一个设置需要改变，那么建议使用 JSON 字符串来把这些属性合成一个。下面 (源文件在 这里 ) 是一个实例：

>

另外，在 http://www.json.org/json.js 这个JavaScript 文件中，提供了一些封装好的 JSON 方法供我们使用。