android-components/components/feature/readerview/README.md

1.3 KiB

Android Components > Feature > Reader View

A component wrapping/providing a Reader View WebExtension.

Usage

Setting up the dependency

Use Gradle to download the library from maven.mozilla.org (Setup repository):

implementation "org.mozilla.components:feature-readerview:{latest-version}"

Integration

Initializing the feature:

val readerViewFeature = ReaderViewFeature(
    context,
    engine,
    sessionManager,
    onReaderViewAvailableChange = {
    	// e.g. readerViewToolbarActionVisible = it
    }
)

Showing and hiding Reader View:

readerViewFeature.showReaderView()
readerViewFeature.hideReaderView()

Showing and hiding the Reader View appearance UI (to adjust font size, font type and color scheme). Note that changes to the appearance settings are automatically persisted as user preferences.

readerViewFeature.showAppearanceControls()
readerViewFeature.hideAppearanceControls()

License

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/