first commit

.gitignore

@@ -13,6 +13,8 @@ bin/
 gen/
 out/
 
+.idea/
+
 # Gradle files
 .gradle/
 build/

README.md

@@ -1,2 +1,191 @@
-# stateLayout
-a quick switch layout 
+# StateLayout用法
+
+## 演示
+
+![演示图](http://upload-images.jianshu.io/upload_images/1967808-08bf36a152a8ded2.gif)
+
+
+## 使用方法
+### 引入布局
+
+用法与SrcollView一致，只允许一个`根布局`
+
+```
+<com.fngdo.statelayout.StateLayout
+        android:id="@+id/state_layout"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent">
+        <!-- 内容布局 one root view -->
+</com.fngdo.statelayout.StateLayout>
+```
+
+### 布局设置图标和文字
+```
+<declare-styleable name="StateLayout">
+    <!-- 错误提示图标 -->
+    <attr name="errorImg" format="reference" />
+    <!-- 错误提示文字 -->
+    <attr name="errorText" format="string" />
+    <!-- 空数据提示图标 -->
+    <attr name="emptyImg" format="reference" />
+    <!-- 空数据提示文字 -->
+    <attr name="emptyText" format="string" />
+    <!-- 没有网络提示图标 -->
+    <attr name="noNetworkImg" format="reference" />
+    <!-- 没有网络提示文字 -->
+    <attr name="noNetworkText" format="string" />
+    <!-- 超时提示图标 -->
+    <attr name="timeOutImg" format="reference" />
+    <!-- 超时提示文字 -->
+    <attr name="timeOutText" format="string" />
+    <!-- 登录提示图标 -->
+    <attr name="loginImg" format="reference" />
+    <!-- 登录提示文字 -->
+    <attr name="loginText" format="string" />
+    <!-- 加载提示文字 -->
+    <attr name="loadingText" format="string" />
+</declare-styleable>
+```
+
+#### 示例：
+
+```
+<com.fngdo.statelayout.StateLayout
+    xmlns:sl="http://schemas.android.com/apk/res-auto"
+    android:id="@+id/state_layout"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    sl:emptyImg="@drawable/ic_state_empty"
+    sl:emptyText="空数据提示文字"
+    sl:errorImg="@drawable/ic_state_error"
+    sl:errorText="错误提示文字"
+    sl:loadingText="加载提示文字"
+    sl:loginImg="@drawable/ic_state_login"
+    sl:loginText="登录提示文字"
+    sl:noNetworkImg="@drawable/ic_state_no_network"
+    sl:noNetworkText="没有网络提示文字"
+    sl:timeOutImg="@drawable/ic_state_time_out"
+    sl:timeOutText="超时提示文字">
+</com.fngdo.statelayout.StateLayout>
+```
+
+### 代码提前设置图标和文字
+```
+//type为StateLayout的固定Type变量
+public static final int ERROR = 1;
+public static final int EMPTY = 2;
+public static final int TIMEOUT = 3;
+public static final int NOT_NETWORK = 4;
+public static final int LOADING = 5;
+public static final int LOGIN = 6;
+```
+![image](http://upload-images.jianshu.io/upload_images/1967808-4e6be6b3e218fece.png)
+
+### 代码设置显示布局
+```
+//展示没有网络的界面
+stateLayout.showNoNetworkView();
+//展示超时的界面
+stateLayout.showTimeoutView();
+//展示空数据的界面
+stateLayout.showEmptyView();
+//展示错误的界面
+stateLayout.showErrorView();
+//展示登录的界面
+stateLayout.showLoginView();
+
+//如下图所示
+1，直接显示
+2，设置提示stringId和图片Id显示
+3，设置提示stringId显示
+4，设置提示字符串现实
+5，设置提示字符串和图片Id显示
+```
+![image](http://upload-images.jianshu.io/upload_images/1967808-eb1e0af3ea1d7913.png)
+```
+//显示加载界面
+stateLayout.showLoadingView();
+
+1，直接显示
+2，设置提示stringId显示
+3，设置提示字符串现实
+4，设置自定义加载View现实，如：
+    1)进度条
+    2)显示gif的View
+    3)自定义布局View
+    
+```
+![image](http://upload-images.jianshu.io/upload_images/1967808-878baa6fd9576469.png)
+```
+//显示自定义界面
+stateLayout.showCustomView();
+```
+设置替换成自定义的界面:
+![image](http://upload-images.jianshu.io/upload_images/1967808-f26b6a9925917e9d.png)
+
+
+### 设置切换界面动画
+动画默认为`false`，如果需要开启动画，请调用
+
+```
+//开启动画
+stateLayout.setUseAnimation(true);
+```
+如果用户不设置自定义动画，一般为默认的`渐隐缩放`动画
+如果用户需要设置动画，请调用
+
+```
+//设置动画
+stateLayout.setViewSwitchAnimProvider(new FadeScaleViewAnimProvider());
+```
+`stateLayout`自定义了两种动画
+
+```
+//渐隐缩放，渐显放大动画
+FadeScaleViewAnimProvider
+//渐隐渐显动画
+FadeViewAnimProvider
+```
+用户如需自定义动画样式，请实现`ViewAnimProvider`接口
+
+重写`showAnimation`和`hideAnimation`方法。
+
+```
+//以FadeViewAnimProvider为例
+public class FadeViewAnimProvider implements ViewAnimProvider {
+
+    @Override
+    public Animation showAnimation() {
+        Animation animation = new AlphaAnimation(0.0f,1.0f);
+        animation.setDuration(200);
+        animation.setInterpolator(new DecelerateInterpolator());
+        return animation;
+    }
+
+    @Override
+    public Animation hideAnimation() {
+        Animation animation = new AlphaAnimation(1.0f,0.0f);
+        animation.setDuration(200);
+        animation.setInterpolator(new AccelerateDecelerateInterpolator());
+        return animation;
+    }
+
+}
+```
+
+
+### 监听刷新和登录点击
+请实现`StateLayout`里面的`OnViewRefreshListener`接口。
+
+重写两个方法：
+
+```
+//刷新界面
+void refreshClick();
+    
+//登录点击
+void loginClick();
+```
+
+
+感谢[lufficc](https://github.com/lufficc/StateLayout)提供的思路

app/.gitignore

@@ -0,0 +1 @@
+/build

app/build.gradle

@@ -0,0 +1,27 @@
+apply plugin: 'com.android.application'
+
+android {
+    buildToolsVersion BUILD_TOOLS_VERSION
+    compileSdkVersion Integer.parseInt(COMPILE_SDK_VERSION)
+
+    defaultConfig {
+        applicationId "com.fingdo.statelayoutdemo"
+        minSdkVersion Integer.parseInt(MIN_SDK_VERSION)
+        targetSdkVersion Integer.parseInt(TARGET_SDK_VERSION)
+        versionCode 1
+        versionName "1.0"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+    compile fileTree(dir: 'libs', include: ['*.jar'])
+    compile APPCOMPAT_LIB
+    compile project(':library')
+}

app/proguard-rules.pro

@@ -0,0 +1,17 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in /Users/fingdo/Library/Android/sdk/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}

app/src/main/AndroidManifest.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.fingdo.statelayoutdemo">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:supportsRtl="true"
+        android:theme="@style/AppTheme">
+        <activity android:name=".SampleActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+
+    </application>
+
+</manifest>