28 | * The main purpose of using this drawable is to set its 29 | * background color dynamically during runtime. 30 | *
31 | * 32 | * @author pabhinav (pabhinav@iitrpr.ac.in) 33 | */ 34 | public class CircleDrawable extends Drawable { 35 | 36 | /** 37 | * {@link Paint} object used to draw on {@link Canvas}. 38 | */ 39 | Paint mPaint; 40 | 41 | /** 42 | * {@link RectF} holds four float coordinates for a rectangle. The rectangle is 43 | * represented by the coordinates of its 4 edges (left, top, right bottom). 44 | */ 45 | RectF mRectF; 46 | 47 | /** 48 | * Constructor for this class. 49 | * 50 | *51 | * Used to initialize {@link Paint} object and {@link RectF} object. 52 | *
53 | * @param backgroundColor is the color resource used to render background 54 | * of this circle/oval drawable object. 55 | */ 56 | public CircleDrawable(int backgroundColor) { 57 | 58 | this.mPaint = new Paint(Paint.ANTI_ALIAS_FLAG); 59 | mPaint.setStyle(Paint.Style.FILL); 60 | mPaint.setColor(backgroundColor); 61 | 62 | this.mRectF = new RectF(); 63 | } 64 | 65 | /** 66 | * Draws on {@link Canvas} object. 67 | *68 | * Identifies the {@link Canvas} bounds, and detect whether width and 69 | * height is identical or not. If width is not equal to height, this 70 | * means one need to draw oval, else circle. It uses drawOval and 71 | * drawCircle methods of {@link Canvas} object. 72 | *
73 | * 74 | * @param canvas The canvas to draw into 75 | */ 76 | @Override 77 | public void draw(Canvas canvas) { 78 | 79 | /** Fetch the width and height of bounds of canvas **/ 80 | int height = getBounds().height(); 81 | int width = getBounds().width(); 82 | 83 | /** Draw Oval if height and width are not equal **/ 84 | if (width != height) { 85 | mRectF.left = 0.0f; 86 | mRectF.top = 0.0f; 87 | mRectF.right = width; 88 | mRectF.bottom = height; 89 | canvas.drawOval(mRectF, mPaint); 90 | } 91 | /** Else draw circle **/ 92 | else { 93 | canvas.drawCircle(height / 2, width / 2, width / 2, mPaint); 94 | } 95 | } 96 | 97 | /** 98 | * Specify an alpha value for the drawable. 99 | * This alpha is used to set alpha value for {@link Paint} object. 100 | */ 101 | @Override 102 | public void setAlpha(int alpha) { 103 | mPaint.setAlpha(alpha); 104 | } 105 | 106 | /** 107 | * Specify an optional color filter for the drawable. 108 | * The color filter is set for {@link Paint} object. 109 | * 110 | * @param colorFilter The color filter to apply, or {@code null} to remove the 111 | * existing color filter 112 | */ 113 | @Override 114 | public void setColorFilter(ColorFilter colorFilter) { 115 | mPaint.setColorFilter(colorFilter); 116 | } 117 | 118 | /** 119 | * Return the opacity/transparency of this Drawable. 120 | * Opacity is set to {@link android.graphics.PixelFormat#OPAQUE}. 121 | */ 122 | @Override 123 | public int getOpacity() { 124 | return PixelFormat.OPAQUE; 125 | } 126 | } 127 | -------------------------------------------------------------------------------- /app/src/main/java/com/pabhinav/zsrv/zstacklistview/DummyData.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2016 Abhinav Puri 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | package com.pabhinav.zsrv.zstacklistview; 17 | 18 | /** 19 | * Dummy data holding class. 20 | * It has some static methods for fetching some dummy intities. 21 | * 22 | * @author pabhinav (pabhinav@iitrpr.ac.in) 23 | */ 24 | public class DummyData { 25 | 26 | /** Counters **/ 27 | private static int counterForLocation; 28 | private static int counterForName; 29 | private static int counterForTimePassed; 30 | 31 | /** Initializing counters **/ 32 | static { 33 | counterForLocation = 0; 34 | counterForName = 0; 35 | counterForTimePassed = 0; 36 | } 37 | 38 | /** 39 | * Used to fetch some random locations in the world. 40 | * 41 | * @return Country name. 42 | */ 43 | public static String dummyLocation(){ 44 | checkCounterForOverflow(); 45 | String locations[] = new String [] { 46 | "France", 47 | "London", 48 | "USA", 49 | "Canada", 50 | "Italy", 51 | "South America", 52 | "Australia", 53 | "South Africa", 54 | "Hungary", 55 | "Portugal", 56 | "India", 57 | "Singapore", 58 | "China", 59 | "Japan", 60 | "Korea", 61 | "Hong Kong", 62 | "Antartica", 63 | "Russia", 64 | "Germany", 65 | "Sri Lanka" 66 | }; 67 | return locations[counterForLocation++]; 68 | } 69 | 70 | /** 71 | * Used to fetch some dummy time passed, till last user login. 72 | * 73 | * @return time passed till last login. 74 | */ 75 | public static String dummyTimePassed(){ 76 | checkCounterForOverflow(); 77 | String timePassed[] = new String [] { 78 | "10min ago", 79 | "1min ago", 80 | "2min ago", 81 | "long time ago", 82 | "5min ago", 83 | "Now", 84 | "yesterday", 85 | "2days ago", 86 | "5days ago", 87 | "1month ago", 88 | "2month ago", 89 | "5month ago", 90 | "1year ago", 91 | "2year ago", 92 | "5year ago", 93 | "1min ago", 94 | "2min ago", 95 | "long time ago", 96 | "5min ago", 97 | "Now" 98 | }; 99 | return timePassed[counterForTimePassed++]; 100 | } 101 | 102 | /** 103 | * Used to fetch name of person. 104 | * 105 | * @return name of a person. 106 | */ 107 | public static String dummyName(){ 108 | checkCounterForOverflow(); 109 | String names[] = new String[] { 110 | "Zlatan Ibrahimovic", 111 | "Lionel Messi", 112 | "Joan Kim", 113 | "Billy Foster", 114 | "Patrick Vierra", 115 | "Marie Crawfrod", 116 | "Sean White", 117 | "Christian White", 118 | "Bruce Brown", 119 | "Ashley Martinez", 120 | "Jennifer Guerro", 121 | "Didier Drogba", 122 | "Robbin Johnson", 123 | "Abhinav Puri", 124 | "Steve Thomas", 125 | "Quarentino Jeorge", 126 | "Klevtov Whiskey", 127 | "Nurik Roman", 128 | "Cattie Pack", 129 | "Ellie Johnson" 130 | }; 131 | return names[counterForName++]; 132 | } 133 | 134 | /** 135 | * Resets all counters to its initial starting value. 136 | */ 137 | public static void resetAllCounters(){ 138 | counterForTimePassed = 0; 139 | counterForLocation = 0; 140 | counterForName = 0; 141 | } 142 | 143 | /** 144 | * If counter overflow, i.e., crosses the index of dummy 145 | * list data, then need to begin again, which gives it 146 | * cyclic property. 147 | */ 148 | private static void checkCounterForOverflow(){ 149 | if(counterForName >= 20){ 150 | counterForName = 0; 151 | } else if(counterForTimePassed >= 20){ 152 | counterForTimePassed = 0; 153 | } else if(counterForLocation >= 20){ 154 | counterForLocation = 0; 155 | } 156 | } 157 | 158 | } 159 | -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env bash 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 10 | DEFAULT_JVM_OPTS="" 11 | 12 | APP_NAME="Gradle" 13 | APP_BASE_NAME=`basename "$0"` 14 | 15 | # Use the maximum available, or set MAX_FD != -1 to use that value. 16 | MAX_FD="maximum" 17 | 18 | warn ( ) { 19 | echo "$*" 20 | } 21 | 22 | die ( ) { 23 | echo 24 | echo "$*" 25 | echo 26 | exit 1 27 | } 28 | 29 | # OS specific support (must be 'true' or 'false'). 30 | cygwin=false 31 | msys=false 32 | darwin=false 33 | case "`uname`" in 34 | CYGWIN* ) 35 | cygwin=true 36 | ;; 37 | Darwin* ) 38 | darwin=true 39 | ;; 40 | MINGW* ) 41 | msys=true 42 | ;; 43 | esac 44 | 45 | # Attempt to set APP_HOME 46 | # Resolve links: $0 may be a link 47 | PRG="$0" 48 | # Need this for relative symlinks. 49 | while [ -h "$PRG" ] ; do 50 | ls=`ls -ld "$PRG"` 51 | link=`expr "$ls" : '.*-> \(.*\)$'` 52 | if expr "$link" : '/.*' > /dev/null; then 53 | PRG="$link" 54 | else 55 | PRG=`dirname "$PRG"`"/$link" 56 | fi 57 | done 58 | SAVED="`pwd`" 59 | cd "`dirname \"$PRG\"`/" >/dev/null 60 | APP_HOME="`pwd -P`" 61 | cd "$SAVED" >/dev/null 62 | 63 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 64 | 65 | # Determine the Java command to use to start the JVM. 66 | if [ -n "$JAVA_HOME" ] ; then 67 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 68 | # IBM's JDK on AIX uses strange locations for the executables 69 | JAVACMD="$JAVA_HOME/jre/sh/java" 70 | else 71 | JAVACMD="$JAVA_HOME/bin/java" 72 | fi 73 | if [ ! -x "$JAVACMD" ] ; then 74 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 75 | 76 | Please set the JAVA_HOME variable in your environment to match the 77 | location of your Java installation." 78 | fi 79 | else 80 | JAVACMD="java" 81 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 82 | 83 | Please set the JAVA_HOME variable in your environment to match the 84 | location of your Java installation." 85 | fi 86 | 87 | # Increase the maximum file descriptors if we can. 88 | if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then 89 | MAX_FD_LIMIT=`ulimit -H -n` 90 | if [ $? -eq 0 ] ; then 91 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 92 | MAX_FD="$MAX_FD_LIMIT" 93 | fi 94 | ulimit -n $MAX_FD 95 | if [ $? -ne 0 ] ; then 96 | warn "Could not set maximum file descriptor limit: $MAX_FD" 97 | fi 98 | else 99 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 100 | fi 101 | fi 102 | 103 | # For Darwin, add options to specify how the application appears in the dock 104 | if $darwin; then 105 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 106 | fi 107 | 108 | # For Cygwin, switch paths to Windows format before running java 109 | if $cygwin ; then 110 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 111 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 112 | JAVACMD=`cygpath --unix "$JAVACMD"` 113 | 114 | # We build the pattern for arguments to be converted via cygpath 115 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 116 | SEP="" 117 | for dir in $ROOTDIRSRAW ; do 118 | ROOTDIRS="$ROOTDIRS$SEP$dir" 119 | SEP="|" 120 | done 121 | OURCYGPATTERN="(^($ROOTDIRS))" 122 | # Add a user-defined pattern to the cygpath arguments 123 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 124 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 125 | fi 126 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 127 | i=0 128 | for arg in "$@" ; do 129 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 130 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 131 | 132 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 133 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 134 | else 135 | eval `echo args$i`="\"$arg\"" 136 | fi 137 | i=$((i+1)) 138 | done 139 | case $i in 140 | (0) set -- ;; 141 | (1) set -- "$args0" ;; 142 | (2) set -- "$args0" "$args1" ;; 143 | (3) set -- "$args0" "$args1" "$args2" ;; 144 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 145 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 146 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 147 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 148 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 149 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 150 | esac 151 | fi 152 | 153 | # Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules 154 | function splitJvmOpts() { 155 | JVM_OPTS=("$@") 156 | } 157 | eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS 158 | JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME" 159 | 160 | exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@" 161 | -------------------------------------------------------------------------------- /app/src/main/java/com/pabhinav/zsrv/zstacklistview/MainActivity.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2016 Abhinav Puri 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | package com.pabhinav.zsrv.zstacklistview; 17 | 18 | import android.os.Bundle; 19 | import android.support.v7.app.AppCompatActivity; 20 | import android.support.v7.widget.LinearLayoutManager; 21 | import android.support.v7.widget.RecyclerView; 22 | import android.util.Log; 23 | import android.view.View; 24 | 25 | import java.util.ArrayList; 26 | 27 | import butterknife.Bind; 28 | import butterknife.ButterKnife; 29 | 30 | /** 31 | * This is the launcher activity for this app. 32 | *33 | * Uses {@link RecyclerView} for listing some data. Its compatible 34 | * from minimum android api level 14 to latest android version. 35 | * This covers more than 96% android devices. 36 | *
37 | * 38 | * @author pabhinav (pabhinav@iitrpr.ac.in) 39 | */ 40 | public class MainActivity extends AppCompatActivity { 41 | 42 | /** 43 | * {@link RecyclerView} used to populate a list of items. 44 | * This view will also be passed to its {@link MyRecyclerViewAdapter}, 45 | * which is an adapter for this view, where this view is used 46 | * to manipulate its listed item's visibilities. 47 | *48 | * It uses Jake Wharton's {@link ButterKnife} library to 49 | * initialize itself. 50 | * @see 51 | * Butterknife Library 52 | *
53 | */ 54 | @Bind(R.id.my_recycler_view) 55 | RecyclerView mRecyclerView; 56 | 57 | /** 58 | * Layout Manager used to populate {@link RecyclerView} is 59 | * {@link LinearLayoutManager}, whose object will also be used 60 | * in adapter for detecting child item views visibility. 61 | */ 62 | LinearLayoutManager mLayoutManager; 63 | 64 | /** 65 | * The adapter for {@link RecyclerView}. 66 | * Custom adapter is implemented and attached with {@link RecyclerView} 67 | */ 68 | RecyclerView.Adapter mAdapter; 69 | 70 | /** 71 | * Called when the activity is starting. 72 | * 73 | *It initializes {@link RecyclerView} and attach to its customized 74 | * {@link MyRecyclerViewAdapter}, also uses {@link ButterKnife}, 75 | * a library by JakeWharton. 76 | * 77 | * @param savedInstanceState If the activity is being re-initialized after 78 | * previously being shut down then this Bundle contains the data it most 79 | * recently supplied in {@link #onSaveInstanceState}. 80 | */ 81 | @Override 82 | protected void onCreate(Bundle savedInstanceState) { 83 | super.onCreate(savedInstanceState); 84 | setContentView(R.layout.activity_main); 85 | ButterKnife.bind(this); 86 | 87 | /** 88 | * {@link RecyclerView} can perform several optimizations if it can know 89 | * in advance that changes in adapter content cannot change the size of the 90 | * {@link RecyclerView} itself. 91 | * 92 | *
Since our {@link RecyclerView} have fixed size, this attribute can 93 | * be set to true.
94 | */ 95 | mRecyclerView.setHasFixedSize(true); 96 | 97 | /** 98 | * {@link LinearLayoutManager} creates a vertical list of tiles. Initialize 99 | * it with {@link Context} object. 100 | */ 101 | mLayoutManager = new LinearLayoutManager(this); 102 | 103 | /** 104 | * Attach {@link LinearLayoutManager} to our {@link RecyclerView}. 105 | */ 106 | mRecyclerView.setLayoutManager(mLayoutManager); 107 | 108 | /** 109 | * Initailize {@link MyRecyclerViewAdapter} custom adapter for our {@link RecyclerView}. 110 | * Custom Adapter requires {@link Context} object, List of item's data, 111 | * {@link LinearLayoutManager} object and {@link RecyclerView} itself. 112 | */ 113 | mAdapter = new MyRecyclerViewAdapter(this,generateData(), mLayoutManager); 114 | 115 | /** 116 | * Attach {@link MyRecyclerViewAdapter} custom adapter with our {@link RecyclerView}. 117 | */ 118 | mRecyclerView.setAdapter(mAdapter); 119 | 120 | /** 121 | * Listen to scroll events using {@link android.support.v7.widget.RecyclerView.OnScrollListener} 122 | * for {@link RecyclerView}. 123 | */ 124 | mRecyclerView.addOnScrollListener(new MyRecyclerOnScrollListener(mLayoutManager, mRecyclerView, this)); 125 | } 126 | 127 | /** 128 | * Called after {@link #onRestoreInstanceState}, {@link #onRestart}, or 129 | * {@link #onPause}, for the activity to start interacting with the user. 130 | * This is a place where click listeners have been added to each 131 | * {@link RecyclerView}'s clickable items. 132 | */ 133 | @Override 134 | public void onResume(){ 135 | super.onResume(); 136 | 137 | /** 138 | * {@link RecyclerView} has its each child item's click 139 | * event captured here. One can set setOnItemClickListener 140 | * on its attached adapter. 141 | */ 142 | ((MyRecyclerViewAdapter) mAdapter).setOnItemClickListener( 143 | new MyRecyclerViewAdapter.MyClickListener() { 144 | @Override 145 | public void onItemClick(int position, View v) { 146 | 147 | /** Just logging click events **/ 148 | Log.d("Item Pressed : ", " Position : " + position); 149 | } 150 | } 151 | ); 152 | } 153 | 154 | /** 155 | * Dummy data generator. 156 | *157 | * This simply fills in some randomly captured data, and returns the list. 158 | * It makes use of {@link DummyData} and {@link DataObject} classes. 159 | *
160 | * 161 | * @return {@link ArrayList} of {@link DataObject} objects. 162 | */ 163 | public ArrayList31 | * This uses {@link android.support.v7.widget.RecyclerView.ViewHolder} 32 | * object to initialize data model objects and render them on screen. 33 | *
34 | *35 | * It always make sure that the visibility of all list items are set 36 | * to be visible, except for the case when the item at the top of list. 37 | *
38 | *39 | * It has been done this way, because {@link MainActivity} has a layout 40 | * in which {@link android.widget.FrameLayout} is used, with two children, 41 | * one {@link RecyclerView} and other a masked tile view, with exactly same 42 | * size as that of each list item size, and placed exactly below the first 43 | * list item. So, first item in {@link RecyclerView} is never made visible, 44 | * instead of which the masked tile view, which is exactly below this first 45 | * item is seen on screen. 46 | *
47 | *48 | * In simple word, the very first list item is never made visible, instead, 49 | * a placeholder view (mask tile) just below first list item and exactly of 50 | * same size, imitates this first list item, and is seen on screen. 51 | * It has been done this way to show effect of stacking of tiles on first 52 | * list item. 53 | *
54 | * 55 | * @author pabhinav (pabhinav@iitrpr.ac.in) 56 | */ 57 | public class MyRecyclerViewAdapter extends RecyclerView.Adapter96 | * This new ViewHolder is constructed with a new View that can represent the items 97 | * of the given type. 98 | *
99 | * 100 | * @param parent The ViewGroup into which the new View will be added after it is bound to 101 | * an adapter position. 102 | * @param viewType The view type of the new View. 103 | * 104 | * @return A new ViewHolder that holds a View of the 105 | * {@link com.pabhinav.zsrv.zstacklistview.MyRecyclerViewAdapter.DataObjectHolder} 106 | * view type. 107 | */ 108 | @Override 109 | public DataObjectHolder onCreateViewHolder(ViewGroup parent, int viewType) { 110 | View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.tile, parent, false); 111 | return new DataObjectHolder(view); 112 | } 113 | 114 | /** 115 | * Called by RecyclerView to display the data at the specified position. 116 | *117 | * This method also makes sure that the visibility of all list items are set 118 | * to be visible, except for the case when the item at the top of list. 119 | * 120 | * (The reason for doing this is explained in {@link MyRecyclerViewAdapter} 121 | * and {@link MyRecyclerOnScrollListener} class javadoc) 122 | *
123 | * 124 | * @param holder The {@link com.pabhinav.zsrv.zstacklistview.MyRecyclerViewAdapter.DataObjectHolder} 125 | * which should be updated to represent the contents of the item at the given 126 | * position in the data set. 127 | * @param position The position of the item within the adapter's data set. 128 | */ 129 | @Override 130 | public void onBindViewHolder(DataObjectHolder holder, int position) { 131 | 132 | /** Get the name plate letter **/ 133 | String namePlateLetter = mDataset.get(position).getName().substring(0,1).toUpperCase(); 134 | 135 | /** Need to use {@link CircleDrawable} for rendering background of name plate letter holding {@link TextView} **/ 136 | CircleDrawable circleDrawable = new CircleDrawable(mContext.getResources().getColor(LetterColorMapping.letterToColorIdMapping.get(namePlateLetter))); 137 | 138 | /** update holder view data **/ 139 | holder.namePlateTextView.setText(namePlateLetter); 140 | holder.nameTextView.setText(String.format("%s%s", namePlateLetter, mDataset.get(position).getName().substring(1))); 141 | holder.locationTextView.setText(mDataset.get(position).getLocation()); 142 | holder.timePassedTextView.setText(mDataset.get(position).getTimePassed()); 143 | holder.namePlateTextView.setBackgroundDrawable(circleDrawable); 144 | 145 | /** Let all children become visible, except for the child with index position 0 **/ 146 | int childIndex = position - mLinearLayoutManager.findFirstVisibleItemPosition(); 147 | if (childIndex > 0) { 148 | holder.mItemView.setAlpha(1); 149 | } 150 | } 151 | 152 | /** 153 | * {@link android.support.v7.widget.RecyclerView.ViewHolder} static class, 154 | * used to describe item view in {@link RecyclerView}. 155 | * 156 | * @author pabhinav (pabhinav@iitrpr.ac.in) 157 | */ 158 | public static class DataObjectHolder extends RecyclerView.ViewHolder implements View.OnClickListener { 159 | 160 | /** 161 | * {@link TextView} used for describing list item. 162 | */ 163 | TextView nameTextView, locationTextView, timePassedTextView, namePlateTextView; 164 | 165 | /** 166 | * Root {@link View} inflated from layout representing list item. 167 | */ 168 | View mItemView; 169 | 170 | /** 171 | * Constructor initializing View elements 172 | * 173 | * @param itemView the root {@link View} object. 174 | */ 175 | public DataObjectHolder(View itemView) { 176 | super(itemView); 177 | 178 | mItemView = itemView; 179 | nameTextView = (TextView)itemView.findViewById(R.id.name_text_view); 180 | locationTextView = (TextView)itemView.findViewById(R.id.place); 181 | timePassedTextView = (TextView)itemView.findViewById(R.id.time_passed_out); 182 | namePlateTextView = (TextView)itemView.findViewById(R.id.name_plate_text_view); 183 | 184 | /** Need to register click events on main view **/ 185 | itemView.setOnClickListener(this); 186 | } 187 | 188 | @Override 189 | public void onClick(View v) { 190 | 191 | /** Notify callback interface **/ 192 | myClickListener.onItemClick(getPosition(), v); 193 | } 194 | } 195 | 196 | /** 197 | * Setter function for callback interface. 198 | * 199 | * @param myClickListener callback interface notifying click events captured. 200 | */ 201 | public void setOnItemClickListener(MyClickListener myClickListener) { 202 | this.myClickListener = myClickListener; 203 | } 204 | 205 | /** 206 | * Addition of new item in {@link RecyclerView}. 207 | * 208 | * @param dataObj item model object to be added to list. 209 | * @param index position at which item is to be added. 210 | */ 211 | public void addItem(DataObject dataObj, int index) { 212 | mDataset.add(dataObj); 213 | notifyItemInserted(index); 214 | } 215 | 216 | /** 217 | * Deletion of an existing item in {@link RecyclerView}. 218 | * 219 | * @param index position at which item is to be deleted. 220 | */ 221 | public void deleteItem(int index) { 222 | mDataset.remove(index); 223 | notifyItemRemoved(index); 224 | } 225 | 226 | /** 227 | * Specifies number of items registered to {@link RecyclerView} 228 | * 229 | * @return number of items in this adapter. 230 | */ 231 | @Override 232 | public int getItemCount() { 233 | return mDataset.size(); 234 | } 235 | 236 | /** 237 | * Callback Interface used to notify click events on list items. 238 | */ 239 | public interface MyClickListener { 240 | void onItemClick(int position, View v); 241 | } 242 | 243 | } 244 | -------------------------------------------------------------------------------- /app/src/main/java/com/pabhinav/zsrv/zstacklistview/MyRecyclerOnScrollListener.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright (C) 2016 Abhinav Puri 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | package com.pabhinav.zsrv.zstacklistview; 17 | 18 | import android.app.Activity; 19 | import android.content.Context; 20 | import android.support.v7.widget.LinearLayoutManager; 21 | import android.support.v7.widget.RecyclerView; 22 | import android.view.View; 23 | import android.widget.TextView; 24 | 25 | /** 26 | * This class is used to listen to scroll events for {@link RecyclerView}. 27 | * 28 | *29 | * On listening to scroll events, first visible item is detected. 30 | * if the position of current first visible item is greater than 31 | * the position of first visible item previously saved, then this 32 | * means that user is scrolling upwards, and one needs to make sure 33 | * that new item which is going to reach the topmost position of 34 | * list show pop in of stack effect and for doing this, item at 35 | * first position is hidden and mask tile, which was in the background, 36 | * becomes visible. 37 | *
38 | *39 | * Similarly, if position of current first visible item is lesser 40 | * than the position of first visible item previously saved, then 41 | * this means user is scrolling downwards, and in order to show 42 | * pop out of stack effect, item at first position is made visible. 43 | *
44 | * 45 | * @author pabhinav (pabhinav@iitrpr.ac.in) 46 | */ 47 | public class MyRecyclerOnScrollListener extends RecyclerView.OnScrollListener{ 48 | 49 | /** 50 | * Keeps the older value of {@link LinearLayoutManager#findFirstVisibleItemPosition()} 51 | * method's returned value, and also is updated on scroll detection, whenever difference is 52 | * found with the new value. 53 | */ 54 | private int positionDelta = -1; 55 | 56 | /** 57 | * {@link LinearLayoutManager} object for vertical aligning list items. 58 | */ 59 | private LinearLayoutManager mLinearLayoutManager; 60 | 61 | /** 62 | * {@link RecyclerView} object used here to get child at specified position in the list. 63 | */ 64 | private RecyclerView mRecyclerView; 65 | 66 | /** 67 | * View holder for masked tile view present in the background of first list view item. 68 | */ 69 | private MaskedTileDataObjectHolder mMaskedTileDataObjectHolder; 70 | 71 | /** 72 | * {@link Context} of the calling Activity. 73 | */ 74 | private Context mContext; 75 | 76 | /** 77 | * Constructor for this class. 78 | * 79 | * @param linearLayoutManager {@link LinearLayoutManager} for vertical aligning list items 80 | * @param recyclerView {@link RecyclerView} used in this class for getting child at specified 81 | * position in the list. 82 | * @param context {@link Context} of the calling Activity. 83 | */ 84 | public MyRecyclerOnScrollListener(LinearLayoutManager linearLayoutManager, RecyclerView recyclerView, Context context){ 85 | this.mLinearLayoutManager = linearLayoutManager; 86 | this.mRecyclerView = recyclerView; 87 | this.mMaskedTileDataObjectHolder = new MaskedTileDataObjectHolder(context); 88 | this.mContext = context; 89 | } 90 | 91 | /** 92 | * View Holder static class for masked tile view present in the background of the first list view item. 93 | * 94 | * @author pabhinav (pabhinav@iitrpr.ac.in) 95 | */ 96 | public static class MaskedTileDataObjectHolder { 97 | 98 | /** 99 | * {@link TextView} used for describing list item. 100 | */ 101 | TextView maskedNameTextView, maskedLocationTextView, maskedTimePassedTextView, maskedNamePlateTextView; 102 | 103 | /** 104 | * Root {@link View} inflated from layout representing list item. 105 | */ 106 | View maskedItemView; 107 | 108 | /** 109 | * Constructor initializing View elements 110 | * 111 | * @param context the {@link Context} object of the calling activity. 112 | */ 113 | public MaskedTileDataObjectHolder(Context context){ 114 | maskedItemView = ((Activity)context).findViewById(R.id.masked_tile); 115 | maskedNameTextView = (TextView)((Activity)context).findViewById(R.id.masked_name_text_view); 116 | maskedLocationTextView = (TextView)((Activity)context).findViewById(R.id.masked_place); 117 | maskedTimePassedTextView = (TextView) ((Activity)context).findViewById(R.id.masked_time_passed_out); 118 | maskedNamePlateTextView = (TextView) ((Activity)context).findViewById(R.id.masked_name_plate_text_view); 119 | } 120 | } 121 | 122 | /** 123 | * Callback method to be invoked when RecyclerView's scroll state changes. 124 | * 125 | * @param recyclerView The RecyclerView whose scroll state has changed. 126 | * @param newState The updated scroll state. 127 | */ 128 | @Override 129 | public void onScrollStateChanged(RecyclerView recyclerView, int newState) { 130 | super.onScrollStateChanged(recyclerView, newState); 131 | } 132 | 133 | /** 134 | * Callback method to be invoked when the RecyclerView has been scrolled. 135 | * This will be called after the scroll has completed. 136 | * 137 | *138 | * Always make child at index 0, invisible. 139 | * 140 | * Exception : 141 | * If one is on the top of {@link RecyclerView}, ie, can't 142 | * scroll up more, then make child at index 0, visible. 143 | * This is done so because, mask tile view is below the 144 | * list, and when first list item is not visible, the shadow 145 | * of second list item can be seen on the mask tile. So, in 146 | * order to show list tiles all on same elevation (when no 147 | * more scrolling up can be done), make first list item visible. 148 | *
149 | * 150 | *151 | * Important : 152 | * Make sure that the child view which is going to get 153 | * invisible has its alpha set to 0, instead of setting 154 | * its visibility to View.INVISIBLE. 155 | *
156 | * 157 | *158 | * Reason : 159 | * If we set visibility to View.INVISIBLE, then we won't 160 | * be able to receive click events on this child view. 161 | *
162 | * 163 | * @param recyclerView The RecyclerView which scrolled. 164 | * @param dx The amount of horizontal scroll. 165 | * @param dy The amount of vertical scroll. 166 | */ 167 | @Override 168 | public void onScrolled(RecyclerView recyclerView, int dx, int dy) { 169 | super.onScrolled(recyclerView, dx, dy); 170 | 171 | /** There has to difference between older and newer first visible item position to show stack effect **/ 172 | if(Math.abs(positionDelta - mLinearLayoutManager.findFirstVisibleItemPosition()) > 0) { 173 | 174 | /** 175 | * Detect user scrolling down, and make item visible at the index just next 176 | * to top most, ie, at index = 1. 177 | */ 178 | if (mLinearLayoutManager.findFirstVisibleItemPosition() < positionDelta) { 179 | 180 | /** Need to make item tile at second index visible **/ 181 | View v = mRecyclerView.getChildAt(1); 182 | v.setAlpha(1); 183 | } 184 | 185 | /** Get the child which is made invisible, always is the first visible item in {@link RecyclerView} **/ 186 | MyRecyclerViewAdapter.DataObjectHolder childDataObjectHolder = (MyRecyclerViewAdapter.DataObjectHolder) mRecyclerView.getChildViewHolder(mRecyclerView.getChildAt(0)); 187 | 188 | /** Imitate to background mask tile view **/ 189 | imitateMaskedTileViewWithTileView(childDataObjectHolder); 190 | } 191 | 192 | /** 193 | * Detect when top of {@link RecyclerView} has reached. 194 | * Now, no more up scrolling can be done. 195 | *196 | * To detect when no more up scrolling can be done, 197 | * 198 | * Two conditions need to be followed : 199 | * 200 | * 1) The difference between the top of child at index (not position) = 0 201 | * and the top of the parent (which is the whole {@link RecyclerView}) 202 | * is zero. 203 | * 204 | * 2) The very first visible item has position (not index) = 0. 205 | *
206 | */ 207 | if(mRecyclerView.getChildAt(0).getTop() == 0 && mLinearLayoutManager.findFirstVisibleItemPosition() == 0){ 208 | /** Since no more scrolling up can be done, exception case is reached and now first item has to be visible. **/ 209 | mRecyclerView.getChildAt(0).setAlpha(1); 210 | } else { 211 | /** Not the exception case, make first item invisible **/ 212 | mRecyclerView.getChildAt(0).setAlpha(0); 213 | } 214 | 215 | /** update the postionDelta value to newly visible child **/ 216 | positionDelta = mLinearLayoutManager.findFirstVisibleItemPosition(); 217 | } 218 | 219 | /** 220 | * This method exactly imitates masked tile view with the first list item. 221 | *222 | * Before using this function, it is made sure that first list item is not 223 | * visible anymore, and mask tile view is visible. 224 | *
225 | * 226 | * @param dataObjectHolder The {@link com.pabhinav.zsrv.zstacklistview.MyRecyclerViewAdapter.DataObjectHolder} 227 | * object representing view type at first list item position, used to imitate its view's 228 | * value to masked view in the background. 229 | */ 230 | public void imitateMaskedTileViewWithTileView(final MyRecyclerViewAdapter.DataObjectHolder dataObjectHolder){ 231 | 232 | /** Copy {@link TextView} text to masked tile view's corresponding {@link TextView} **/ 233 | mMaskedTileDataObjectHolder.maskedNameTextView.setText(dataObjectHolder.nameTextView.getText()); 234 | mMaskedTileDataObjectHolder.maskedNamePlateTextView.setText(dataObjectHolder.namePlateTextView.getText()); 235 | mMaskedTileDataObjectHolder.maskedTimePassedTextView.setText(dataObjectHolder.timePassedTextView.getText()); 236 | mMaskedTileDataObjectHolder.maskedLocationTextView.setText(dataObjectHolder.locationTextView.getText()); 237 | 238 | /** Get the name plate letter character **/ 239 | String namePlateLetter = mMaskedTileDataObjectHolder.maskedNamePlateTextView.getText().toString().toUpperCase().substring(0,1); 240 | 241 | /** Color name plate character holder {@link TextView} background**/ 242 | CircleDrawable circleDrawable = new CircleDrawable(mContext.getResources().getColor(LetterColorMapping.letterToColorIdMapping.get(namePlateLetter))); 243 | 244 | /** Set the colored background **/ 245 | mMaskedTileDataObjectHolder.maskedNamePlateTextView.setBackgroundDrawable(circleDrawable); 246 | 247 | } 248 | } 249 | -------------------------------------------------------------------------------- /LICENSE.txt: -------------------------------------------------------------------------------- 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 {yyyy} {name of copyright owner} 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 | -------------------------------------------------------------------------------- /.idea/qaplug_profiles.xml: -------------------------------------------------------------------------------- 1 | 2 |