滑动面板布局

  
实现滑动面板 UI 模式。
最新更新 稳定版 候选版本 Beta 版 Alpha 版
2022年1月26日 1.2.0 - - -

声明依赖项

要添加对 SlidingPaneLayout 的依赖项，您必须将 Google Maven 代码库添加到您的项目中。阅读Google 的 Maven 代码库以了解更多信息。

在应用或模块的 build.gradle 文件中添加所需构件的依赖项

Groovy

dependencies {
    implementation "androidx.slidingpanelayout:slidingpanelayout:1.2.0"
}

Kotlin

dependencies {
    implementation("androidx.slidingpanelayout:slidingpanelayout:1.2.0")
}

有关依赖项的更多信息，请参阅添加构建依赖项。

反馈

您的反馈有助于改进 Jetpack。如果您发现新的问题或有改进此库的想法，请告知我们。在创建新问题之前，请查看此库中现有问题。您可以通过点击星号按钮为现有问题添加您的投票。

创建新的问题

查看问题跟踪器文档以了解更多信息。

1.2.0 版

1.2.0 版

2022年1月26日

androidx.slidingpanelayout:slidingpanelayout:1.2.0 已发布。1.2.0 版包含这些提交。

自 1.1.0 版以来的重要更改

  • SlidingPaneLayout 现在是**可折叠感知的**。在可折叠设备上，SlidingPaneLayout 将自动调整两个窗格的大小，以便窗格位于折叠、铰链等的任一侧。
  • 在处理您自己的配置更改时，-SlidingPaneLayout 现在会在提供的空间量发生变化时（例如，展开可折叠设备时）在单窗格和双窗格模式之间进行动画切换。
  • 当两个面板重叠时，SlidingPaneLayout 现在具有新的 UI 样式。当 SlidingPaneLayout 打开时，每个面板现在都将从边缘延伸到边缘，详细信息或辅助面板将完全覆盖列表或主面板。与旧版 UI 样式相关的 API（例如淡入淡出颜色）已被弃用。
  • SlidingPaneLayout 现在默认设置为“关闭”状态 - 即显示列表或主面板。调用 open() 或 openPane() 现在将显示详细信息或辅助面板。
  • 改进了与更多测量规范的兼容性，以确保可以在任何类型的布局中使用 SlidingPaneLayout，而不会引发 IllegalStateException。
  • SlidingPaneLayout 现在允许注册多个 PanelSlideListeners。
  • 开发人员现在可以通过设置锁定模式来控制用户是否可以在列表面板和详细信息面板之间滑动。

1.2.0-rc01 版本

2021 年 12 月 15 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.2.0-rc01。1.2.0-rc01 版本包含这些提交。

依赖项更新

  • SlidingPaneLayout 现在依赖于 Window 1.0.0-rc01，修复了与早期 AndroidX Window 测试版的不兼容性。

1.2.0-beta01 版本

2021 年 9 月 1 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.2.0-beta01，无重大更改。1.2.0-beta01 版本包含这些提交。

1.2.0-alpha04 版本

2021 年 8 月 18 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.2.0-alpha04。1.2.0-alpha04 版本包含这些提交。

新增功能

  • 使用折叠设备时，SlidingPaneLayout 现在会在单面板和双面板模式之间进行动画切换。（aosp/1702066，b/186211031）
  • 改进了与更多测量规范的兼容性，以确保可以在任何类型的布局中使用 SlidingPaneLayout，而不会引发 IllegalStateException。（aosp/1774187，aosp/1773623，aosp/1773256）

错误修复

  • 修复了当面板重叠时，点击详细信息面板的空位置会将点击事件传递到列表面板的问题。（aosp/1755141）

依赖项更新

1.2.0-alpha03 版本

2021 年 6 月 30 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.2.0-alpha03。1.2.0-alpha03 版本包含这些提交。

依赖项更改

1.2.0-alpha02 版本

2021 年 5 月 5 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.2.0-alpha02。1.2.0-alpha02 版本包含这些提交。

错误修复

  • SlidingPaneLayout 现在会考虑宽度不为零的折叠功能。（847cc2）
  • SlidingPaneLayout 现在在启用手势导航时会扩大拖动边缘大小，这与 DrawerLayout 的行为一致。（2c6d24）
  • 即使在设备不可滑动（即两个面板并排显示）时更改 SlidingPaneLayout 的打开和关闭状态，该状态现在也会保留，从而确保用户在旋转设备或切换到较小的显示屏时仍将看到详细信息屏幕。（b15eda）
  • 修复锁定模式行为（Ic01dc）

外部贡献

  • 感谢 Cesar Valiente 修复了 SlidingPaneLayout，使其现在能够考虑宽度不为零的折叠功能。（847cc2）

1.2.0-alpha01 版本

2021 年 3 月 24 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.2.0-alpha01。1.2.0-alpha01 版本包含这些提交。

新增功能

  • SlidingPaneLayout 现在是**可折叠感知的**。在可折叠设备上，SlidingPaneLayout 将自动调整两个窗格的大小，以便窗格位于折叠、铰链等的任一侧。

行为更改

  • 当两个面板重叠时，SlidingPaneLayout 现在具有新的 UI 样式。当 SlidingPaneLayout 打开时，每个面板现在都将从边缘延伸到边缘，详细信息或辅助面板将完全覆盖列表或主面板。与旧版 UI 样式相关的 API（例如淡入淡出颜色）已被弃用。（Ia60ce）
  • SlidingPaneLayout 现在默认设置为“关闭”状态 - 即显示列表或主面板。调用 open() 或 openPane() 现在将显示详细信息或辅助面板。（I5d26c）

API 更改

  • SlidingPaneLayout 现在允许注册多个 PanelSlideListeners。（I50ce2）
  • 开发人员现在可以通过设置锁定模式来控制用户是否可以在列表面板和详细信息面板之间滑动。（Idf2fd，I5d26c）

1.1.0 版本

1.1.0 版本

2020 年 6 月 24 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.1.0。1.1.0 版本包含这些提交。

自 1.0.0 版本以来的重大更改

1.1.0-rc01 版本

2020 年 5 月 20 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.1.0-rc01，自 1.1.0-beta01 以来没有更改。1.1.0-rc01 版本包含这些提交。

1.1.0-beta01 版本

2020 年 4 月 1 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.1.0-beta01，自 1.1.0-alpha01 以来没有更改。1.1.0-beta01 版本包含这些提交。

1.1.0-alpha01 版本

2020 年 3 月 18 日

已发布 androidx.slidingpanelayout:slidingpanelayout:1.1.0-alpha01。1.1.0-alpha01 版本包含这些提交。

API 更改