WebviewStyle

MUI HTML5

MUI

WebviewStyle

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方法则在前面。