开源APPAndroid实践Android知识

安利一个Android导航库

2017-04-17  本文已影响274人  CoderMiner

SlidingRootNav

这是一个像DrawerLayout一样的抽屉式的导航库,这个库实现的抽屉在content view的下层,滑动之后,才能看到相应的导航页

使用

Gradle

添加依赖

compile 'com.yarolegovich:sliding-root-nav:1.0.2'

使用说明

  1. 创建一个 content_view.xml或通过编程方式创建
  2. 在Activity中设置view(setContentView)
  3. 创建menu.xml或通过编程方式创建
  4. 在onCreate方法中注入菜单。
new SlidingRootNavBuilder(this)
  .withMenuLayout(R.layout.menu_left_drawer)
  .inject();

API

过场动画

创建时可以添加一些过场动画,库本身提供一些默认的过场。

new SlidingRootNavBuilder(this)
  .withDragDistance(140) //水平动画. Default == 180dp
  .withRootViewScale(0.7f) //设置主view的缩放比例0~0.7. 默认值 == 0.65f;
  .withRootViewElevation(10) //主view垂直方向的值 0~10dp. 默认值 == 8.
  .withRootViewYTranslation(4) //主view y轴方向的过场0~4. 默认值 == 0
  .addRootTransformation(customTransformation) // 添加自定义过场
  .inject();

customTransformation 是自定义的,需要实现 RootTransformation 接口

菜单的行为
new SlidingRootNavBuilder(this)
  .withMenuOpened(true) //初始化菜单的状态(打开/关闭) 默认值 == false
  .withMenuLocked(false) //锁定菜单,true时不能打开或关闭菜单 默认值 == false.
  .withGravity(SlideGravity.LEFT) //设置菜单从哪个方向出来,
  .withSavedState(savedInstanceState) //是否保存菜单的状态
  .inject();
控制布局
public interface SlidingRootNav {
    boolean isMenuHidden();
    boolean isMenuLocked();
    void closeMenu();
    void closeMenu(boolean animated);
    void openMenu();
    void openMenu(boolean animated);
    void setMenuLocked(boolean locked);
    SlidingRootNavLayout getLayout(); //If for some reason you need to work directly with layout - you can
}

在调用inject()后返回的实例,可以控制布局

回调
builder.addDragListener(listener);

public interface DragListener {
  void onDrag(float progress); //Float between 0 and 1, where 1 is a fully visible menu
}
builder.addDragStateListener(listener);

public interface DragStateListener {
  void onDragStart();
  void onDragEnd(boolean isMenuOpened);
}
兼容 DrawerLayout.DrawerListener 回调
DrawerListenerAdapter adapter = new DrawerListenerAdapter(yourDrawerListener, viewToPassAsDrawer);
builder.addDragListener(listenerAdapter).addDragStateListener(listenerAdapter);

库-github
实例源码

上一篇下一篇

猜你喜欢

热点阅读