在继续 API 重构的过程中，我们计划对 Dialog 小部件进行一些更改。我们知道，像这样的 API 更改对我们的用户并非没有成本，因此我们想明确表示，除非另有说明，jQuery UI Dialog 在 1.9 中将同时支持 1.8 API，并且已弃用的 API 不会在 jQuery UI 2.0 之前移除。了解更多关于完整的 jQuery UI API 重构。

API 重构

在对话框中包含焦点
我们目前只在模态对话框中包含焦点。我们将更改此行为，始终包含焦点，即使在非模态对话框中也是如此。这将使我们更符合 DHTML 样式指南。我们不确定是否要实现一个用于将焦点移出对话框的按键命令（例如 F6），因为这将需要定义一个用于跟踪焦点应移到何处的系统。

允许禁用对话框
对话框目前不支持禁用。它们确实继承了添加 ui-state-disabled 类的默认行为，这使得对话框看起来被禁用了，但用户仍然可以与对话框中的元素进行交互。为了支持禁用对话框，我们将在对话框上放置一个 div 以防止鼠标交互。

能够配置哪个元素获得焦点
打开对话框时，我们会搜索可获取焦点的元素，并聚焦找到的第一个元素。如果没有可获取焦点的元素，那么我们会聚焦对话框本身。我们将添加一个 autoFocus 选项，它将允许自定义哪个元素获得焦点。该选项将接受一个函数，该函数将返回要聚焦的元素。该选项的默认值为当前实现。如果使用该选项没有找到任何元素，则将聚焦对话框。

在销毁时将对话框移回原始 DOM 位置
创建对话框时，它们会被移动到 body 的末尾。销毁对话框时，它们目前会停留在 body 的末尾。我们将更改此行为，以便将对话框（如果可能）返回到原始位置。这将通过在创建时跟踪一个兄弟元素或父元素来实现。

自动堆叠
stack 选项控制对话框在获得焦点时是否会移动到其他对话框之上。由于这应该是始终如此，我们将删除该选项并强制执行此行为。此外，我们可能会删除 moveToTop 方法，因为根据对话框打开的时间以及它们是模态还是非模态，适当的对话框应该始终对用户可用。

更合理的模态
当前用于管理模态对话框的实现有点笨拙，它比较元素的 z-index，并且经常会导致问题。我们计划简化实现并切换到基于层次结构的解决方案，而不是基于样式的解决方案。

反馈

我们很乐意听到您对这些更改的反馈意见。我们希望确保在最终确定和实施这些更改之前解决社区可能遇到的任何问题。如果您有任何反馈意见，请在 相关论坛帖子 上发布。谢谢。

ARIA 黑客马拉松的最初想法是让 jQuery UI 的开发者和 ARIA 专家在一个房间里聚在一起，让他们互相认识，分享知识并致力于 jQuery UI 的无障碍性。

在多伦多 OCAD 大学的包容性设计研究中心 (IDRC) 会面，jQuery UI 团队的几位成员（Richard、Scott、Dan、Jörn），OCAD 的多位开发者（Michelle、Justin、Antranig、Harris），以及来自多伦多（Ates、George、Darcy）和更远的地方（来自波士顿的 Mat，来自华盛顿大学的 Candace 和 William，以及来自伊利诺伊大学的 Jerry）了解了大量关于为屏幕阅读器用户进行测试和开发的信息，了解了 ARIA 标准及其流程，以及 Mozilla 在无障碍性方面的工作。

• Colin Clark 对 IDRC 团队的工作进行了概述，包括利用 jQuery UI 的 Fluid 项目。
• Hans Hillen 提供了许多关于使用 JAWS 和 NVDA 进行测试和开发以及 ARIA 规范和 DHTML 样式指南的非常实用的见解。
• Jospeh Scheuhammer 积极参与 ARIA 标准流程，他提供了关于该流程如何运作、如何提供反馈以及哪些文档可以和应该与主要规范一起使用等的见解。
• David Bolter 对 Mozilla 在 Firefox 无障碍性方面的努力进行了概述，还涵盖了 Firefox Mobile 的现状和未来。
• 最后，Jennison Asuncion 演示了在普通网站上使用 JAWS，让观众（更确切地说，是听众）更好地了解盲人用户如何实际使用屏幕阅读器。他也是一个非常友善的人。

