Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit b2bc8ddc authored by Nate Fischer's avatar Nate Fischer Committed by android-build-merger
Browse files

WebView: clarify docs for onShowCustomView am: aaaa660a

am: 3ea1a6d6

Change-Id: Id1a2fc32030f8a5aed8af4dfd6c7046a65d51a6e
parents 8f6945f4 3ea1a6d6
Loading
Loading
Loading
Loading
+25 −9
Original line number Original line Diff line number Diff line
@@ -71,11 +71,24 @@ public class WebChromeClient {
    }
    }


    /**
    /**
     * Notify the host application that the current page has entered full
     * Notify the host application that the current page has entered full screen mode. After this
     * screen mode. The host application must show the custom View which
     * call, web content will no longer be rendered in the WebView, but will instead be rendered
     * contains the web contents — video or other HTML content —
     * in {@code view}. The host application should add this View to a Window which is configured
     * in full screen mode. Also see "Full screen support" documentation on
     * with {@link android.view.WindowManager.LayoutParams#FLAG_FULLSCREEN} flag in order to
     * {@link WebView}.
     * actually display this web content full screen.
     *
     * <p>The application may explicitly exit fullscreen mode by invoking {@code callback} (ex. when
     * the user presses the back button). However, this is generally not necessary as the web page
     * will often show its own UI to close out of fullscreen. Regardless of how the WebView exits
     * fullscreen mode, WebView will invoke {@link #onHideCustomView()}, signaling for the
     * application to remove the custom View.
     *
     * <p>If this method is not overridden, WebView will report to the web page it does not support
     * fullscreen mode and will not honor the web page's request to run in fullscreen mode.
     *
     * <p class="note"><b>Note:</b> if overriding this method, the application must also override
     * {@link #onHideCustomView()}.
     *
     * @param view is the View object to be shown.
     * @param view is the View object to be shown.
     * @param callback invoke this callback to request the page to exit
     * @param callback invoke this callback to request the page to exit
     * full screen mode.
     * full screen mode.
@@ -98,10 +111,13 @@ public class WebChromeClient {
            CustomViewCallback callback) {};
            CustomViewCallback callback) {};


    /**
    /**
     * Notify the host application that the current page has exited full
     * Notify the host application that the current page has exited full screen mode. The host
     * screen mode. The host application must hide the custom View, ie. the
     * application must hide the custom View (the View which was previously passed to {@link
     * View passed to {@link #onShowCustomView} when the content entered fullscreen.
     * #onShowCustomView(View, CustomViewCallback) onShowCustomView()}). After this call, web
     * Also see "Full screen support" documentation on {@link WebView}.
     * content will render in the original WebView again.
     *
     * <p class="note"><b>Note:</b> if overriding this method, the application must also override
     * {@link #onShowCustomView(View, CustomViewCallback) onShowCustomView()}.
     */
     */
    public void onHideCustomView() {}
    public void onHideCustomView() {}