中国天气小工具风格制作指南

1、【注意，有些参数已失效或改变，但还没有在这里写上去，等有空了写】首先小工具版本必须是以上，低于这个版本是不支持这个功能的。“中国天气 ”下载请移步： Win7小工具 “中国天气 ”其次，先来普及一下基础知识：JSON ：教条式的定义就不说了，这里只告诉大家如何最简单的写出符合规则的JSON 数据（小工具的风格定义以JSON 为基础）。“ 表”示一个数组，里面的内容以逗号分隔，比如“ "aa","bb","cc"就是一”个标准的数组。“ 表”示一个对象，里面的内容以键值对的形式出现，例如下面一段：view sourceprint?12n

2、ame: "zjfeiye",3age: 29,4email: "zjfeiye",5website: ""6可以看出，实际上每个键值对的键和值由冒号分隔，而键值对则由逗号分隔，请注意，最后一行，不需要以逗号结尾，同时要注意不要把标点写成中文标点两者是可以相互嵌套的，例如下面这段：view sourceprint?12a: "a",3b: "1","2","3",4c: 5d: "d"6789a:"a",b:&quo

3、t;b",c:"c"基础到此为止。下面开始制作：1/13首先找到风格文件夹，一般位于：Windows SidebarGadgetsXCN Weather.Gadgetstyles要制作风格，首先要有一套图标，按照命名规则命名好每一个图标，要注意图标最好是一样尺寸的，每个图标代表的含义见此：天气图例同时如果你希望有背景，那么还需要制作一张背景图片。第一步：给自己的风格起一个独一无二的代号，尽量不要跟别人重名，例如：“myStyle ”，在 “ styles 下建”立一个以代号为文件名的JS 文件，这里是：“ ，注”意必须以 “.style.js结”尾，这是一个约定。

4、第二步：在 “styles 下”建立一个文件夹，例如：“myStyle ”，将你准备好的图标放进去。第三步：使用记事本或其他纯文本编辑工具编辑“”，首先架构起一个大概的轮廓：view sourceprint?01/addStyle表示添加一个风格02addStyle(03name: "myStyle", /表示风格代号 , 必须跟文件名相同表示风格版本号05displayName: "默认风格 ", /风格显示名称，显示在配置面板中06author: "阿干 ", /风格作者07email: "zjfeiye",

5、/作者邮件（可不写，整行去掉）08website: "", /作者主页（可不写，整行去掉）folder: "default", /风格使用的图片的存放目录，就是第二步所建立的09 文件夹名10bg: "bg", /所使用的背景图片的文件名，必须为PNG格式，不用带扩展名11width: 270, /整个小工具尺寸的宽度，一般就是背景图的高宽12height: 220, /整个小工具尺寸的高度13items: /用来定义所要显示的元素14) 。这样，一个最基本的结构就定义好了，这时候，如果重启小工具你就已经能在配置面板中看到这个风格了，

