最近,React Native 发布了 0.64 版本,与往常一样,该版本又涉及到了一系列的变化。其中,最大的改动莫过于区别 Android 与 iOS 系统的通知栏。
React Native 项目中,如果你需要在应用程序中显示通知信息,就可以使用一个实用的 JavaScript 库 rn-root-notification。下面是一个简单的教程,帮助你快速上手并使用 rn-root-notification 运用于你的项目。
安装 rn-root-notification
你可以使用 npm 包管理器来安装该包:
npm install --save rn-root-notification
或者,如果你想在使用 Yarn 包管理器:
yarn add rn-root-notification
开始使用
在你的 React Native 项目的一个 JavaScript 文件,你首先可以将 rn-root-notification
导入你的依赖中:
import RootNotification from 'rn-root-notification';
接下来,你可以使用 RootNotification.show
方法来创建一个基本的通知:
RootNotification.show({ title: '新通知标题', message: '新通知正文' });
当然,这只是创建一个最基础的通知,在后续有深入使用时,您可能需要各种参数定制,下面我们将演示更多的自定义设置。
设定自定义设置
下面列出了一些您可能需要自定义的设置:
smallIcon
属性
您可能需要为 Android 系统定义一个尺寸小且具有唯一辨识度的图标。将图标的路径传递给 smallIcon
属性即可,如下:
RootNotification.show({ title: '新通知标题', message: '新通知正文', smallIcon: 'ic_launcher' });
注意,在 Android 10 系统中此设置无效。
largeIcon
属性
作为 Android 系统中的一个更棒的功能,除了显示小图标,还可以显示一些更大的图片。该功能用于更新一些重要、较多的通知消息。将图标的路径传递给 largeIcon
属性即可,如下:
RootNotification.show({ title: '新通知标题', message: '新通知正文', largeIcon: 'ic_launcher', smallIcon: 'ic_notification' });
priority
属性
将通知的优先级设置为高或低。
RootNotification.show({ title: '新通知标题', message: '新通知正文', priority: 'high' });
vibrate
属性
设置通知在弹出时是否振动。
RootNotification.show({ title: '新通知标题', message: '新通知正文', vibrate: true });
lights
属性
设置通知在弹出时是否有 LED 灯光效果闪烁。
RootNotification.show({ title: '新通知标题', message: '新通知正文', lights: true });
iconBadgeNumber
属性
为消息通知区域添加 Icon Badge Badge 数字。(仅适用于 iOS)
RootNotification.show({ title: '新通知标题', message: '新通知正文', iconBadgeNumber: 1 });
playSound
属性
为新通知添加音频效果。(iOS没有默认的铃声,可能需要在其他应用中添加音频效果之后,再使用这个选项)
RootNotification.show({ title: '新通知标题', message: '新通知正文', playSound: true });
发送本地通知
您可以将本地通知发送到设备上,然后该通知将被弹出到前台。在以下代码中,您将看到如何使用此功能。
-- -------------------- ---- ------- ------------------------------------ ----------- ----- ---------- -------------- ---------- ------------------ -------- --------------------------------- -------- ------- ------ ---------- -------- ----- ---------- ---- ---- ------- ------ ----------------- ----------- ---------- ----------- ------- --------- ------- -------- ----------- ------ --------- ----- --- --------------- - ---- - -- - --- ---
总结
rn-root-notification 是一款非常实用的 npm 包,可以快速、轻松地在设备上生成通知消息。在此教程中,我们探讨了如何安装和使用该包,另外,也说明了一些自定义的集成选项,以满足你特殊的设计需求。希望此教程能给您的工作带来帮助,请掌握并迅速启动您自己的 React Native 开发吧!
参考链接
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055ca081e8991b448da06e