window

window

用于设置 SWAN 的状态栏、导航条、标题、窗口背景色。

属性	类型	默认值	描述	最低版本
navigationBarBackgroundColor	HexColor	#000000	导航栏背景颜色，如 "#000000"	-
navigationBarTextStyle	String	white	导航栏标题颜色，目前仅支持 black/white	-
navigationBarTitleText	String	-	导航栏标题文字内容	-
navigationStyle	String	default	导航栏样式，仅支持以下值：default(默认样式) custom(自定义导航栏)，只保留右上角胶囊按钮	百度 App版本11.1.0
backgroundColor	HexColor	#ffffff	背景颜色	-
backgroundTextStyle	String	dark	下拉背景字体、loading 图的样式，仅支持 dark/light	-
enablePullDownRefresh	Boolean	false	是否开启下拉刷新	-
onReachBottomDistance	Number	50	页面上拉触底事件触发时距页面底部距离，单位为 px	-

注意：

• navigationStyle 全局配置Android和iOS从百度 App版本11.1.0开始支持, 但子页面配置支持情况Android从百度 App版本11.1开始支持，iOS从百度 App版本11.2开始支持, 做低版本兼容时，通过 swan.getSystemInfo 或者 swan.getSystemInfoSync 获取百度 App版本号进行兼容判断，具体见下表；
• 无其它特殊说明，请使用canIUse或者SWAN基础库版本进行兼容判断。

navigationStyle配置

顶bar设置	iOS	Android	WebView组件页面	备注
百度 App定义的顶bar	无版本限制	无版本限制	无版本限制	-
顶bar全局透明设置	百度 App版本>=11.1	百度 App版本>=11.1	不生效	-
顶bar子页面透明设置	百度 App版本>=11.2	百度 App版本>=11.1	不生效	每个page的json文件可以单独配置navigationStyle

适配提示

原生顶bar高度=状态栏高度（statusBarHeight）+顶部导航栏高度（navigationBarHeight）；可通过 swan.getSystemInfo 或者 swan.getSystemInfoSync 获取。

示例：

{
	"window":{
		"navigationBarBackgroundColor": "#ffffff",
		"navigationBarTextStyle": "black",
		"navigationBarTitleText": "swan接口功能演示",
		"backgroundColor": "#eeeeee",
		"backgroundTextStyle": "light"
	}
}