WebView控件之WebSettings各种配置方法源码总结

2018-04-15 12:56:05

WebSettings用于管理WebView状态配置,当WebView第一次被创建时,WebView包含着一个默认的配置,这些默认的配置将通过get方法返回,通过WebView中的getSettings方法获得一个WebSettings对象,如果一个WebView被销毁,在WebSettings中所有回调方法将抛出IllegalStateException异常。

1、setSupportZoom(boolean support)

设置WebView是否支持使用屏幕控件或手势进行缩放,默认是true,支持缩放。

  1. getSettings.setSupportZoom(false);  

2、setMediaPlaybackRequiresUserGesture(boolean require)

设置WebView是否通过手势触发播放媒体,默认是true,需要手势触发。

  1. getSettings.setMediaPlaybackRequiresUserGesture(false);  

3、setBuiltInZoomControls(boolean enabled)

设置WebView是否使用其内置的变焦机制,该机制集合屏幕缩放控件使用,默认是false,不使用内置变焦机制。

  1. getSettings.setBuiltInZoomControls(true);  

4、setDisplayZoomControls(boolean enabled)

设置WebView使用内置缩放机制时,是否展现在屏幕缩放控件上,默认true,展现在控件上。

  1. getSettings.setDisplayZoomControls(false);  

5、setAllowFileAccess(boolean allow)

设置在WebView内部是否允许访问文件,默认允许访问。

  1. getSettings.setAllowFileAccess(false);  

6、setAllowContentAccess(boolean allow)

设置WebView是否使用其内置的变焦机制,该机制结合屏幕缩放控件使用,默认是false,不使用内置变焦机制。

  1. getSettings.setAllowContentAccess(false);  

7、setLoadWithOverviewMode(boolean overview)

设置WebView是否使用预览模式加载界面。

  1. getSettings.setLoadWithOverviewMode(false);  

8、setSaveFormData(boolean save)

设置WebView是否保存表单数据,默认true,保存数据。

  1. getSettings.setSaveFormData(false);  

9、setTextZoom(int textZoom)

设置WebView中加载页面字体变焦百分比,默认100,整型数。

  1. getSettings.setTextZoom(100);  

10、setAcceptThirdPartyCookies(boolean accept)

设置WebView访问第三方Cookies策略,参考CookieManager提供的方法:setShouldAcceptThirdPartyCookies。

  1. getSettings.setAcceptThirdPartyCookies(false);  

11、setUseWideViewPort(boolean use)

设置WebView是否使用viewport,当该属性被设置为false时,加载页面的宽度总是适应WebView控件宽度;当被设置为true,当前页面包含viewport属性标签,在标签中指定宽度值生效,如果页面不包含viewport标签,无法提供一个宽度值,这个时候该方法将被使用。

  1. getSettings.setUseWideViewPort(false);  

12、setSupportMultipleWindows(boolean support)

设置WebView是否支持多屏窗口,参考WebChromeClient#onCreateWindow,默认false,不支持。

  1. getSettings.setSupportMultipleWindows(true);  

13、setLayoutAlgorithm(LayoutAlgorithm l)

设置WebView底层的布局算法,参考LayoutAlgorithm#NARROW_COLUMNS,将会重新生成WebView布局

  1. getSettings.setLayoutAlgorithm(LayoutAlgorithm l);  

14、setStandardFontFamily(String font)

设置WebView标准字体库字体,默认字体“sans-serif”。

  1. getSettings.setStandardFontFamily("sans-serif");  

15、setFixedFontFamily(String font)

设置WebView固定的字体库字体,默认“monospace”。

  1. getSettings.setFixedFontFamily("monospace");  

16、setSansSerifFontFamily(String font)

设置WebView Sans SeriFontFamily字体库字体,默认“sans-serif”。

  1. getSettings.setSansSerifFontFamily("sans-serif");  

17、setSerifFontFamily(String font)

设置WebView seri FontFamily字体库字体,默认“sans-serif”。

  1. getSettings.setSansSerifFontFamily("sans-serif");  

18、setCursiveFontFamily(String font)

设置WebView字体库字体,默认“cursive”

  1. getSettings.setCursiveFontFamily("cursive");  

