当前位置： 首页 > news >正文

uniapp动态页面API

news 2025/7/3 12:16:36

目录

 uni.setNavigationBarTitle动态设置标题

uni.showNavigationBarLoading为标题添加加载动画与uni.hideNavigationBarLoading停止加载动画

​编辑

  uni.setNavigationBarColor用于设置导航栏的颜色，包括背景颜色和文字颜色。这对于自定义应用的主题和风格非常有用。

uni.setTabBarItem设置 tabBar 项的文本

uni.setTabBarStyle(OBJECT)

uni.hideTabBar(OBJECT)

uni.showTabBar(OBJECT)

uni.setTabBarBadge(OBJECT)

uni.removeTabBarBadge(OBJECT)

uni.showTabBarRedDot(OBJECT)

uni.hideTabBarRedDot(OBJECT)

 uni.setNavigationBarTitle动态设置标题

 是一个用于设置页面导航栏标题的方法。它允许你在页面加载后动态地更改导航栏的标题。

uni.setNavigationBarTitle(OBJECT)

代码示例

<template><view class="content"><!-- 设置导航栏标题按钮 --><button @click="changeNavigationBarTitle">更改导航栏标题</button></view>
</template><script setup>// 更改导航栏标题const changeNavigationBarTitle = () => {uni.setNavigationBarTitle({title: '新标题', // 新的导航栏标题success: function() {console.log('导航栏标题设置成功');},fail: function(err) {console.error('设置导航栏标题失败:', err);}});};
</script>

详细解释

  1. title：必须，字符串类型，表示新的导航栏标题。
  2. success：可选，成功回调函数，当设置成功时触发。
  3. fail：可选，失败回调函数，当设置失败时触发。

uni.showNavigationBarLoading为标题添加加载动画与uni.hideNavigationBarLoading停止加载动画

<template><!-- 页面的主要内容区域 --><view class="content"><!-- 点击按钮时触发 showLoading 方法 --><button @click="showLoading">加载</button></view>
</template><script setup>// 显示加载指示器const showLoading = () => {// 显示导航栏中的加载指示器uni.showNavigationBarLoading();// 模拟异步操作，2秒后隐藏加载指示器setTimeout(() => {// 隐藏导航栏中的加载指示器uni.hideNavigationBarLoading();}, 2000);};
</script><style>/* 页面内容区域的样式 */.content {padding: 20px; /* 内边距为 20px */}
</style>



所用的 API 解释

  1.  uni.showNavigationBarLoading

    • 功能：在导航栏中显示一个加载指示器。
    • 用途：当页面需要加载数据或执行耗时操作时，显示一个加载指示器，以提升用户体验。
    • 参数：无参数。
    • 示例： 
      uni.showNavigationBarLoading();

  2. uni.hideNavigationBarLoading

    • 功能：在导航栏中隐藏加载指示器。
    • 用途：当数据加载完成或耗时操作结束后，隐藏加载指示器。
    • 参数：无参数。
    • 示例： 
      uni.hideNavigationBarLoading();

  3. setTimeout

    • 功能：设置一个定时器，在指定时间后执行回调函数。
    • 用途：模拟异步操作，例如数据请求或耗时任务。
    • 参数：
      • callback: 回调函数。 
      • delay: 延迟时间（毫秒）。
    • 案例 
      setTimeout(() => {// 回调函数console.log('2秒后执行');
}, 2000);

  uni.setNavigationBarColor用于设置导航栏的颜色，包括背景颜色和文字颜色。这对于自定义应用的主题和风格非常有用。

<template><!-- 页面的主要内容区域 --><view class="content"><!-- 点击按钮时触发 changeNavigationBarColor 方法 --><button @click="changeNavigationBarColor">更改导航栏颜色</button></view>
</template><script setup>// 更改导航栏颜色const changeNavigationBarColor = () => {// 设置导航栏颜色uni.setNavigationBarColor({frontColor: '#ffffff', // 文字和图标颜色backgroundColor: '#ff0000', // 背景颜色animation: {duration: 2000, // 动画持续时间timingFunc: 'ease' // 动画效果}});};
</script><style>/* 页面内容区域的样式 */.content {padding: 20px; /* 内边距为 20px */}
</style>

API 介绍

uni.setNavigationBarColor 用于设置导航栏的颜色，包括背景颜色和文字颜色。这对于自定义应用的主题和风格非常有用。

参数说明

uni.setNavigationBarColor 接受一个对象参数 OBJECT，其中包含以下属性：

  • frontColor: 导航栏前面的颜色，通常是文字和图标颜色。默认值为 #000000。
  • backgroundColor: 导航栏的背景颜色，默认值为 #ffffff。
  • animation: 动画效果配置对象，可选。
    • duration: 动画持续时间（单位：毫秒），默认值为 400。
    • timingFunc: 动画的效果，可选值为 linear, easeIn, easeOut, ease, 默认值为 linear。

uni.setTabBarItem设置 tabBar 项的文本

