android WebView

navigation

WebView

public class WebView
extends AbsoluteLayout implements ViewTreeObserver.OnGlobalFocusChangeListener, ViewGroup.OnHierarchyChangeListener

java.lang.Object
↳	android.view.View
	↳	android.view.ViewGroup
		↳	android.widget.AbsoluteLayout
			↳	android.webkit.WebView

A View that displays web pages. This class is the basis upon which you can roll your own web browser or simply display some online content within your Activity. It uses the WebKit rendering engine to display web pages and includes methods to navigate forward and backward through a history, zoom in and out, perform text searches and more.

Note that, in order for your Activity to access the Internet and load web pages in a WebView, you must add the INTERNET permissions to your Android Manifest file:

<uses-permission android:name="android.permission.INTERNET" />

This must be a child of the <manifest> element.

For more information, read Building Web Apps in WebView.

Basic usage

By default, a WebView provides no browser-like widgets, does not enable JavaScript and web page errors are ignored. If your goal is only to display some HTML as a part of your UI, this is probably fine; the user won't need to interact with the web page beyond reading it, and the web page won't need to interact with the user. If you actually want a full-blown web browser, then you probably want to invoke the Browser application with a URL Intent rather than show it with a WebView. For example:

 Uri uri = Uri.parse("https://www.example.com");
 Intent intent = new Intent(Intent.ACTION_VIEW, uri);
 startActivity(intent);

See Intent for more information.

To provide a WebView in your own Activity, include a <WebView> in your layout, or set the entire Activity window as a WebView during onCreate():

 WebView webview = new WebView(this);
 setContentView(webview);

Then load the desired web page:

 // Simplest usage: note that an exception will NOT be thrown
 // if there is an error loading this page (see below).
 webview.loadUrl("https://example.com/");

 // OR, you can also load from an HTML string:
 String summary = "<html><body>You scored <b>192</b> points.</body></html>";
 webview.loadData(summary, "text/html", null);
 // ... although note that there are restrictions on what this HTML can do.
 // See the JavaDocs for loadData() and loadDataWithBaseURL() for more info.

A WebView has several customization points where you can add your own behavior. These are:

Creating and setting a WebChromeClient subclass. This class is called when something that might impact a browser UI happens, for instance, progress updates and JavaScript alerts are sent here (see Debugging Tasks).
Creating and setting a WebViewClient subclass. It will be called when things happen that impact the rendering of the content, eg, errors or form submissions. You can also intercept URL loading here (via shouldOverrideUrlLoading()).
Modifying the WebSettings, such as enabling JavaScript with setJavaScriptEnabled().
Injecting Java objects into the WebView using the addJavascriptInterface(Object, String) method. This method allows you to inject Java objects into a page's JavaScript context, so that they can be accessed by JavaScript in the page.

Here's a more complicated example, showing error handling, settings, and progress notification:

 // Let's display the progress in the activity title bar, like the
 // browser app does.
 getWindow().requestFeature(Window.FEATURE_PROGRESS);

 webview.getSettings().setJavaScriptEnabled(true);

 final Activity activity = this;
 webview.setWebChromeClient(new WebChromeClient() {
   public void onProgressChanged(WebView view, int progress) {
     // Activities and WebViews measure progress with different scales.
     // The progress meter will automatically disappear when we reach 100%
     activity.setProgress(progress * 1000);
   }
 });
 webview.setWebViewClient(new WebViewClient() {
   public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
     Toast.makeText(activity, "Oh no! " + description, Toast.LENGTH_SHORT).show();
   }
 });

 webview.loadUrl("https://developer.android.com/");

Zoom

To enable the built-in zoom, set WebSettings.setBuiltInZoomControls(boolean) (introduced in API level CUPCAKE).

NOTE: Using zoom if either the height or width is set to WRAP_CONTENT may lead to undefined behavior and should be avoided.

Cookie and window management

For obvious security reasons, your application has its own cache, cookie store etc.—it does not share the Browser application's data.

By default, requests by the HTML to open new windows are ignored. This is true whether they be opened by JavaScript or by the target attribute on a link. You can customize your WebChromeClient to provide your own behavior for opening multiple windows, and render them in whatever manner you want.

The standard behavior for an Activity is to be destroyed and recreated when the device orientation or any other configuration changes. This will cause the WebView to reload the current page. If you don't want that, you can set your Activity to handle the orientation and keyboardHidden changes, and then just leave the WebView alone. It'll automatically re-orient itself as appropriate. Read Handling Runtime Changes for more information about how to handle configuration changes during runtime.

Building web pages to support different screen densities

The screen density of a device is based on the screen resolution. A screen with low density has fewer available pixels per inch, where a screen with high density has more — sometimes significantly more — pixels per inch. The density of a screen is important because, other things being equal, a UI element (such as a button) whose height and width are defined in terms of screen pixels will appear larger on the lower density screen and smaller on the higher density screen. For simplicity, Android collapses all actual screen densities into three generalized densities: high, medium, and low.

