├── .gitignore
├── .idea
├── gradle.xml
├── misc.xml
├── modules.xml
└── runConfigurations.xml
├── README.md
├── app
├── .gitignore
├── build.gradle
├── proguard-rules.pro
└── src
│ ├── androidTest
│ └── java
│ │ └── net
│ │ └── vrgsoft
│ │ └── parallaxview
│ │ └── ExampleInstrumentedTest.kt
│ ├── main
│ ├── AndroidManifest.xml
│ ├── java
│ │ └── net
│ │ │ └── vrgsoft
│ │ │ └── parallaxview
│ │ │ ├── MainActivity.kt
│ │ │ └── TestAdapter.kt
│ └── res
│ │ ├── drawable-v24
│ │ └── ic_launcher_foreground.xml
│ │ ├── drawable-xxxhdpi
│ │ ├── earth.png
│ │ ├── fast_furious_back.png
│ │ ├── fast_furious_front.png
│ │ ├── game_of_thrones_back.png
│ │ ├── game_of_thrones_front.png
│ │ ├── jupiter.png
│ │ ├── mars.png
│ │ ├── mercury.png
│ │ ├── mult_back.png
│ │ ├── mult_front.png
│ │ ├── neptune.png
│ │ ├── saturn.png
│ │ ├── sherlok_back.png
│ │ ├── sherlok_front.png
│ │ ├── space.jpg
│ │ ├── star_wars_back.png
│ │ ├── star_wars_front.png
│ │ ├── uranus.png
│ │ └── venus.png
│ │ ├── drawable
│ │ ├── ic_launcher_background.xml
│ │ └── ic_navigate_next.xml
│ │ ├── layout
│ │ ├── activity_main.xml
│ │ ├── fragment_scroll.xml
│ │ └── item.xml
│ │ ├── menu
│ │ └── menu.xml
│ │ ├── mipmap-anydpi-v26
│ │ ├── ic_launcher.xml
│ │ └── ic_launcher_round.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
│ └── test
│ └── java
│ └── net
│ └── vrgsoft
│ └── parallaxview
│ └── ExampleUnitTest.kt
├── build.gradle
├── gradle.properties
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── parallax
├── .gitignore
├── build.gradle
├── proguard-rules.pro
└── src
│ ├── androidTest
│ └── java
│ │ └── net
│ │ └── vrgsoft
│ │ └── parallaxview
│ │ └── ExampleInstrumentedTest.java
│ ├── main
│ ├── AndroidManifest.xml
│ ├── java
│ │ └── net
│ │ │ └── vrgsoft
│ │ │ └── parallaxview
│ │ │ └── ParallaxView.kt
│ └── res
│ │ └── values
│ │ ├── attrs.xml
│ │ └── strings.xml
│ └── test
│ └── java
│ └── net
│ └── vrgsoft
│ └── parallaxview
│ └── ExampleUnitTest.java
├── scroll1.gif
├── scroll2.gif
└── settings.gradle
/.gitignore:
--------------------------------------------------------------------------------
1 | *.iml
2 | .gradle
3 | /local.properties
4 | /.idea/workspace.xml
5 | /.idea/libraries
6 | .DS_Store
7 | /build
8 | /captures
9 | .externalNativeBuild
10 |
--------------------------------------------------------------------------------
/.idea/gradle.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
18 |
19 |
--------------------------------------------------------------------------------
/.idea/misc.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
16 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
--------------------------------------------------------------------------------
/.idea/modules.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
--------------------------------------------------------------------------------
/.idea/runConfigurations.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
11 |
12 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | #### [HIRE US](http://vrgsoft.net/)
2 | # ParallaxView
3 | View container which applies parallax effect to its content.
4 | You can Even achieve 3d effect if you use two containers, one atop another like on video below.
5 | 
6 | 
7 | # Usage
8 | This view works only in scrollable containers (like RecyclerView, ListView, ScrollView etc).
9 | Its also possible to achieve parallax scrolling in two directions simultaneously (of course, if your parent container supports bi-directional scrolling)
10 | *For a working implementation, Have a look at the Sample Project - app*
11 | 1. Include the library as local library project.
12 | ```gradle
13 | allprojects {
14 | repositories {
15 | maven { url 'https://jitpack.io' }
16 | }
17 | }
18 | dependencies {
19 | implementation 'com.github.VRGsoftUA:ParallaxView:1.0'
20 | }
21 | ```
22 | 2. Include ParallaxView class in your xml layout. For Example:
23 | ```
24 |
32 |
39 |
40 | ```
41 | # Customization
42 | | Attribute | Description |
43 | | ------------- | ------------- |
44 | | app:isEnabledHorizontalParallax | Enables or disables horizontal parallax effect |
45 | | app:isEnabledVerticalParallax | Same as isEnabledHorizontalParallax but vertical |
46 | | app:isInvertedHorizontalParallax | If true direction of the parallax effect will be opposite to scroll direction |
47 | | app:isInvertedVerticalParallax | Same as isInvertedHorizontalParallax but vertical |
48 | | app:isNeedScale | Defines whether scale need to be applied |
49 | | app:decelerateFactor | Possibles values: from 0 to 1. The bigger the value the faster will be moving the parallax effect |
50 | | app:parallaxScale | Scale value applied to the whole ParallaxView. Default is 1.5. Do nothing if isNeedScale set to false |
51 |
52 | You can also change this attributes in runtime through methods
53 | #### Contributing
54 | * Contributions are always welcome
55 | * If you want a feature and can code, feel free to fork and add the change yourself and make a pull request
56 |
--------------------------------------------------------------------------------
/app/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 |
--------------------------------------------------------------------------------
/app/build.gradle:
--------------------------------------------------------------------------------
1 | apply plugin: 'com.android.application'
2 |
3 | apply plugin: 'kotlin-android'
4 |
5 | apply plugin: 'kotlin-android-extensions'
6 |
7 | android {
8 | compileSdkVersion 27
9 | defaultConfig {
10 | applicationId "net.vrgsoft.parallaxview"
11 | minSdkVersion 16
12 | targetSdkVersion 27
13 | versionCode 1
14 | versionName "1.0"
15 | testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
16 | }
17 | buildTypes {
18 | release {
19 | minifyEnabled false
20 | proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
21 | }
22 | }
23 | }
24 |
25 | dependencies {
26 | implementation fileTree(dir: 'libs', include: ['*.jar'])
27 | implementation"org.jetbrains.kotlin:kotlin-stdlib-jre7:$kotlin_version"
28 | implementation 'com.android.support:appcompat-v7:27.1.1'
29 | implementation 'com.android.support.constraint:constraint-layout:1.1.0'
30 | testImplementation 'junit:junit:4.12'
31 | androidTestImplementation 'com.android.support.test:runner:1.0.2'
32 | androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
33 | implementation project(":parallax")
34 | implementation 'com.android.support:recyclerview-v7:27.1.1'
35 | }
36 |
--------------------------------------------------------------------------------
/app/proguard-rules.pro:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # You can control the set of applied configuration files using the
3 | # proguardFiles setting in build.gradle.
4 | #
5 | # For more details, see
6 | # http://developer.android.com/guide/developing/tools/proguard.html
7 |
8 | # If your project uses WebView with JS, uncomment the following
9 | # and specify the fully qualified class name to the JavaScript interface
10 | # class:
11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
12 | # public *;
13 | #}
14 |
15 | # Uncomment this to preserve the line number information for
16 | # debugging stack traces.
17 | #-keepattributes SourceFile,LineNumberTable
18 |
19 | # If you keep the line number information, uncomment this to
20 | # hide the original source file name.
21 | #-renamesourcefileattribute SourceFile
22 |
--------------------------------------------------------------------------------
/app/src/androidTest/java/net/vrgsoft/parallaxview/ExampleInstrumentedTest.kt:
--------------------------------------------------------------------------------
1 | package net.vrgsoft.parallaxview
2 |
3 | import android.support.test.InstrumentationRegistry
4 | import android.support.test.runner.AndroidJUnit4
5 |
6 | import org.junit.Test
7 | import org.junit.runner.RunWith
8 |
9 | import org.junit.Assert.*
10 |
11 | /**
12 | * Instrumented test, which will execute on an Android device.
13 | *
14 | * See [testing documentation](http://d.android.com/tools/testing).
15 | */
16 | @RunWith(AndroidJUnit4::class)
17 | class ExampleInstrumentedTest {
18 | @Test
19 | fun useAppContext() {
20 | // Context of the app under test.
21 | val appContext = InstrumentationRegistry.getTargetContext()
22 | assertEquals("net.vrgsoft.parallaxview", appContext.packageName)
23 | }
24 | }
25 |
--------------------------------------------------------------------------------
/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/app/src/main/java/net/vrgsoft/parallaxview/MainActivity.kt:
--------------------------------------------------------------------------------
1 | package net.vrgsoft.parallaxview
2 |
3 | import android.os.Bundle
4 | import android.support.v4.app.Fragment
5 | import android.support.v7.app.AppCompatActivity
6 | import android.support.v7.widget.LinearLayoutManager
7 | import android.support.v7.widget.RecyclerView.HORIZONTAL
8 | import android.view.*
9 | import kotlinx.android.synthetic.main.activity_main.*
10 |
11 | class MainActivity : AppCompatActivity() {
12 | override fun onCreate(savedInstanceState: Bundle?) {
13 | super.onCreate(savedInstanceState)
14 | setContentView(R.layout.activity_main)
15 | rvContent.apply {
16 | layoutManager = LinearLayoutManager(context, HORIZONTAL, false)
17 | adapter = TestAdapter(prepareBackTestData(), prepareFrontTestData())
18 | }
19 | }
20 |
21 | override fun onCreateOptionsMenu(menu: Menu?): Boolean {
22 | menuInflater.inflate(R.menu.menu, menu)
23 | return super.onCreateOptionsMenu(menu)
24 | }
25 |
26 | override fun onOptionsItemSelected(item: MenuItem?): Boolean {
27 | if(item?.itemId == R.id.next) showNextFragment()
28 | return true
29 | }
30 |
31 | private fun showNextFragment(){
32 | supportFragmentManager
33 | .beginTransaction()
34 | .add(R.id.container, NextFragment())
35 | .addToBackStack(null)
36 | .commit()
37 | }
38 | }
39 |
40 | fun prepareBackTestData(): List {
41 | val data = ArrayList()
42 | data.add(R.drawable.fast_furious_back)
43 | data.add(R.drawable.star_wars_back)
44 | data.add(R.drawable.game_of_thrones_back)
45 | data.add(R.drawable.sherlok_back)
46 | data.add(R.drawable.mult_back)
47 | return data
48 | }
49 |
50 | fun prepareFrontTestData(): List {
51 | val data = ArrayList()
52 | data.add(R.drawable.fast_furious_front)
53 | data.add(R.drawable.star_wars_front)
54 | data.add(R.drawable.game_of_thrones_front)
55 | data.add(R.drawable.sherlok_front)
56 | data.add(R.drawable.mult_front)
57 | return data
58 | }
59 |
60 | class NextFragment : Fragment(){
61 | override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
62 | return inflater.inflate(R.layout.fragment_scroll, container, false)
63 | }
64 |
65 | override fun onCreateOptionsMenu(menu: Menu?, inflater: MenuInflater?) {
66 | }
67 | }
--------------------------------------------------------------------------------
/app/src/main/java/net/vrgsoft/parallaxview/TestAdapter.kt:
--------------------------------------------------------------------------------
1 | package net.vrgsoft.parallaxview
2 |
3 | import android.support.v7.widget.AppCompatImageView
4 | import android.support.v7.widget.RecyclerView
5 | import android.view.LayoutInflater
6 | import android.view.View
7 | import android.view.ViewGroup
8 |
9 | class TestAdapter(private val backImages: List, private val frontImages: List) : RecyclerView.Adapter() {
10 |
11 | override fun onBindViewHolder(holder: TestHolder, position: Int) {
12 | holder.ivImage.setImageResource(backImages[position])
13 | holder.ivImage2.setImageResource(frontImages[position])
14 | }
15 |
16 | override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): TestHolder =
17 | TestHolder(LayoutInflater.from(parent.context).inflate(R.layout.item, parent, false))
18 |
19 |
20 | override fun getItemCount(): Int = backImages.size
21 | }
22 |
23 |
24 | class TestHolder(root: View) : RecyclerView.ViewHolder(root) {
25 | var ivImage: AppCompatImageView = root.findViewById(R.id.ivImage)
26 | var ivImage2: AppCompatImageView = root.findViewById(R.id.ivImage2)
27 | }
--------------------------------------------------------------------------------
/app/src/main/res/drawable-v24/ic_launcher_foreground.xml:
--------------------------------------------------------------------------------
1 |
7 |
12 |
13 |
19 |