更新记录

1.1.5（2023-10-13）

增加隐私协议内容区域高度自定义,默认为30vh,超出滚动显示

1.1.4（2023-09-14）

优化文档 : 进阶使用方法,请仔细看文档中的各种使用方法

需要手动重新触发可以 使用 ref 再次调用插件内的 checkPrivacySetting() 方法

使用 @needAuthorization 判断当前是否需要授权才能使用api接口, false为已经授权不需要弹窗,可直接使用

1.1.3（2023-09-14）

文档优化

平台兼容性

zero-privacy

仅测试于 vue2, vue3, 微信小程序. 其他平台可自行测试

一. 介绍

1. 支持 居中弹出,底部弹出
2. 不依赖第三方弹窗组件,内置轻量动画效果
3. 支持自定义触发条件
4. 支持自定义主题色
5. 弹窗时可使用配置参数隐藏tabar,避免弹窗出现时可以跳转页面,关闭弹窗自动展示tabbar
6. 自动获取隐私协议名称
7. 底部弹出时自动适配安全距离

二. 为什么需要隐私协议

为规范开发者的用户个人信息处理行为，保障用户的合法权益，自2023年9月15日起，对于涉及处理用户个人信息的小程序开发者，微信要求，仅当开发者主动向平台同步用户已阅读并同意了小程序的隐私保护指引等信息处理规则后，方可调用微信提供的隐私接口。

三. 使用方法

使用前请确保配置等相关操作都做好了,划重点!划重点!划重点!必看

配置详细教程: 如何配置才能触发小程序隐私协议弹窗

组件内已处理相关逻辑,开发者仅需要在小程序后台填写所用户隐私保护指引,导入uni_modules后直接使用即可 考虑到平台兼容性,请添加微信小程序的条件编译

1. 打开页面直接触发 (在小程序首页等tabbar页面直接处理隐私弹窗逻辑)

<template>
<!-- 有tabbar的页面 -->
    <view class="container">
    <!-- #ifdef MP-WEIXIN -->
        <zero-privacy :onNeed='false' :hideTabBar='true'></zero-privacy>
        <!-- #endif -->
    </view>
</template>

<!-- 没有tabbar的页面 -->
<template>
    <view class="container">
    <!-- #ifdef MP-WEIXIN -->
        <zero-privacy :onNeed='false'></zero-privacy>
        <!-- #endif -->
    </view>
</template>

需要重新触发可以 使用 ref 再次调用插件内的  checkPrivacySetting() 方法

2. 按需触发 (在页面点击某些需要用到隐私协议后处理隐私弹窗逻辑)

   <template>
   <view class="container">
       <view class="btn" @click="handleCopy">
           复制
       </view>
       <!-- #ifdef MP-WEIXIN -->
       <zero-privacy></zero-privacy>
       <!-- #endif -->
   </view>
   </template>

3. 自定义内容使用

<template>
    <view class="container">
    <!-- #ifdef MP-WEIXIN -->
        <zero-privacy title="测试自定义标题" predesc="协议前内容" privacy-contract-name-custom="<自定义名称及括号>" subdesc="协议后内容协议后内容协议后内容.&#10;主动换行"></zero-privacy>
    <!-- #endif -->
    </view>
</template>

4. 进阶使用

<template>
    <view class="container">
        <!-- #ifdef MP-WEIXIN -->
        <zero-privacy @needAuthorization='handleNeedAuthorization' @agree='handleNeedAuthorization(false)'></zero-privacy>
        <!-- #endif -->
    </view>
</template>

<script setup>
    const handleNeedAuthorization=(val)=>{
        console.log('是否需要授权',val);
        // false便是已经授权过,或者无需授权
        if(!val){
            // 无需授权,直接执行业务,同理,点击同意也是执行下面的业务
        }
    }
</script>   

四. 参数说明

predesc 和 subdesc 的自定义内容,需要主动换行时在内容中添加实体字符 
 即可

event

五. 实战踩坑(作者仅测试少量api,大家可以在评论区分享自己用到的隐私api坑,这边会统一整理)

1. 获取微信昵称 nickname 的输入框无法按需触发隐私授权弹窗,请在登录注册等获取用户名页面使用直接触发方式调用
2. 获取定位等功能, 一般在页面加载就发起请求,此时隐私弹窗的授权判断可能还没获取到,所以请注意隐私api的触发时机

插件预览:

小程序搜索: zerojs零技术

预览的小程序不一定能及时更新当前插件