By default, WebView scales a web page so that it is drawn at a size that matches the default appearance on a medium density screen. So, it applies 1.5x scaling on a high density screen (because its pixels are smaller) and 0.75x scaling on a low density screen (because its pixels are bigger). Starting with API level ECLAIR, WebView supports DOM, CSS, and meta tag features to help you (as a web developer) target screens with different screen densities.

Here's a summary of the features you can use to handle different screen densities:

The window.devicePixelRatio DOM property. The value of this property specifies the default scaling factor used for the current device. For example, if the value of window.devicePixelRatio is "1.0", then the device is considered a medium density (mdpi) device and default scaling is not applied to the web page; if the value is "1.5", then the device is considered a high density device (hdpi) and the page content is scaled 1.5x; if the value is "0.75", then the device is considered a low density device (ldpi) and the content is scaled 0.75x.
The -webkit-device-pixel-ratio CSS media query. Use this to specify the screen densities for which this style sheet is to be used. The corresponding value should be either "0.75", "1", or "1.5", to indicate that the styles are for devices with low density, medium density, or high density screens, respectively. For example:
```
 <link rel="stylesheet" media="screen and (-webkit-device-pixel-ratio:1.5)" href="hdpi.css" />
```
The hdpi.css stylesheet is only used for devices with a screen pixel ration of 1.5, which is the high density pixel ratio.

HTML5 Video support

In order to support inline HTML5 video in your application you need to have hardware acceleration turned on.

Full screen support

In order to support full screen — for video or other HTML content — you need to set a WebChromeClient and implement both onShowCustomView(View, WebChromeClient.CustomViewCallback) and onHideCustomView(). If the implementation of either of these two methods is missing then the web contents will not be allowed to enter full screen. Optionally you can implement getVideoLoadingProgressView() to customize the View displayed whilst a video is loading.

HTML5 Geolocation API support

For applications targeting Android N and later releases (API level > M) the geolocation api is only supported on secure origins such as https. For such applications requests to geolocation api on non-secure origins are automatically denied without invoking the correspondingonGeolocationPermissionsShowPrompt(String, GeolocationPermissions.Callback) method.

Layout size

It is recommended to set the WebView layout height to a fixed value or to MATCH_PARENT instead of using WRAP_CONTENT. When using MATCH_PARENT for the height none of the WebView's parents should use a WRAP_CONTENT layout height since that could result in incorrect sizing of the views.

Setting the WebView's height to WRAP_CONTENT enables the following behaviors:

The HTML body layout height is set to a fixed value. This means that elements with a height relative to the HTML body may not be sized correctly.
For applications targeting KITKAT and earlier SDKs the HTML viewport meta tag will be ignored in order to preserve backwards compatibility.

Using a layout width of WRAP_CONTENT is not supported. If such a width is used the WebView will attempt to use the width of the parent instead.

Metrics

WebView may upload anonymous diagnostic data to Google when the user has consented. This data helps Google improve WebView. Data is collected on a per-app basis for each app which has instantiated a WebView. An individual app can opt out of this feature by putting the following tag in its manifest:

 <meta-data android:name="android.webkit.WebView.MetricsOptOut"
            android:value="true" />

Data will only be uploaded for a given app if the user has consented AND the app has not opted out.

Safe Browsing

If Safe Browsing is enabled, WebView will block malicious URLs and present a warning UI to the user to allow them to navigate back safely or proceed to the malicious page.

The recommended way for apps to enable the feature is putting the following tag in the manifest:

 <meta-data android:name="android.webkit.WebView.EnableSafeBrowsing"
            android:value="true" />

Summary

Nested classes
`interface`	`WebView.FindListener` Interface to listen for find results.
`class`	`WebView.HitTestResult`
`interface`	`WebView.PictureListener` This interface was deprecated in API level 12. This interface is now obsolete.
`class`	`WebView.VisualStateCallback` Callback interface supplied to `postVisualStateCallback(long, WebView.VisualStateCallback)` for receiving notifications about the visual state.
`class`	`WebView.WebViewTransport` Transportation object for returning WebView across thread boundaries.

Inherited XML attributes
From class `android.view.ViewGroup`
From class `android.view.View`

Constants
`int`	`RENDERER_PRIORITY_BOUND` The renderer associated with this WebView is bound with the default priority for services.
`int`	`RENDERER_PRIORITY_IMPORTANT` The renderer associated with this WebView is bound with `BIND_IMPORTANT`.
`int`	`RENDERER_PRIORITY_WAIVED` The renderer associated with this WebView is bound with `BIND_WAIVE_PRIORITY`.
`String`	`SCHEME_GEO` URI scheme for map address.
`String`	`SCHEME_MAILTO` URI scheme for email address.
`String`	`SCHEME_TEL` URI scheme for telephone number.

