JSON对象,原生窗口设置参数的对象
属性:
- background: (String 类型 )窗口的背景颜色
窗口空白区域的背景模式,设置background为颜色值(参考CSS Color Names,可取值/十六进制值/rgb值/rgba值),窗口为独占模式显示(占整个屏幕区域); 设置background为“transparent”,则表示窗口背景透明,为非独占模式。
平台支持
- Android - 2.2+ (支持): Android平台4.0以上系统才支持,4.0以下系统窗口显示白色背景。
- iOS - 5.0+ (支持): iOS平台不支持“transparent”背景透明样式,默认背景使用白色背景。
- blockNetworkImage: (Boolean 类型
)是否阻塞网络图片的加载
布尔类型,true表示阻塞,false表示不阻塞,默认值为false。 阻塞后Webview窗口将不加载页面中使用的所有网络图片,可通过Webview窗口对象的setBlockNetWorkImage()方法动态修改此状态。
平台支持
- Android - 2.2+ (支持)
- iOS - 5.0+ (不支持): 忽略此属性,Webview窗口加载页面中所有图片。
- bottom: (String 类型 )窗口垂直向上的偏移量
支持百分比、像素值,当设置了top和height值时,此属性值忽略;
- bounce: (String 类型 )窗口遇到边框是否有反弹效果
可取值:none表示没有反弹效果;vertical表示垂直方向有反弹效果;horizontal表示水平方向有反弹效果;all表示垂直和水平方向都有反弹效果。
平台支持
- Android - (不支持)
- iOS - (支持): 默认值为none,垂直和水平方向都没有反弹效果。
- bounceBackground: (String 类型
)窗口回弹效果区域的背景
窗口回弹效果区域背景可支持颜色值或图片: 颜色值格式为"#RRGGBB",如"#FFFFFF"为设置白色背景; 背景图为"url(%image path%)",如"url(./icon.png)"为设置icon.png为背景图,图片采用平铺模式绘制。
平台支持
- Android - (不支持)
- iOS - 5.0+ (支持): 默认值为系统窗口背景色,通常为黑色。
- dock: (WebviewDock 类型 )窗口的停靠方式
当Webview窗口添加到另外一个窗口中时,停靠方式才会生效,采用停靠方式添加会导致原Webview窗口自动调整其大小避免其内容呗子窗口盖住。 可取值:"top",控件停靠则页面顶部;"bottom",控件停靠在页面底部;"right",控件停靠在页面右侧;"left",控件停靠在页面左侧。
平台支持
- Android - 2.2+ (支持)
- iOS - 5.0+ (支持)
- height: (String 类型 )窗口的高度
支持百分比、像素值,默认为100%。未设置height属性值时,可同时设置top和bottom属性值改变窗口的默认高度。
- left: (String 类型 )窗口水平向右的偏移量
支持百分比、像素值,默认值为0px。未设置left属性值时,可设置right属性值改变窗口的默认left位置。
- margin: (String 类型 )窗口的边距
用于定位窗口的位置,支持auto,auto表示居中。若设置了left、right、top、bottom则对应的边距值失效。
- mask: (String 类型 )窗口的遮罩
用于设置Webview窗口的遮罩层样式,遮罩层会覆盖Webview中所有内容,包括子webview,并且截获webview的所有触屏事件,此时Webview窗口的点击操作会触发maskClick事件。 字符串类型,可取值: rgba格式字符串,定义纯色遮罩层样式,如"rgba(0,0,0,0.5)",表示黑色半透明; "none",表示不使用遮罩层; 默认值为"none",即无遮罩层。
- opacity: (Number 类型 )窗口的不透明度
0为全透明,1为不透明,默认值为1,即不透明。
平台支持
- Android - 2.2+ (支持): 需Android4.0及以上平台才支持,Android4.0以前平台忽略此属性。
- iOS - 4.3+ (支持)
- popGesture: (String 类型 )窗口的侧滑返回功能
可取值"none":无侧滑返回功能;"close":侧滑返回关闭Webview窗口;"hide":侧滑返回隐藏webview窗口。 仅iOS平台支持。
平台支持
- Android - 2.2+ (不支持): 忽略此属性。
- iOS - 5.0+ (支持)
- render: (String 类型 )窗口渲染模式
支持以下属性值: "onscreen" - Webview窗口在屏幕区可见时渲染,不可见时不进行渲染,此时能减少内存使用量; "always" - Webview在任何时候都渲染,在内存较大的设备上使用,被遮挡的窗口在此中模式下显示的时候会有更流畅的效果。 默认值为"onscreen"。 仅Android平台支持。
平台支持
- Android - 2.2+ (支持)
- iOS - 4.3+ (不支持)
- right: (String 类型 )窗口水平向左的偏移量
支持百分比、像素值,默认无值。当设置了left和width值时,此属性值忽略;
- scalable: (Boolean 类型 )窗口是否可缩放
窗口设置为可缩放(scalable:true)时,用户可通过双指操作放大或缩小页面,此时html页面可通过meta节点设置“name="viewport" content="user-scalable=no"”来限制页面不可缩放。 窗口设置为不可缩放(scalable:false)时,用户不可通过双指操作放大或缩小页面,即使页面中的meta节点也无法开启可缩放功能。 默认值为false,即不可缩放。
- scrollIndicator: (String 类型
)窗口是否显示滚动条
用于控制窗口滚动条样式,可取值: "all":垂直和水平滚动条都显示; "vertical":仅显示垂直滚动条; "horizontal":仅显示水平滚动条; "none":垂直和水平滚动条都不显示。 默认值为"all",即垂直和水平滚动条都显示。 注意:显示滚动条的前提条件是窗口中的内容超过窗口显示的宽或高。
- scrollsToTop: (Boolean 类型
)点击设备的状态栏时是否滚动返回至顶部
true表示点击设备的状态栏可以滚动返回至顶部,false表示点击设备的状态栏不可以,默认值为true。 此功能仅iOS平台支持,在iPhone上有且只有一个Webview窗口的scrollsToTop属性值为true时才生效,所以在显示和关闭Webview窗口时需动态更新所有Webview的scrollsToTop值,已确保此功能生效。
平台支持
- Android - ALL (不支持)
- iOS - 5.0+ (支持)
- top: (String 类型 )窗口垂直向下的偏移量
支持百分比、像素值,默认值为0px。未设置top属性值时,可设置bottom属性值改变窗口的默认top位置。
- transition: (WebviewTransition 类型
)窗口定义窗口变换的动画效果,参考Transition
- transform: (WebviewTransform 类型
)窗口定义窗口变形效果,参考Transform
- position: (WebviewPosition 类型 )Webview窗口的排版位置
当Webview窗口添加到另外一个窗口中时,排版位置才会生效,排版位置决定子窗口在父窗口中的定位方式。 可取值:"static",控件在页面中正常定位,如果页面存在滚动条则随窗口内容滚动;"absolute",控件在页面中绝对定位,如果页面存在滚动条不随窗口内容滚动;"dock",控件在页面中停靠,停靠的位置由dock属性值决定。
平台支持
- Android - (支持)
- iOS - (支持)
- width: (String 类型 )窗口的宽度
支持百分比、像素值,默认为100%。未设置width属性值时,可同时设置left和right属性值改变窗口的默认宽度。
- zindex: (Number 类型 )窗口的堆叠顺序值
拥有更高堆叠顺序的窗口总是会处于堆叠顺序较低的窗口的前面,拥有相同堆叠顺序的窗口后调用show方法则在前面。