手风琴 API 重构

---

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

API 重构

删除导航和 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
此选项被重命名以确保在手风琴（活动 vs. 选择，用于处理活动面板）和整个 jQuery UI 套件中保持一致。

删除 activate 方法
activate 方法将被删除，转而通过更新 active 选项来实现。activate 方法的加入并没有简化手风琴的使用，因此没有必要。

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

将 changestart 事件重命名为 beforeactivate
此事件被重命名以确保在手风琴（activate vs. change，用于处理活动面板）和整个 jQuery UI 套件中保持一致。

将 change 事件重命名为 activate
此事件被重命名以确保在手风琴（activate vs. change，用于处理活动面板）和整个 jQuery UI 套件中保持一致。

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

反馈

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