在 UniApp 中，uni.setTabBarItem 方法用于设置 tabBar 中某一项的属性。以下是 uni.setTabBarItem 的详细属性说明及示例代码。

uni.setTabBarItem 属性说明

uni.setTabBarItem 方法有以下几个参数：

  • index (Number): tabBar 的项的索引。
  • text (String): tabBar 项的文字内容。
  • iconPath (String): 图片路径，非当前项时显示的图片。
  • selectedIconPath (String): 图片路径，当前项显示的图片。
  • badgeText (String): 显示在 tabBar 项右上角的标记文本，默认为空字符串。
  • success (Function): 接口调用成功的回调函数。
  • fail (Function): 接口调用失败的回调函数。
  • complete (Function): 接口调用结束的回调函数（调用成功、失败都会执行）。
// 设置 tabBar 项的文本const setText = () => {uni.setTabBarItem({index: 0, // tabBar 的项的索引text: '新消息', // 设置的文本内容success: function(res) {console.log('设置文本成功');},fail: function(err) {console.error('设置文本失败', err);}});};
	// 设置 tabBar 项的图标const setIcon = () => {uni.setTabBarItem({index: 0,iconPath: '', // 未选中状态的图标路径selectedIconPath: '', // 选中状态的图标路径success: function(res) {console.log('设置图标成功');},fail: function(err) {console.error('设置图标失败', err);}});};

uni.setTabBarStyle(OBJECT)设置tabBar样式
 

