public abstract class WebSettings
extends Object
| java.lang.Object | |
| ↳ | android.webkit.WebSettings |
管理WebView的设置状态。 首次创建WebView时，它会获取一组默认设置。 这些默认设置将从任何getter调用中返回。 从WebView.getSettings（）获取的WebSettings对象与WebView的生命周期相关联。 如果WebView已被销毁，则WebSettings上的任何方法调用都将引发IllegalStateException。
Nested classes |
|
|---|---|
枚举 |
WebSettings.LayoutAlgorithm 枚举控制html的布局。 |
枚举 |
WebSettings.PluginState 插件状态影响插件在页面上的处理方式。 |
枚举 |
WebSettings.RenderPriority
|
枚举 |
WebSettings.TextSize 此枚举在API级别14中已弃用。请改为使用 |
枚举 |
WebSettings.ZoomDensity 枚举用于指定WebView的所需密度。 |
Public constructors |
|
|---|---|
WebSettings() |
|
Public methods |
|
|---|---|
abstract boolean |
enableSmoothTransition() 此方法在API级别17中已弃用。此方法现在已过时，并且将来将成为禁用操作。 |
abstract boolean |
getAllowContentAccess() 获取此WebView是否支持内容URL访问。 |
abstract boolean |
getAllowFileAccess() 获取此WebView是否支持文件访问。 |
abstract boolean |
getAllowFileAccessFromFileURLs() 获取在文件方案URL上下文中运行的JavaScript是否可以访问来自其他文件方案URL的内容。 |
abstract boolean |
getAllowUniversalAccessFromFileURLs() 获取在文件配置URL上下文中运行的JavaScript是否可以访问任何来源的内容。 |
abstract boolean |
getBlockNetworkImage() 获取WebView是否不从网络加载图像资源。 |
abstract boolean |
getBlockNetworkLoads() 获取WebView是否不从网络加载任何资源。 |
abstract boolean |
getBuiltInZoomControls() 获取是否正在使用WebView中内置的缩放机制。 |
abstract int |
getCacheMode() 获取当前设置以覆盖缓存模式。 |
abstract String |
getCursiveFontFamily() 获取草书字体系列名称。 |
abstract boolean |
getDatabaseEnabled() 获取数据库存储API是否已启用。 |
abstract String |
getDatabasePath() 此方法在API级别19中已被弃用。数据库路径由实施管理，此方法已过时。 |
abstract int |
getDefaultFixedFontSize() 获取默认的固定字体大小。 |
abstract int |
getDefaultFontSize() 获取默认字体大小。 |
abstract String |
getDefaultTextEncodingName() 获取默认的文本编码名称。 |
static String |
getDefaultUserAgent(Context context) 返回WebView使用的默认用户代理。 |
abstract WebSettings.ZoomDensity |
getDefaultZoom() 此方法在API级别19中已被弃用。只会返回默认值。 |
abstract int |
getDisabledActionModeMenuItems() 获取禁用的动作模式菜单项，用整数字段标志表示。 |
abstract boolean |
getDisplayZoomControls() 获取当使用内置缩放机制时WebView是否显示屏幕缩放控件。 |
abstract boolean |
getDomStorageEnabled() 获取是否启用DOM Storage API。 |
abstract String |
getFantasyFontFamily() 获取幻想字体系列名称。 |
abstract String |
getFixedFontFamily() 获取固定的字体系列名称。 |
abstract boolean |
getJavaScriptCanOpenWindowsAutomatically() 获取JavaScript是否可以自动打开窗口。 |
abstract boolean |
getJavaScriptEnabled() 获取是否启用JavaScript。 |
abstract WebSettings.LayoutAlgorithm |
getLayoutAlgorithm() 获取当前的布局算法。 |
abstract boolean |
getLightTouchEnabled() 此方法在API级别18中已弃用。此设置已过时。 |
abstract boolean |
getLoadWithOverviewMode() 获取此WebView是否以概览模式加载页面。 |
abstract boolean |
getLoadsImagesAutomatically() 获取WebView是否加载图像资源。 |
abstract boolean |
getMediaPlaybackRequiresUserGesture() 获取WebView是否需要用户手势才能播放媒体。 |
abstract int |
getMinimumFontSize() 获取最小字体大小。 |
abstract int |
getMinimumLogicalFontSize() 获取最小的逻辑字体大小。 |
abstract int |
getMixedContentMode() 获取WebView关于从安全来源加载不安全内容的当前行为。 |
abstract boolean |
getOffscreenPreRaster() 获取此WebView是否应当在屏幕上显示栅格但将其连接到窗口时进行栅格化。 |
abstract WebSettings.PluginState |
getPluginState() 此方法在API级别18中已弃用。将来不会支持插件，因此不应使用插件。 |
abstract String |
getSansSerifFontFamily() 获取sans-serif字体系列名称。 |
abstract boolean |
getSaveFormData() 获取WebView是否保存表单数据。 |
abstract boolean |
getSavePassword() 此方法在API级别18中已弃用。将来的版本不支持在WebView中保存密码。 |
abstract String |
getSerifFontFamily() 获取serif字体系列名称。 |
abstract String |
getStandardFontFamily() 获取标准字体系列名称。 |
WebSettings.TextSize |
getTextSize() 此方法在API级别14中已弃用。请改为使用 |
abstract int |
getTextZoom() 获取页面的文本缩放百分比。 |
abstract boolean |
getUseWideViewPort() 获取WebView是否支持“视口”HTML元标记或将使用宽视口。 |
abstract String |
getUserAgentString() 获取WebView的用户代理字符串。 |
abstract void |
setAllowContentAccess(boolean allow) 在WebView中启用或禁用内容URL访问。 |
abstract void |
setAllowFileAccess(boolean allow) 在WebView中启用或禁用文件访问。 |
abstract void |
setAllowFileAccessFromFileURLs(boolean flag) 设置是否允许在文件方案URL上下文中运行的JavaScript访问来自其他文件方案URL的内容。 |
abstract void |
setAllowUniversalAccessFromFileURLs(boolean flag) 设置是否允许在文件方案URL上下文中运行的JavaScript访问任何来源的内容。 |
abstract void |
setAppCacheEnabled(boolean flag) 设置是否应该启用应用程序缓存API。 |
abstract void |
setAppCacheMaxSize(long appCacheMaxSize) 此方法在API级别18中已弃用。未来的配额将自动进行管理。 |
abstract void |
setAppCachePath(String appCachePath) 设置应用程序缓存文件的路径。 |
abstract void |
setBlockNetworkImage(boolean flag) 设置WebView是否不应从网络加载图像资源（通过http和https URI方案访问的资源）。 |
abstract void |
setBlockNetworkLoads(boolean flag) 设置WebView是否不应从网络加载资源。 |
abstract void |
setBuiltInZoomControls(boolean enabled) 设置WebView是否应使用其内置的缩放机制。 |
abstract void |
setCacheMode(int mode) 覆盖缓存的使用方式。 |
abstract void |
setCursiveFontFamily(String font) 设置草书字体系列名称。 |
abstract void |
setDatabaseEnabled(boolean flag) 设置是否启用数据库存储API。 |
abstract void |
setDatabasePath(String databasePath) 此方法在API级别19中已弃用。数据库路径由实现管理，调用此方法将不起作用。 |
abstract void |
setDefaultFixedFontSize(int size) 设置默认的固定字体大小。 |
abstract void |
setDefaultFontSize(int size) 设置默认字体大小。 |
abstract void |
setDefaultTextEncodingName(String encoding) 设置解码HTML页面时使用的默认文本编码名称。 |
abstract void |
setDefaultZoom(WebSettings.ZoomDensity zoom) 此方法在API级别19中已弃用。此方法不再受支持，请参阅推荐替代方法的功能文档。 |
abstract void |
setDisabledActionModeMenuItems(int menuItems) 根据 |
abstract void |
setDisplayZoomControls(boolean enabled) 设置WebView在使用内置缩放机制时是否应显示屏幕缩放控件。 |
abstract void |
setDomStorageEnabled(boolean flag) 设置是否启用DOM存储API。 |
abstract void |
setEnableSmoothTransition(boolean enable) 此方法在API级别17中已弃用。此方法现在已过时，并且将来将成为禁用操作。 |
abstract void |
setFantasyFontFamily(String font) 设置幻想字体系列名称。 |
abstract void |
setFixedFontFamily(String font) 设置固定的字体系列名称。 |
abstract void |
setGeolocationDatabasePath(String databasePath) 此方法在API级别24中已弃用。地理位置数据库由实施管理，调用此方法将不起作用。 |
abstract void |
setGeolocationEnabled(boolean flag) 设置是否启用地理位置。 |
abstract void |
setJavaScriptCanOpenWindowsAutomatically(boolean flag) 指示JavaScript自动打开窗口。 |
abstract void |
setJavaScriptEnabled(boolean flag) 告诉WebView启用JavaScript执行。 |
abstract void |
setLayoutAlgorithm(WebSettings.LayoutAlgorithm l) 设置底层布局算法。 |
abstract void |
setLightTouchEnabled(boolean enabled) 此方法在API级别18中已弃用。从 |
abstract void |
setLoadWithOverviewMode(boolean overview) 设置WebView是否以概览模式加载页面，即缩小宽度以适合屏幕的内容。 |
abstract void |
setLoadsImagesAutomatically(boolean flag) 设置WebView是否应加载图像资源。 |
abstract void |
setMediaPlaybackRequiresUserGesture(boolean require) 设置WebView是否需要用户手势才能播放媒体。 |
abstract void |
setMinimumFontSize(int size) 设置最小字体大小。 |
abstract void |
setMinimumLogicalFontSize(int size) 设置最小逻辑字体大小。 |
abstract void |
setMixedContentMode(int mode) 配置WebView在安全来源尝试从不安全来源加载资源时的行为。 |
abstract void |
setNeedInitialFocus(boolean flag) 告诉WebView当 |
abstract void |
setOffscreenPreRaster(boolean enabled) 设置此WebView是否应在屏幕外显示时贴上瓦片，但是贴到窗口上。 |
abstract void |
setPluginState(WebSettings.PluginState state) 此方法在API级别18中已弃用。将来不会支持插件，因此不应使用插件。 |
abstract void |
setRenderPriority(WebSettings.RenderPriority priority) 此方法在API级别18中已被弃用。不建议调整线程优先级，并且在将来的版本中将不支持此方法。 |
abstract void |
setSansSerifFontFamily(String font) 设置sans-serif字体系列名称。 |
abstract void |
setSaveFormData(boolean save) 设置WebView是否应保存表单数据。 |
abstract void |
setSavePassword(boolean save) 此方法在API级别18中已弃用。将来的版本不支持在WebView中保存密码。 |
abstract void |
setSerifFontFamily(String font) 设置serif字体系列名称。 |
abstract void |
setStandardFontFamily(String font) 设置标准字体系列名称。 |
abstract void |
setSupportMultipleWindows(boolean support) 设置WebView是否支持多个窗口。 |
abstract void |
setSupportZoom(boolean support) 设置WebView是否支持使用其屏幕缩放控件和手势进行缩放。 |
void |
setTextSize(WebSettings.TextSize t) 此方法在API级别14中已弃用。请改用 |
abstract void |
setTextZoom(int textZoom) 以百分比设置页面的文本缩放。 |
abstract void |
setUseWideViewPort(boolean use) 设置WebView是应该启用对“视口”HTML元标记的支持还是应该使用宽视口。 |
abstract void |
setUserAgentString(String ua) 设置WebView的用户代理字符串。 |
abstract boolean |
supportMultipleWindows() 获取WebView是否支持多个窗口。 |
abstract boolean |
supportZoom() 获取WebView是否支持缩放。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
int LOAD_CACHE_ELSE_NETWORK
使用缓存资源时，即使它们已经过期。 否则从网络加载资源。 与setCacheMode(int)使用。
常数值：1（0x00000001）
int LOAD_CACHE_ONLY
不要使用网络，从缓存中加载。 与setCacheMode(int)使用。
常量值：3（0x00000003）
int LOAD_DEFAULT
默认缓存使用模式。 如果导航类型不强制执行任何特定行为，请在缓存资源可用且未过期时使用，否则请从网络中加载资源。 与setCacheMode(int)使用。
常量值：-1（0xffffffff）
int LOAD_NORMAL
此常数在API级别17中已弃用。
这个值是过时的，从API级别HONEYCOMB及以后它具有相同的效果LOAD_DEFAULT 。
正常缓存使用模式。 与setCacheMode(int)使用。
常量值：0（0x00000000）
int LOAD_NO_CACHE
不要使用缓存，从网络加载。 与setCacheMode(int)使用。
常量值：2（0x00000002）
int MENU_ITEM_NONE
与setDisabledActionModeMenuItems(int)一起setDisabledActionModeMenuItems(int) 。 没有菜单项应该被禁用。
常量值：0（0x00000000）
int MENU_ITEM_PROCESS_TEXT
与setDisabledActionModeMenuItems(int)一起setDisabledActionModeMenuItems(int) 。 禁用文本处理的所有动作模式菜单项。 默认情况下，WebView将搜索能够处理ACTION_PROCESS_TEXT活动并在动作模式菜单中显示它们。 如果通过setDisabledActionModeMenuItems(int)设置此标志，这些菜单项将被禁用。
常量值：4（0x00000004）
int MENU_ITEM_SHARE
与setDisabledActionModeMenuItems(int)一起setDisabledActionModeMenuItems(int) 。 禁用菜单项“共享”。
常数值：1（0x00000001）
int MENU_ITEM_WEB_SEARCH
与setDisabledActionModeMenuItems(int)一起setDisabledActionModeMenuItems(int) 。 禁用菜单项“Web搜索”。
常量值：2（0x00000002）
int MIXED_CONTENT_ALWAYS_ALLOW
与setMixedContentMode(int)一起setMixedContentMode(int)在此模式下，WebView将允许安全来源加载来自任何其他来源的内容，即使该来源不安全。 这是WebView最不安全的操作模式，并且可能的应用程序不应设置此模式。
常量值：0（0x00000000）
int MIXED_CONTENT_COMPATIBILITY_MODE
与setMixedContentMode(int)一起setMixedContentMode(int)在此模式下，WebView将尝试与现代Web浏览器在混合内容方面的兼容性。 一些不安全的内容可能被允许通过安全来源加载，而其他类型的内容将被阻止。 内容的类型被允许或阻止可能会将发布更改为发布，并且没有明确定义。 此模式旨在供应用程序使用，这些应用程序无法控制呈现的内容，但希望在合理安全的环境中运行。 为了实现最高安全性，建议应用程序使用MIXED_CONTENT_NEVER_ALLOW 。
常量值：2（0x00000002）
int MIXED_CONTENT_NEVER_ALLOW
与setMixedContentMode(int)一起setMixedContentMode(int)在此模式下，WebView将不允许安全来源加载来自不安全来源的内容。 这是WebView的首选和最安全的操作模式，强烈建议应用程序使用此模式。
常数值：1（0x00000001）
boolean enableSmoothTransition ()
此方法在API级别17中已弃用。
这种方法现在已经过时了，将来会变成不可操作的。
获取WebView是否在平移或缩放时平滑过渡。
| Returns | |
|---|---|
boolean |
|
boolean getAllowContentAccess ()
获取此WebView是否支持内容URL访问。
| Returns | |
|---|---|
boolean |
|
boolean getAllowFileAccess ()
获取此WebView是否支持文件访问。
| Returns | |
|---|---|
boolean |
|
也可以看看：
boolean getAllowFileAccessFromFileURLs ()
获取在文件方案URL上下文中运行的JavaScript是否可以访问来自其他文件方案URL的内容。
| Returns | |
|---|---|
boolean |
whether JavaScript running in the context of a file scheme URL can access content from other file scheme URLs |
boolean getAllowUniversalAccessFromFileURLs ()
获取在文件配置URL上下文中运行的JavaScript是否可以访问任何来源的内容。 这包括访问来自其他文件系统URL的内容。
| Returns | |
|---|---|
boolean |
whether JavaScript running in the context of a file scheme URL can access content from any origin |
boolean getBlockNetworkImage ()
获取WebView是否不从网络加载图像资源。
| Returns | |
|---|---|
boolean |
true if the WebView does not load image resources from the network |
boolean getBlockNetworkLoads ()
获取WebView是否不从网络加载任何资源。
| Returns | |
|---|---|
boolean |
true if the WebView does not load any resources from the network |
boolean getBuiltInZoomControls ()
获取是否正在使用WebView中内置的缩放机制。
| Returns | |
|---|---|
boolean |
true if the zoom mechanisms built into WebView are being used |
int getCacheMode ()
获取当前设置以覆盖缓存模式。
| Returns | |
|---|---|
int |
the current setting for overriding the cache mode |
也可以看看：
String getCursiveFontFamily ()
获取草书字体系列名称。
| Returns | |
|---|---|
String |
the cursive font family name as a string |
也可以看看：
boolean getDatabaseEnabled ()
获取数据库存储API是否已启用。
| Returns | |
|---|---|
boolean |
true if the database storage API is enabled |
也可以看看：
String getDatabasePath ()
此方法在API级别19中已被弃用。
数据库路径由实现管理，此方法已过时。
获取保存数据库存储API数据库的路径。
| Returns | |
|---|---|
String |
the String path to the database storage API databases |
也可以看看：
int getDefaultFixedFontSize ()
获取默认的固定字体大小。
| Returns | |
|---|---|
int |
a non-negative integer between 1 and 72 |
也可以看看：
int getDefaultFontSize ()
获取默认字体大小。
| Returns | |
|---|---|
int |
a non-negative integer between 1 and 72 |
也可以看看：
String getDefaultTextEncodingName ()
获取默认的文本编码名称。
| Returns | |
|---|---|
String |
the default text encoding name as a string |
String getDefaultUserAgent (Context context)
返回WebView使用的默认用户代理。 如果调用setUserAgentString(String) ，WebView的一个实例可以使用不同的User-Agent。
| Parameters | |
|---|---|
context |
Context: a Context object used to access application assets |
| Returns | |
|---|---|
String |
|
WebSettings.ZoomDensity getDefaultZoom ()
此方法在API级别19中已被弃用。
只会返回默认值。
获取页面的默认缩放密度。 这应该从UI线程中调用。 不建议将此设置用于新应用程序。
| Returns | |
|---|---|
WebSettings.ZoomDensity |
the zoom density |
int getDisabledActionModeMenuItems ()
获取禁用的动作模式菜单项，用整数字段标志表示。 默认值是MENU_ITEM_NONE
| Returns | |
|---|---|
int |
all the disabled menu item flags combined with bitwise OR. |
boolean getDisplayZoomControls ()
获取当使用内置缩放机制时WebView是否显示屏幕缩放控件。
| Returns | |
|---|---|
boolean |
true if the WebView displays on-screen zoom controls when using the built-in zoom mechanisms |
boolean getDomStorageEnabled ()
获取是否启用DOM Storage API。
| Returns | |
|---|---|
boolean |
true if the DOM Storage APIs are enabled |
String getFantasyFontFamily ()
获取幻想字体系列名称。
| Returns | |
|---|---|
String |
the fantasy font family name as a string |
也可以看看：
String getFixedFontFamily ()
获取固定的字体系列名称。
| Returns | |
|---|---|
String |
the fixed font family name as a string |
也可以看看：
boolean getJavaScriptCanOpenWindowsAutomatically ()
获取JavaScript是否可以自动打开窗口。
| Returns | |
|---|---|
boolean |
true if JavaScript can open windows automatically during window.open() |
boolean getJavaScriptEnabled ()
获取是否启用JavaScript。
| Returns | |
|---|---|
boolean |
true if JavaScript is enabled |
WebSettings.LayoutAlgorithm getLayoutAlgorithm ()
获取当前的布局算法。
| Returns | |
|---|---|
WebSettings.LayoutAlgorithm |
the layout algorithm in use, as a WebSettings.LayoutAlgorithm value |
boolean getLightTouchEnabled ()
此方法在API级别18中已被弃用。
此设置已过时。
获取是否启用轻触。
| Returns | |
|---|---|
boolean |
|
boolean getLoadWithOverviewMode ()
获取此WebView是否以概览模式加载页面。
| Returns | |
|---|---|
boolean |
whether this WebView loads pages in overview mode |
boolean getLoadsImagesAutomatically ()
获取WebView是否加载图像资源。 这包括使用数据URI方案嵌入的图像。
| Returns | |
|---|---|
boolean |
true if the WebView loads image resources |
boolean getMediaPlaybackRequiresUserGesture ()
获取WebView是否需要用户手势才能播放媒体。
| Returns | |
|---|---|
boolean |
true if the WebView requires a user gesture to play media |
int getMinimumFontSize ()
获取最小字体大小。
| Returns | |
|---|---|
int |
a non-negative integer between 1 and 72 |
也可以看看：
int getMinimumLogicalFontSize ()
获取最小的逻辑字体大小。
| Returns | |
|---|---|
int |
a non-negative integer between 1 and 72 |
int getMixedContentMode ()
获取WebView关于从安全来源加载不安全内容的当前行为。
| Returns | |
|---|---|
int |
The current setting, one of MIXED_CONTENT_NEVER_ALLOW, MIXED_CONTENT_ALWAYS_ALLOW or MIXED_CONTENT_COMPATIBILITY_MODE. |
boolean getOffscreenPreRaster ()
获取此WebView是否应当在屏幕上显示栅格但将其连接到窗口时进行栅格化。
| Returns | |
|---|---|
boolean |
true if this WebView will raster tiles when it is offscreen but attached to a window. |
WebSettings.PluginState getPluginState ()
此方法在API级别18中已被弃用。
将来不会支持插件，因此不应使用插件。
获取有关是否启用插件的当前状态。
| Returns | |
|---|---|
WebSettings.PluginState |
the plugin state as a WebSettings.PluginState value |
String getSansSerifFontFamily ()
获取sans-serif字体系列名称。
| Returns | |
|---|---|
String |
the sans-serif font family name as a string |
boolean getSaveFormData ()
获取WebView是否保存表单数据。
| Returns | |
|---|---|
boolean |
whether the WebView saves form data |
也可以看看：
boolean getSavePassword ()
此方法在API级别18中已被弃用。
未来版本不支持在WebView中保存密码。
获取WebView是否保存密码。
| Returns | |
|---|---|
boolean |
whether the WebView saves passwords |
也可以看看：
String getSerifFontFamily ()
获取serif字体系列名称。 默认是“serif”。
| Returns | |
|---|---|
String |
the serif font family name as a string |
也可以看看：
String getStandardFontFamily ()
获取标准字体系列名称。
| Returns | |
|---|---|
String |
the standard font family name as a string |
WebSettings.TextSize getTextSize ()
此方法在API级别14中已弃用。
改为使用getTextZoom() 。
获取页面的文本大小。 如果以前使用setTextZoom(int)以百分比指定文本大小，则将返回最匹配的WebSettings.TextSize 。
| Returns | |
|---|---|
WebSettings.TextSize |
the text size as a WebSettings.TextSize value |
int getTextZoom ()
获取页面的文本缩放百分比。
| Returns | |
|---|---|
int |
the text zoom of the page in percent |
也可以看看：
boolean getUseWideViewPort ()
获取WebView是否支持“视口”HTML元标记或将使用宽视口。
| Returns | |
|---|---|
boolean |
true if the WebView supports the viewport meta tag |
也可以看看：
String getUserAgentString ()
获取WebView的用户代理字符串。
| Returns | |
|---|---|
String |
the WebView's user-agent string |
也可以看看：
void setAllowContentAccess (boolean allow)
在WebView中启用或禁用内容URL访问。 内容URL访问允许WebView从系统中安装的内容提供者加载内容。 默认已启用。
| Parameters | |
|---|---|
allow |
boolean
|
void setAllowFileAccess (boolean allow)
在WebView中启用或禁用文件访问。 文件访问默认启用。 请注意，这只启用或禁用文件系统访问。 资产和资源仍可通过file：/// android_asset和file：/// android_res访问。
| Parameters | |
|---|---|
allow |
boolean
|
void setAllowFileAccessFromFileURLs (boolean flag)
设置是否允许在文件方案URL上下文中运行的JavaScript访问来自其他文件方案URL的内容。 要启用最严格的安全策略，应禁用此设置。 请注意，如果值getAllowUniversalAccessFromFileURLs()为真，则忽略此设置的值。 还要注意，该设置仅影响对文件系统资源的JavaScript访问。 其他对这些资源的访问，例如，来自图像HTML元素，不受影响。 为防止可能违反ICE_CREAM_SANDWICH和更早版本设备上的相同域策略，您应该明确将此值设置为false 。
API级别 ICE_CREAM_SANDWICH_MR1及以下的默认值为true，API级别 JELLY_BEAN及以上的值为false。
| Parameters | |
|---|---|
flag |
boolean: whether JavaScript running in the context of a file scheme URL should be allowed to access content from other file scheme URLs |
void setAllowUniversalAccessFromFileURLs (boolean flag)
设置是否允许在文件方案URL上下文中运行的JavaScript访问任何来源的内容。 这包括访问来自其他文件系统URL的内容。 见setAllowFileAccessFromFileURLs(boolean) 。 要启用最严格的安全策略，应禁用此设置。 请注意，此设置仅影响对文件系统资源的JavaScript访问。 其他对这些资源的访问，例如，来自图像HTML元素，不受影响。 为防止可能违反ICE_CREAM_SANDWICH和更早版本设备上的相同域策略，您应该明确将此值设置为false 。
API级别 ICE_CREAM_SANDWICH_MR1及以下的默认值为true，API级别 JELLY_BEAN及以上的值为false。
| Parameters | |
|---|---|
flag |
boolean: whether JavaScript running in the context of a file scheme URL should be allowed to access content from any origin |
void setAppCacheEnabled (boolean flag)
设置是否应该启用应用程序缓存API。 默认值是false。 请注意，为了启用应用程序缓存API，还必须为setAppCachePath(String)提供有效的数据库路径。
| Parameters | |
|---|---|
flag |
boolean: true if the WebView should enable Application Caches |
void setAppCacheMaxSize (long appCacheMaxSize)
此方法在API级别18中已被弃用。
将来的配额将被自动管理。
设置应用程序缓存内容的最大大小。 传递的大小将四舍五入到数据库可以支持的最接近的值，因此应该将其视为指导，而不是硬限制。 将大小设置为小于当前数据库大小的值不会导致数据库被修剪。 默认大小是MAX_VALUE 。 建议将最大尺寸设置为默认值。
| Parameters | |
|---|---|
appCacheMaxSize |
long: the maximum size in bytes |
void setAppCachePath (String appCachePath)
设置应用程序缓存文件的路径。 为了启用应用程序缓存API，必须使用应用程序可写入的路径调用此方法。 该方法只能被调用一次：重复调用被忽略。
| Parameters | |
|---|---|
appCachePath |
String: a String path to the directory containing Application Caches files. |
也可以看看：
void setBlockNetworkImage (boolean flag)
设置WebView是否不应从网络加载图像资源（通过http和https URI方案访问的资源）。 请注意，除非getLoadsImagesAutomatically()返回true，否则此方法无效。 另请注意，使用setBlockNetworkLoads(boolean)禁用所有网络负载也会阻止加载网络映像，即使此标志设置为false。 当此设置的值从true更改为false时，将自动提取由WebView当前显示的内容引用的网络图像资源。 默认值是false。
| Parameters | |
|---|---|
flag |
boolean: whether the WebView should not load image resources from the network |
void setBlockNetworkLoads (boolean flag)
设置WebView是否不应从网络加载资源。 使用setBlockNetworkImage(boolean)只能避免加载图像资源。 请注意，如果此设置的值从true更改为false，则在调用reload()之前，不会提取由WebView当前显示的内容引用的网络资源。 如果应用程序不具有INTERNET权限，则尝试将值设置为false将导致引发SecurityException 。 如果应用程序具有INTERNET权限，则默认值为false，否则为true。
| Parameters | |
|---|---|
flag |
boolean: true means block network loads by the WebView |
也可以看看：
void setBuiltInZoomControls (boolean enabled)
设置WebView是否应使用其内置的缩放机制。 内置的缩放机制包括在WebView内容上显示的屏幕缩放控件，以及使用捏手势控制缩放。 是否显示这些屏幕控件可以使用setDisplayZoomControls(boolean)进行设置。 默认值是false。
内置机制是目前唯一支持的缩放机制，因此建议始终启用此设置。
| Parameters | |
|---|---|
enabled |
boolean: whether the WebView should use its built-in zoom mechanisms |
void setCacheMode (int mode)
覆盖缓存的使用方式。 缓存的使用方式基于导航类型。 对于正常的页面加载，检查缓存并根据需要重新验证内容。 在返回时，内容不会重新生效，而是仅从缓存中检索内容。 该方法允许客户端通过指定的一个，以覆盖此行为LOAD_DEFAULT ， LOAD_CACHE_ELSE_NETWORK ， LOAD_NO_CACHE或LOAD_CACHE_ONLY 。 默认值是LOAD_DEFAULT 。
| Parameters | |
|---|---|
mode |
int: the mode to use |
void setCursiveFontFamily (String font)
设置草书字体系列名称。 默认是“草书”。
| Parameters | |
|---|---|
font |
String: a font family name |
void setDatabaseEnabled (boolean flag)
设置是否启用数据库存储API。 默认值是false。 有关如何正确设置数据库存储API的信息，另请参阅setDatabasePath(String) 。 这个设置是全局的，在一个进程中的所有WebView实例中都是有效的。 请注意，在给定进程中加载任何 WebView页面之前，您应该只修改此设置，因为WebView实现可能会在该点之后忽略此设置的更改。
| Parameters | |
|---|---|
flag |
boolean: true if the WebView should use the database storage API |
void setDatabasePath (String databasePath)
此方法在API级别19中已被弃用。
数据库路径由实现管理，调用此方法将不起作用。
设置数据库存储API数据库应保存到的路径。 为了使数据库存储API正常工作，必须使用应用程序可写入的路径调用此方法。 该方法只能被调用一次：重复调用被忽略。
| Parameters | |
|---|---|
databasePath |
String: a path to the directory where databases should be saved. |
void setDefaultFixedFontSize (int size)
设置默认的固定字体大小。 默认值是16。
| Parameters | |
|---|---|
size |
int: a non-negative integer between 1 and 72. Any number outside the specified range will be pinned. |
void setDefaultFontSize (int size)
设置默认字体大小。 默认值是16。
| Parameters | |
|---|---|
size |
int: a non-negative integer between 1 and 72. Any number outside the specified range will be pinned. |
void setDefaultTextEncodingName (String encoding)
设置解码HTML页面时使用的默认文本编码名称。 默认值是“UTF-8”。
| Parameters | |
|---|---|
encoding |
String: the text encoding name |
void setDefaultZoom (WebSettings.ZoomDensity zoom)
此方法在API级别19中已被弃用。
此方法不再受支持，请参阅推荐替代方法的功能文档。
设置页面的默认缩放密度。 这必须从UI线程调用。 默认值是MEDIUM 。 不建议将此设置用于新应用程序。 如果WebView用于显示面向移动设备的页面，则可以通过调整页面的“元视口”标签的“宽度”和“初始缩放”属性来实现预期的效果。 对于缺少标签的页面，可以使用setInitialScale(int)和setUseWideViewPort(boolean) 。
| Parameters | |
|---|---|
zoom |
WebSettings.ZoomDensity: the zoom density |
void setDisabledActionModeMenuItems (int menuItems)
根据 menuItems标志禁用动作模式菜单项。
| Parameters | |
|---|---|
menuItems |
int: an integer field flag for the menu items to be disabled. |
void setDisplayZoomControls (boolean enabled)
设置WebView在使用内置缩放机制时是否应显示屏幕缩放控件。 见setBuiltInZoomControls(boolean) 。 默认值是true。
| Parameters | |
|---|---|
enabled |
boolean: whether the WebView should display on-screen zoom controls |
void setDomStorageEnabled (boolean flag)
设置是否启用DOM存储API。 默认值是false。
| Parameters | |
|---|---|
flag |
boolean: true if the WebView should use the DOM storage API |
void setEnableSmoothTransition (boolean enable)
此方法在API级别17中已弃用。
这种方法现在已经过时了，将来会变成不可操作的。
设置WebView是否将在平移或缩放时启用平滑过渡，或者当托管WebView的窗口没有焦点时启用。 如果确实如此，WebView将选择一个解决方案来最大化性能。 例如WebView的内容在转换过程中可能不会更新。 如果它是假的，WebView将保持其保真度。 默认值是false。
| Parameters | |
|---|---|
enable |
boolean
|
void setFantasyFontFamily (String font)
设置幻想字体系列名称。 默认是“幻想”。
| Parameters | |
|---|---|
font |
String: a font family name |
void setFixedFontFamily (String font)
设置固定的字体系列名称。 默认是“等宽”。
| Parameters | |
|---|---|
font |
String: a font family name |
void setGeolocationDatabasePath (String databasePath)
此方法在API级别24中已弃用。
地理位置数据库由实施管理，调用此方法将不起作用。
设置地理位置数据库应该保存的路径。 为了保持地理位置权限和缓存位置，必须使用应用程序可写入的路径调用此方法。
| Parameters | |
|---|---|
databasePath |
String: a path to the directory where databases should be saved. |
void setGeolocationEnabled (boolean flag)
设置是否启用地理位置。 默认值是true。
请注意，为了WebView中的页面可以使用Geolocation API，必须满足以下要求：
Android开发手册ACCESS_COARSE_LOCATION, ACCESS_FINE_LOCATION; onGeolocationPermissionsShowPrompt(String, GeolocationPermissions.Callback) callback to receive notifications that a page is requesting access to location via the JavaScript Geolocation API. | Parameters | |
|---|---|
flag |
boolean: whether Geolocation should be enabled |
void setJavaScriptCanOpenWindowsAutomatically (boolean flag)
指示JavaScript自动打开窗口。 这适用于JavaScript函数window.open（）。 默认值是false。
| Parameters | |
|---|---|
flag |
boolean: true if JavaScript can open windows automatically |
void setJavaScriptEnabled (boolean flag)
告诉WebView启用JavaScript执行。 默认值是false。
| Parameters | |
|---|---|
flag |
boolean: true if the WebView should execute JavaScript |
void setLayoutAlgorithm (WebSettings.LayoutAlgorithm l)
设置底层布局算法。 这将导致WebView的重新布局。 默认值是NARROW_COLUMNS 。
| Parameters | |
|---|---|
l |
WebSettings.LayoutAlgorithm: the layout algorithm to use, as a WebSettings.LayoutAlgorithm value |
void setLightTouchEnabled (boolean enabled)
此方法在API级别18中已被弃用。
从JELLY_BEAN此设置已过时，并没有任何影响。
启用轻触式进行选择并激活鼠标悬停。
| Parameters | |
|---|---|
enabled |
boolean
|
void setLoadWithOverviewMode (boolean overview)
设置WebView是否以概览模式加载页面，即缩小宽度以适合屏幕的内容。 当内容宽度大于WebView控件的宽度时，例如在启用getUseWideViewPort()时，将考虑此设置。 默认值是false。
| Parameters | |
|---|---|
overview |
boolean
|
void setLoadsImagesAutomatically (boolean flag)
设置WebView是否应加载图像资源。 请注意，此方法控制所有图像的加载，包括使用数据URI方案嵌入的图像。 使用setBlockNetworkImage(boolean)来控制仅加载使用网络URI方案指定的图像。 请注意，如果此设置的值从false更改为true，则会自动加载由WebView当前显示的内容引用的所有图像资源。 默认值是true。
| Parameters | |
|---|---|
flag |
boolean: whether the WebView should load image resources |
void setMediaPlaybackRequiresUserGesture (boolean require)
设置WebView是否需要用户手势才能播放媒体。 默认值是true。
| Parameters | |
|---|---|
require |
boolean: whether the WebView requires a user gesture to play media |
void setMinimumFontSize (int size)
设置最小字体大小。 默认值是8。
| Parameters | |
|---|---|
size |
int: a non-negative integer between 1 and 72. Any number outside the specified range will be pinned. |
void setMinimumLogicalFontSize (int size)
设置最小逻辑字体大小。 默认值是8。
| Parameters | |
|---|---|
size |
int: a non-negative integer between 1 and 72. Any number outside the specified range will be pinned. |
void setMixedContentMode (int mode)
配置WebView在安全来源尝试从不安全来源加载资源时的行为。 默认情况下，目标KITKAT或更低的应用默认为MIXED_CONTENT_ALWAYS_ALLOW 。 目标LOLLIPOP应用默认为MIXED_CONTENT_NEVER_ALLOW 。 WebView的首选和最安全的操作模式是MIXED_CONTENT_NEVER_ALLOW ，强烈建议不要使用MIXED_CONTENT_ALWAYS_ALLOW 。
| Parameters | |
|---|---|
mode |
int: The mixed content mode to use. One of MIXED_CONTENT_NEVER_ALLOW, MIXED_CONTENT_ALWAYS_ALLOW or MIXED_CONTENT_COMPATIBILITY_MODE. |
void setNeedInitialFocus (boolean flag)
告诉WebView当requestFocus(int, android.graphics.Rect)被调用时是否需要设置节点具有焦点。 默认值是true。
| Parameters | |
|---|---|
flag |
boolean: whether the WebView needs to set a node |
void setOffscreenPreRaster (boolean enabled)
设置此WebView是否应在屏幕外显示时贴上瓦片，但是贴到窗口上。 打开此功能可避免在屏幕上对屏幕外WebView进行动画制作时出现伪影。 此模式下的外屏WebView使用更多内存。 默认值是false。
请遵循以下准则来限制内存使用情况：
| Parameters | |
|---|---|
enabled |
boolean
|
void setPluginState (WebSettings.PluginState state)
此方法在API级别18中已被弃用。
将来不会支持插件，因此不应使用插件。
告诉WebView根据需要启用，禁用或插件。 按需模式意味着如果存在可处理嵌入内容的插件，则会显示占位符图标而不是插件。 当点击占位符时，插件将被启用。 默认值是OFF 。
| Parameters | |
|---|---|
state |
WebSettings.PluginState: a PluginState value |
void setRenderPriority (WebSettings.RenderPriority priority)
此方法在API级别18中已被弃用。
不建议调整线程优先级，这在以后的版本中将不被支持。
设置渲染线程的优先级。 与其他设置不同，只需在每个进程中调用一次。 默认值是NORMAL 。
| Parameters | |
|---|---|
priority |
WebSettings.RenderPriority: the priority |
void setSansSerifFontFamily (String font)
设置sans-serif字体系列名称。 默认值是“sans-serif”。
| Parameters | |
|---|---|
font |
String: a font family name |
void setSaveFormData (boolean save)
设置WebView是否应保存表单数据。 默认值是true。
| Parameters | |
|---|---|
save |
boolean
|
void setSavePassword (boolean save)
此方法在API级别18中已被弃用。
未来版本不支持在WebView中保存密码。
设置WebView是否应保存密码。 默认值是true。
| Parameters | |
|---|---|
save |
boolean
|
void setSerifFontFamily (String font)
设置serif字体系列名称。 默认值是“sans-serif”。
| Parameters | |
|---|---|
font |
String: a font family name |
void setStandardFontFamily (String font)
设置标准字体系列名称。 默认值是“sans-serif”。
| Parameters | |
|---|---|
font |
String: a font family name |
void setSupportMultipleWindows (boolean support)
设置WebView是否支持多个窗口。 如果设置为true，则主机应用程序必须实现onCreateWindow(WebView, boolean, boolean, Message) 。 默认值是false。
| Parameters | |
|---|---|
support |
boolean: whether to suport multiple windows |
void setSupportZoom (boolean support)
设置WebView是否支持使用其屏幕缩放控件和手势进行缩放。 应该使用的特定缩放机制可以使用setBuiltInZoomControls(boolean)进行设置。 此设置不影响使用zoomIn()和zoomOut()方法执行的缩放。 默认值是true。
| Parameters | |
|---|---|
support |
boolean: whether the WebView should support zoom |
void setTextSize (WebSettings.TextSize t)
此方法在API级别14中已弃用。
改为使用setTextZoom(int) 。
设置页面的文字大小。 默认值是NORMAL 。
| Parameters | |
|---|---|
t |
WebSettings.TextSize: the text size as a WebSettings.TextSize value |
void setTextZoom (int textZoom)
以百分比设置页面的文本缩放。 默认值是100。
| Parameters | |
|---|---|
textZoom |
int: the text zoom in percent |
void setUseWideViewPort (boolean use)
设置WebView是应该启用对“视口”HTML元标记的支持还是应该使用宽视口。 当设置值为false时，布局宽度始终设置为设备无关（CSS）像素中WebView控件的宽度。 当值为true并且页面包含视口元标记时，将使用标记中指定的宽度值。 如果页面不包含标签或不提供宽度，则将使用宽视口。
| Parameters | |
|---|---|
use |
boolean: whether to enable support for the viewport meta tag |
void setUserAgentString (String ua)
设置WebView的用户代理字符串。 如果字符串为空或空，将使用系统默认值。 请注意，从KITKAT Android版本开始，在加载网页时更改用户代理会导致WebView再次启动加载。
| Parameters | |
|---|---|
ua |
String: new user-agent string |
boolean supportMultipleWindows ()
获取WebView是否支持多个窗口。
| Returns | |
|---|---|
boolean |
true if the WebView supports multiple windows |
boolean supportZoom ()
获取WebView是否支持缩放。
| Returns | |
|---|---|
boolean |
true if the WebView supports zoom |
也可以看看：