Skip to content

Latest commit

 

History

History
84 lines (60 loc) · 3 KB

README.md

File metadata and controls

84 lines (60 loc) · 3 KB
Raw

Android Components > Feature > Find In Page

A feature that provides Find in Page functionality.

Usage

Setting up the dependency

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

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

Adding feature to application

To use this feature you have to do two things:

1. Add the FindInPageBar widget to you layout:

<mozilla.components.feature.findinpage.view.FindInPageBar
        android:id="@+id/find_in_page"
        android:layout_width="match_parent"
        android:background="#FFFFFFFF"
        android:elevation="10dp"
        android:layout_height="56dp"
        android:padding="4dp" />

These are the properties that you can customize of this widget.

<attr name="findInPageQueryTextColor" format="reference|color"/>
<attr name="findInPageQueryHintTextColor" format="reference|color"/>
<attr name="findInPageQueryTextSize" format="dimension"/>
<attr name="findInPageResultCountTextColor" format="reference|color"/>
<attr name="findInPageResultCountTextSize" format="dimension"/>
<attr name="findInPageButtonsTint" format="reference|color"/>
<attr name="findInPageNoMatchesTextColor" format="reference|color"/>

2. Add the FindInPageFeature to your activity/fragment:

val findInPageBar = layout.findViewById<FindInPageBar>(R.id.find_in_page)

val findInPageFeature = FindInPageFeature(
    sessionManager,
    findInPageView
) {
    // Optional: Handle clicking of "close" button.
}

lifecycle.addObservers(findInPageFeature)

// To show "Find in Page" results for a `Session`:
findInPageFeature.bind(session)

🦊 A practical example of using feature find in page can be found in Sample Browser.

Facts

This component emits the following Facts:

Action Item Extras Description
CLICK previous The user clicked the previous result button.
CLICK next The user clicked the next result button.
CLICK close The user clicked the close button.
COMMIT input inputExtras The user committed a query to be found on the page.

inputExtras

Key Type Value
value String The query that was searched

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/