setWinAttr

设置 window 属性

setWinAttr({params})

params

bounces:

  • 类型:布尔
  • 默认值:无
  • 描述:(可选项)页面是否弹动

bgColor:

  • 类型:字符串
  • 默认值:无
  • 描述:(可选项)背景色,支持图片和颜色,格式为#fff、#ffffff、rgba(r,g,b,a)等,图片路径支持fs://、widget://等APICloud自定义文件路径协议,同时支持相对路径

scrollToTop:

  • 类型:布尔
  • 默认值:无
  • 描述:(可选项)当点击状态栏,页面是否滚动到顶部。若当前屏幕上不止一个页面的scrollToTop属性为true,则所有的都不会起作用。只iOS有效

scrollEnabled:

  • 类型:布尔
  • 默认值:无
  • 描述:(可选项)页面内容超出后是否可以滚动,只支持iOS

vScrollBarEnabled:

  • 类型:布尔
  • 默认值:无
  • 描述:(可选项)是否显示垂直滚动条

hScrollBarEnabled:

  • 类型:布尔
  • 默认值:无
  • 描述:(可选项)是否显示水平滚动条

scaleEnabled:

  • 类型:布尔
  • 默认值:无
  • 描述:(可选项)页面是否可以缩放

slidBackEnabled:

  • 类型:布尔
  • 默认值:无
  • 描述:(可选项)是否支持滑动返回。iOS7.0及以上系统中,在新打开的页面中向右滑动,可以返回到上一个页面,该字段只iOS有效

hideHomeIndicator:

  • 类型:布尔
  • 默认值:无
  • 描述:(可选项)是否隐藏虚拟home键。设置为true时,虚拟home键会在屏幕没有触摸操作时自动隐藏,触摸后又会显示出来。只支持iOS

softInputMode:

  • 类型:字符串
  • 默认值:无
  • 描述:(可选项)当键盘弹出时,输入框被盖住时,当前页面的调整方式;只iOS有效,Android请在 config.xml 里面配置并云编译使用
  • 取值范围

    1. resize //若键盘盖住输入框,页面会自动上移
    2. pan //若键盘盖住输入框,页面不会自动上移
    3. auto //默认值,由系统决定如何处理,iOS平台该字段等同于resize

示例代码

  1. api.setWinAttr({
  2. bounces: true
  3. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本