在小组讨论中，我们定义了最新版本的 NVDA 在最新版本的 Firefox 上作为支持 ARIA 和无障碍性的设置，同时还在 Windows 上的 JAWS 和 OSX 上的 VoiceOver 上进行了测试。如果代码可维护并且不会破坏符合规范的 AT 中的 ARIA，我们将接受对其他或旧版 AT 的合理补丁。

在为期两天的主要活动结束后，Hans 和 Jörn 停留到星期五，致力于多个 jQuery UI 小部件的键盘和无障碍性实现。Jörn 还与 OCAD 的 Justin 和 Michelle 以及 Mozilla 的 Bobby 和 David 会面，以招募他们加入 jQuery UI 和测试子团队（QUnit、TestSwarm）。他们之间有许多共同的兴趣，这应该会导致今后更多合作。

特别感谢 IDRC 和 Colin Clark 主办此次活动，以及 Mozilla 和 David Bolter 为部分差旅和住宿费用提供资金。

如需查看大部分完整的与会者名单（以及指向 Twitter 和 GitHub 个人资料的链接）以及活动期间收集的各种资源，请访问 我们计划 wiki 上的活动页面。

早在 11 月，我们就宣布了 众多 API 重构中的第一个。在那篇文章中，我们简要地说明了我们的总体目标

jQuery UI 正在进行 API 重构，这将缩减 API 的大小，以提供更稳定的代码库，使其更易于学习和使用。我们将在接下来的几周内发布提议的更改，以便收集社区的反馈意见。我们的目标是在 1.9 中同时支持旧版（当前）和新版（提议）API，然后在 2.0 中删除对旧版 API 的支持。

现在三个月过去了，两件事很清楚：1）发布所有提议的更改需要不止几周时间；2）我们没有提供足够的信息来介绍计划的更改以及背后的原因。

过去

jQuery UI 刚创建时，它是新插件和现有插件的组合。引入现有的、流行的插件对每个人都有益：jQuery UI 发布时间更早，拥有更多插件，原始作者的辛勤工作得到了 jQuery 项目的公开认可和支持，并且现有用户群获得了对他们正在使用的代码的官方支持。不幸的是，这种方法有一个缺点。由于现有插件是由不同的作者使用不同的设计原则和不同的编码风格编写的，因此 jQuery UI 内部缺乏一致性。在 1.0 到 1.8 版本之间，曾尝试标准化 API 的各个部分，但从未有过足够大的协调工作来进行必要的更改。

除了插件之间的不一致性之外，在过去三年半的时间里，还出现了其他问题。随着用户要求越来越多的功能，选项、方法和事件的数量持续增长。随着时间的推移，这导致了我们今天所看到的现状，即使像拖放元素这样简单的东西也有近 30 个选项。一方面，能够处理如此多的用例令人印象深刻，通常只需使用其中的一两个选项即可。另一方面，对于新用户来说，找到合适的选项可能是非常困难的任务，尤其是当选项数量众多时。

现在

认识到现有的问题，我们在 1.8 版本中采取了不同的方法。我们定义了一个新的插件构建流程，该流程侧重于简化 API，使其易于扩展。随着 1.8 版本的成功，特别是 Autocomplete 小部件的简洁性和灵活性，我们确信我们的新流程正在发挥作用。有了新的流程和新的标准，我们决定重新设计所有现有的插件，使用相同的设计流程。10 月份，jQuery UI 团队在波士顿聚在一起，对所有现有的插件进行第一次重新设计。几周后，我们开始发布提议的更改，以收集社区的反馈意见。我们仍在为特定插件处理一些细节。

我们的目标是在 2.0 版本中拥有一个完全更新的项目。我们将拥有更简单的 API、更好的稳定性、完整的文档以及每个插件的完整测试套件。但是，实现这一目标将需要进行大量向后不兼容的更改。我们意识到这可能会造成痛苦，并且我们正在尽一切努力来减轻升级带来的痛苦。具体来说，我们在实施新 API 时会做以下几件事

