Skip to content

Latest commit

 

History

History
122 lines (112 loc) · 7.04 KB

README-CN.md

File metadata and controls

122 lines (112 loc) · 7.04 KB

SlideMenuLayout

简介

一个支持左右滑动并带有视差滑动效果的安卓滑动菜单控件。
Platform SDK

演示

封装不同场景下的滑动嵌套

特性

  • 支持滑动方向的配置
  • 直接作为控件使用
  • 处理各个场景下的滑动冲突
  • 侧滑菜单打开时候点击主体布局关闭侧滑菜单（可配置）
  • 侧滑菜单打开/关闭的时候主体布局暗度自动变化（可配置）
  • 支持滑动视差效果（可配置）

最新版本

模块 slideMenuLayout
最新版本 Download

集成

Maven集成

<dependency>
  <groupId>com.justkiddingbaby</groupId>
  <artifactId>slidemenu</artifactId>
  <version>最新版本</version>
  <type>pom</type>
</dependency>

JCenter集成

第一步 在项目build.gradle中添加

repositories {
    jcenter()
}

第一步 在module的build.gradle中添加

compile 'com.justkiddingbaby:slidemenu:最新版本'

属性说明

属性 说明 值
slideMode 滑动模式 left right both none
slidePadding 滑动菜单打开时候主视图预留边界 dimension
slideTime 滑动菜单单开的时间，默认800ms integer
parallax 是否允許滑动视差效果，默认true boolean
contentAlpha 设置侧滑菜单打开时候ContentView的阴影透明度（范围0<alpha<=1.0），默认0.5f float
contentShadowColor 设置侧滑菜单打开时候ContentView的阴影颜色，默认色值#000000 color
contentToggle 设置是否允许侧滑菜单打开时候点击ContentView关闭侧滑菜单，默认false boolean
allowDragging 设置是否允许拖动进行打开/关闭菜单的操作，默认true boolean

方法说明

返回值 方法 说明
void setSlideMode(int slideMode) 设置滑动模式
void setSlidePadding(int slidePadding) 设置滑动边界
void setSlideTime(int slideTime) 设置滑动菜单打开的时间
View getSlideLeftView() 返回左滑菜单
View getSlideRightView() 返回右滑菜单
View getSlideContentView() 返回主视图
void toggleLeftSlide() 打开/关闭左滑菜单
void openLeftSlide() 打开左滑菜单
void closeLeftSlide() 关闭左滑此单
boolean isLeftSlideOpen() 左滑菜单是否打开
void toggleRightSlide() 打开/关闭右滑菜单
void openRightSlide() 打开右滑菜单
void closeRightSlide() 关闭右滑菜单
boolean isRightSlideOpen() 右滑菜单是否打开
void setParallaxSwitch(boolean parallax) 设置是否允许滑动视差效果
void setContentAlpha(float contentAlpha) 设置在侧滑菜单打开时候的ContentView的透明度，该值为1.0时表示滑动过程中无阴影
void setContentShadowColor(int color) 设置ContentView在滑动过程中的阴影颜色
void setContentToggle(boolean contentToggle) 设置ContentView是否在侧滑菜单打开时候点击关闭侧滑菜单.默认false
void setAllowTogging(boolean allowTogging) 设置是否允许拖动进行打开/关闭菜单的操作，默认true.
void addOnSlideChangedListener(OnSlideChangedListener listener) 设置侧滑菜单变化的监听器

使用方式

布局中使用

 <com.jkb.slidemenu.SlideMenuLayout
        android:id="@+id/mainSlideMenu"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@color/white"
        app:slideMode="both">
        <include layout="@layout/content_menu_left" />
        <include layout="@layout/content_menu_right" />
        <include layout="@layout/content_menu_content" />
 </com.jkb.slidemenu.SlideMenuLayout>

注意

SlideMenuLayout中布局的顺序是侧滑菜单布局在前，主体内容在后(为了防止右滑菜单重叠问题)。
要是slideMode为both时，则SlideMenuLayout必须要有三个子视图，否则会抛出异常。

发布历史

v1.3.0(2017/12/25)

1、添加特性:添加禁止拖动菜单（只能通过打开/关闭/切换方法打开）支持.
2、添加特性:添加菜单打开变化时候的监听器.

v1.2.2(2017/12/18)

1、修复issue#5

v1.2.1(2017/9/18)

1、当contentToggle属性的值为true时，拦截content view的touch事件.

v1.2.0(2017/8/20)

1、添加特性:侧滑菜单打开时候点击主体布局关闭侧滑菜单（可配置）. 2、添加特性:侧滑菜单打开/关闭的时候主体布局暗度自动变化（可配置）. 3、添加特性:支持滑动视差效果（可配置）.

v1.0.1(2017/6/9)

1、修改最低版本SDK为12.

v1.0.0(2017/6/8)

1、发布SlideMenuLayout，处理各个场景下的滑动冲突。
2、封装demo。

License

本框架遵循MIT开源协议. 浏览LICENSE查看更多信息.