// 设置 tabBar 的整体样式
const setTabBarStyle = () => {uni.setTabBarStyle({backgroundColor: '#f5f5f5', // tabBar 的背景色color: '#666666', // 文字默认颜色selectedColor: '#ff0000', // 文字选中时的颜色borderStyle: 'black' // tabBar 上边框的颜色});
};

uni.setTabBarStyle 方法接受一个对象作为参数，该对象包含以下属性：

  • borderStyle (String): tabBar 上边框的颜色，可选值为 'black' 或 'white'。
  • backgroundColor (String): tabBar 的背景色。
  • color (String): tabBar 文字默认颜色。
  • selectedColor (String): tabBar 文字选中时的颜色。

uni.hideTabBar(OBJECT)隐藏 tabBar

uni.hideTabBar 方法用于隐藏 tabBar。它接受一个对象作为参数，该对象包含以下属性：

  • animation (Boolean): 是否以动画方式隐藏 tabBar，默认为 false。
  • success (Function): 接口调用成功的回调函数。
  • fail (Function): 接口调用失败的回调函数。
  • complete (Function): 接口调用结束的回调函数（调用成功、失败都会执行）。
	// 隐藏 tabBarconst hideTabBar = () => {uni.hideTabBar({animation: true, // 以动画方式隐藏 tabBarsuccess: function(res) {console.log('隐藏 tabBar 成功');},fail: function(err) {console.error('隐藏 tabBar 失败', err);}});};

uni.showTabBar(OBJECT)显示 tabBar

// 显示 tabBarconst showTabBar = () => {uni.showTabBar({animation: true, // 以动画方式显示 tabBarsuccess: function(res) {console.log('显示 tabBar 成功');},fail: function(err) {console.error('显示 tabBar 失败', err);}});};

uni.showTabBar 方法用于显示 tabBar。它接受一个对象作为参数，该对象包含以下属性：

  • animation (Boolean): 是否以动画方式显示 tabBar，默认为 false。
  • success (Function): 接口调用成功的回调函数。
  • fail (Function): 接口调用失败的回调函数。
  • complete (Function): 接口调用结束的回调函数（调用成功、失败都会执行）。

uni.setTabBarBadge(OBJECT)设置 tabBar 项的徽标文本

	// 设置 tabBar 项的徽标文本const setTabBarBadge = () => {uni.setTabBarBadge({index: 0, // tabBar 的项的索引text: '1', // 设置的文本内容success: function(res) {console.log('设置 tabBar 徽标成功');},fail: function(err) {console.error('设置 tabBar 徽标失败', err);}});};

// 清除 tabBar 项的徽标文本const clearTabBarBadge = () => {uni.setTabBarBadge({index: 0, // tabBar 的项的索引text: '', // 清除徽标success: function(res) {console.log('清除 tabBar 徽标成功');},fail: function(err) {console.error('清除 tabBar 徽标失败', err);}});};
 

uni.setTabBarBadge 方法用于设置 tabBar 项的徽标文本。它接受一个对象作为参数，该对象包含以下属性：

  • index (Number): tabBar 的项的索引。
  • text (String): 设置的文本内容。
  • success (Function): 接口调用成功的回调函数。
  • fail (Function): 接口调用失败的回调函数。
  • complete (Function): 接口调用结束的回调函数（调用成功、失败都会执行）。

uni.removeTabBarBadge(OBJECT)移除 tabBar 项的徽标文本

// 移除 tabBar 项的徽标文本const removeTabBarBadge = () => {uni.removeTabBarBadge({index: 0, // tabBar 的项的索引success: function(res) {console.log('移除 tabBar 徽标成功');},fail: function(err) {console.error('移除 tabBar 徽标失败', err);}});};

uni.removeTabBarBadge 方法用于移除 tabBar 项的徽标文本。它接受一个对象作为参数，该对象包含以下属性：

  • index (Number): tabBar 的项的索引。
  • success (Function): 接口调用成功的回调函数。
  • fail (Function): 接口调用失败的回调函数。
  • complete (Function): 接口调用结束的回调函数（调用成功、失败都会执行）。

uni.showTabBarRedDot(OBJECT)在 tabBar 项上显示红点

// 显示 tabBar 项的红点const showTabBarRedDot = () => {uni.showTabBarRedDot({index: 0, // tabBar 的项的索引success: function(res) {console.log('显示 tabBar 红点成功');},fail: function(err) {console.error('显示 tabBar 红点失败', err);}});};

uni.showTabBarRedDot 方法用于在 tabBar 项上显示红点。它接受一个对象作为参数，该对象包含以下属性：

  • index (Number): tabBar 的项的索引。
  • success (Function): 接口调用成功的回调函数。
  • fail (Function): 接口调用失败的回调函数。
  • complete (Function): 接口调用结束的回调函数（调用成功、失败都会执行）。

uni.hideTabBarRedDot(OBJECT)隐藏 tabBar 项的红点

	// 隐藏 tabBar 项的红点const hideTabBarRedDot = () => {uni.hideTabBarRedDot({index: 0, // tabBar 的项的索引success: function(res) {console.log('隐藏 tabBar 红点成功');},fail: function(err) {console.error('隐藏 tabBar 红点失败', err);}});};

uni.hideTabBarRedDot 方法用于隐藏 tabBar 项的红点。它接受一个对象作为参数，该对象包含以下属性：

  • index (Number): tabBar 的项的索引。
  • success (Function): 接口调用成功的回调函数。
  • fail (Function): 接口调用失败的回调函数。
  • complete (Function): 接口调用结束的回调函数（调用成功、失败都会执行）。

下拉刷新

 通过属性手动下滑刷新

需要在 pages.json 里，找到的当前页面的pages节点，并在 style 选项中开启 enablePullDownRefresh

"path": "pages/index/index","style": {"navigationBarTitleText": "uni-app","enablePullDownRefresh": true}

也可以通过API来控制

通过API控制也需要加入enablePullDownRefresh属性

"path": "pages/index/index","style": {"navigationBarTitleText": "uni-app","enablePullDownRefresh": true}

uni.startPullDownRefresh() 用于结束下拉刷新状态

uni.stopPullDownRefresh() 用于结束下拉刷新状态

<template><view class="container"><button @click="onClick(1)">开始刷新</button><button @click="onClick(2)">停止刷新</button></view>
</template><script setup>
var onClick = (i) => {if(i===1){uni.startPullDownRefresh()}else{uni.stopPullDownRefresh()}
}
</script><style>
.container {display: flex;flex-direction: column;align-items: center;justify-content: center;height: 100vh;
}
</style>

http://www.lryc.cn/news/432503.html

相关文章：

  • 最优化方法Python计算：求解约束优化问题的拉格朗日乘子算法
  • 每日OJ_牛客_骆驼命名法（递归深搜）
  • MySQL 数据库管理与操作指南
  • Android Manifest 权限描述大全对照表
  • Ollama Qwen2 支持 Function Calling
  • APP测试工程师岗位面试题
  • 如何进行 AWS 云监控
  • 第十六篇：走入计算机网络的传输层--传输层概述
  • 提升效率！ArcGIS中创建脚本工具
  • 无人机之报警器的作用
  • 风格控制水平创新高！南理工InstantX小红书发布CSGO:简单高效的端到端风格迁移框架
  • python文件自动化（4）
  • HTTP 方法
  • 通过redis-operator 来部署 Redis Cluster 集群
  • vue3集成sql语句编辑器
  • Optuna发布 4.0 重大更新：多目标TPESampler自动化超参数优化速度提升显著
  • https和harbor仓库跟k8s
  • 云计算之网络
  • MySQL Workbench 的入门指南
  • 【SpringBoot】使用Nacos服务注册发现与配置管理
  • Leetcode面试经典150题-210.课程表II
  • 视频汇聚平台LntonAIServer视频质量诊断功能--偏色检测与噪声检测
  • Vue 使用接口返回的背景图片和拼图图片进行滑动拼图验证
  • 1-7 掩膜的运用 opencv树莓派4B 入门系列笔记
  • EG边缘计算网关连接华为云物联网平台（MQTT协议）
  • List中常见的方法和五种遍历方式
  • 华为 HCIP-Datacom H12-821 题库 (8)
  • 12. GIS地图制图工程师岗位职责、技术要求和常见面试题
  • ORACLE 统计信息的备份与恢复
  • 2. GIS数据工程师岗位职责、技术要求和常见面试题