uniapp 悬浮窗-任意界面 Ba-FloatWinWeb

简介(下载地址)

Ba-FloatWinWeb 是一款支持自定义任意界面的悬浮窗插件。采用webview方式,同时支持本地、网络地址;自带几种界面,可直接使用。

  • 支持显示、更新、隐藏
  • 支持记录显示位置
  • 支持拖动
  • 支持监听点击事件
  • 支持自动申请、判断悬浮窗权限
  • 支持手动申请、判断悬浮窗权限
  • 支持同时设置多个悬浮窗,并且可以不同样式
  • 自带几种界面,可直接使用(见效果图)

uniapp 常用原生插件大全


截图展示

uniapp 悬浮窗-任意界面 Ba-FloatWinWeb_第1张图片

使用方法

script 中引入组件

	const floatWin = uni.requireNativePlugin('Ba-FloatWinWeb')

script 中调用(示例参考,可根据自己业务和调用方法自行修改)

        methods: {
			showFW(tag) { //显示
				let params = {
					//isToast: true,
					//tag: tag,//悬浮窗标识,用于区分多个悬浮窗,可以不传
					webUrl: "file:///android_asset/testFloatWin.html",//网页地址
					width:128,//宽度 px
					height: 128,//高度 px
					xRatio: 0.8,//x轴偏移量(屏幕宽度比例)
					yRatio: 0.7,//y轴偏移量(屏幕高度比例)
					//moveType: 1,//拖动方式:1:不可拖动 2:任意拖动、3:贴边拖动。默认2
					//isRememberXY: false,//是否记住上次的位置。默认true
					//isPermission: false,//是否申请悬浮窗权限。默认true
					//widthRatio:1,//宽度(屏幕宽度比例),width有值时无效
					//heightRatio: 0.3,//高度(屏幕高度比例),height有值时无效
					//webviewBgColor:"#FFFFFF"//webview背景色,默认透明
				}
				floatWin.show(params,
					(res) => {
						console.log(res);
						uni.showToast({
							title: res.msg,
							icon: "none",
							duration: 3000
						})
					});
			},
			updateFW(tag) { //更新数据
				let webUrl ="file:///android_asset/testFloatWin.html?num1=66&num2=21"
				floatWin.update({
						webUrl: webUrl,
						//tag: tag
					},
					(res) => {
						console.log(res);
						uni.showToast({
							title: res.msg,
							icon: "none",
							duration: 3000
						})
					});
			},
			hideFW(tag) { //隐藏
				floatWin.hide({
						tag: tag
					},
					(res) => {
						console.log(res);
						uni.showToast({
							title: res.msg,
							icon: "none",
							duration: 3000
						})
					});
			},
		}

点击事件监听

在应用生命周期app.vue的onLaunch事件中设置监听:

        onLaunch: function() {
			var globalEvent = uni.requireNativePlugin('globalEvent');
			globalEvent.addEventListener('baFloatWinWeb', function(e) {
				console.log('baFloatWinWeb:' + JSON.stringify(e));
				//处理点击事件
			});
		},
		onShow: function() {
		},
		onHide: function() {
		}

点击事件参数

属性名 说明
action 事件类型,如:onClick
tag 悬浮窗标识,用于区分多个悬浮窗,可以不传
json 附加参数,可在html网页中自定义添加

示例:

{"action":"onClick","json":{"msg":"点击了item1"},"tag":"menu"}

网页配置

同时支持在线网页和本地网页。

如果用在线网页,直接传地址即可;

如果用本地网页,文件放在项目根目录,“nativeplugins/Ba-FloatWinWeb/android/assets/”目录下,没有就新建,配置如下(demo):

├── nativeplugins 
  ├── Ba-FloatWinWeb
    ├── android                  
      ├── assets
		├── static
		  ├── ba_float_win_icon.png
		  ├── ba_float_win_logo.png
		├── testFloatWin.html
		├── testFloatWin2.html 
		├── testFloatWin3.html 
		├── testFloatWin4.html  

webUrl参数,传入地址的格式为:“file:///android_asset/”+html文件名称

html网页示例(testFloatWin.html)

DOCTYPE html>
<html lang="zh">
	<head>
		<meta charset="utf-8">
		<title>webviewtitle>
		<script src="https://cdn.staticfile.org/jquery/1.10.2/jquery.min.js">script>
		<script>
			$(document).ready(function() {
				onLoad()
			});

			function onLoad() {
				let num1 = GetUrlParam("num1")
				let num2 = GetUrlParam("num2")
				let num3 = GetUrlParam("num3")
				let num4 = GetUrlParam("num4")
				if (num1)
					$("#num1").text(num1)
				if (num2)
					$("#num2").text(num2)
				if (num3)
					$("#num3").text(num3)
				if (num4)
					$("#num4").text(num4)
			}

			function onClickFW(json) { //点击事件
				Android.onClickFW(json);
			}
			//获取url参数
			function GetUrlParam(paramName) {
				let url = decodeURI(window.location.href);
				console.log(url)
				var arrObj = url.split("?");
				if (arrObj.length > 1) {
					var arrPara = arrObj[1].split("&");
					var arr;
					for (var i = 0; i < arrPara.length; i++) {
						arr = arrPara[i].split("=");
						if (arr != null && arr[0] == paramName) {
							return arr[1];
						}
					}
					return "";
				} else {
					return "";
				}
			}
		script>

		<style>
			body,
			html {
				height: 128px;
				width: 128px;
				margin: 0;
				padding: 0;
				overflow: hidden;
			}

			.container {
				display: flex;
				flex-direction: column;
				border-radius: 12px;
				width: 128px;
				height: 128px;
				background: rgba(0, 0, 50, 0.6);
				//box-shadow: 0px 0px 32px 0px rgba(0, 0, 0, 0.2);
				border-radius: 12px 12px 12px 12px;
				opacity: 1;
			}

			.row {
				display: flex;
				flex-direction: row;
				margin: 6px 6px 0px 6px;
			}

			.item {
				display: flex;
				flex-direction: column;
				justify-content: center;
				align-items: center;
				width: 55px;
				height: 55px;
				background: rgba(255, 255, 255, 0.1);
				border-radius: 8px 8px 8px 8px;
				opacity: 1;
			}

			.name {
				text-align: center;
				width: 34px;
				height: 17px;
				font-size: 13px;
				font-weight: 500;
				color: rgba(255, 255, 255, 0.6);
			}

			.num {
				text-align: center;
				margin-top: 6px;
				width: 21px;
				height: 18px;
				font-size: 14px;
				font-weight: bold;
				color: #FFFFFF;
			}
		style>
	head>

	<body style=" overflow:hidden" scroll="no">
		<div class="container">
			<div class="row">
				<div class="item" onclick="onClickFW('item1')">
					<div class="name">
						采购
					div>
					<div id="num1" class="num">
						50
					div>
				div>
				<div class="item" onclick="onClickFW('item2')" style="margin-left: 6px;">
					<div class="name">
						售出
					div>
					<div id="num2" class="num">
						20
					div>
				div>
			div>
			<div class="row">
				<div class="item" onclick="onClickFW('item3')">
					<div class="name">
						折损
					div>
					<div id="num3" class="num">
						3
					div>
				div>
				<div class="item" onclick="onClickFW('item4')" style="margin-left: 6px;">
					<div class="name">
						过期
					div>
					<div id="num4" class="num">
						0
					div>
				div>
			div>
		div>
	body>
html>

api 列表

方法名 说明
show 显示
update 更新数据
hide 隐藏

你可能感兴趣的:(uni-app,uni-app,悬浮窗,应用之上,自定义任意界面,拖动,应用上层)