StatusBar 状态栏

概述

StatusBar 状态栏，主要用于自定义导航栏时状态栏占位，高度与状态栏相等。

支持平台

App-vue	App-Nvue	微信小程序	支付宝小程序	百度小程序	字节小程序	QQ小程序	H5	PC	快手小程序	钉钉小程序
✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

温馨提示

一般来说我们会通过 z-index + position 来进行层级的设置，但是 weex （Nvue）不支持 z-index 设置层级关系，默认越靠后的元素层级越高。

引入

以下介绍两种常用的引入方式。

第一种：在页面中引用、注册

import fuiStatusBar from "@/components/firstui/fui-status-bar/fui-status-bar.vue"
export default {
	components:{
		fuiStatusBar
	}
}

第二种：easycom组件规范

传统vue组件，需要安装、引用、注册，三个步骤后才能使用组件。easycom将其精简为一步。

First UI easycom配置请查看 快速上手。

如果不了解easycom，可先查看 官网文档 (opens new window)。

代码演示

部分示例演示，完整使用请参考示例程序以及文档API。

基础使用

通过 background 属性设置StatusBar背景色。

<fui-status-bar background="#fff"></fui-status-bar>

固定于顶部

通过 isFixed 属性设置StatusBar是否固定与顶部。

<fui-status-bar background="#fff" isFixed></fui-status-bar>

Slots

插槽名称	说明
default	标签内显示内容

Props

属性名	类型	说明	默认值	平台差异说明
background	String	状态栏背景色	transparent	-
isFixed	Boolean	是否固定在顶部	false	-
zIndex	Number	z-index值，isFixed为true时生效	99	Nvue端不支持，默认越靠后的元素层级越高，即将组件放置最底部
isOccupy V2.3.0+	Boolean	当isFixed为true时，是否占据状态栏高度，避免高度塌陷。 注意：使用此属性请将组件放置页面最顶部	false	Nvue端不推荐使用，避免层级低于其他元素，请根据**@init**事件返回高度值自行设置。

Events

事件名	说明	回调参数
@init	初始化时触发	{   statusBarHeight:状态栏高度 }