原文链接：http://dojotoolkit.org/book/dojo-1-2-release-notes

向后兼容

Dojo1.2中添加了一些新特性，也修改和废弃了一些原有特性。不过，最重要的是，Dojo1.2的主体仍然保持与Dojo1.0和Dojo1.2向后兼容。对此，“迁移问题”中会详细介绍。

Core及相关的库

键盘事件

为防止将可打印字符键错误地识别为功能键（例如，在IE中，左括号与向下箭头键的keyCode相同），新增了charOrCode属性，不推荐使用keyChar。

浏览器检测

消除了dojo.isIE、dojo.isFF、dojo.isSafari等属性“错误的”返回值。在用户代理不是指定浏览器的情况下，这些属性现在的返回值是undefined而不再是0，但在条件正确的情况仍然会返回版本号。

dojo.cldr

dojo.cldr已经从CLDR1.5.1更新为1.6。由于地区表已经更新，因此格式化字符串或使用dojo.date.locale、dojo.number、dojo.currency等包解析的用户字符串有可能与以前版本不一样。

djConfig.addOnLoad

通过dojo.addOnLoad添加了一个新回调函数。

在djConfig.isDebug=true的情况下，try/catch行为将发生变化

以前，当Core中某些模块（XHR、Deferred、dojo.addOnLoad回调代码）发生的错误被捕获后，要么通过控制台进行报告，要么另行抛出，导致难以追踪错误的起因。虽然这样有利于代码稳定，但从开发角度看，却不利于发现错误。现在，相关模块会让最初的异常向上冒泡，并在djConfig.isDebug设置为true的情况下停止JavaScript的执行。如果diConfig.isDebug被设置为false（或undefined），则使用try/catch结构并通过控制台记录错误。

dojo.fx.easing

以前的dojo.fx.easing已经被提升到Core中，并可以通过dojo.require(“dojo.fx.easing”)加载。

dojo.html.set()

新增特性，用于在ContentPane外部使用类似ContentPane的功能。

Dijit方面的增强

易用性及观感的增强

在Dojo1.2中，Dijit的外观和易用性获得了较大增强。

_Widget.attributeMap

现在，attributeMap也可以处理innerHTML和类名了。可以把attributeMap的作用想象成绑定部件属性与DOM节点。

_Widget.placeAt

placeAt()是一个新的domNode操作方法，用于简化对部件的domNode的连缀和放置操作（或通过addChild()将部件的domNode添加到其他部件中）。

动画

加快了部件中默认的动画执行时间。现在，可以通过dojo.config.defaultDuration控制动画了。

BorderContainer

修正了窗格布局中缺失边框或出现双边框的问题。通过新的参数gutters=true/false（默认为true）可以为所有窗格添加“外边距”（包括不可调整大小的窗格），从而使窗格与窗格、窗格与BorderContainer之间保持一定距离。

Button

修正了垂直对齐及各种显示问题。

CheckBox

突出显示搜索结果。

FilteringSelect

不必为了让用户能清除下拉列表中的值而放入空值了，用户现在可以使用退格或删除键清除该值。

突出显示搜索结果。

表单验证

增强后的表单部件不会再因为用户输入的值不完整而变黄了。但是，如果用户输入的值无效（哪怕再继续输入更多字符也仍然无效），仍然会变黄……这样用户就不会再感到它们“慌报军情”了。

另外，还为dijit.form.Form部件新增了onValidStateChange连接点，以便能够创建像禁用提交按钮（在表单无效时）之类的行为。

Menu

新增了CheckableMenuItem类。使用这个类，用户在选择菜单项时会伴随一个对勾图标出现或消息（有点类似切换按钮）。

RadioButton

在FF和Safari中实现了类似IE中的获取焦点的效果（标签四周会出现带阴影的线框）。

Tree

解决了水平滚动的问题，而且为每一行都设置了white-space:nowrap，确保标签不会折行显示。

同时还修正了图标与文本垂直的对齐问题。

TimeTextBox

自动滚动

键盘支持

更佳的外观

Tooltip

缩小了箭头图标

Util

util/buildscripts

通过一个新的构建选项可以去掉构建过程中所有JavaScript文件内包含的console.*调用。

stripConsole=normal将去掉除console.warn和console.error之外的所有console.*调用

stripConsole=all将去掉所有console.*调用

警告：如果在使用这个选项时导致了OutOfMemoryError，请参考http://trac.dojotoolkit.org/ticket/7698。

DOH：单元测试框架

新增了一个doh.robot包，以方便为DnD和部件等视觉组件编写单元测试。

在dijit/tests/form/robot中也可以找到一些类似的测试。

迁移问题

在从Dojo1.1迁移到Dojo1.2时，需要对已有应用程序作如下更新：

下载文件或执行JavaScript的链接（dojo.addOnUnload()与dojo.addOnWindowUnload()）

通过dojo.addOnUnload()注册的回调函数以前不能在IE中被触发。现在这个问题虽然已经修正，但是也出现了一个问题。用户在单击下载文件或执行JavaScript代码（即href属性值为javascript:开头）的链接时，会触发window.onbeforeunload事件，而该事件又会触发dojo.addOnUnload回调函数。但是，上述链接通常不会影响页面。因此，如果要在dojo.addOnUnload()中执行破坏性操作，请务必格外小心。

如果需要清理循环引用以避免内存泄漏（除了有用的Dojo代码外），那么可以使用Dojo1.2中新增的dojo.addOnWindowUnload方法，该方法基于window.onunload触发回调函数。dojo.addOnWindowUnload与dojo.addOnUnload的原理相同，但只基于window.onunload事件发生（即页面真正缷载）而触发。在dojo.addOnWindowUnload()回调函数中操作DOM和JavaScript属性时要小心，因为页面的状态不一定可靠。

Editor

出于安全原因，不推荐使用TEXTAREA；而使用DIV。

Widget.arrt()

Widget.arrt()是用于设置/取得所有部件属性的标准接口。旧方法setValue()、setAttribute()和setTitle()仍然存在，但已经不推荐使用。基本上，Widget.attr()与dojo.attr()相似，详细内容请参考http://blog.dojotoolkit.org/2008/08/19/widget-attr。

dijit._Widget.destroy()

对_Widget的.destroy()方法从技术上作了修改。以前，这个方法有一个“已定案的（finalize）”什么也不做的参数。但现在，这个参数被改为了“保护DOM（preserveDom）”，是一个布尔值，表示destory()是否删除与_Widget(this.domNode)关联的domNode。传入“true”，则保留DOM。

dojo.isGears转移到dojo.gears.available

检测Gears的特性转移到了dojo.gears模块中。要检测Gears是否已经安装，首先执行dojo.require(“dojo.gears”)，然后根据dojo.gears.available返回的布尔值确定。

在调用dojo.xhr时，不再推荐使用handleAs: “json-comment-filtered”

如果再使用handleAs: “json-comment-filtered”，会在控制台中看到一条警告消息。

要取消该警告，可以将djConfig.useCommentedJson设置为true。

同时，这也意味着删除了djConfig.usePlainJson标签，因为普通的JSON是优先考虑的，目前使用普通的JSON不会产生警告。

dijit.layout.BorderContainer在所有窗格四周添加了外边距

新参数“gutters”的默认值为true，因此会在所有窗格周围添加“外边距”（即使是大小不可调整的窗格），从而使窗格与窗格、窗格与BorderContainer之间保持一定距离。