6、当然，如果你现在选中他的话，不会显示任何东西，因为刚才的最后一条“需要显示的元素”还没有定义。下面我们尝试定义2 个元素，也是2 种不同类型的元素，图片和文本：2/13view sourceprint?001/addStyle表示添加一个风格/ “/ ”表示它后面的代码不起作用，即注释，你如果希望那个定义不要002气作用，在他前面加上“ / ”或者删除该行即可，但是一定要注意检查逗号，不要少了或者多了！003addStyle(004name: "myStyle", /表示风格代号 , 必须跟文件名相同005version: "",/表示风格

7、版本号006displayName: " 默认风格 ", /风格显示名称，显示在配置面板中007author: " 阿干 ", /风格作者008email: "zjfeiye", /作者邮件（可不写，整行去掉）009website: "", /作者主页（可不写，整行去掉）folder: "default", /风格使用的图片的存放目录，就是第二步所建立的010文件夹名bg: "bg", /所使用的背景图片的文件名，必须为 PNG格式，不用带扩展011名012width: 27

8、0, /整个小工具尺寸的宽度013height: 220, /整个小工具尺寸的高度014items: 015 / 一对 之间是一个元素，多个元素用逗号分隔，这个元素以地名为例016type: "text", /表示这个元素是文本017options: /options表示元素属性，是一个嵌套的对象018font: " 微软雅黑 ", /表示所使用的字体019fontsize: 36, /表示字体大小020color: "White", /表示文字颜色021colorN: "Black", /表示夜晚字体颜色，以上

9、4 条为文本类型独有属性022023left: 265, /距离小工具左侧距离，即坐标X024top: 20, /距离小工具顶部距离，即坐标Y025align: "right", /对齐方式，“ left ”，“ right ”, “center ”，026/为“ left ”时：上面 left 的定义为从小工具最左侧到文本最左侧027/为“ right”时： left的定义从小工具最左侧到文本最右侧028/为“ center ”时： left的定义从小工具最左侧到文本中心029/blur: 0, /模糊值 0-100030/brightness: 0,/亮度，这个参数我自

10、己也整不大明白：（031/opacity: 100,/不透明度 0-100032/rotation: 0,/角度033shadow: /定义阴影效果034color: "Black", /阴影颜色035colorN: "White", /表示夜晚阴影颜色036radius: 3, /阴影大小3/13037alpha: 25, /阴影不透明度038deltaX: 3, /阴影 X偏移039deltaY: 3/阴影 Y偏移040,041glow: / 定义光晕效果042color: "Black", /光晕颜色043colorN: &qu

11、ot;White", /表示夜晚光晕颜色044radius: 3, /光晕大小045alpha: 10/光晕不透明度046, /以上各项从 align （包括）起到最后，每一个定义都可以删除，包括047嵌套的对象，例如下一个元素就是个最简定义formater: function(wInfo) /定义格式器，你可以理解为，该元素所要048显示的数据从这里取得returnwInfo.location。 /返回地名这里可做自定义操作，例如：return049wInfo.location+",中国 " 。能取得哪些数据参见天气数据结构050,tip: function(w

12、Info) /提示信息，支持两种定义方式，另一种是直接051指定文本，例如： tip: "今日天气 "052returnwInfo.location。053,link: true/外链，支持 3 种定义方式， true/false:使用默认的外链，即054中国天气主页；字符串，例如:link:""。回调函数，类似tip ，可以自己根据变量拼接外联路径055/ 一个元素定义结束056, /今日天气，这是一个最简化的定义057type: "text",058options: 059font: "微软雅黑 ",060fo

13、ntsize: 14,061color: "White",062063left: 245,064top: 74065,066formater: function(wInfo) 。068069, /今日图标，这是一个图片类型的元素070type: "image", /这一行制定这个元素是一个图片类型071options: 4/13072/width: ,/图片宽度073/height: ,/图片高度，这两条是图片类型的元素的独有定义，以下各条请参见文本类型074075left: -10,076top: 0077/align: "right&quo

14、t;,078/blur: 0,079/brightness: 0,080/opacity: 100,081/rotation: 0,082/shadow: 083/ color: "Black",084/ colorN: "White", /表示夜晚阴影颜色085/ radius: 3,086/ alpha: 75,087/ deltaX: 3,088/ deltaY: 3089/,090/glow: 091/ color: "Black",092/ colorN: "White", /表示夜晚光晕颜色093/ r

15、adius: 3,094/ alpha: 25095/096,097formater: function(wInfo) 。099100101102) 。下面我们来看看天气数据的数据结构：view sourceprint?0102"provider": "中国天气 ", /提供商，用 wIvider获取"fchh": "Sun Jan 17 18:00:00 UTC+0800 2010", /发布时间，用03 wInfo.fchh 获取，一般情况下用不上此数据，如果要用的话建议使用 new Date(w

16、Info.fchh) ，获取一个时间对象，相应的 newDate(wInfo.fchh).getHours()就能获取到小时数。5/1304"location": "宁波 ", /当前城市，用 wInfo.location获取05"code": "101210401", /当前城市代码，用 wInfo.code获取06"postcode": "315000", /邮政编码，用 wInfo.postcode获取07"sunup": "06:50&q

17、uot;, /日出时间，用 wInfo.sunup获取08"sunset": "17:15", /日落时间，用 wInfo.sunset获取09"today": /今日天气10"tempH": "", /白天温度，用 wInfo.today.tempH获取11"tempL": 2, /夜间温度，用 wInfo.today.tempL获取12"tempR": "2 ", /温度范围，用 wInfo.today.tempR 获取13&quo

