WebView控件之WebSettings详解

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

1、setSupportZoom(boolean support)

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

getSettings.setSupportZoom(false);

2、setMediaPlaybackRequiresUserGesture(boolean require)

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

getSettings.setMediaPlaybackRequiresUserGesture(false);

3、setBuiltInZoomControls(boolean enabled)

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

getSettings.setBuiltInZoomControls(true);

4、setDisplayZoomControls(boolean enabled)

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

getSettings.setDisplayZoomControls(false);

5、setAllowFileAccess(boolean allow)

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

getSettings.setAllowFileAccess(false);

6、setAllowContentAccess(boolean allow)

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

getSettings.setAllowContentAccess(false);

7、setLoadWithOverviewMode(boolean overview)

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

getSettings.setLoadWithOverviewMode(false);

8、setSaveFormData(boolean save)

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

getSettings.setSaveFormData(false);

9、setTextZoom(int textZoom)

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

getSettings.setTextZoom(100);

10、setAcceptThirdPartyCookies(boolean accept)

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

getSettings.setAcceptThirdPartyCookies(false);

11、setUseWideViewPort(boolean use)

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

getSettings.setUseWideViewPort(false);

12、setSupportMultipleWindows(boolean support)

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

getSettings.setSupportMultipleWindows(true);

13、setLayoutAlgorithm(LayoutAlgorithm l)

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

getSettings.setLayoutAlgorithm(LayoutAlgorithm l);

14、setStandardFontFamily(String font)

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

getSettings.setStandardFontFamily("sans-serif");

15、setFixedFontFamily(String font)

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

getSettings.setFixedFontFamily("monospace");

16、setSansSerifFontFamily(String font)

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

getSettings.setSansSerifFontFamily("sans-serif");

17、setSerifFontFamily(String font)

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

getSettings.setSansSerifFontFamily("sans-serif");

18、setCursiveFontFamily(String font)

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

getSettings.setCursiveFontFamily("cursive");

19、setFantasyFontFamily(String font)

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

getSettings.setFantasyFontFamily("fantasy");

20、setMinimumFontSize(int size)

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

getSettings.setMinimumFontSize(8);

21、setMinimumLogicalFontSize(int size)

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

getSettings.setMinimumLogicalFontSize(8);

22、setDefaultFontSize(int size)

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

getSettings.setDefaultFontSize(16);

23、setDefaultFixedFontSize(int size)

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

getSettings.setDefaultFixedFontSize(16);

24、setLoadsImagesAutomatically(boolean flag)

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

getSettings.setLoadsImagesAutomatically(false);

25、setBlockNetworkImage(boolean flag)

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

getSettings.setBlockNetworkImage(true);

26、setBlockNetworkLoads(boolean flag)

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

getSettings.setBlockNetworkLoads(true);

27、setJavaScriptEnabled(boolean flag)

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

getSettings.setJavaScriptEnabled(true);

28、setAllowUniversalAccessFromFileURLs(boolean flag)

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

getSettings.setAllowUniversalAccessFromFileURLs(false);

29、setAllowFileAccessFromFileURLs(boolean flag)

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

getSettings.setAllowFileAccessFromFileURLs(false);

30、setGeolocationDatabasePath(String databasePath)

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

getSettings.setGeolocationDatabasePath(String path);

31、setAppCacheEnabled(boolean flag)

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

getSettings.setAppCacheEnabled(true);

32、setAppCachePath(String appCachePath)

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

getSettings.setAppCachePath(String appCachePath);

33、setDatabaseEnabled(boolean flag)

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

getSettings.setDatabaseEnabled(false);

34、setDomStorageEnabled(boolean flag)

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

getSettings.setDomStorageEnabled(true);

35、setGeolocationEnabled(boolean flag)

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

getSettings.setGeolocationEnabled(false);

36、setJavaScriptCanOpenWindowsAutomatically(boolean flag)

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

getSettings.setJavaScriptCanOpenWindowsAutomatically(true);

37、setDefaultTextEncodingName(String encoding)

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

getSettings.setDefaultTextEncodingName("UTF-8");

38、setUserAgentString(String ua)

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

getSettings.setUserAgentString(String ua);

39、setNeedInitialFocus(boolean flag)

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

getSettings.setNeedInitialFocus(false);

40、setCacheMode(int mode)

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

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.

getSettings.setMixedContentMode(WebSettings.MIXED_CONTENT_COMPATIBILITY_MODE);

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,425评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,058评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,186评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,848评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,249评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,554评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,830评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,536评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,239评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,505评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,004评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,346评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,999评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,060评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,821评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,574评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,480评论 2 267

推荐阅读更多精彩内容