19、setFantasyFontFamily(String font)

设置WebView字体库字体,默认“fantasy”。

  1. getSettings.setFantasyFontFamily("fantasy");  

20、setMinimumFontSize(int size)

设置WebView字体最小值,默认值8,取值1到72

  1. getSettings.setMinimumFontSize(8);  

21、setMinimumLogicalFontSize(int size)

设置WebView逻辑上最小字体值,默认值8,取值1到72

  1. getSettings.setMinimumLogicalFontSize(8);  

22、setDefaultFontSize(int size)

设置WebView默认值字体值,默认值16,取值1到72

  1. getSettings.setDefaultFontSize(16);  

23、setDefaultFixedFontSize(int size)

设置WebView默认固定的字体值,默认值16,取值1到72

  1. getSettings.setDefaultFixedFontSize(16);  

24、setLoadsImagesAutomatically(boolean flag)

设置WebView是否加载图片资源,默认true,自动加载图片

  1. getSettings.setLoadsImagesAutomatically(false);  

25、setBlockNetworkImage(boolean flag)

设置WebView是否以http、https方式访问从网络加载图片资源,默认false

  1. getSettings.setBlockNetworkImage(true);  

26、setBlockNetworkLoads(boolean flag)

设置WebView是否从网络加载资源,Application需要设置访问网络权限,否则报异常

  1. getSettings.setBlockNetworkLoads(true);  

27、setJavaScriptEnabled(boolean flag)

设置WebView是否允许执行JavaScript脚本,默认false,不允许

  1. getSettings.setJavaScriptEnabled(true);  

28、setAllowUniversalAccessFromFileURLs(boolean flag)

设置WebView运行中的脚本可以是否访问任何原始起点内容,默认true

  1. getSettings.setAllowUniversalAccessFromFileURLs(false);  

29、setAllowFileAccessFromFileURLs(boolean flag)

设置WebView运行中的一个文件方案被允许访问其他文件方案中的内容,默认值true

  1. getSettings.setAllowFileAccessFromFileURLs(false);  

30、setGeolocationDatabasePath(String databasePath)

设置WebView保存地理位置信息数据路径,指定的路径Application具备写入权限

  1. getSettings.setGeolocationDatabasePath(String path);  

31、setAppCacheEnabled(boolean flag)

设置Application缓存API是否开启,默认false,设置有效的缓存路径参考setAppCachePath(String path)方法

  1. getSettings.setAppCacheEnabled(true);  

32、setAppCachePath(String appCachePath)

设置当前Application缓存文件路径,Application Cache API能够开启需要指定Application具备写入权限的路径

  1. getSettings.setAppCachePath(String appCachePath);  

33、setDatabaseEnabled(boolean flag)

设置是否开启数据库存储API权限,默认false,未开启,可以参考setDatabasePath(String path)

  1. getSettings.setDatabaseEnabled(false);  

34、setDomStorageEnabled(boolean flag)

设置是否开启DOM存储API权限,默认false,未开启,设置为true,WebView能够使用DOM storage API

  1. getSettings.setDomStorageEnabled(true);  

35、setGeolocationEnabled(boolean flag)

设置是否开启定位功能,默认true,开启定位

  1. getSettings.setGeolocationEnabled(false);  

36、setJavaScriptCanOpenWindowsAutomatically(boolean flag)

设置脚本是否允许自动打开弹窗,默认false,不允许

  1. getSettings.setJavaScriptCanOpenWindowsAutomatically(true);  

37、setDefaultTextEncodingName(String encoding)

设置WebView加载页面文本内容的编码,默认“UTF-8”。

  1. getSettings.setDefaultTextEncodingName("UTF-8");  

38、setUserAgentString(String ua)

设置WebView代理字符串,如果String为null或为空,将使用系统默认值

  1. getSettings.setUserAgentString(String ua);  

39、setNeedInitialFocus(boolean flag)

设置WebView是否需要设置一个节点获取焦点当被回调的时候,默认true

  1. getSettings.setNeedInitialFocus(false);  

40、setCacheMode(int mode)

