# 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
	}
}
1
2
3
4
5
6
第二种:easycom组件规范
传统vue组件,需要安装、引用、注册,三个步骤后才能使用组件。easycom将其精简为一步。

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

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

# 代码演示

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

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

<fui-status-bar background="#fff"></fui-status-bar>
1
固定于顶部

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

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

# Slots

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

# Props

属性名 类型 说明 默认值 平台差异说明
background String 状态栏背景色 transparent -
isFixed Boolean 是否固定在顶部 false -
zIndex Number z-index值,isFixed为true时生效 99 Nvue端不支持,默认越靠后的元素层级越高,即将组件放置最底部

# Events

事件名 说明 回调参数
@init 初始化时触发 {
  statusBarHeight:状态栏高度
}
Last Updated: 9/29/2022, 1:07:59 AM