AndroidSlidingUpPanel 快速入门指南

霍璟尉

于 2024-08-09 07:08:43 发布

阅读量607

点赞数 6

本文链接：https://blog.csdn.net/gitblog_00901/article/details/141042342

版权

AndroidSlidingUpPanel 快速入门指南

AndroidSlidingUpPanelThis library provides a simple way to add a draggable sliding up panel (popularized by Google Music and Google Maps) to your Android application. Brought to you by Umano.项目地址:https://gitcode.com/gh_mirrors/an/AndroidSlidingUpPanel

1. 项目介绍

引入

AndroidSlidingUpPanel 是一款由Umano公司开发并开放给社区的开源库。它为Android开发者提供了一种简单的方式来实现在App内添加可拖拽的上滑面板(sliding up panel)，这一特性深受Google Music和Google Maps等知名应用的影响。

公司背景

Umano是一家成立于2012年的初创企业，专注于音频领域，通过聘请专业的配音演员来提供新闻阅读服务。然而，在2015年末，该公司被Dropbox收购，但其所贡献的开源库AndroidSlidingUpPanel仍在社区中发挥着重要作用。

核心特点

简化UI设计: 提升应用用户体验，增强视觉吸引力。
灵活扩展性: 适用于多种应用场景，如菜单、设置页面或额外信息展示。
易于集成: 简单配置即可使用，降低开发成本。

2. 项目快速启动

添加依赖

要在你的项目中引入此库，首先需在你的module的build.gradle文件中添加以下依赖：

dependencies {
    implementation 'com.sothree.slidinguppanel:library:3.3.0'
}

确保你的仓库中包含了相关Maven中心库，可通过在repositories块下添加mavenCentral()来实现。

基础用法

在布局文件中，你需要使用com.sothree.slidinguppanel.SlidingUpPanelLayout作为容器组件。下面是一个基础示例：

<com.sothree.slidinguppanel.SlidingUpPanelLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/slid_up_panel"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 主体布局 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
        <!-- ...主体内容... -->
    </LinearLayout>

    <!-- 上滑面板布局 -->
    <FrameLayout
        android:layout_width="match_parent"
        android:layout_height="300dp">
        <!-- ...上滑面板内容... -->
    </FrameLayout>
</com.sothree.slidinguppanel.SlidingUpPanelLayout>

控制面板状态

你可以通过调用SlidingUpPanelLayout提供的API来控制面板的显示状态。例如，如果你想在程序运行初期设定面板初始状态，可以这样做:

import com.sothree.slidinguppanel.SlidingUpPanelLayout;

// 获取SlidingUpPanelLayout实例
SlidingUpPanelLayout mLayout = findViewById(R.id.slid_up_panel);

// 设置面板状态为展开(EXPANDED)
mLayout.setPanelState(SlidingUpPanelLayout.PanelState.EXPANDED);