Version 11.2.0

- Adds support for RTL languages. Detected automatically but can be overriden by the developer if needed. (Fixes #70)

- Marked programmatic addition as depreciated in order to simplify library and removed documentation. Will be removed shortly.

Author: turing-tech

README.md

@@ -37,9 +37,7 @@ Note: All customisation methods (`setAutoHide`, `setBarColour`, etc) return the
 
 ####How to use - ScrollBar
 
-The 'scrollBar' can be implemented programatically or through XML.
-
-#####XML
+The library comes in two flavours, drag and touch. Try both out to see which you prefer.
 
 Option 1
 
@@ -72,29 +70,12 @@ Additonal optional attributes:
 * msb_handleOffColour - Colour
 * msb_textColour - Colour
 * msb_barThickness - Integer
+* msb_rightToLeft - Integer
 
 Please note that for both of these configurations, both recyclerView and lightOnTouch* must have a valid value. The recyclerView attribute should point to the id of the `recyclerView` to which you want to link the scrollbar.
 
 \* lightOnTouch behaves as follows. A value of true will cause the handle to be grey until pressed, when it will become the normal accent colour (as set). A value of false will cause the handle to always have the accent colour, even when not being pressed.
 
-#####Programmatically
-
-Option 1
-
-```java
-DragScrollBar materialScrollBar = new DragScrollBar(this, recyclerView, {{lightOnTouch}});
-```
-
-or
-
-Option 2
-
-```java
-TouchScrollBar materialScrollBar = new TouchScrollBar(this, recyclerView, {{lightOnTouch}});
-```
-
-where "recyclerView" is the object of the `recyclerView` to which you want to link the `scrollBar`. The difference between the two options is that the touch option hides after a cooldown period and touches anywhere on the track, whether on the button or not, scroll the view. The drag option on the other hand hides using the animation seen in the video and will only respond to touches on the handle. "lightOnTouch" can either be true or false. A value of true will cause the handle to be grey until pressed, when it will become the normal accent colour (as set). A value of false will cause the handle to always have the accent colour, even when not being pressed.
-
 ####My recyclerView elements aren't all the same size! What do I do?
 
 If you are in the situation of using headers of one size and elements of another, we've developed a solution speicifcally for you. Please follow the tutorial [here](https://github.com/krimin-killr21/MaterialScrollBar/wiki/Header-Tutorial).
@@ -104,16 +85,14 @@ If you are in the situation of using headers of one size and elements of another
 To add an indicator, simply add the following line of code:
 
 ```java
-materialScrollBar.setIndicator({{Indicator}}, {{addSpace}});
+scrollBar.setIndicator({{Indicator}}, {{addSpace}});
 ```
 
-If you implemented the bar programmatically, simply get the object using `findViewById()` and then the scrollbar's id.
-
 The indicator should be either `AlphatbetIndicator`, `DateAndTimeIndicator`, or `CustomIndicator`. See below for specific instructions per indicator.
 
 `{{addSpace}}` is a boolean which indicates whether there should be space in between the indicator and the bar. True adds space, as in the latest version of the Google Launcher, while false adds no space, as in the Android 5.1 system scrollbars.
 
-To use an indicator, you **MUST** make your 'recyclerView''s adapter implement the relevant interface. If you do not, the library will throw a runtime error informing you of your mistake. See documentation for the relevant interface.
+To use an indicator, you **MUST** make your `recyclerView`'s adapter implement the relevant interface. If you do not, the library will throw a runtime error informing you of your mistake. See documentation for the relevant interface.
 
 ####Indicators
 #####AlphabetIndicator

app/src/main/AndroidManifest.xml

@@ -4,6 +4,7 @@
 
     <application
         android:allowBackup="true"
+        android:supportsRtl="true"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
         android:theme="@style/AppTheme" >

app/src/main/java/com/turingtechnologies/materialscrollbardemo/DateActivity.java

@@ -20,7 +20,7 @@ protected void onCreate(Bundle savedInstanceState) {
         RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerView);
         recyclerView.setAdapter(new DemoAdapter(this));
         recyclerView.setLayoutManager(new LinearLayoutManager(this));
-        new TouchScrollBar(this, recyclerView, false).setIndicator(new DateAndTimeIndicator(this, false, true, true, true), true);
+        ((TouchScrollBar) findViewById(R.id.touchScrollBar)).setIndicator(new DateAndTimeIndicator(this, false, true, true, true), true);
     }
 
     @Override

app/src/main/java/com/turingtechnologies/materialscrollbardemo/IconActivity.java