18、t;imgD": "", /白天图标，用 wInfo.today.imgD 获取14"imgN": "n00", /夜间图标，用 wInfo.today.imgN获取15"weatherD": "", /白天天气，用 wInfo.today.imgDT 获取16"weatherN": "晴", /夜间天气，用 wInfo.today.imgNT获取17"weather": "晴转多云 ", / 天气情况，用

19、 wInfo.today.weather获取18"weatherImg": "n0", /天气图标，用 wInfo.today.weatherImg获取19"flD": "", /白天风力，用 wInfo.today.flD获取20"flN": " 微风 ", /夜间风力，用 wInfo.today.flN获取21"fxD": "", /白天风向，用 wInfo.today.fxD获取22"fxN": "无

20、持续风向 ", / 夜间风向，用 wInfo.today.fxN获取23"week": " 星期四 ", /星期，用 wInfo.today.week获取24"fl": "微风 ", /今日风力，用 wInfo.today.fl获取25"fx": "无持续风向 "/今日风向，用 wInfo.today.fx获取26,"next1": /明天天气，获取同上只需要将today 改成 next1即可，例27 如：5",31"imgD

21、": "01",32"imgN": "n02",33"weatherD": "多云 ",34"weatherN": "阴 ",35"weather": "多云转阴 ",36"weatherImg": "1",37"flD": "微风 ",38"flN": "微风 ",39"fxD

22、": "无持续风向 ",40"fxN": "无持续风向 ",41"week": "星期五 ",42"fl": "微风 ",6/1343"fx": "无持续风向 "44,"next2": /后天天天气，获取同上只需要将today 改成 next2 即可，例45 如： wInfo.next2.tempH46"tempH": 10,47"tempL":

23、3,48"tempR": "103",49"imgD": "01",50"imgN": "n01",51"weatherD": "多云 ",52"weatherN": "多云 ",53"weather": "多云 ",54"weatherImg": "1",55"flD": "微风 &qu

24、ot;,56"flN": "微风 ",57"fxD": "无持续风向 ",58"fxN": "无持续风向 ",59"week": " 星期六 ",60"fl": "微风 ",61"fx": "无持续风向 "62,63 "next3": /大后天天天气，获取同上只需要将today 改成 next3 即可，例如： wInfo.next3.te

25、mpH64"tempH": 13,65"tempL": 5,66"tempR": "135",67"imgD": "01",68"imgN": "n01",69"weatherD": "多云 ",70"weatherN": "多云 ",71"weather": "多云 ",72"weatherImg"

26、;: "1",73"flD": "微风 ",74"flN": "微风 ",75"fxD": "无持续风向 ",76"fxN": "无持续风向 ",77"week": "星期日 ",78"fl": "微风 ",79"fx": "无持续风向 "80,"next4":,"ne

27、xt5":81"now": /实时天气，获取同上只需要将today 改成 now即可，例如：7/1382"time":"16:10", /发布时间83"temp":14, /当前温度84"wd":" 东南风 ",/风向85"ws":" 小于 3 级",/风力86"wse":"<3",/风力另一种表达方式87"sd":"54%",/湿度88&q

28、uot;ap":"1025.1hPa"/气压8990基本上就差不多了，剩下的就是不断的调试了，祝大家做出自己满意的风格来，同时也可以把你的独一无二的风格打包出来供大家使用：）8/13=图片命名规则=1. 必须为 png 格式2. 必须按照天气图列对照表进行命名天气图列对照表：9/1310/13=如何重用图标=有时候我们并不需要为白天黑夜单独定义图标，也就是说不管白天还是黑夜，天气图标是完全可以通用的，可以用一个图标解决，这样可以显著减小风格包的体积。例如 “默认风格 ”就是采用了这种方式，如果你打开“C:UsersYourNameAppDataLocalMicro

29、softWindows SidebarGadgetsXCN Weather.Gadgetstylesdefault ”你就会发现只有少量的图标有黑夜状态的图标那么这是怎么实现的呢，我们打开该目录下的“，”找到第75 行，我们发现这么一段：view sourceprint?01formater: function(wInfo) 。03/c = "n00"。04varexcept = "n00,n01,n03,n04,n05,n13,n18,n29,n30,n31".split(",")。05if(!except.contains(c) 06c = c.repl