├── .gitignore ├── LICENSE ├── README.md ├── StateFrameLayout ├── .gitignore ├── build.gradle ├── proguard-rules.pro └── src │ └── main │ ├── AndroidManifest.xml │ ├── java │ └── com │ │ └── lwkandroid │ │ └── widget │ │ ├── AlphaContentAnimation.java │ │ ├── BaseContentAnimation.java │ │ ├── LayoutState.java │ │ ├── StateConstants.java │ │ ├── StateFrameLayout.java │ │ ├── StateFrameLayoutManager.java │ │ └── StateGlobalOptions.java │ └── res │ └── values │ ├── attrs.xml │ └── strings.xml ├── app ├── .gitignore ├── build.gradle ├── proguard-rules.pro └── src │ └── main │ ├── AndroidManifest.xml │ ├── java │ └── com │ │ └── lwkandroid │ │ └── statelayoutdemo │ │ ├── DemoApplication.java │ │ └── MainActivity.java │ └── res │ ├── layout │ ├── activity_main.xml │ ├── layout_empty.xml │ ├── layout_empty2.xml │ ├── layout_loading.xml │ ├── layout_loading2.xml │ └── layout_net_error.xml │ ├── mipmap-hdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ ├── mipmap-mdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ ├── mipmap-xhdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ ├── mipmap-xxhdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ ├── mipmap-xxxhdpi │ ├── ic_launcher.png │ └── ic_launcher_round.png │ └── values │ ├── colors.xml │ ├── strings.xml │ └── styles.xml ├── build.gradle ├── config-mavencentral.gradle ├── gradle.properties ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat ├── pics ├── sample01.png ├── sample02.png ├── sample03.png └── sample04.png ├── publish-mavencentral.gradle └── settings.gradle /.gitignore: -------------------------------------------------------------------------------- 1 | # OSX 2 | *.DS_Store 3 | 4 | # Gradle files 5 | build/ 6 | .gradle/ 7 | */build/ 8 | 9 | # IDEA 10 | *.iml 11 | *.idea 12 | .idea/.name 13 | .idea/encodings.xml 14 | .idea/inspectionProfiles/Project_Default.xml 15 | .idea/inspectionProfiles/profiles_settings.xml 16 | .idea/misc.xml 17 | .idea/modules.xml 18 | .idea/scopes/scope_settings.xml 19 | .idea/vcs.xml 20 | .idea/workspace.xml 21 | .idea/libraries 22 | .idea/gradle.xml 23 | 24 | # Built application files 25 | *.apk 26 | *.ap_ 27 | 28 | # Files for the Dalvik VM 29 | *.dex 30 | 31 | # Java class files 32 | *.class 33 | 34 | # Generated files 35 | antLauncher/bin 36 | antLauncher/gen 37 | 38 | # Local configuration file (sdk path, etc) 39 | local.properties 40 | 41 | # Log Files 42 | *.log -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright 2018 LuoWenkang 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # StateFrameLayout 2 | 3 | 【不再维护,如有bug、需求,请自行clone源码修改】 4 | 5 | ## 简介 6 | 7 | 项目中经常遇到这样一种情况,新打开的界面需要加载数据,存在多种状态的结果,需要根据不同结果展示界面,这个过程归纳起来可以分为五种状态:**初始状态Init、请求状态Loading、空数据状态Empty、网络错误状态NetError、成功请求状态Content。** 如果多个界面都存在这个流程,那么封装整个过程的调用就很有必要了,既可以简化调用过程,又可以很方便的管理整个流程。 8 | 9 | `StateFrameLayout` 继承自`FrameLayout`,内部实现了一句代码切换各种状态的功能,并且内部实现了状态缓存,无需担心内存回收后重新打开界面会导致状态被重置(可打开手机开发者选项中的“不保留活动”来验证)。 10 | 11 | ## 使用 12 | 13 | **2.0.0版本和之前不兼容** 14 | 15 | 【最新版本号以[这里](https://github.com/Vanish136/StateFrameLayout/releases)为准】 16 | 17 | Gradle中引用 18 | ``` 19 | #last-version请查看上面的最新版本号 20 | #2.0.0迁移到MavenCentral后引用方式如下 21 | 22 | implementation 'com.lwkandroid.library:StateFrameLayout:last-version' 23 | ``` 24 | 25 | ### 全局配置 26 | 2.0.0版本开始支持全局配置,可统一设置公共配置,示例如下: 27 | ``` 28 | # 在Application入口处设置 29 | public class DemoApplication extends Application 30 | { 31 | @Override 32 | public void onCreate() 33 | { 34 | super.onCreate(); 35 | //全局配置 36 | StateFrameLayoutManager.getGlobalOptions() 37 | .setEmptyLayoutId(R.layout.layout_empty) //全局Empty状态的视图id 38 | .setLoadingLayoutId(R.layout.layout_loading) //全局Loading状态的视图id 39 | .setNetErrorLayoutId(R.layout.layout_net_error) //全局NetError状态的视图id 40 | .setEnableContentAnim(true) //是否允许内容视图显示动画 41 | .setContentAnim(new BaseContentAnimation()); //全局内容视图显示的动画对象,可继承BaseContentAnimation对象自定义 42 | } 43 | } 44 | ``` 45 | 46 | ### xml中定义 47 | ``` 48 | 57 | 58 | 59 | 63 | 64 | 70 | 71 | 72 | 73 | 74 | ``` 75 | 76 | ### 代码中使用 77 | ``` 78 | StateFrameLayout mStateFrameLayout = (StateFrameLayout) findViewById(R.id.stateLayout); 79 | //Empty状态的视图id 80 | mStateFrameLayout.setEmptyLayoutId(R.layout.layout_empty2); 81 | //Loading状态的视图id 82 | mStateFrameLayout.setLoadingLayoutId(R.layout.layout_loading); 83 | //NetError状态的视图id 84 | mStateFrameLayout.setNetErrorLayoutId(R.layout.layout_net_error); 85 | //设置内容视图的显示动画 86 | mStateFrameLayout.setContentAnimation(BaseContentAnimation animation); 87 | 88 | #2.1.0开始新增方法 89 | mStateFrameLayout.setEmptyView(View view); 90 | mStateFrameLayout.setLoadingView(View view); 91 | mStateFrameLayout.setNetErrorView(View view); 92 | 93 | //切换到Init初始状态,所有视图均不可见,这也是StateFrameLayout加载完成后的默认状态 94 | mStateFrameLayout.switchToInitState(); 95 | //切换到Empty状态 96 | mStateFrameLayout.switchToEmptyState(); 97 | //切换到Loading状态 98 | mStateFrameLayout.switchToLoadingState(); 99 | //切换到NetError状态 100 | mStateFrameLayout.switchToNetErrorState(); 101 | //切换到Content状态 102 | mStateFrameLayout.switchToContentState(); 103 | ``` 104 | 105 |
106 | 107 | ## 效果图 108 | ![](https://github.com/LwkCoder/StateFrameLayout/raw/master/pics/sample01.png) 109 | ![](https://github.com/LwkCoder/StateFrameLayout/raw/master/pics/sample02.png) 110 | ![](https://github.com/LwkCoder/StateFrameLayout/raw/master/pics/sample03.png) 111 | ![](https://github.com/LwkCoder/StateFrameLayout/raw/master/pics/sample04.png) 112 | 113 |
114 | 115 | ### 混淆配置 116 | 无需特别混淆规则 117 |
118 | 119 | ### 参考 120 | MaterialPageStateLayout: https://github.com/Syehunter/MaterialPageStateLayout
121 | 感谢所有为开源做出贡献的人们! -------------------------------------------------------------------------------- /StateFrameLayout/.gitignore: -------------------------------------------------------------------------------- 1 | /build 2 | -------------------------------------------------------------------------------- /StateFrameLayout/build.gradle: -------------------------------------------------------------------------------- 1 | apply plugin: 'com.android.library' 2 | apply from: "${rootProject.projectDir}/publish-mavencentral.gradle" 3 | 4 | android { 5 | compileSdkVersion COMPILE_SDK_VERSION as int 6 | // buildToolsVersion BUILD_TOOLS_VERSION 7 | 8 | defaultConfig { 9 | minSdkVersion MIN_SDK_VERSION as int 10 | targetSdkVersion TARGET_SDK_VERSION as int 11 | } 12 | } 13 | 14 | dependencies { 15 | implementation fileTree(dir: 'libs', include: ['*.jar']) 16 | compileOnly "androidx.annotation:annotation:${AppcompatVersion}" 17 | } 18 | 19 | allprojects { 20 | tasks.withType(Javadoc) {//兼容中文字符 21 | options { 22 | encoding "UTF-8" 23 | charSet 'UTF-8' 24 | links "http://docs.oracle.com/javase/7/docs/api" 25 | } 26 | } 27 | } -------------------------------------------------------------------------------- /StateFrameLayout/proguard-rules.pro: -------------------------------------------------------------------------------- 1 | # Add project specific ProGuard rules here. 2 | # By default, the flags in this file are appended to flags specified 3 | # in C:\AndroidDev\Sdk/tools/proguard/proguard-android.txt 4 | # You can edit the include path and order by changing the proguardFiles 5 | # directive in build.gradle. 6 | # 7 | # For more details, see 8 | # http://developer.android.com/guide/developing/tools/proguard.html 9 | 10 | # Add any project specific keep options here: 11 | 12 | # If your project uses WebView with JS, uncomment the following 13 | # and specify the fully qualified class name to the JavaScript interface 14 | # class: 15 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview { 16 | # public *; 17 | #} 18 | 19 | # Uncomment this to preserve the line number information for 20 | # debugging stack traces. 21 | #-keepattributes SourceFile,LineNumberTable 22 | 23 | # If you keep the line number information, uncomment this to 24 | # hide the original source file name. 25 | #-renamesourcefileattribute SourceFile 26 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 3 | 4 | 7 | 8 | 9 | 10 | 11 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/java/com/lwkandroid/widget/AlphaContentAnimation.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.widget; 2 | 3 | import android.animation.Animator; 4 | import android.animation.ObjectAnimator; 5 | import android.view.View; 6 | 7 | /** 8 | * Description:透明渐变动画 9 | * 10 | * @author LWK 11 | * @date 2019/6/12 12 | */ 13 | final class AlphaContentAnimation extends BaseContentAnimation 14 | { 15 | @Override 16 | public Animator[] getAnimator(View v) 17 | { 18 | return new Animator[]{ObjectAnimator.ofFloat(v, "alpha", 0f, 1f)}; 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/java/com/lwkandroid/widget/BaseContentAnimation.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.widget; 2 | 3 | import android.animation.Animator; 4 | import android.view.View; 5 | import android.view.animation.Interpolator; 6 | import android.view.animation.LinearInterpolator; 7 | 8 | /** 9 | * Description:内容视图的动画基类 10 | * 11 | * @author LWK 12 | * @date 2019/6/12 13 | */ 14 | public abstract class BaseContentAnimation 15 | { 16 | /** 17 | * 动画加速器:默认为LinearInterpolator 18 | */ 19 | private Interpolator mInterpolator = new LinearInterpolator(); 20 | 21 | /** 22 | * 动画持续时间:默认为200ms 23 | */ 24 | private long mAnimDuration = 200; 25 | 26 | /** 27 | * 设置动画加速器 28 | */ 29 | public void setInterpolator(Interpolator interpolator) 30 | { 31 | this.mInterpolator = interpolator; 32 | } 33 | 34 | /** 35 | * 设置动画持续时间 36 | */ 37 | public void setAnimDuration(long animDuration) 38 | { 39 | this.mAnimDuration = animDuration; 40 | } 41 | 42 | /** 43 | * 子类实现此方法决定动画类型 44 | * 45 | * @param v 执行动画的View 46 | * @return 47 | */ 48 | public abstract Animator[] getAnimator(View v); 49 | 50 | /** 51 | * 开始动画 52 | */ 53 | public void startAnim(View v) 54 | { 55 | Animator[] animators = getAnimator(v); 56 | for (Animator animator : animators) 57 | { 58 | animator.setDuration(mAnimDuration); 59 | animator.setInterpolator(mInterpolator); 60 | animator.start(); 61 | } 62 | } 63 | } 64 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/java/com/lwkandroid/widget/LayoutState.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.widget; 2 | 3 | import java.lang.annotation.Retention; 4 | import java.lang.annotation.RetentionPolicy; 5 | 6 | import androidx.annotation.IntDef; 7 | 8 | /** 9 | * Description:状态值 10 | * 11 | * @author LWK 12 | * @date 2019/6/11 13 | */ 14 | @IntDef({StateConstants.NONE, 15 | StateConstants.INIT, 16 | StateConstants.LOADING, 17 | StateConstants.EMPTY, 18 | StateConstants.NET_ERROR, 19 | StateConstants.CONTENT}) 20 | @Retention(RetentionPolicy.SOURCE) 21 | public @interface LayoutState 22 | { 23 | } 24 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/java/com/lwkandroid/widget/StateConstants.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.widget; 2 | 3 | /** 4 | * Description:状态常量 5 | * 6 | * @author LWK 7 | * @date 2019/6/11 8 | */ 9 | final class StateConstants 10 | { 11 | /** 12 | * 无状态,只在StateFrameLayout初始化时作占位,防止初始化后无法切到INIT状态 13 | */ 14 | static final int NONE = 100; 15 | /** 16 | * 初始状态,不显示任何View 17 | */ 18 | static final int INIT = NONE << 1; 19 | /** 20 | * 请求数据 21 | */ 22 | static final int LOADING = NONE << 2; 23 | /** 24 | * 空数据 25 | */ 26 | static final int EMPTY = NONE << 3; 27 | /** 28 | * 网络异常 29 | */ 30 | static final int NET_ERROR = NONE << 4; 31 | /** 32 | * 正常显示 33 | */ 34 | static final int CONTENT = NONE << 5; 35 | 36 | static final String TAG_INIT = "init"; 37 | static final String TAG_LOADING = "loading"; 38 | static final String TAG_EMPTY = "empty"; 39 | static final String TAG_ERROR = "error"; 40 | static final String TAG_CONTENT = "content"; 41 | } 42 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/java/com/lwkandroid/widget/StateFrameLayout.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.widget; 2 | 3 | import android.content.Context; 4 | import android.content.res.TypedArray; 5 | import android.os.Parcel; 6 | import android.os.Parcelable; 7 | import android.util.AttributeSet; 8 | import android.view.LayoutInflater; 9 | import android.view.View; 10 | import android.widget.FrameLayout; 11 | 12 | import com.lwkandroid.stateframelayout.R; 13 | 14 | import androidx.annotation.LayoutRes; 15 | 16 | /** 17 | * 配合各状态切换的FrameLayout 18 | * 19 | * @author LWK 20 | */ 21 | public class StateFrameLayout extends FrameLayout 22 | { 23 | /** 24 | * Loading视图布局id 25 | */ 26 | private int mLoadingLayoutId = -1; 27 | /** 28 | * Empty视图布局id 29 | */ 30 | private int mEmptyLayoutId = -1; 31 | /** 32 | * NetError视图布局id 33 | */ 34 | private int mNetErrorLayoutId = -1; 35 | /** 36 | * 内容视图显示动画 37 | */ 38 | private boolean mEnableContentAnim = StateFrameLayoutManager.getGlobalOptions().isEnableContentAnim(); 39 | /** 40 | * 当前状态 41 | */ 42 | @LayoutState 43 | private int mCurState = StateConstants.NONE; 44 | /** 45 | * 内容视图动画 46 | */ 47 | private BaseContentAnimation mContentAnimation = StateFrameLayoutManager.getGlobalOptions().getContentAnim(); 48 | /** 49 | * 是否初始化完成 50 | */ 51 | private boolean mHasInit = false; 52 | 53 | public StateFrameLayout(Context context) 54 | { 55 | super(context); 56 | init(context, null); 57 | } 58 | 59 | public StateFrameLayout(Context context, AttributeSet attrs) 60 | { 61 | super(context, attrs); 62 | init(context, attrs); 63 | } 64 | 65 | @Override 66 | protected void onFinishInflate() 67 | { 68 | super.onFinishInflate(); 69 | if (!mHasInit) 70 | { 71 | if (getChildCount() > 0) 72 | { 73 | getChildAt(0).setTag(StateConstants.TAG_CONTENT); 74 | } 75 | setChildViewWithTag(StateConstants.TAG_EMPTY, inflateChildLayout(mEmptyLayoutId)); 76 | setChildViewWithTag(StateConstants.TAG_LOADING, inflateChildLayout(mLoadingLayoutId)); 77 | setChildViewWithTag(StateConstants.TAG_ERROR, inflateChildLayout(mNetErrorLayoutId)); 78 | 79 | //切换到初始状态 80 | switchToInitState(); 81 | mHasInit = true; 82 | } 83 | } 84 | 85 | private void init(Context context, AttributeSet attrs) 86 | { 87 | //获取自定义属性 88 | TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.StateFrameLayout); 89 | if (ta != null) 90 | { 91 | mLoadingLayoutId = ta.getResourceId(R.styleable.StateFrameLayout_loadingLayoutResId, 92 | StateFrameLayoutManager.getGlobalOptions().getLoadingLayoutId()); 93 | mEmptyLayoutId = ta.getResourceId(R.styleable.StateFrameLayout_emptyLayoutResId, 94 | StateFrameLayoutManager.getGlobalOptions().getEmptyLayoutId()); 95 | mNetErrorLayoutId = ta.getResourceId(R.styleable.StateFrameLayout_netErrorLayoutResId, 96 | StateFrameLayoutManager.getGlobalOptions().getNetErrorLayoutId()); 97 | mEnableContentAnim = ta.getBoolean(R.styleable.StateFrameLayout_enableContentAnim, 98 | StateFrameLayoutManager.getGlobalOptions().isEnableContentAnim()); 99 | ta.recycle(); 100 | } 101 | } 102 | 103 | /** 104 | * 切换到初始状态,所有View都隐藏 105 | */ 106 | public void switchToInitState() 107 | { 108 | realSwitchState(StateConstants.INIT); 109 | } 110 | 111 | /** 112 | * 切换到Empty状态 113 | */ 114 | public void switchToEmptyState() 115 | { 116 | realSwitchState(StateConstants.EMPTY); 117 | } 118 | 119 | /** 120 | * 切换到Loading状态 121 | */ 122 | public void switchToLoadingState() 123 | { 124 | realSwitchState(StateConstants.LOADING); 125 | } 126 | 127 | /** 128 | * 切换到NetError状态 129 | */ 130 | public void switchToNetErrorState() 131 | { 132 | realSwitchState(StateConstants.NET_ERROR); 133 | } 134 | 135 | /** 136 | * 切换到Content状态 137 | */ 138 | public void switchToContentState() 139 | { 140 | realSwitchState(StateConstants.CONTENT); 141 | } 142 | 143 | /** 144 | * 设置Empty状态的布局id 145 | * 146 | * @param layoutId 147 | */ 148 | public void setEmptyLayoutId(@LayoutRes int layoutId) 149 | { 150 | this.mEmptyLayoutId = layoutId; 151 | setEmptyView(inflateChildLayout(mEmptyLayoutId)); 152 | } 153 | 154 | /** 155 | * 【2.1.0版本新增】 156 | * 设置Empty状态对应的View 157 | * 158 | * @param view 159 | */ 160 | public void setEmptyView(View view) 161 | { 162 | setChildViewWithTag(StateConstants.TAG_EMPTY, view); 163 | } 164 | 165 | /** 166 | * 设置Loading状态的布局id 167 | * 168 | * @param layoutId 169 | */ 170 | public void setLoadingLayoutId(@LayoutRes int layoutId) 171 | { 172 | this.mLoadingLayoutId = layoutId; 173 | setLoadingView(inflateChildLayout(mLoadingLayoutId)); 174 | } 175 | 176 | /** 177 | * 【2.1.0版本新增】 178 | * 设置Loading状态对应的View 179 | * 180 | * @param view 181 | */ 182 | public void setLoadingView(View view) 183 | { 184 | setChildViewWithTag(StateConstants.TAG_LOADING, view); 185 | } 186 | 187 | /** 188 | * 设置NetError状态的布局id 189 | * 190 | * @param layoutId 191 | */ 192 | public void setNetErrorLayoutId(@LayoutRes int layoutId) 193 | { 194 | this.mNetErrorLayoutId = layoutId; 195 | setNetErrorView(inflateChildLayout(mNetErrorLayoutId)); 196 | } 197 | 198 | /** 199 | * 【2.1.0版本新增】 200 | * 设置NetError状态对应的View 201 | * 202 | * @param view 203 | */ 204 | public void setNetErrorView(View view) 205 | { 206 | setChildViewWithTag(StateConstants.TAG_ERROR, view); 207 | } 208 | 209 | /** 210 | * 设置内容视图的显示动画 211 | * 212 | * @param animation 213 | */ 214 | public void setContentAnimation(BaseContentAnimation animation) 215 | { 216 | this.mContentAnimation = animation; 217 | } 218 | 219 | private View inflateChildLayout(@LayoutRes int layoutId) 220 | { 221 | View view = null; 222 | try 223 | { 224 | view = LayoutInflater.from(getContext()).inflate(layoutId, this, false); 225 | } catch (Exception e) 226 | { 227 | e.printStackTrace(); 228 | } 229 | 230 | return view; 231 | } 232 | 233 | /** 234 | * 除了指定Tag的View外,隐藏其他全部View 235 | * 236 | * @param tag 237 | * @return 指定的View 238 | */ 239 | private View hideViewsExcept(Object tag) 240 | { 241 | View indexChild = null; 242 | for (int i = 0, count = getChildCount(); i < count; i++) 243 | { 244 | View child = getChildAt(i); 245 | if (tag != null && tag == child.getTag()) 246 | { 247 | child.setVisibility(VISIBLE); 248 | indexChild = child; 249 | } else 250 | { 251 | child.setVisibility(GONE); 252 | } 253 | } 254 | return indexChild; 255 | } 256 | 257 | /** 258 | * 获取当前状态 259 | */ 260 | public int getCurrentState() 261 | { 262 | return mCurState; 263 | } 264 | 265 | /** 266 | * 是否开启内容布局显示动画 267 | */ 268 | public void enableContentAnim(boolean enable) 269 | { 270 | this.mEnableContentAnim = enable; 271 | } 272 | 273 | /** 274 | * 内部执行切换状态的方法 275 | * 276 | * @param targetState 目标状态 277 | */ 278 | private void realSwitchState(int targetState) 279 | { 280 | if (mCurState == targetState) 281 | { 282 | return; 283 | } 284 | 285 | if (StateConstants.INIT == targetState) 286 | { 287 | hideViewsExcept(StateConstants.TAG_INIT); 288 | } else if (StateConstants.EMPTY == targetState) 289 | { 290 | hideViewsExcept(StateConstants.TAG_EMPTY); 291 | } else if (StateConstants.LOADING == targetState) 292 | { 293 | hideViewsExcept(StateConstants.TAG_LOADING); 294 | } else if (StateConstants.NET_ERROR == targetState) 295 | { 296 | hideViewsExcept(StateConstants.TAG_ERROR); 297 | } else if (StateConstants.CONTENT == targetState) 298 | { 299 | View contentView = hideViewsExcept(StateConstants.TAG_CONTENT); 300 | if (mEnableContentAnim && mContentAnimation != null 301 | && contentView != null) 302 | { 303 | mContentAnimation.startAnim(contentView); 304 | } 305 | } 306 | mCurState = targetState; 307 | } 308 | 309 | /** 310 | * 根据Tag设置子View 311 | * 312 | * @param tag 313 | * @param childView 314 | */ 315 | private void setChildViewWithTag(Object tag, View childView) 316 | { 317 | int visibility = View.GONE; 318 | for (int i = 0, count = getChildCount(); i < count; i++) 319 | { 320 | View child = getChildAt(i); 321 | if (tag == child.getTag()) 322 | { 323 | //存在相同tag的view需要先移除 324 | visibility = child.getVisibility(); 325 | removeView(child); 326 | break; 327 | } 328 | } 329 | 330 | if (childView != null) 331 | { 332 | childView.setTag(tag); 333 | addView(childView); 334 | childView.setVisibility(visibility); 335 | } 336 | } 337 | 338 | /****************************************************** 状态恢复 ***********************************************************************/ 339 | 340 | @Override 341 | protected Parcelable onSaveInstanceState() 342 | { 343 | SavedViewState state = new SavedViewState(super.onSaveInstanceState()); 344 | state.loadingId = mLoadingLayoutId; 345 | state.emptyId = mEmptyLayoutId; 346 | state.netErrorId = mNetErrorLayoutId; 347 | state.lastState = mCurState; 348 | state.enableAnim = mEnableContentAnim; 349 | return state; 350 | } 351 | 352 | @Override 353 | protected void onRestoreInstanceState(Parcelable state) 354 | { 355 | if (!(state instanceof SavedViewState)) 356 | { 357 | super.onRestoreInstanceState(state); 358 | return; 359 | } 360 | 361 | SavedViewState ss = (SavedViewState) state; 362 | super.onRestoreInstanceState(ss); 363 | 364 | mLoadingLayoutId = ss.loadingId; 365 | mEmptyLayoutId = ss.emptyId; 366 | mNetErrorLayoutId = ss.netErrorId; 367 | mEnableContentAnim = ss.enableAnim; 368 | realSwitchState(ss.lastState); 369 | } 370 | 371 | static class SavedViewState extends BaseSavedState 372 | { 373 | int loadingId; 374 | int emptyId; 375 | int netErrorId; 376 | int lastState; 377 | boolean enableAnim; 378 | 379 | SavedViewState(Parcelable superState) 380 | { 381 | super(superState); 382 | } 383 | 384 | private SavedViewState(Parcel source) 385 | { 386 | super(source); 387 | loadingId = source.readInt(); 388 | emptyId = source.readInt(); 389 | netErrorId = source.readInt(); 390 | lastState = source.readInt(); 391 | enableAnim = source.readByte() == (byte) 1; 392 | } 393 | 394 | @Override 395 | public void writeToParcel(Parcel out, int flags) 396 | { 397 | super.writeToParcel(out, flags); 398 | out.writeInt(loadingId); 399 | out.writeInt(emptyId); 400 | out.writeInt(netErrorId); 401 | out.writeInt(lastState); 402 | out.writeByte(enableAnim ? (byte) 1 : (byte) 0); 403 | } 404 | 405 | public static final Parcelable.Creator CREATOR = new Creator() 406 | { 407 | @Override 408 | public SavedViewState createFromParcel(Parcel source) 409 | { 410 | return new SavedViewState(source); 411 | } 412 | 413 | @Override 414 | public SavedViewState[] newArray(int size) 415 | { 416 | return new SavedViewState[size]; 417 | } 418 | }; 419 | } 420 | } 421 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/java/com/lwkandroid/widget/StateFrameLayoutManager.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.widget; 2 | 3 | /** 4 | * Description:管理类 5 | * 6 | * @author LWK 7 | * @date 2019/6/12 8 | */ 9 | public final class StateFrameLayoutManager 10 | { 11 | static 12 | { 13 | GLOBAL_OPTIONS = new StateGlobalOptions(); 14 | } 15 | 16 | private static final StateGlobalOptions GLOBAL_OPTIONS; 17 | 18 | private StateFrameLayoutManager() 19 | { 20 | } 21 | 22 | public static StateGlobalOptions getGlobalOptions() 23 | { 24 | return GLOBAL_OPTIONS; 25 | } 26 | } 27 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/java/com/lwkandroid/widget/StateGlobalOptions.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.widget; 2 | 3 | import androidx.annotation.LayoutRes; 4 | 5 | /** 6 | * Description: 全局配置 7 | * 8 | * @author LWK 9 | * @date 2019/6/11 10 | */ 11 | public final class StateGlobalOptions 12 | { 13 | private @LayoutRes 14 | int mEmptyLayoutId = -1; 15 | private @LayoutRes 16 | int mNetErrorLayoutId = -1; 17 | private @LayoutRes 18 | int mLoadingLayoutId = -1; 19 | private boolean mEnableContentAnim; 20 | private BaseContentAnimation mContentAnim = new AlphaContentAnimation(); 21 | 22 | public int getEmptyLayoutId() 23 | { 24 | return mEmptyLayoutId; 25 | } 26 | 27 | public StateGlobalOptions setEmptyLayoutId(@LayoutRes int layoutId) 28 | { 29 | this.mEmptyLayoutId = layoutId; 30 | return this; 31 | } 32 | 33 | public int getNetErrorLayoutId() 34 | { 35 | return mNetErrorLayoutId; 36 | } 37 | 38 | public StateGlobalOptions setNetErrorLayoutId(@LayoutRes int layoutId) 39 | { 40 | this.mNetErrorLayoutId = layoutId; 41 | return this; 42 | } 43 | 44 | public int getLoadingLayoutId() 45 | { 46 | return mLoadingLayoutId; 47 | } 48 | 49 | public StateGlobalOptions setLoadingLayoutId(@LayoutRes int layoutId) 50 | { 51 | this.mLoadingLayoutId = layoutId; 52 | return this; 53 | } 54 | 55 | public boolean isEnableContentAnim() 56 | { 57 | return mEnableContentAnim; 58 | } 59 | 60 | public StateGlobalOptions setEnableContentAnim(boolean enable) 61 | { 62 | this.mEnableContentAnim = enable; 63 | return this; 64 | } 65 | 66 | public BaseContentAnimation getContentAnim() 67 | { 68 | return mContentAnim; 69 | } 70 | 71 | public StateGlobalOptions setContentAnim(BaseContentAnimation animation) 72 | { 73 | this.mContentAnim = animation; 74 | return this; 75 | } 76 | } 77 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/res/values/attrs.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /StateFrameLayout/src/main/res/values/strings.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | -------------------------------------------------------------------------------- /app/.gitignore: -------------------------------------------------------------------------------- 1 | /build 2 | -------------------------------------------------------------------------------- /app/build.gradle: -------------------------------------------------------------------------------- 1 | apply plugin: 'com.android.application' 2 | 3 | android { 4 | compileSdkVersion COMPILE_SDK_VERSION as int 5 | // buildToolsVersion BUILD_TOOLS_VERSION 6 | 7 | defaultConfig { 8 | applicationId APPLICATION_ID 9 | minSdkVersion MIN_SDK_VERSION as int 10 | targetSdkVersion TARGET_SDK_VERSION as int 11 | 12 | versionCode VERSION_CODE as int 13 | versionName VERSION_NAME 14 | } 15 | 16 | buildTypes { 17 | release { 18 | minifyEnabled false 19 | proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 20 | } 21 | } 22 | } 23 | 24 | dependencies { 25 | implementation fileTree(dir: 'libs', include: ['*.jar']) 26 | implementation "androidx.appcompat:appcompat:$AppcompatVersion" 27 | implementation project(':StateFrameLayout') 28 | } 29 | -------------------------------------------------------------------------------- /app/proguard-rules.pro: -------------------------------------------------------------------------------- 1 | # Add project specific ProGuard rules here. 2 | # By default, the flags in this file are appended to flags specified 3 | # in C:\AndroidDev\Sdk/tools/proguard/proguard-android.txt 4 | # You can edit the include path and order by changing the proguardFiles 5 | # directive in build.gradle. 6 | # 7 | # For more details, see 8 | # http://developer.android.com/guide/developing/tools/proguard.html 9 | 10 | # Add any project specific keep options here: 11 | 12 | # If your project uses WebView with JS, uncomment the following 13 | # and specify the fully qualified class name to the JavaScript interface 14 | # class: 15 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview { 16 | # public *; 17 | #} 18 | 19 | # Uncomment this to preserve the line number information for 20 | # debugging stack traces. 21 | #-keepattributes SourceFile,LineNumberTable 22 | 23 | # If you keep the line number information, uncomment this to 24 | # hide the original source file name. 25 | #-renamesourcefileattribute SourceFile 26 | -------------------------------------------------------------------------------- /app/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 5 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | -------------------------------------------------------------------------------- /app/src/main/java/com/lwkandroid/statelayoutdemo/DemoApplication.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.statelayoutdemo; 2 | 3 | import android.app.Application; 4 | 5 | import com.lwkandroid.widget.StateFrameLayoutManager; 6 | 7 | /** 8 | * Description: 9 | * 10 | * @author LWK 11 | * @date 2019/6/12 12 | */ 13 | public class DemoApplication extends Application 14 | { 15 | @Override 16 | public void onCreate() 17 | { 18 | super.onCreate(); 19 | //全局配置 20 | StateFrameLayoutManager.getGlobalOptions() 21 | .setEmptyLayoutId(R.layout.layout_empty) 22 | .setLoadingLayoutId(R.layout.layout_loading) 23 | .setNetErrorLayoutId(R.layout.layout_net_error) 24 | .setEnableContentAnim(true); 25 | } 26 | } 27 | -------------------------------------------------------------------------------- /app/src/main/java/com/lwkandroid/statelayoutdemo/MainActivity.java: -------------------------------------------------------------------------------- 1 | package com.lwkandroid.statelayoutdemo; 2 | 3 | import android.os.Bundle; 4 | import android.view.LayoutInflater; 5 | import android.widget.Toast; 6 | 7 | import com.lwkandroid.widget.StateFrameLayout; 8 | 9 | import androidx.appcompat.app.AppCompatActivity; 10 | 11 | public class MainActivity extends AppCompatActivity 12 | { 13 | StateFrameLayout mStateFrameLayout; 14 | 15 | @Override 16 | protected void onCreate(Bundle savedInstanceState) 17 | { 18 | super.onCreate(savedInstanceState); 19 | setContentView(R.layout.activity_main); 20 | 21 | mStateFrameLayout = findViewById(R.id.stateLayout); 22 | mStateFrameLayout.setEmptyLayoutId(R.layout.layout_empty2); 23 | mStateFrameLayout.setLoadingView(LayoutInflater.from(MainActivity.this).inflate(R.layout.layout_loading2, null)); 24 | 25 | mStateFrameLayout.findViewById(R.id.btn_empty_retry) 26 | .setOnClickListener(v -> Toast.makeText(MainActivity.this, "点击Empty重试", Toast.LENGTH_SHORT).show()); 27 | mStateFrameLayout.findViewById(R.id.btn_net_error_retry) 28 | .setOnClickListener(v -> Toast.makeText(MainActivity.this, "点击NetError重试", Toast.LENGTH_SHORT).show()); 29 | 30 | findViewById(R.id.btn_loading).setOnClickListener(v -> mStateFrameLayout.switchToLoadingState()); 31 | findViewById(R.id.btn_empty).setOnClickListener(v -> mStateFrameLayout.switchToEmptyState()); 32 | findViewById(R.id.btn_net_error).setOnClickListener(v -> mStateFrameLayout.switchToNetErrorState()); 33 | findViewById(R.id.btn_content).setOnClickListener(v -> mStateFrameLayout.switchToContentState()); 34 | } 35 | } 36 | -------------------------------------------------------------------------------- /app/src/main/res/layout/activity_main.xml: -------------------------------------------------------------------------------- 1 | 2 | 10 | 11 | 15 | 16 |