• 确保我们拥有 2.0 API 的完整测试套件
• 创建 1.8 API 的单独测试套件
• 在新功能之上重新实现任何已弃用的功能
• 在旧版和新版 API 无法并存的情况下默认使用 1.8 API

这种方法有几个优点，其中一个最重要的优点是升级到 1.9 应该不会破坏任何现有的页面。事实上，1.9 版本将比任何 1.8.x 版本更好地支持 1.8 API。随着插件针对 1.9 进行重构，1.8.x 中存在的许多错误将被修复，而其中一些修复将难以移植到 1.8 分支。由于 1.9 版本中对 1.8 API 的支持实际上是在 2.0 API 之上构建的新代码，因此它受益于这些错误修复。为 1.8 API 添加完整的测试套件确保了这些错误实际上在两个 API 中都被修复。

默认情况下完全支持 1.8 API 对升级到 1.9 很有帮助，但它无法提供一种方法来确定您是否已准备好升级到仅使用 2.0 API。为了解决这个问题，我们添加了一个新的标志，jQuery.uiBackCompat。如果您加载 jQuery，然后设置 jQuery.uiBackCompat = false，然后加载 jQuery UI，则不会加载任何 1.8 API。这将导致只有 2.0 API 可用，并且允许您测试页面的新 API 兼容性，并确信您将在 2.0 发布时准备好升级到 2.0。

未来

当 jQuery UI 2.0 发布时，我们将不再支持 1.8 API。但是，1.9 中的 1.8 API 兼容层应该继续工作；它只是不会包含在 2.0 版本中，并且不再获得官方支持。所有新的插件都将通过新的设计流程，因此像这样的重大 API 更改不应该再次发生。一旦现有的插件更新到我们的新标准，我们应该能够比以前更快地推进项目。

值得一提的是，只有小部件、实用程序和效果在 1.9 中被重构。所有交互都将在 2.0 中被重写，因此它们将经历不同的实现过程。作为 jQuery UI 的用户，除了发布时间之外，在小部件重构和交互重写之间应该没有太多感知上的差异。

我们知道，没有人期待重构现有代码以适应 API 更改，我们正在努力确保过渡过程清晰简单。我们希望您，我们的用户，理解我们需要抓住这个机会改进 jQuery UI，使其在长期内更加健壮、可扩展和易于维护。

继续API 重设计，我们对选项卡小部件有一些计划更改。我们知道像这样的 API 更改并非没有代价，因此我们想明确表示，除了特别说明的地方外，**jQuery UI 选项卡在 1.9 中也将支持 1.8 API**，并且已弃用的 API 不会在 jQuery UI 2.0 之前被移除。

API 重构

移除旋转。
rotate 方法将被移除，因为它并不常见，并且一直作为内置扩展来实现。这实际上将被移除，而不仅仅是在 1.9 中被弃用，因为它一直作为扩展存在。Christopher McCulloh 基于原始代码有一个增强的旋转扩展。

彻底改造 ajax 选项卡
ajaxOptions 和 cache 选项将被移除，取而代之的是一个新的事件：beforeload。beforeload 事件将接收一个 jqXHR 对象和将传递给 jQuery.ajax() 的设置对象。ajaxOptions 通过修改传递给 beforeload 的设置来替换，缓存可以通过调用 event.preventDefault() 来实现，以防止 ajax 调用并直接跳转到显示选项卡。我们还将保持 href 属性不变，并将面板 ID 存储在 aria-controls 属性中。aria-controls 属性将为所有选项卡设置，无论它们是本地还是远程。这将消除对 url 方法的需求，该方法也将被移除。可以在 aria-controls 值中预先定义一个值以用于远程选项卡，从而消除了在 title 属性（也已被移除）中指定位置的必要性。abort 方法将被移除，因为 jqXHR 对象将可以直接访问，因此您可以直接中止 ajax 调用。beforeload 事件的另一个好处是，当与现有的 load 事件配对时，您可以创建自定义加载功能；因此，我们正在移除 spinner 选项。

