/NestedScrollWebView

An Android WebView that implements NestedScrollingChild, in order to use it with CoordinatorLayout and AppBarLayout.

Primary LanguageJavaOtherNOASSERTION

NestedScrollWebView for Android

A WebView that implements NestedScrollingChild, in order to use it with CoordinatorLayout and AppBarLayout from the Android Design Support Library. This is necessary since embedding a regular WebView in a NestedScrollView causes height issues (e.g. infinite height, tested with design:23.1.1).

This is just a workaround, until Google will hopefully fix it.

The code is based on this and this.

Setup Instructions

(1) Using gradle

  • Add the JitPack repository to your root build.gradle at the end of repositories:
allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}
  • In your application's main module (usually called "app"), edit your build.gradle to add a new dependency:
dependencies {
    implementation 'com.github.rhlff:NestedScrollWebView:v1.1.1'
}

(2) Using git submodule

  • In the root of your application's project add the library as a git submodule:
git submodule add https://github.com/rhlff/NestedScrollWebView
  • In the root of your application's project edit the file "settings.gradle" and add the following lines:
include ':NestedScrollWebView:lib'
project(':NestedScrollWebView').projectDir = new File('/NestedScrollWebView')
  • In your application's main module (usually called "app"), edit your build.gradle to add a new dependency:
 dependencies {
    ...
    compile project(':NestedScrollWebView:lib')
 }

Now your project is ready to use this library.

To update the library, follow these steps:

  • From the root of your application's project change directory to the library:
cd NestedScrollWebView
  • Pull the last changes:
git pull origin master

Now the library is up to date.

Usage

In your layout.xml include the following:

<com.tobiasrohloff.view.NestedScrollWebView
            android:id="@+id/webView"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:focusable="true"
            android:focusableInTouchMode="true"
            app:layout_behavior="@string/appbar_scrolling_view_behavior" />

Known Issues

Doesn't work well with CollapsingToolbarLayout, mainly tested with the regular ToolbarLayout.

License

Copyright (C) 2016 Tobias Rohloff

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.