@@ -37,7 +37,7 @@ protected void onCreate(Bundle savedInstanceState) {
         RecyclerView recyclerView = ((RecyclerView)findViewById(R.id.recyclerView));
         recyclerView.setAdapter(new IconAdapter(this));
         recyclerView.setLayoutManager(new GridLayoutManager(this, 4));
-        new TouchScrollBar(this, recyclerView, true).setIndicator(new CustomIndicator(this), true);
+        ((TouchScrollBar) findViewById(R.id.touchScrollBar)).setIndicator(new CustomIndicator(this), true);
     }
 
     @Override

app/src/main/java/com/turingtechnologies/materialscrollbardemo/NameActivity.java

@@ -20,7 +20,7 @@ protected void onCreate(Bundle savedInstanceState) {
         RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerView);
         recyclerView.setAdapter(new DemoAdapter(this));
         recyclerView.setLayoutManager(new LinearLayoutManager(this));
-        new TouchScrollBar(this, recyclerView, false).setIndicator(new CustomIndicator(this), true);
+        ((TouchScrollBar) findViewById(R.id.touchScrollBar)).setIndicator(new CustomIndicator(this), true);
     }
 
     @Override

app/src/main/res/layout/activity_main.xml

@@ -18,6 +18,6 @@
         android:layout_height="match_parent"
         android:layout_alignParentTop="true"
         android:layout_alignParentRight="true"
-        android:layout_alignParentEnd="false" />
+        android:layout_alignParentEnd="true" />
 
 </RelativeLayout>

app/src/main/res/layout/activity_others.xml

@@ -18,11 +18,21 @@
     xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
     tools:context=".MainActivity">
 
     <android.support.v7.widget.RecyclerView
         android:id="@+id/recyclerView"
         android:layout_width="match_parent"
         android:layout_height="match_parent" />
 
+    <com.turingtechnologies.materialscrollbar.TouchScrollBar
+        app:msb_lightOnTouch="false"
+        app:msb_recyclerView="@id/recyclerView"
+        android:layout_alignParentRight="true"
+        android:layout_alignParentEnd="true"
+        android:id="@+id/touchScrollBar"
+        android:layout_width="wrap_content"
+        android:layout_height="match_parent"/>
+
 </RelativeLayout>

app/src/main/res/layout/item_layout.xml

@@ -7,21 +7,25 @@
     android:layout_height="56dp"
     android:focusableInTouchMode="false">
 
-            <ImageView
-                android:layout_width="35dp"
-                android:layout_height="35dp"
-                android:layout_marginTop="10.5dp"
-                android:id="@+id/imageView"
-                android:layout_marginLeft="16dp" />
+        <ImageView
+            android:layout_width="35dp"
+            android:layout_height="35dp"
+            android:layout_marginTop="10.5dp"
+            android:id="@+id/imageView"
+            android:layout_marginStart="16dp"
+            android:layout_marginLeft="16dp" />
 
-            <TextView
-                android:layout_width="wrap_content"
-                android:layout_height="wrap_content"
-                android:textSize="16sp"
-                android:text="Medium Text"
-                android:id="@+id/textView"
-                android:textColor="#212121"
-                android:layout_marginLeft="72dp"
-                android:layout_centerVertical="true" />
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:textSize="16sp"
+            android:text="Medium Text"
+            android:id="@+id/textView"
+            android:textColor="#212121"
+            android:layout_toRightOf="@id/imageView"
+            android:layout_toEndOf="@id/imageView"
+            android:layout_marginLeft="16dp"
+            android:layout_marginStart="16dp"
+            android:layout_centerVertical="true" />
 
 </RelativeLayout>

lib/build.gradle

@@ -1,6 +1,6 @@
 apply plugin: 'com.android.library'
 
-def libVersion = '11.1.0'
+def libVersion = '11.2.0'
 
 android {
     compileSdkVersion 25

lib/src/main/java/com/turingtechnologies/materialscrollbar/DragScrollBar.java

@@ -30,6 +30,11 @@ public class DragScrollBar extends MaterialScrollBar<DragScrollBar>{
     float handleOffset = 0;
     float indicatorOffset = 0;
 
+    /**
+     * @deprecated Insert via XML instead. Will be removed in future version to be published in the
+     * month of December, 2016.
+     */
+    @Deprecated
     public DragScrollBar(Context context, RecyclerView recyclerView, boolean lightOnTouch){
         super(context, recyclerView, lightOnTouch);
     }