Inherited constants
From class `android.view.ViewGroup`
From class `android.view.View`

Inherited fields
From class `android.view.View`

Public constructors
`WebView(Context context)` Constructs a new WebView with a Context object.
`WebView(Context context, AttributeSet attrs)` Constructs a new WebView with layout parameters.
`WebView(Context context, AttributeSet attrs, int defStyleAttr)` Constructs a new WebView with layout parameters and a default style.
`WebView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)` Constructs a new WebView with layout parameters and a default style.
`WebView(Context context, AttributeSet attrs, int defStyleAttr, boolean privateBrowsing)` This constructor was deprecated in API level 17. Private browsing is no longer supported directly via WebView and will be removed in a future release. Prefer using `WebSettings`, `WebViewDatabase`, `CookieManager` and `WebStorage` for fine-grained control of privacy data.

Public methods
`void`	`addJavascriptInterface(Object object, String name)` Injects the supplied Java object into this WebView.
`void`	`autofill(SparseArray<AutofillValue> values)` Automatically fills the content of the virtual children within this view.
`boolean`	`canGoBack()` Gets whether this WebView has a back history item.
`boolean`	`canGoBackOrForward(int steps)` Gets whether the page can go back or forward the given number of steps.
`boolean`	`canGoForward()` Gets whether this WebView has a forward history item.
`boolean`	`canZoomIn()` This method was deprecated in API level 17. This method is prone to inaccuracy due to race conditions between the web rendering and UI threads; prefer `onScaleChanged(WebView, float, float)`.
`boolean`	`canZoomOut()` This method was deprecated in API level 17. This method is prone to inaccuracy due to race conditions between the web rendering and UI threads; prefer `onScaleChanged(WebView, float, float)`.
`Picture`	`capturePicture()` This method was deprecated in API level 19. Use `onDraw(Canvas)` to obtain a bitmap snapshot of the WebView, or`saveWebArchive(String)` to save the content to a file.
`void`	`clearCache(boolean includeDiskFiles)` Clears the resource cache.
`static void`	`clearClientCertPreferences(Runnable onCleared)` Clears the client certificate preferences stored in response to proceeding/cancelling client cert requests.
`void`	`clearFormData()` Removes the autocomplete popup from the currently focused form field, if present.
`void`	`clearHistory()` Tells this WebView to clear its internal back/forward list.
`void`	`clearMatches()` Clears the highlighting surrounding text matches created by `findAllAsync(String)`.
`void`	`clearSslPreferences()` Clears the SSL preferences table stored in response to proceeding with SSL certificate errors.
`void`	`clearView()` This method was deprecated in API level 18. Use WebView.loadUrl("about:blank") to reliably reset the view state and release page resources (including any running JavaScript).
`void`	`computeScroll()` Called by a parent to request that a child update its values for mScrollX and mScrollY if necessary.
`WebBackForwardList`	`copyBackForwardList()` Gets the WebBackForwardList for this WebView.
`PrintDocumentAdapter`	`createPrintDocumentAdapter(String documentName)` Creates a PrintDocumentAdapter that provides the content of this WebView for printing.
`PrintDocumentAdapter`	`createPrintDocumentAdapter()` This method was deprecated in API level 21. Use `createPrintDocumentAdapter(String)` which requires user to provide a print document name.
`WebMessagePort[]`	`createWebMessageChannel()` Creates a message channel to communicate with JS and returns the message ports that represent the endpoints of this message channel.
`void`	`destroy()` Destroys the internal state of this WebView.
`boolean`	`dispatchKeyEvent(KeyEvent event)` Dispatch a key event to the next view on the focus path.
`void`	`documentHasImages(Message response)` Queries the document to see if it contains any image references.
`static void`	`enableSlowWholeDocumentDraw()` For apps targeting the L release, WebView has a new default behavior that reduces memory footprint and increases performance by intelligently choosing the portion of the HTML document that needs to be drawn.
`void`	`evaluateJavascript(String script, ValueCallback<String> resultCallback)` Asynchronously evaluates JavaScript in the context of the currently displayed page.
`static String`	`findAddress(String addr)` Gets the first substring consisting of the address of a physical location.
`int`	`findAll(String find)` This method was deprecated in API level 16. `findAllAsync(String)` is preferred.
`void`	`findAllAsync(String find)` Finds all instances of find on the page and highlights them, asynchronously.
`View`	`findFocus()` Find the view in the hierarchy rooted at this view that currently has focus.
`void`	`findNext(boolean forward)` Highlights and scrolls to the next match found by `findAllAsync(String)`, wrapping around page boundaries as necessary.
`void`	`flingScroll(int vx, int vy)`
`void`	`freeMemory()` This method was deprecated in API level 19. Memory caches are automatically dropped when no longer needed, and in response to system memory pressure.
`CharSequence`	`getAccessibilityClassName()` Return the class name of this object to be used for accessibility purposes.
`AccessibilityNodeProvider`	`getAccessibilityNodeProvider()` Gets the provider for managing a virtual view hierarchy rooted at this View and reported to `AccessibilityService`s that explore the window content.
`SslCertificate`	`getCertificate()` Gets the SSL certificate for the main top-level page or null if there is no certificate (the site is not secure).
`int`	`getContentHeight()` Gets the height of the HTML content.
`static PackageInfo`	`getCurrentWebViewPackage()` If WebView has already been loaded into the current process this method will return the package that was used to load it.
`Bitmap`	`getFavicon()` Gets the favicon for the current page.
`Handler`	`getHandler()`
`WebView.HitTestResult`	`getHitTestResult()` Gets a HitTestResult based on the current cursor node.
`String[]`	`getHttpAuthUsernamePassword(String host, String realm)` This method was deprecated in API level 26. Use `getHttpAuthUsernamePassword(String, String)` instead
`String`	`getOriginalUrl()` Gets the original URL for the current page.
`int`	`getProgress()` Gets the progress for the current page.
`boolean`	`getRendererPriorityWaivedWhenNotVisible()` Return whether this WebView requests a priority of `RENDERER_PRIORITY_WAIVED` when not visible.
`int`	`getRendererRequestedPriority()` Get the requested renderer priority for this WebView.
`static Uri`	`getSafeBrowsingPrivacyPolicyUrl()` Returns a URL pointing to the privacy policy for Safe Browsing reporting.
`float`	`getScale()` This method was deprecated in API level 17. This method is prone to inaccuracy due to race conditions between the web rendering and UI threads; prefer `onScaleChanged(WebView, float, float)`.
`WebSettings`	`getSettings()` Gets the WebSettings object used to control the settings for this WebView.
`TextClassifier`	`getTextClassifier()` Returns the `TextClassifier` used by this WebView.
`String`	`getTitle()` Gets the title for the current page.
`String`	`getUrl()` Gets the URL for the current page.
`WebChromeClient`	`getWebChromeClient()` Gets the chrome handler.
`WebViewClient`	`getWebViewClient()` Gets the WebViewClient.
`void`	`goBack()` Goes back in the history of this WebView.
`void`	`goBackOrForward(int steps)` Goes to the history item that is the number of steps away from the current item.
`void`	`goForward()` Goes forward in the history of this WebView.
`void`	`invokeZoomPicker()` Invokes the graphical zoom picker widget for this WebView.
`boolean`	`isPrivateBrowsingEnabled()` Gets whether private browsing is enabled in this WebView.
`void`	`loadData(String data, String mimeType, String encoding)` Loads the given data into this WebView using a 'data' scheme URL.
`void`	`loadDataWithBaseURL(String baseUrl, String data, String mimeType, String encoding, StringhistoryUrl)` Loads the given data into this WebView, using baseUrl as the base URL for the content.
`void`	`loadUrl(String url)` Loads the given URL.
`void`	`loadUrl(String url, Map<String, String> additionalHttpHeaders)` Loads the given URL with the specified additional HTTP headers.
`void`	`onChildViewAdded(View parent, View child)` This method was deprecated in API level 8. WebView no longer needs to implement ViewGroup.OnHierarchyChangeListener. This method does nothing now.
`void`	`onChildViewRemoved(View p, View child)` This method was deprecated in API level 8. WebView no longer needs to implement ViewGroup.OnHierarchyChangeListener. This method does nothing now.
`InputConnection`	`onCreateInputConnection(EditorInfo outAttrs)` Creates a new InputConnection for an InputMethod to interact with the WebView.
`boolean`	`onDragEvent(DragEvent event)` Handles drag events sent by the system following a call to `startDragAndDrop()`.
`void`	`onFinishTemporaryDetach()` Called after `onStartTemporaryDetach()` when the container is done changing the view.
`boolean`	`onGenericMotionEvent(MotionEvent event)` Implement this method to handle generic motion events.
`void`	`onGlobalFocusChanged(View oldFocus, View newFocus)` This method was deprecated in API level 3. WebView should not have implemented ViewTreeObserver.OnGlobalFocusChangeListener. This method does nothing now.
`boolean`	`onHoverEvent(MotionEvent event)` Implement this method to handle hover events.
`boolean`	`onKeyDown(int keyCode, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyDown()`: perform press of the view when `KEYCODE_DPAD_CENTER` or `KEYCODE_ENTER` is released, if the view is enabled and clickable.
`boolean`	`onKeyMultiple(int keyCode, int repeatCount, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyMultiple()`: always returns false (doesn't handle the event).
`boolean`	`onKeyUp(int keyCode, KeyEvent event)` Default implementation of `KeyEvent.Callback.onKeyUp()`: perform clicking of the view when `KEYCODE_DPAD_CENTER`, `KEYCODE_ENTER` or `KEYCODE_SPACE` is released.
`void`	`onPause()` Does a best-effort attempt to pause any processing that can be paused safely, such as animations and geolocation.
`void`	`onProvideAutofillVirtualStructure(ViewStructure structure, int flags)` Populates a `ViewStructure` containing virtual children to fullfil an autofill request. The `ViewStructure` traditionally represents a `View`, while for web pages it represent HTML nodes.
`void`	`onProvideVirtualStructure(ViewStructure structure)` Called when assist structure is being retrieved from a view as part of `Activity.onProvideAssistData` to generate additional virtual structure under this view.
`void`	`onResume()` Resumes a WebView after a previous call to `onPause()`.
`void`	`onStartTemporaryDetach()` This is called when a container is going to temporarily detach a child, with `ViewGroup.detachViewFromParent`.
`boolean`	`onTouchEvent(MotionEvent event)` Implement this method to handle touch screen motion events.
`boolean`	`onTrackballEvent(MotionEvent event)` Implement this method to handle trackball motion events.
`void`	`onWindowFocusChanged(boolean hasWindowFocus)` Called when the window containing this view gains or loses focus.
`boolean`	`overlayHorizontalScrollbar()` This method was deprecated in API level 23. This method is now obsolete.
`boolean`	`overlayVerticalScrollbar()` This method was deprecated in API level 23. This method is now obsolete.
`boolean`	`pageDown(boolean bottom)` Scrolls the contents of this WebView down by half the page size.
`boolean`	`pageUp(boolean top)` Scrolls the contents of this WebView up by half the view size.
`void`	`pauseTimers()` Pauses all layout, parsing, and JavaScript timers for all WebViews.
`boolean`	`performLongClick()` Calls this view's OnLongClickListener, if it is defined.
`void`	`postUrl(String url, byte[] postData)` Loads the URL with postData using "POST" method into this WebView.
`void`	`postVisualStateCallback(long requestId, WebView.VisualStateCallback callback)` Posts a `WebView.VisualStateCallback`, which will be called when the current state of the WebView is ready to be drawn.
`void`	`postWebMessage(WebMessage message, Uri targetOrigin)` Post a message to main frame.
`void`	`reload()` Reloads the current URL.
`void`	`removeJavascriptInterface(String name)` Removes a previously injected Java object from this WebView.
`boolean`	`requestChildRectangleOnScreen(View child, Rect rect, boolean immediate)` Called when a child of this group wants a particular rectangle to be positioned onto the screen.
`boolean`	`requestFocus(int direction, Rect previouslyFocusedRect)` Call this to try to give focus to a specific view or to one of its descendants and give it hints about the direction and a specific rectangle that the focus is coming from. Looks for a view to give focus to respecting the setting specified by `getDescendantFocusability()`.
`void`	`requestFocusNodeHref(Message hrefMsg)` Requests the anchor or image element URL at the last tapped point.
`void`	`requestImageRef(Message msg)` Requests the URL of the image last touched by the user.
`WebBackForwardList`	`restoreState(Bundle inState)` Restores the state of this WebView from the given Bundle.
`void`	`resumeTimers()` Resumes all layout, parsing, and JavaScript timers for all WebViews.
`void`	`savePassword(String host, String username, String password)` This method was deprecated in API level 18. Saving passwords in WebView will not be supported in future versions.
`WebBackForwardList`	`saveState(Bundle outState)` Saves the state of this WebView used in `onSaveInstanceState(Bundle)`.
`void`	`saveWebArchive(String filename)` Saves the current view as a web archive.
`void`	`saveWebArchive(String basename, boolean autoname, ValueCallback<String> callback)` Saves the current view as a web archive.
`void`	`setBackgroundColor(int color)` Sets the background color for this view.
`void`	`setCertificate(SslCertificate certificate)` This method was deprecated in API level 17. Calling this function has no useful effect, and will be ignored in future releases.
`void`	`setDownloadListener(DownloadListener listener)` Registers the interface to be used when content can not be handled by the rendering engine, and should be downloaded instead.
`void`	`setFindListener(WebView.FindListener listener)` Registers the listener to be notified as find-on-page operations progress.
`void`	`setHorizontalScrollbarOverlay(boolean overlay)` This method was deprecated in API level 23. This method has no effect.
`void`	`setHttpAuthUsernamePassword(String host, String realm, String username, String password)` This method was deprecated in API level 26. Use `setHttpAuthUsernamePassword(String, String, String, String)` instead
`void`	`setInitialScale(int scaleInPercent)` Sets the initial scale for this WebView.
`void`	`setLayerType(int layerType, Paint paint)` Specifies the type of layer backing this view.
`void`	`setLayoutParams(ViewGroup.LayoutParams params)` Set the layout parameters associated with this view.
`void`	`setMapTrackballToArrowKeys(boolean setMap)` This method was deprecated in API level 17. Only the default case, true, will be supported in a future version.
`void`	`setNetworkAvailable(boolean networkUp)` Informs WebView of the network state.
`void`	`setOverScrollMode(int mode)` Set the over-scroll mode for this view.
`void`	`setPictureListener(WebView.PictureListener listener)` This method was deprecated in API level 12. This method is now obsolete.
`void`	`setRendererPriorityPolicy(int rendererRequestedPriority, boolean waivedWhenNotVisible)` Set the renderer priority policy for this `WebView`.
`static void`	`setSafeBrowsingWhitelist(List<String> urls, ValueCallback<Boolean> callback)` Sets the list of domains that are exempt from SafeBrowsing checks.
`void`	`setScrollBarStyle(int style)` Specify the style of the scrollbars.
`void`	`setTextClassifier(TextClassifier textClassifier)` Sets the `TextClassifier` for this WebView.
`void`	`setVerticalScrollbarOverlay(boolean overlay)` This method was deprecated in API level 23. This method has no effect.
`void`	`setWebChromeClient(WebChromeClient client)` Sets the chrome handler.
`static void`	`setWebContentsDebuggingEnabled(boolean enabled)` Enables debugging of web contents (HTML / CSS / JavaScript) loaded into any WebViews of this application.
`void`	`setWebViewClient(WebViewClient client)` Sets the WebViewClient that will receive various notifications and requests.
`boolean`	`shouldDelayChildPressedState()` Return true if the pressed state should be delayed for children or descendants of this ViewGroup.
`boolean`	`showFindDialog(String text, boolean showIme)` This method was deprecated in API level 18. This method does not work reliably on all Android versions; implementing a custom find dialog using WebView.findAllAsync() provides a more robust solution.
`static void`	`startSafeBrowsing(Context context, ValueCallback<Boolean> callback)` Starts Safe Browsing initialization.
`void`	`stopLoading()` Stops the current load.
`void`	`zoomBy(float zoomFactor)` Performs a zoom operation in this WebView.
`boolean`	`zoomIn()` Performs zoom in in this WebView.
`boolean`	`zoomOut()` Performs zoom out in this WebView.

Protected methods
`int`	`computeHorizontalScrollOffset()` Compute the horizontal offset of the horizontal scrollbar's thumb within the horizontal range.
`int`	`computeHorizontalScrollRange()` Compute the horizontal range that the horizontal scrollbar represents.
`int`	`computeVerticalScrollExtent()` Compute the vertical extent of the vertical scrollbar's thumb within the vertical range.
`int`	`computeVerticalScrollOffset()` Compute the vertical offset of the vertical scrollbar's thumb within the horizontal range.
`int`	`computeVerticalScrollRange()` Compute the vertical range that the vertical scrollbar represents.
`void`	`dispatchDraw(Canvas canvas)` Called by draw to draw the child views.
`void`	`onAttachedToWindow()` This is called when the view is attached to a window.
`void`	`onConfigurationChanged(Configuration newConfig)` Called when the current configuration of the resources being used by the application have changed.
`void`	`onDraw(Canvas canvas)` Implement this to do your drawing.
`void`	`onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect)` Called by the view system when the focus state of this view changes.
`void`	`onMeasure(int widthMeasureSpec, int heightMeasureSpec)` Measure the view and its content to determine the measured width and the measured height.
`void`	`onOverScrolled(int scrollX, int scrollY, boolean clampedX, boolean clampedY)` Called by `overScrollBy(int, int, int, int, int, int, int, int, boolean)` to respond to the results of an over-scroll operation.
`void`	`onScrollChanged(int l, int t, int oldl, int oldt)` This is called in response to an internal scroll in this view (i.e., the view scrolled its own contents).
`void`	`onSizeChanged(int w, int h, int ow, int oh)` This is called during layout when the size of this view has changed.
`void`	`onVisibilityChanged(View changedView, int visibility)` Called when the visibility of the view or an ancestor of the view has changed.
`void`	`onWindowVisibilityChanged(int visibility)` Called when the window containing has change its visibility (between `GONE`, `INVISIBLE`, and `VISIBLE`).

Inherited methods
From class `android.widget.AbsoluteLayout`
From class `android.view.ViewGroup`
From class `android.view.View`
From class `java.lang.Object`
From interface `android.view.ViewParent`
From interface `android.view.ViewManager`
From interface `android.graphics.drawable.Drawable.Callback`
From interface `android.view.KeyEvent.Callback`
From interface `android.view.accessibility.AccessibilityEventSource`
From interface `android.view.ViewTreeObserver.OnGlobalFocusChangeListener`
From interface `android.view.ViewGroup.OnHierarchyChangeListener`

Constants

RENDERER_PRIORITY_BOUND

added in API level 26

int RENDERER_PRIORITY_BOUND

The renderer associated with this WebView is bound with the default priority for services. Use with setRendererPriorityPolicy(int, boolean).

Constant Value: 1 (0x00000001)

RENDERER_PRIORITY_IMPORTANT

added in API level 26

int RENDERER_PRIORITY_IMPORTANT

The renderer associated with this WebView is bound with BIND_IMPORTANT. Use with setRendererPriorityPolicy(int, boolean).

Constant Value: 2 (0x00000002)

RENDERER_PRIORITY_WAIVED

added in API level 26

int RENDERER_PRIORITY_WAIVED

The renderer associated with this WebView is bound with BIND_WAIVE_PRIORITY. At this priority level WebView renderers will be strong targets for out of memory killing. Use with setRendererPriorityPolicy(int, boolean).

Constant Value: 0 (0x00000000)

Parameters
`context`	`Context`: a Context object used to access application assets
`attrs`	`AttributeSet`: an AttributeSet passed to our parent

Parameters
`object`	`Object`: the Java object to inject into this WebView's JavaScript context. Null values are ignored.
`name`	`String`: the name used to expose the object in JavaScript

Parameters
`script`	`String`: the JavaScript to execute.
`resultCallback`	`ValueCallback`: A callback to be invoked when the script execution completes with the result of the execution (if any). May be null if no notification of the result is required.

Parameters
`host`	`String`: the host to which the credentials apply
`realm`	`String`: the realm to which the credentials apply

Parameters
`data`	`String`: a String of data in the given encoding
`mimeType`	`String`: the MIME type of the data, e.g. 'text/html'
`encoding`	`String`: the encoding of the data

Parameters
`baseUrl`	`String`: the URL to use as the page's base URL. If null defaults to 'about:blank'.
`data`	`String`: a String of data in the given encoding
`mimeType`	`String`: the MIMEType of the data, e.g. 'text/html'. If null, defaults to 'text/html'.
`encoding`	`String`: the encoding of the data
`historyUrl`	`String`: the URL to use as the history entry. If null defaults to 'about:blank'. If non-null, this must be a valid URL.

Parameters
`url`	`String`: the URL of the resource to load
`additionalHttpHeaders`	`Map`: the additional headers to be used in the HTTP request for this URL, specified as a map from name to value. Note that if this map contains any of the headers that are set by default by this WebView, such as those controlling caching, accept types or the User-Agent, their values may be overridden by this WebView's defaults.

Parameters
`parent`	`View`: the view in which a child was added
`child`	`View`: the new child view added in the hierarchy

Parameters
`p`	`View`: the view from which the child was removed
`child`	`View`: the child removed from the hierarchy

Parameters
`oldFocus`	`View`: The previously focused view, if any.
`newFocus`	`View`: The newly focused View, if any.

Parameters
`keyCode`	`int`: a key code that represents the button pressed, from `KeyEvent`
`event`	`KeyEvent`: the KeyEvent object that defines the button action

Parameters
`keyCode`	`int`: A key code that represents the button pressed, from `KeyEvent`.
`repeatCount`	`int`: The number of times the action was made.
`event`	`KeyEvent`: The KeyEvent object that defines the button action.

Parameters
`structure`	`ViewStructure`: fill in with virtual children data for autofill purposes.
`flags`	`int`: optional flags.

Parameters
`url`	`String`: the URL of the resource to load
`postData`	`byte`: the data will be passed to "POST" request, which must be be "application/x-www-form-urlencoded" encoded.

Parameters
`requestId`	`long`: An id that will be returned in the callback to allow callers to match requests with callbacks.
`callback`	`WebView.VisualStateCallback`: The callback to be invoked.

Parameters
`message`	`WebMessage`: the WebMessage
`targetOrigin`	`Uri`: the target origin.

Parameters
`child`	`View`: The direct child making the request.
`rect`	`Rect`: The rectangle in the child's coordinates the child wishes to be on the screen.
`immediate`	`boolean`: True to forbid animated or delayed scrolling, false otherwise

Parameters
`direction`	`int`: One of FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, and FOCUS_RIGHT
`previouslyFocusedRect`	`Rect`: The rectangle (in this View's coordinate system) to give a finer grained hint about where focus is coming from. May be null if there is no hint.

Parameters
`host`	`String`: the host that required the credentials
`username`	`String`: the username for the given host
`password`	`String`: the password for the given host

Parameters
`basename`	`String`: the filename where the archive should be placed
`autoname`	`boolean`: if false, takes basename to be a file. If true, basename is assumed to be a directory in which a filename will be chosen according to the URL of the current page.
`callback`	`ValueCallback`: called after the web archive has been saved. The parameter for onReceiveValue will either be the filename under which the file was saved, or null if saving the file failed.

zhen

android WebView

Annotations

Interfaces

Classes

Enums

WebView

Basic usage

Zoom

Cookie and window management

Building web pages to support different screen densities

HTML5 Video support

Full screen support

HTML5 Geolocation API support

Layout size

Metrics

Safe Browsing

Summary

Nested classes

Inherited XML attributes

Constants

Inherited constants

Inherited fields

Public constructors

Public methods

Protected methods

Inherited methods

Constants

RENDERER_PRIORITY_BOUND

RENDERER_PRIORITY_IMPORTANT

RENDERER_PRIORITY_WAIVED

SCHEME_GEO

SCHEME_MAILTO

SCHEME_TEL

Public constructors

WebView

WebView

WebView

WebView

WebView

Public methods

addJavascriptInterface

autofill

canGoBack

canGoBackOrForward

canGoForward

canZoomIn

canZoomOut

capturePicture

clearCache

clearClientCertPreferences

clearFormData

clearHistory

clearMatches

clearSslPreferences

clearView

computeScroll

copyBackForwardList

createPrintDocumentAdapter

createPrintDocumentAdapter

createWebMessageChannel

destroy

dispatchKeyEvent

documentHasImages

enableSlowWholeDocumentDraw

evaluateJavascript

findAddress

findAll

findAllAsync

findFocus

findNext

flingScroll

freeMemory

getAccessibilityClassName

getAccessibilityNodeProvider

getCertificate

getContentHeight

getCurrentWebViewPackage

getFavicon

getHandler

Parameters
`layerType`	`int`: The type of layer to use with this view, must be one of `LAYER_TYPE_NONE`, `LAYER_TYPE_SOFTWARE` or `LAYER_TYPE_HARDWARE`
`paint`	`Paint`: The paint used to compose the layer. This argument is optional and can be null. It is ignored when the layer type is`LAYER_TYPE_NONE`

Parameters
`rendererRequestedPriority`	`int`: the minimum priority at which this WebView desires the renderer process to be bound.
`waivedWhenNotVisible`	`boolean`: if true, this flag specifies that when this WebView is not visible, it will be treated as if it had requested a priority of `RENDERER_PRIORITY_WAIVED`.

Rule	Example	Matches Subdomain
HOSTNAME	example.com	Yes
.HOSTNAME	.example.com	No
IPV4_LITERAL	192.168.1.1	No
IPV6_LITERAL_WITH_BRACKETS	[10:20:30:40:50:60:70:80]	No

Parameters
`urls`	`List`: the list of URLs This value must never be `null`.
`callback`	`ValueCallback`: will be called with true if URLs are successfully added to the whitelist. It will be called with false if any URLs are malformed. The callback will be run on the UI thread This value may be `null`.

Parameters
`text`	`String`: if non-null, will be the initial text to search for. Otherwise, the last String searched for in this WebView will be used to start.
`showIme`	`boolean`: if true, show the IME, assuming the user will begin typing. If false and text is non-null, perform a find all.

Parameters
`context`	`Context`: Application Context.
`callback`	`ValueCallback`: will be called on the UI thread with `true` if initialization is successful, `false` otherwise.

Parameters
`focused`	`boolean`: True if the View has focus; false otherwise.
`direction`	`int`: The direction focus has moved when requestFocus() is called to give this view focus. Values are `FOCUS_UP`, `FOCUS_DOWN`, `FOCUS_LEFT`, `FOCUS_RIGHT`, `FOCUS_FORWARD`, or `FOCUS_BACKWARD`. It may not always apply, in which case use the default.
`previouslyFocusedRect`	`Rect`: The rectangle, in this view's coordinate system, of the previously focused view. If applicable, this will be passed in as finer grained information about where the focus is coming from (in addition to direction). Will be `null` otherwise.

Parameters
`widthMeasureSpec`	`int`: horizontal space requirements as imposed by the parent. The requirements are encoded with `View.MeasureSpec`.
`heightMeasureSpec`	`int`: vertical space requirements as imposed by the parent. The requirements are encoded with `View.MeasureSpec`.

Parameters
`scrollX`	`int`: New X scroll value in pixels
`scrollY`	`int`: New Y scroll value in pixels
`clampedX`	`boolean`: True if scrollX was clamped to an over-scroll boundary
`clampedY`	`boolean`: True if scrollY was clamped to an over-scroll boundary

Parameters
`l`	`int`: Current horizontal scroll origin.
`t`	`int`: Current vertical scroll origin.
`oldl`	`int`: Previous horizontal scroll origin.
`oldt`	`int`: Previous vertical scroll origin.