重写缓存被使用到的方法,该方法基于Navigation Type,加载普通的页面,将会检查缓存同时重新验证是否需要加载,如果不需要重新加载,将直接从缓存读取数据,允许客户端通过指定LOAD_DEFAULT、LOAD_CACHE_ELSE_NETWORK、LOAD_NO_CACHE、LOAD_CACHE_ONLY其中之一重写该行为方法,默认值LOAD_DEFAULT

  1. getSettings.setCacheMode(WebSettings.LOAD_DEFAULT);  

41、setMixedContentMode(int mode)

设置当一个安全站点企图加载来自一个不安全站点资源时WebView的行为,android.os.Build.VERSION_CODES.KITKAT默认为MIXED_CONTENT_ALWAYS_ALLOW,android.os.Build.VERSION_CODES#LOLLIPOP默认为MIXED_CONTENT_NEVER_ALLOW,取值其中之一:MIXED_CONTENT_NEVER_ALLOW、MIXED_CONTENT_ALWAYS_ALLOW、MIXED_CONTENT_COMPATIBILITY_MODE.

  1. getSettings.setMixedContentMode(WebSettings.MIXED_CONTENT_COMPATIBILITY_MODE);  


  • 2017-02-16 08:09:01

    HTML中PRE和p的区别

    pre 元素可定义预格式化的文本。被包围在 pre 元素中的文本通常会保留空格和换行符。而文本也会呈现为等宽字体。 <pre> 标签的一个常见应用就是用来表示计算机的源代码。

  • 2017-02-16 15:14:14

    动态加载js和css

    开发过程中经常需要动态加载js和css,今天特意总结了一下常用的方法。

  • 2017-02-17 17:11:24

    mysql插入数据后返回自增ID的方法c

    产生的ID 每次连接后保存在服务器中。这意味着函数向一个给定客户端返回的值是该客户端产生对影响AUTO_INCREMENT列的最新语句第一个 AUTO_INCREMENT值的。这个值不能被其它客户端影响,即使它们产生它们自己的 AUTO_INCREMENT值。这个行为保证了你能够找回自己的 ID 而不用担心其它客户端的活动,而且不需要加锁或处理

  • 2017-02-21 07:59:45

    不会被 iOS 停掉的网页定时器

    其实这个标题略微有点标题党:iOS 中,除了少数服务(如播放音乐),大部分 App 在用户按了 Home 键之后,过不了多久就会被完全冻结,这对 Safari 同样适用。本文不考虑这样情况,只考虑 Safari 运行时,怎样让定时器持续工作。

  • 2017-02-24 15:04:10

    PHP 中的 9 个魔术方法

    这个标题有点牵强因为php有不只9种魔术方法, 但是这些将会引导你使用php魔术方法一个好的开始。它可能魔幻,但是并不需要魔杖。 这些'魔术'方法拥有者特殊的名字,以两个下划线开始,表示这些方法在php特定事件下将会被触发。这可能听起来有点自动魔法但是它真的很酷的,我们已经看过一个简单的例子在 last post,即我们使用一个构造器-使用这个作为我们第一个例子

  • 2017-02-24 15:06:18

    PHP 中的 9 个魔术方法

    这个标题有点牵强因为php有不只9种魔术方法, 但是这些将会引导你使用php魔术方法一个好的开始。它可能魔幻,但是并不需要魔杖。 这些'魔术'方法拥有者特殊的名字,以两个下划线开始,表示这些方法在php特定事件下将会被触发。这可能听起来有点自动魔法但是它真的很酷的,我们已经看过一个简单的例子在 last post,即我们使用一个构造器-使用这个作为我们第一个例子

  • 2017-02-24 15:07:05

    PHP 中的 9 个魔术方法

    这个标题有点牵强因为php有不只9种魔术方法, 但是这些将会引导你使用php魔术方法一个好的开始。它可能魔幻,但是并不需要魔杖。 这些'魔术'方法拥有者特殊的名字,以两个下划线开始,表示这些方法在php特定事件下将会被触发。这可能听起来有点自动魔法但是它真的很酷的,我们已经看过一个简单的例子在 last post,即我们使用一个构造器-使用这个作为我们第一个例子