选中 vs. 活动
为了提高 jQuery UI 套件内部的一致性，select/selected 将在整个套件中重命名为 activate/active。这对选项卡意味着 selected 选项将被重命名为 active，select 事件将被重命名为 beforeactivate，show 事件将被重命名为 activate。beforeactivate 和 activate 选项将包括对旧选项卡和新选项卡的选项卡和内容面板的引用，类似于手风琴。此外，select 方法将被移除，取而代之的是设置 active 选项。最后，deselectable 选项将在 1.9 中被移除，因为它在 1.8 中已被弃用。

移除模板化
所有与模板化相关的选项都将被移除。选项卡中的模板化是一个一次性实现，与 jQuery UI 的其余部分不一致。此更改包括移除 idPrefix、tabTemplate 和 panelTemplate 选项。

添加和移除选项卡
add 和 remove 方法将被移除，取而代之的是一个新的 refresh 方法。这与初始化后更新新插件的方式一致。移除这些方法也意味着 add 和 remove 事件将被移除。

启用和禁用选项卡
选项卡将正确支持禁用单个选项卡或整个选项卡集。可以使用布尔值来禁用整个集，或者可以使用索引数组来禁用单个选项卡。此外，enable 和 disable 事件将被移除，以与其他小部件保持一致。

移除长度方法
length 方法将被移除，因为它没有太多用途，可以通过计算列表项的数量轻松地计算出来。

移除 cookie 选项
cookie 选项将被移除，因为 cookie 支持不是插件的核心功能。跨页状态管理应该很容易，但不要内置。

设计更改仍在变化中
我们还没有完全解决的几件事。我们计划用 show 和 hide 选项替换 fx 选项，以与其他小部件保持一致，但仍在解决一个关于如何在插件之间支持效果的开放性问题。我们还想移除 load 方法，但我们需要验证它是否可以作为扩展构建。在我们进入新的实现之前，我们还不知道这是否可行；如果不可行，load 方法将保留在插件中。

反馈

我们非常乐意听到您对这些更改的反馈意见。我们希望确保在最终确定和实施这些更改之前解决社区可能遇到的任何问题。如果您有任何反馈意见，请在相关论坛帖子中发表。谢谢。

继续API 重设计，我们对位置实用程序有一些计划更改。

API 重构

将偏移选项合并到 my 和 at 选项中
偏移选项将被移除，取而代之的是将偏移量作为 my 或 at 选项的一部分。
例如，你现在可能会这样做

$( "#elem" ).position({
    my: "left top",
    at: "left top",
    of: "#otherElem",
    offset: "50 20"
});

现在你将这样做

$( "#elem" ).position({
    my: "left+50 top+20",
    at: "left top",
    of: "#otherElem"
});

无论你是在 my 还是 at 选项中包含偏移量，偏移量都会根据最终位置进行调整，就像当前的偏移量选项一样。我们还计划支持百分比，这样你就可以根据元素宽度或高度的百分比来偏移元素。如果你在 my 选项中指定百分比，那么百分比将基于被定位元素的大小。如果你在 at 选项中指定百分比，那么百分比将基于被定位元素的相对大小。
例如，要将元素放置在屏幕下方 1/4 处并水平居中，你可以这样做

$( "#elem" ).position({
    my: "center top",
    at: "center top+25%",
    of: window
});

要将元素定位，使其只有左侧 10% 可见，你可以这样做

$( "#elem" ).position({
    my: "left-10% center",
    at: "right center",
    of: window
});

更好的碰撞处理
目前碰撞处理相当简单。如果你启用了碰撞（通过指定 fit 或 flip），插件将检测是否存在碰撞，如果存在，它将相应地移动元素。但是，根据元素的大小，这种调整实际上可能会导致更少的元素可见。我们计划使碰撞处理更智能，这样它永远不会使定位更差。API 不会有任何变化，只是碰撞处理会更好。

反馈

我们非常希望听到你对这些更改的反馈。我们希望确保在我们最终确定并实施这些更改之前，解决社区可能遇到的任何问题。如果您有任何反馈，请在 相关的论坛帖子 上发布。谢谢。

