# Android SlidingDrawer 滑动式抽屉详解与实例
滑动式抽屉（SlidingDrawer）是Android平台上一个独特的控件，它提供了一种隐藏和显示内容的方式，常用于创建类似抽屉的交互体验。在Android 1.5版本的模拟器中，进入应用程序列表时所展示的效果就是SlidingDrawer的典型应用场景。本篇将详细介绍SlidingDrawer的使用方法、重要属性以及相关操作方法，并提供一个完整的实例。
## 一、SlidingDrawer简介
SlidingDrawer 控件允许开发者将内容隐藏在屏幕之外，然后通过一个可拖动的手柄（handle）来显示这些隐藏的内容。它支持垂直和水平两种滑动方向，并由两个主要部分组成：一是handle，用户可以通过拖动它来控制抽屉的开闭；二是content，即隐藏的内容区域。
在XML布局文件中，SlidingDrawer 需要明确指定handle和content的ID。以下是一个简单的SlidingDrawer布局示例：
```xml
<SlidingDrawer
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:handle="@+id/handle"
android:content="@+id/content"
android:orientation="vertical"
android:id="@+id/slidingdrawer">
<ImageButton
android:id="@id/handle"
android:layout_width="50dip"
android:layout_height="44dip"
android:src="@drawable/up" />
<LinearLayout
android:id="@id/content"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:background="#ffffff">
<TextView
android:text="这是一个滑动式抽屉的示例"
android:id="@+id/tv"
android:textSize="18px"
android:textColor="#000000"
android:gravity="center_vertical|center_horizontal"
android:layout_width="match_parent"
android:textStyle="bold"
android:layout_height="match_parent"/>
</LinearLayout>
</SlidingDrawer>
```
在这个例子中，`<ImageButton>`作为handle，而`<LinearLayout>`则包含了隐藏的内容。
## 二、SlidingDrawer的重要属性
1. `android:allowSingleTap`: 如果设置为true，用户只需点击handle即可打开或关闭抽屉，而无需拖动。
2. `android:animateOnClick`: 如果设置为true，打开或关闭抽屉时会有一个平滑的动画效果。
3. `android:content`: 指定抽屉内隐藏内容的视图ID。
4. `android:handle`: 指定抽屉手柄的视图ID。
5. `android:orientation`: 定义抽屉的滑动方向，可选"vertical"（垂直）或"horizontal"（水平）。
## 三、SlidingDrawer的重要方法
1. `animateClose()`: 使用动画效果关闭抽屉。
2. `close()`: 立即关闭抽屉，无动画效果。
3. `getContent()`: 获取抽屉内容视图。
4. `isMoving()`: 判断抽屉是否正在移动。
5. `isOpened()`: 判断抽屉是否完全打开。
6. `lock()`: 屏蔽抽屉的触摸事件，使其无法被用户手动操作。
7. `setOnDrawerCloseListener(OnDrawerCloseListener onDrawerCloseListener)`: 设置抽屉关闭时的监听器。
8. `unlock()`: 解除对抽屉触摸事件的屏蔽，恢复用户手动操作。
9. `toggle()`: 切换抽屉的开关状态，如果已打开则关闭，反之则打开。
## 四、完整实例
以下是一个完整的SlidingDrawer应用实例：
1. 创建布局文件 `slidingdrawer.xml`:
```xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical"
android:background="@drawable/default_bg">
<SlidingDrawer
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:handle="@+id/handle"
android:content="@+id/content"
android:orientation="vertical"
android:id="@+id/slidingdrawer">
<ImageButton
android:id="@id/handle"
android:layout_width="50dip"
android:layout_height="44dip"
android:src="@drawable/up" />
<LinearLayout
android:id="@id/content"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:background="#ffffff">
<TextView
android:text="这是一个滑动式抽屉的示例"
android:id="@+id/tv"
android:textSize="18px"
android:textColor="#000000"
android:gravity="center_vertical|center_horizontal"
android:layout_width="match_parent"
android:textStyle="bold"
android:layout_height="match_parent"/>
</LinearLayout>
</SlidingDrawer>
</LinearLayout>
```
2. 创建对应的Activity类，例如 `MainActivity.java`:
```java
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.widget.SlidingDrawer;
public class MainActivity extends Activity {
private SlidingDrawer slidingDrawer;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.slidingdrawer);
slidingDrawer = (SlidingDrawer) findViewById(R.id.slidingdrawer);
slidingDrawer.setOnDrawerCloseListener(new SlidingDrawer.OnDrawerCloseListener() {
@Override
public void onDrawerClosed() {
// 抽屉关闭时的操作
}
});
}
public void toggleDrawer(View v) {
if (slidingDrawer.isOpened()) {
slidingDrawer.close();
} else {
slidingDrawer.open();
}
}
}
```
在这个例子中，我们设置了抽屉关闭时的监听器，并在Activity的主视图中添加了一个按钮，点击该按钮会触发`toggleDrawer()`方法，从而切换抽屉的开关状态。
通过以上步骤，你就创建了一个简单的SlidingDrawer应用。你可以根据实际需求，自定义handle和content的内容，或者调整SlidingDrawer的相关属性，以实现更丰富的交互效果。
请注意，尽管SlidingDrawer在早期的Android版本中被广泛使用，但在Android Design Support Library中并没有提供等效的组件。随着Material Design的推广，现在的应用更倾向于使用`NavigationView`或自定义布局来实现类似的功能。然而，对于向后兼容或学习Android历史控件的开发者来说，理解SlidingDrawer仍然很有价值。
