Skip to content

snu.setPermTips()

配置权限提示内容

为各权限配置权限提示气泡的展示内容(标题、正文、图标等)。tips 以"权限名 → 提示配置"的 Map 形式传入。

兼容性

WebAndroid

属性

名称类型必备默认值描述
tipsMap[string, SnPermTipConfig]-权限名与提示配置的映射

setPermTips 中单个权限的提示内容配置,四个字段均可省略。html 非空时优先展示(替代 title / content)。

名称类型必填描述
htmlString自定义 HTML 内容
titleString提示标题
contentString提示正文
iconString提示图标名

返回值

类型必备描述
Void无返回值

示例

typescript
let tips = new Map<string, object>()
tips.set('camera', { title: '需要相机权限', content: '用于拍照', icon: 'camera' })
snu.setPermTips(tips)

snu.setPermTipsStyle()

配置权限提示样式

配置权限提示气泡的整体样式(位置、颜色、尺寸、动画等)。该样式会随主题切换自动更新,无需重复调用。

兼容性

WebAndroid

属性

名称类型必备默认值描述
styleSnPermTipsStyleConfig-提示气泡样式配置

setPermTipsStyle 的提示气泡样式配置,各字段均可省略(省略时使用内置默认值)。

名称类型必填描述
positionString弹出位置,可选值 top | bottom,默认 top
bgColorString气泡背景颜色,默认 $front
radiusString | Number气泡圆角,默认 $12
paddingString | Number内边距,默认 '$16px $20px'
marginString | Number外边距,默认 '$12px'
titleColorString标题颜色,默认 $title
titleSizeString | Number标题字号,默认 $16
contentColorString正文颜色,默认 $text
contentSizeString | Number正文字号,默认 $14
iconColorString图标颜色,默认 $title
iconSizeString | Number图标字号,默认 $22
spacingString | Number行与行、图标与文本的间距,默认 $10
maxWidthString | Number气泡最大宽度(px),0 表示不限制
aniTimeString | Number出入动画时长,默认 $250

返回值

类型必备描述
Void无返回值

示例

typescript
snu.setPermTipsStyle({
	position: 'top',
	bgColor: '#333333',
	radius: '12',
	contentSize: '$14'
})

snu.registerPermListener()

注册权限监听器

注册权限监听器,用于接收权限相关状态变化的回调。传 null 可清除当前监听。

兼容性

WebAndroid

属性

名称类型必备默认值描述
listenerPermListener/null-权限监听器;null 表示清除

返回值

类型必备描述
Void无返回值

示例

typescript
snu.registerPermListener({
	onChange: (perm) => {}
})

snu.unregisterPermListener()

注销权限监听器

注销已注册的权限监听器,停止接收权限变化回调。

兼容性

WebAndroid

属性

名称类型必备默认值描述
listenerPermListener/null-待注销的监听器

返回值

类型必备描述
Void无返回值

示例

typescript
snu.unregisterPermListener(listener)

snu.hidePermTips()

隐藏权限提示

隐藏当前展示的权限提示气泡。

兼容性

WebAndroid

属性

返回值

类型必备描述
Void无返回值

示例

typescript
snu.hidePermTips()

使用 MIT 协议