正如 之前所述，jQuery UI 正在进行 API 重构，这将缩减 API 的大小，以提供更稳定的代码库，使其更易于学习和使用。这篇文章列出了进度条小部件的拟议更改的详细信息以及每个更改背后的原因。

API 重构

添加对不确定进度条的支持。
我们之前说过，不确定进度条应该是一个单独的小部件。但是，有一个很常见的用例，你可能希望在知道实际进度之前就开始提供有关任务已启动的反馈。在这种情况下，你可能希望从不确定进度条开始，并在获得足够的信息以提供详细信息后切换到确定进度条。为了支持这一点，我们将允许 value 选项设置为 false，以指示进度条应该是 不确定的。

从不确定状态切换到确定状态将如下所示

$( "#progressbar" ).progressbar({
    value: false
});

// later when you find out more information
$( "#progressbar" ).progressbar( "option", {
    value: 15,
    max: 250
});

反馈

我们非常希望听到你对这些更改的反馈。我们希望确保在我们最终确定并实施这些更改之前，解决社区可能遇到的任何问题。如果您有任何反馈，请在 相关的论坛帖子 上发布。谢谢。

jQuery UI 正在进行 API 重构，这将缩减 API 的大小，以提供更稳定的代码库，使其更易于学习和使用。我们将在接下来的几周内发布拟议的更改，以便从社区收集反馈。我们的目标是在 1.9 版中同时支持旧（当前）和新（拟议）API，然后在 2.0 版中删除对旧 API 的支持。这篇文章列出了手风琴小部件的拟议更改的详细信息以及每个更改背后的原因。

API 重构

删除 navigation 和 navigationFilter 选项。
与导航相关的选项将被移除，取而代之的是在初始化期间设置 active 选项。内置的导航过滤器并不总是合理，并且默认情况下处于关闭状态。我们计划添加一个演示，展示如何实现当前的导航功能以及如何使用 cookie 来存储活动面板。

将 autoHeight、fillSpace 和 clearStyle 选项合并到一个名为 fixedHeight 的新选项中
autoHeight、fillSpace 和 clearStyle 选项都处理类似的问题，因此不能一起使用。为同一个功能（面板的高度应该如何）提供三个选项会创建一个复杂且令人困惑的 API。这三个选项将被一个名为 fixedHeight 的单个布尔选项替换。当设置为 true（默认值）时，所有面板将具有相同的高度。如果手风琴的高度为“auto”，则所有面板的高度将与最高的面板相同（相当于 autoHeight: true）。如果手风琴具有显式高度，则所有面板的大小将基于该高度（相当于 fillSpace: true）。当 fixedHeight 设置为 false 时，不会对面板的高度进行任何计算，它们的大小将根据其内容进行调整（相当于 clearStyle: true）。

将 icon.headerSelected 选项重命名为 icon.activeHeader
此选项正在被重命名，以确保在手风琴（处理活动面板时为 active 与 selected）和整个 jQuery UI 套件中的一致性。

删除 activate 方法
activate 方法将被移除，取而代之的是更新 active 选项。包含 activate 方法不会简化手风琴的使用，因此没有必要。

将 resize 方法重命名为 refresh
此方法正在被重命名，以确保在整个 jQuery UI 套件中的一致性。但是，这将暂时继续仅处理大小更改。我们确实计划在将来支持添加/删除面板。

将 changestart 事件重命名为 beforeactivate
此事件正在被重命名，以确保在手风琴（处理活动面板时为 activate 与 change）和整个 jQuery UI 套件中的一致性。

将 change 事件重命名为 activate
此事件正在被重命名，以确保在手风琴（处理活动面板时为 activate 与 change）和整个 jQuery UI 套件中的一致性。

添加 .ui-accordion-heading 类
目前没有向每个面板的标题添加类。这会导致样式表使用 .ui-accordion-header a 来进行样式设置，这使得向标题添加额外的锚点变得很困难。为了解决这个问题，我们将在每个标题的第一个子元素中添加一个类，并使用这个新类来进行样式设置。

反馈

我们非常希望听到你对这些更改的反馈。我们希望确保在我们最终确定并实施这些更改之前，解决社区可能遇到的任何问题。如果您有任何反馈，请在 相关的论坛帖子 上发布。谢谢。