WebSettings

FORCE_DARK_AUTO

static val FORCE_DARK_AUTO: Int

Deprecated: refer to setForceDark

Enable force dark dependent on the state of the WebView parent view. If the WebView parent view is being automatically force darkened (see: android.view.View#setForceDarkAllowed), then WebView content will be rendered so as to emulate a dark theme. WebViews that are not attached to the view hierarchy will not be inverted.

Value: 1

FORCE_DARK_OFF

static val FORCE_DARK_OFF: Int

Deprecated: refer to setForceDark

Disable force dark, irrespective of the force dark mode of the WebView parent. In this mode, WebView content will always be rendered as-is, regardless of whether native views are being automatically darkened.

Value: 0

FORCE_DARK_ON

static val FORCE_DARK_ON: Int

Deprecated: refer to setForceDark

Unconditionally enable force dark. In this mode WebView content will always be rendered so as to emulate a dark theme.

Value: 2

LOAD_CACHE_ELSE_NETWORK

static val LOAD_CACHE_ELSE_NETWORK: Int

Use cached resources when they are available, even if they have expired. Otherwise load resources from the network. Use with setCacheMode.

Value: 1

LOAD_CACHE_ONLY

static val LOAD_CACHE_ONLY: Int

Don't use the network, load from the cache. Use with setCacheMode.

Value: 3

LOAD_DEFAULT

static val LOAD_DEFAULT: Int

Default cache usage mode. If the navigation type doesn't impose any specific behavior, use cached resources when they are available and not expired, otherwise load resources from the network. Use with setCacheMode.

Value: -1

LOAD_NORMAL

static val LOAD_NORMAL: Int

Deprecated: This value is obsolete, as from API level android.os.Build.VERSION_CODES#HONEYCOMB and onwards it has the same effect as LOAD_DEFAULT.

Normal cache usage mode. Use with setCacheMode.

Value: 0

LOAD_NO_CACHE

static val LOAD_NO_CACHE: Int

Don't use the cache, load from the network. Use with setCacheMode.

Value: 2

MENU_ITEM_NONE

static val MENU_ITEM_NONE: Int

No menu items should be disabled.

Value: 0

MENU_ITEM_PROCESS_TEXT

static val MENU_ITEM_PROCESS_TEXT: Int

Disable all the action mode menu items for text processing. By default WebView searches for activities that are able to handle android.content.Intent#ACTION_PROCESS_TEXT and show them in the action mode menu. If this flag is set via setDisabledActionModeMenuItems, these menu items will be disabled.

Value: 4

MENU_ITEM_SHARE

static val MENU_ITEM_SHARE: Int

Disable menu item "Share".

Value: 1

MENU_ITEM_WEB_SEARCH

static val MENU_ITEM_WEB_SEARCH: Int

Disable menu item "Web Search".

Value: 2

MIXED_CONTENT_ALWAYS_ALLOW

static val MIXED_CONTENT_ALWAYS_ALLOW: Int

In this mode, the WebView will allow a secure origin to load content from any other origin, even if that origin is insecure. This is the least secure mode of operation for the WebView, and where possible apps should not set this mode.

Value: 0

MIXED_CONTENT_COMPATIBILITY_MODE

static val MIXED_CONTENT_COMPATIBILITY_MODE: Int

In this mode, the WebView will attempt to be compatible with the approach of a modern web browser with regard to mixed content. Some insecure content may be allowed to be loaded by a secure origin and other types of content will be blocked. The types of content are allowed or blocked may change release to release and are not explicitly defined. This mode is intended to be used by apps that are not in control of the content that they render but desire to operate in a reasonably secure environment. For highest security, apps are recommended to use MIXED_CONTENT_NEVER_ALLOW.

Value: 2

MIXED_CONTENT_NEVER_ALLOW

static val MIXED_CONTENT_NEVER_ALLOW: Int

In this mode, the WebView will not allow a secure origin to load content from an insecure origin. This is the preferred and most secure mode of operation for the WebView and apps are strongly advised to use this mode.

Value: 1

enableSmoothTransition

abstract fun enableSmoothTransition(): Boolean

Deprecated: This method is now obsolete, and will become a no-op in future.

Gets whether the WebView enables smooth transition while panning or zooming.

getAllowContentAccess

abstract fun getAllowContentAccess(): Boolean

Gets whether this WebView supports content URL access.

getAllowFileAccess

abstract fun getAllowFileAccess(): Boolean

Gets whether this WebView supports file access.

getAllowFileAccessFromFileURLs

abstract fun getAllowFileAccessFromFileURLs(): Boolean

Gets whether JavaScript running in the context of a file scheme URL can access content from other file scheme URLs.

getAllowUniversalAccessFromFileURLs

abstract fun getAllowUniversalAccessFromFileURLs(): Boolean

Gets whether JavaScript running in the context of a file scheme URL can access content from any origin. This includes access to content from other file scheme URLs.

getBlockNetworkImage

abstract fun getBlockNetworkImage(): Boolean

Gets whether the WebView does not load image resources from the network.

getBlockNetworkLoads

abstract fun getBlockNetworkLoads(): Boolean

Gets whether the WebView does not load any resources from the network.

getBuiltInZoomControls

abstract fun getBuiltInZoomControls(): Boolean

Gets whether the zoom mechanisms built into WebView are being used.

getCacheMode

abstract fun getCacheMode(): Int

Gets the current setting for overriding the cache mode.

getCursiveFontFamily

abstract fun getCursiveFontFamily(): String!

Gets the cursive font family name.

getDatabaseEnabled

abstract fun getDatabaseEnabled(): Boolean

Deprecated: WebSQL is deprecated and this method will become a no-op on all Android versions once support is removed in Chromium. See https://developer.chrome.com/blog/deprecating-web-sql for more information.

Gets whether the database storage API is enabled.

getDatabasePath

abstract fun getDatabasePath(): String!

Deprecated: Database paths are managed by the implementation this method is obsolete.

Gets the path to where database storage API databases are saved.

getDefaultFixedFontSize

abstract fun getDefaultFixedFontSize(): Int

Gets the default fixed font size.

getDefaultFontSize

abstract fun getDefaultFontSize(): Int

Gets the default font size.

getDefaultTextEncodingName

abstract fun getDefaultTextEncodingName(): String!

Gets the default text encoding name.

getDefaultUserAgent

open static fun getDefaultUserAgent(context: Context!): String!

Returns the default User-Agent used by a WebView. An instance of WebView could use a different User-Agent if a call is made to WebSettings.setUserAgentString(String).

getDefaultZoom

abstract fun getDefaultZoom(): WebSettings.ZoomDensity!

Deprecated: Will only return the default value.

Gets the default zoom density of the page. This should be called from the UI thread. This setting is not recommended for use in new applications.

getDisabledActionModeMenuItems

abstract fun getDisabledActionModeMenuItems(): Int

Gets the action mode menu items that are disabled, expressed in an integer field flag. The default value is MENU_ITEM_NONE

getDisplayZoomControls

abstract fun getDisplayZoomControls(): Boolean

Gets whether the WebView displays on-screen zoom controls when using the built-in zoom mechanisms.

getDomStorageEnabled

abstract fun getDomStorageEnabled(): Boolean

Gets whether the DOM Storage APIs are enabled.

getFantasyFontFamily

abstract fun getFantasyFontFamily(): String!

Gets the fantasy font family name.

getFixedFontFamily

abstract fun getFixedFontFamily(): String!

Gets the fixed font family name.

getForceDark

open fun getForceDark(): Int

Deprecated: refer to setForceDark.

Get the force dark mode for this WebView. The default force dark mode is FORCE_DARK_AUTO.

getJavaScriptCanOpenWindowsAutomatically

abstract fun getJavaScriptCanOpenWindowsAutomatically(): Boolean

Gets whether JavaScript can open windows without a user gesture.

getJavaScriptEnabled

abstract fun getJavaScriptEnabled(): Boolean

Gets whether JavaScript is enabled.

getLayoutAlgorithm

abstract fun getLayoutAlgorithm(): WebSettings.LayoutAlgorithm!

Gets the current layout algorithm.

getLightTouchEnabled

abstract fun getLightTouchEnabled(): Boolean

Deprecated: This setting is obsolete.

Gets whether light touches are enabled.

getLoadWithOverviewMode

abstract fun getLoadWithOverviewMode(): Boolean

Gets whether this WebView loads pages in overview mode.

getLoadsImagesAutomatically

abstract fun getLoadsImagesAutomatically(): Boolean

Gets whether the WebView loads image resources. This includes images embedded using the data URI scheme.

getMediaPlaybackRequiresUserGesture

abstract fun getMediaPlaybackRequiresUserGesture(): Boolean

Gets whether the WebView requires a user gesture to play media.

getMinimumFontSize

abstract fun getMinimumFontSize(): Int

Gets the minimum font size.

getMinimumLogicalFontSize

abstract fun getMinimumLogicalFontSize(): Int

Gets the minimum logical font size.

getMixedContentMode

abstract fun getMixedContentMode(): Int

Gets the current behavior of the WebView with regard to loading insecure content from a secure origin.

getOffscreenPreRaster

abstract fun getOffscreenPreRaster(): Boolean

Gets whether this WebView should raster tiles when it is offscreen but attached to a window.

getPluginState

abstract fun getPluginState(): WebSettings.PluginState!

Deprecated: Plugins are not supported in API level android.os.Build.VERSION_CODES#KITKAT or later; enabling plugins is a no-op.

Gets the current state regarding whether plugins are enabled.

getSafeBrowsingEnabled

abstract fun getSafeBrowsingEnabled(): Boolean

Gets whether Safe Browsing is enabled. See setSafeBrowsingEnabled.

getSansSerifFontFamily

abstract fun getSansSerifFontFamily(): String!

Gets the sans-serif font family name.

getSaveFormData

abstract fun getSaveFormData(): Boolean

Deprecated: In Android O and afterwards, this function does not have any effect. Form data will be filled from the platform's autofill service if applicable.

Gets whether the WebView saves form data. In android.os.Build.VERSION_CODES#O, the platform has implemented a fully functional Autofill feature to store form data. Therefore, the Webview form data save feature is disabled.

Note that the feature will continue to be supported on older versions of Android as before.

getSavePassword

abstract fun getSavePassword(): Boolean

Deprecated: Saving passwords in WebView will not be supported in future versions.

Gets whether the WebView saves passwords.

getSerifFontFamily

abstract fun getSerifFontFamily(): String!

Gets the serif font family name. The default is "serif".

getStandardFontFamily

abstract fun getStandardFontFamily(): String!

Gets the standard font family name.

getTextSize

open fun getTextSize(): WebSettings.TextSize!

Deprecated: Use getTextZoom instead.

Gets the text size of the page. If the text size was previously specified in percent using setTextZoom, this will return the closest matching TextSize.

getTextZoom

abstract fun getTextZoom(): Int

Gets the text zoom of the page in percent.

getUseWideViewPort

abstract fun getUseWideViewPort(): Boolean

Gets whether the WebView supports the "viewport" HTML meta tag or will use a wide viewport.

getUserAgentString

abstract fun getUserAgentString(): String!

Gets the WebView's user-agent string.

isAlgorithmicDarkeningAllowed

open fun isAlgorithmicDarkeningAllowed(): Boolean

Get if algorithmic darkening is allowed or not for this WebView. The default is false.

setAlgorithmicDarkeningAllowed

open fun setAlgorithmicDarkeningAllowed(allow: Boolean): Unit

Control whether algorithmic darkening is allowed.

Note: This API and the behaviour described only apply to apps with targetSdkVersion ≥ android.os.Build.VERSION_CODES#TIRAMISU.

WebView always sets the media query prefers-color-scheme according to the app's theme attribute isLightTheme, i.e. prefers-color-scheme is light if isLightTheme is true or not specified, otherwise it is dark. This means that the web content's light or dark style will be applied automatically to match the app's theme if the content supports it.

Algorithmic darkening is disallowed by default.

If the app's theme is dark and it allows algorithmic darkening, WebView will attempt to darken web content using an algorithm, if the content doesn't define its own dark styles and doesn't explicitly disable darkening.

If Android is applying Force Dark to WebView then WebView will ignore the value of this setting and behave as if it were set to true.

The deprecated setForceDark and related API are no-ops in apps with targetSdkVersion ≥ android.os.Build.VERSION_CODES#TIRAMISU, but they still apply to apps with targetSdkVersion < android.os.Build.VERSION_CODES#TIRAMISU.

The below table summarizes how APIs work with different apps.

setAllowContentAccess

abstract fun setAllowContentAccess(allow: Boolean): Unit

Enables or disables content URL access within WebView. Content URL access allows WebView to load content from a content provider installed in the system. The default is enabled.

setAllowFileAccess

abstract fun setAllowFileAccess(allow: Boolean): Unit

Enables or disables file access within WebView. Note that this enables or disables file system access only. Assets and resources are still accessible using file:///android_asset and file:///android_res.

Note: Apps should not open file:// URLs from any external source in WebView, don't enable this if your app accepts arbitrary URLs from external sources. It's recommended to always use androidx.webkit.WebViewAssetLoader to access files including assets and resources over http(s):// schemes, instead of file:// URLs. To prevent possible security issues targeting android.os.Build.VERSION_CODES#Q and earlier, you should explicitly set this value to false.

The default value is true for apps targeting android.os.Build.VERSION_CODES#Q and below, and false when targeting android.os.Build.VERSION_CODES#R and above.

setAllowFileAccessFromFileURLs

abstract fun setAllowFileAccessFromFileURLs(flag: Boolean): Unit

Deprecated: This setting is not secure, please use androidx.webkit.WebViewAssetLoader to load file content securely.

Sets whether cross-origin requests in the context of a file scheme URL should be allowed to access content from other file scheme URLs. Note that some accesses such as image HTML elements don't follow same-origin rules and aren't affected by this setting.

Don't enable this setting if you open files that may be created or altered by external sources. Enabling this setting allows malicious scripts loaded in a file:// context to access arbitrary local files including WebView cookies and app private data.

Loading content via file:// URLs is generally discouraged. See the note in setAllowFileAccess.

Note that the value of this setting is ignored if the value of getAllowUniversalAccessFromFileURLs is true. The default value is true for apps targeting android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH_MR1 and below, and false when targeting android.os.Build.VERSION_CODES#JELLY_BEAN and above. To prevent possible violation of same domain policy when targeting android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH_MR1 and earlier, you should explicitly set this value to false.

setAllowUniversalAccessFromFileURLs

abstract fun setAllowUniversalAccessFromFileURLs(flag: Boolean): Unit

Deprecated: This setting is not secure, please use androidx.webkit.WebViewAssetLoader to load file content securely.

Sets whether cross-origin requests in the context of a file scheme URL should be allowed to access content from any origin. This includes access to content from other file scheme URLs or web contexts. Note that some access such as image HTML elements doesn't follow same-origin rules and isn't affected by this setting.

Don't enable this setting if you open files that may be created or altered by external sources. Enabling this setting allows malicious scripts loaded in a file:// context to launch cross-site scripting attacks, either accessing arbitrary local files including WebView cookies, app private data or even credentials used on arbitrary web sites.

Loading content via file:// URLs is generally discouraged. See the note in setAllowFileAccess.

The default value is true for apps targeting android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH_MR1 and below, and false when targeting android.os.Build.VERSION_CODES#JELLY_BEAN and above. To prevent possible violation of same domain policy when targeting android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH_MR1 and earlier, you should explicitly set this value to false.

setBlockNetworkImage

abstract fun setBlockNetworkImage(flag: Boolean): Unit

Sets whether the WebView should not load image resources from the network (resources accessed via http and https URI schemes). Note that this method has no effect unless getLoadsImagesAutomatically returns true. Also note that disabling all network loads using setBlockNetworkLoads will also prevent network images from loading, even if this flag is set to false. When the value of this setting is changed from true to false, network images resources referenced by content currently displayed by the WebView are fetched automatically. The default is false.

setBlockNetworkLoads

abstract fun setBlockNetworkLoads(flag: Boolean): Unit

Sets whether the WebView should not load resources from the network. Use setBlockNetworkImage to only avoid loading image resources. Note that if the value of this setting is changed from true to false, network resources referenced by content currently displayed by the WebView are not fetched until android.webkit.WebView#reload is called. If the application does not have the android.Manifest.permission#INTERNET permission, attempts to set a value of false will cause a java.lang.SecurityException to be thrown. The default value is false if the application has the android.Manifest.permission#INTERNET permission, otherwise it is true.

setBuiltInZoomControls

abstract fun setBuiltInZoomControls(enabled: Boolean): Unit

Sets whether the WebView should use its built-in zoom mechanisms. The built-in zoom mechanisms comprise on-screen zoom controls, which are displayed over the WebView's content, and the use of a pinch gesture to control zooming. Whether or not these on-screen controls are displayed can be set with setDisplayZoomControls. The default is false.

The built-in mechanisms are the only currently supported zoom mechanisms, so it is recommended that this setting is always enabled. However, on-screen zoom controls are deprecated in Android (see android.widget.ZoomButtonsController) so it's recommended to disable setDisplayZoomControls.

setCacheMode

abstract fun setCacheMode(mode: Int): Unit

Overrides the way the cache is used. The way the cache is used is based on the navigation type. For a normal page load, the cache is checked and content is re-validated as needed. When navigating back, content is not revalidated, instead the content is just retrieved from the cache. This method allows the client to override this behavior by specifying one of LOAD_DEFAULT, LOAD_CACHE_ELSE_NETWORK, LOAD_NO_CACHE or LOAD_CACHE_ONLY. The default value is LOAD_DEFAULT.

setCursiveFontFamily

abstract fun setCursiveFontFamily(font: String!): Unit

Sets the cursive font family name. The default is "cursive".

setDatabaseEnabled

abstract fun setDatabaseEnabled(flag: Boolean): Unit

Deprecated: WebSQL is deprecated and this method will become a no-op on all Android versions once support is removed in Chromium. See https://developer.chrome.com/blog/deprecating-web-sql for more information.

Sets whether the database storage API is enabled. The default value is false. See also setDatabasePath for how to correctly set up the database storage API. This setting is global in effect, across all WebView instances in a process. Note you should only modify this setting prior to making any WebView page load within a given process, as the WebView implementation may ignore changes to this setting after that point.

setDatabasePath

abstract fun setDatabasePath(databasePath: String!): Unit

Deprecated: Database paths are managed by the implementation and calling this method will have no effect.

Sets the path to where database storage API databases should be saved. In order for the database storage API to function correctly, this method must be called with a path to which the application can write. This method should only be called once: repeated calls are ignored.

setDefaultFixedFontSize

abstract fun setDefaultFixedFontSize(size: Int): Unit

Sets the default fixed font size. The default is 16.

setDefaultFontSize

abstract fun setDefaultFontSize(size: Int): Unit

Sets the default font size. The default is 16.

setDefaultTextEncodingName

abstract fun setDefaultTextEncodingName(encoding: String!): Unit

Sets the default text encoding name to use when decoding html pages. The default is "UTF-8".

setDefaultZoom

abstract fun setDefaultZoom(zoom: WebSettings.ZoomDensity!): Unit

Deprecated: This method is no longer supported, see the function documentation for recommended alternatives.

Sets the default zoom density of the page. This must be called from the UI thread. The default is ZoomDensity.MEDIUM. This setting is not recommended for use in new applications. If the WebView is utilized to display mobile-oriented pages, the desired effect can be achieved by adjusting 'width' and 'initial-scale' attributes of page's 'meta viewport' tag. For pages lacking the tag, android.webkit.WebView#setInitialScale and setUseWideViewPort can be used.

setDisabledActionModeMenuItems

abstract fun setDisabledActionModeMenuItems(menuItems: Int): Unit

Disables the action mode menu items according to menuItems flag.

setDisplayZoomControls

abstract fun setDisplayZoomControls(enabled: Boolean): Unit

Sets whether the WebView should display on-screen zoom controls when using the built-in zoom mechanisms. See setBuiltInZoomControls. The default is true. However, on-screen zoom controls are deprecated in Android (see android.widget.ZoomButtonsController) so it's recommended to set this to false.

setDomStorageEnabled

abstract fun setDomStorageEnabled(flag: Boolean): Unit

Sets whether the DOM storage API is enabled. The default value is false.

setEnableSmoothTransition

abstract fun setEnableSmoothTransition(enable: Boolean): Unit

Deprecated: This method is now obsolete, and will become a no-op in future.

Sets whether the WebView will enable smooth transition while panning or zooming or while the window hosting the WebView does not have focus. If it is true, WebView will choose a solution to maximize the performance. e.g. the WebView's content may not be updated during the transition. If it is false, WebView will keep its fidelity. The default value is false.

setFantasyFontFamily

abstract fun setFantasyFontFamily(font: String!): Unit

Sets the fantasy font family name. The default is "fantasy".

setFixedFontFamily

abstract fun setFixedFontFamily(font: String!): Unit

Sets the fixed font family name. The default is "monospace".

setForceDark

open fun setForceDark(forceDark: Int): Unit

Deprecated: The "force dark" model previously implemented by WebView was complex and didn't interoperate well with current Web standards for prefers-color-scheme and color-scheme. In apps with targetSdkVersion ≥ android.os.Build.VERSION_CODES#TIRAMISU this API is a no-op and WebView will always use the dark style defined by web content authors if the app's theme is dark. To customize the behavior, refer to setAlgorithmicDarkeningAllowed.

Set the force dark mode for this WebView.

setGeolocationDatabasePath

abstract fun setGeolocationDatabasePath(databasePath: String!): Unit

Deprecated: Geolocation database are managed by the implementation and calling this method will have no effect.

Sets the path where the Geolocation databases should be saved. In order for Geolocation permissions and cached positions to be persisted, this method must be called with a path to which the application can write.

setGeolocationEnabled

abstract fun setGeolocationEnabled(flag: Boolean): Unit

Sets whether Geolocation is enabled. The default is true.

Please note that in order for the Geolocation API to be usable by a page in the WebView, the following requirements must be met:

• an application must have permission to access the device location, see android.Manifest.permission#ACCESS_COARSE_LOCATION, android.Manifest.permission#ACCESS_FINE_LOCATION;
• an application must provide an implementation of the WebChromeClient.onGeolocationPermissionsShowPrompt callback to receive notifications that a page is requesting access to location via the JavaScript Geolocation API.

setJavaScriptCanOpenWindowsAutomatically

abstract fun setJavaScriptCanOpenWindowsAutomatically(flag: Boolean): Unit

Allows JavaScript to open windows without a user gesture. This applies to the JavaScript function window.open(). The default is false: attempts without a user gesture will fail and do nothing.

This is not affected by the setSupportMultipleWindows setting; the user gesture requirement is enforced even if multiple windows are disabled.

setJavaScriptEnabled

abstract fun setJavaScriptEnabled(flag: Boolean): Unit

Tells the WebView to enable JavaScript execution. The default is false.

setLayoutAlgorithm

abstract fun setLayoutAlgorithm(l: WebSettings.LayoutAlgorithm!): Unit

Sets the underlying layout algorithm. This will cause a re-layout of the WebView. The default is LayoutAlgorithm.NARROW_COLUMNS.

setLightTouchEnabled

abstract fun setLightTouchEnabled(enabled: Boolean): Unit

Deprecated: From android.os.Build.VERSION_CODES#JELLY_BEAN this setting is obsolete and has no effect.

Enables using light touches to make a selection and activate mouseovers.

setLoadWithOverviewMode

abstract fun setLoadWithOverviewMode(overview: Boolean): Unit

Sets whether the WebView loads pages in overview mode, that is, zooms out the content to fit on screen by width. This setting is taken into account when the content width is greater than the width of the WebView control, for example, when getUseWideViewPort is enabled. The default is false.

setLoadsImagesAutomatically

abstract fun setLoadsImagesAutomatically(flag: Boolean): Unit

Sets whether the WebView should load image resources. Note that this method controls loading of all images, including those embedded using the data URI scheme. Use setBlockNetworkImage to control loading only of images specified using network URI schemes. Note that if the value of this setting is changed from false to true, all images resources referenced by content currently displayed by the WebView are loaded automatically. The default is true.

setMediaPlaybackRequiresUserGesture

abstract fun setMediaPlaybackRequiresUserGesture(require: Boolean): Unit

Sets whether the WebView requires a user gesture to play media. The default is true.

setMinimumFontSize

abstract fun setMinimumFontSize(size: Int): Unit

Sets the minimum font size. The default is 8.

setMinimumLogicalFontSize

abstract fun setMinimumLogicalFontSize(size: Int): Unit

Sets the minimum logical font size. The default is 8.

setMixedContentMode

abstract fun setMixedContentMode(mode: Int): Unit

Configures the WebView's behavior when a secure origin attempts to load a resource from an insecure origin. By default, apps that target android.os.Build.VERSION_CODES#KITKAT or below default to MIXED_CONTENT_ALWAYS_ALLOW. Apps targeting android.os.Build.VERSION_CODES#LOLLIPOP default to MIXED_CONTENT_NEVER_ALLOW. The preferred and most secure mode of operation for the WebView is MIXED_CONTENT_NEVER_ALLOW and use of MIXED_CONTENT_ALWAYS_ALLOW is strongly discouraged.

setNeedInitialFocus

abstract fun setNeedInitialFocus(flag: Boolean): Unit

Tells the WebView whether it needs to set a node to have focus when android.webkit.WebView#requestFocus(int,android.graphics.Rect) is called. The default value is true.

setOffscreenPreRaster

abstract fun setOffscreenPreRaster(enabled: Boolean): Unit

Sets whether this WebView should raster tiles when it is offscreen but attached to a window. Turning this on can avoid rendering artifacts when animating an offscreen WebView on-screen. Offscreen WebViews in this mode use more memory. The default value is false.
Please follow these guidelines to limit memory usage:

• WebView size should be not be larger than the device screen size.
• Limit use of this mode to a small number of WebViews. Use it for visible WebViews and WebViews about to be animated to visible.

setPluginState

abstract fun setPluginState(state: WebSettings.PluginState!): Unit

Deprecated: Plugins are not supported in API level android.os.Build.VERSION_CODES#KITKAT or later; enabling plugins is a no-op.

Tells the WebView to enable, disable, or have plugins on demand. On demand mode means that if a plugin exists that can handle the embedded content, a placeholder icon will be shown instead of the plugin. When the placeholder is clicked, the plugin will be enabled. The default is PluginState.OFF.

setRenderPriority

abstract fun setRenderPriority(priority: WebSettings.RenderPriority!): Unit

Deprecated: It is not recommended to adjust thread priorities, and this will not be supported in future versions.

Sets the priority of the Render thread. Unlike the other settings, this one only needs to be called once per process. The default value is RenderPriority.NORMAL.

setSafeBrowsingEnabled

abstract fun setSafeBrowsingEnabled(enabled: Boolean): Unit

Sets whether Safe Browsing is enabled. Safe Browsing allows WebView to protect against malware and phishing attacks by verifying the links.

Safe Browsing can be disabled for all WebViews using a manifest tag (read general Safe Browsing info). The manifest tag has a lower precedence than this API.

Safe Browsing is enabled by default for devices which support it.

setSansSerifFontFamily

abstract fun setSansSerifFontFamily(font: String!): Unit

Sets the sans-serif font family name. The default is "sans-serif".

setSaveFormData

abstract fun setSaveFormData(save: Boolean): Unit

Deprecated: In Android O and afterwards, this function does not have any effect. Form data will be saved to platform's autofill service if applicable.

Sets whether the WebView should save form data. In android.os.Build.VERSION_CODES#O, the platform has implemented a fully functional Autofill feature to store form data. Therefore, the Webview form data save feature is disabled.

Note that the feature will continue to be supported on older versions of Android as before.

setSavePassword

abstract fun setSavePassword(save: Boolean): Unit

Deprecated: Saving passwords in WebView will not be supported in future versions.

Sets whether the WebView should save passwords. The default is true.

setSerifFontFamily

abstract fun setSerifFontFamily(font: String!): Unit

Sets the serif font family name. The default is "sans-serif".

setStandardFontFamily

abstract fun setStandardFontFamily(font: String!): Unit

Sets the standard font family name. The default is "sans-serif".

setSupportMultipleWindows

abstract fun setSupportMultipleWindows(support: Boolean): Unit

Sets whether the WebView should support multiple windows.

If set to true, the WebChromeClient.onCreateWindow callback must be implemented by the application to handle the creation of new windows.

The default is false. When multiple window support is disabled, requests to open new windows (either from the window.open() JavaScript API or from links with target="_blank") will instead be treated as top-level navigations, replacing the current page in the same WebView.

setSupportZoom

abstract fun setSupportZoom(support: Boolean): Unit

Sets whether the WebView should support zooming using its on-screen zoom controls and gestures. The particular zoom mechanisms that should be used can be set with setBuiltInZoomControls. This setting does not affect zooming performed using the WebView.zoomIn() and WebView.zoomOut() methods. The default is true.

setTextSize

open fun setTextSize(t: WebSettings.TextSize!): Unit

Deprecated: Use setTextZoom instead.

Sets the text size of the page. The default is TextSize.NORMAL.

setTextZoom

abstract fun setTextZoom(textZoom: Int): Unit

Sets the text zoom of the page in percent. The default is 100.

setUseWideViewPort

abstract fun setUseWideViewPort(use: Boolean): Unit

Sets whether the WebView should enable support for the "viewport" HTML meta tag or should use a wide viewport. When the value of the setting is false, the layout width is always set to the width of the WebView control in device-independent (CSS) pixels. When the value is true and the page contains the viewport meta tag, the value of the width specified in the tag is used. If the page does not contain the tag or does not provide a width, then a wide viewport will be used.

setUserAgentString

abstract fun setUserAgentString(ua: String?): Unit

Sets the WebView's user-agent string. If the string is null or empty, the system default value will be used.

If the user-agent is overridden in this way, the values of the User-Agent Client Hints headers and navigator.userAgentData for this WebView could be changed.

See androidx.webkit.WebSettingsCompat #setUserAgentMetadata(WebSettings,UserAgentMetadata) for details.

Note that starting from android.os.Build.VERSION_CODES#KITKAT Android version, changing the user-agent while loading a web page causes WebView to initiate loading once again.

supportMultipleWindows

abstract fun supportMultipleWindows(): Boolean

Gets whether the WebView supports multiple windows.

supportZoom

abstract fun supportZoom(): Boolean

Gets whether the WebView supports zoom.