更新记录

1.0.0（2026-01-20）

tsw-statusbar-uts 状态栏工具插件

用于修改应用的状态栏背景颜色、字体颜色以及控制状态栏显示/隐藏的UTS插件，支持鸿蒙、Android、iOS平台。

功能特性

• 设置状态栏背景颜色和字体颜色
• 隐藏/显示状态栏
• iOS平台隐藏/显示HomeIndicator

安装方法

直接通过uni_modules安装即可使用。

使用说明

导入插件

// 导入方法
import * as statusbar from '@/uni_modules/tsw-statusbar-uts';

设置状态栏颜色

// 设置状态栏背景色和文字颜色
statusbar.setStatusBar('#0A59F7', '#F1F3F5', (res) => {
  console.log("修改状态栏结果", res);
});

隐藏状态栏

// 隐藏状态栏
statusbar.hideStatusBar();

显示状态栏

// 显示状态栏
statusbar.showStatusBar();

iOS隐藏HomeIndicator

// iOS隐藏HomeIndicator
statusbar.hideHomeIndicator();

iOS显示HomeIndicator

// iOS显示HomeIndicator
statusbar.showHomeIndicator();

API文档

setStatusBar(backgroundColor: string, contentColor: string, callback: Function)

同时设置状态栏背景颜色和字体颜色

参数：

• backgroundColor：背景颜色，格式为十六进制字符串，如 '#000000'
• contentColor：字体颜色，格式为十六进制字符串，如 '#ffffff'
• callback：回调函数，返回设置结果

hideStatusBar()

隐藏状态栏

showStatusBar()

显示状态栏

hideHomeIndicator()

隐藏iOS设备的HomeIndicator

showHomeIndicator()

显示iOS设备的HomeIndicator

注意事项

• 鸿蒙平台支持任意修改状态栏文字颜色
• Android平台状态栏文字颜色仅支持黑色和白色
• iOS平台状态栏文字颜色根据背景色自动调整为白色或黑色
• iOS平台仅支持隐藏/显示HomeIndicator功能

平台兼容性

平台兼容性

uni-app(4.85)

tsw-statusbar-uts 状态栏工具插件

用于修改应用的状态栏背景颜色、字体颜色以及控制状态栏显示/隐藏的UTS插件，支持鸿蒙、Android、iOS平台。

功能特性

• 设置状态栏背景颜色和字体颜色
• 隐藏/显示状态栏
• iOS平台隐藏/显示HomeIndicator

安装方法

直接通过uni_modules安装即可使用。

使用说明

导入插件

// 导入方法
import * as statusbar from '@/uni_modules/tsw-statusbar-uts';

设置状态栏颜色

// 设置状态栏背景色和文字颜色
statusbar.setStatusBar('#0A59F7', '#F1F3F5', (res) => {
  console.log("修改状态栏结果", res);
});

隐藏状态栏

// 隐藏状态栏
statusbar.hideStatusBar();

显示状态栏

// 显示状态栏
statusbar.showStatusBar();

iOS隐藏HomeIndicator

// iOS隐藏HomeIndicator
statusbar.hideHomeIndicator();

iOS显示HomeIndicator

// iOS显示HomeIndicator
statusbar.showHomeIndicator();

API文档

setStatusBar(backgroundColor: string, contentColor: string, callback: Function)

同时设置状态栏背景颜色和字体颜色

参数：

• backgroundColor：背景颜色，格式为十六进制字符串，如 '#000000'
• contentColor：字体颜色，格式为十六进制字符串，如 '#ffffff'
• callback：回调函数，返回设置结果

hideStatusBar()

隐藏状态栏

showStatusBar()

显示状态栏

hideHomeIndicator()

隐藏iOS设备的HomeIndicator

showHomeIndicator()

显示iOS设备的HomeIndicator

注意事项

• 鸿蒙平台支持任意修改状态栏文字颜色
• Android平台状态栏文字颜色仅支持黑色和白色
• iOS平台状态栏文字颜色根据背景色自动调整为白色或黑色
• iOS平台仅支持隐藏/显示HomeIndicator功能

平台兼容性