Vue自定義鈴聲提示音組件的實現(xiàn)
背景/前言
之前的一個功能需求,需要在頁面接收消息,一旦有了新消息之后,需要用鈴聲進行提醒。
因為沒有找到類似的比較便捷的組件,所以就自己寫了一個。然后想著能不能嘗試下做成一個公共的組件,發(fā)布出去讓其他開發(fā)者也用用?于是就試著寫了一個項目(項目地址在最后),發(fā)布成了npm包。
目前這個組件已經(jīng)發(fā)布到了npm上,歡迎大家試用。如果有好的建議,或者找到了更好的類似組件,歡迎指出和分享~
下面是使用文檔:
組件的使用
安裝
npm i easy-ring
加載
1)全局使用
在vue-cli項目main.js上當作插件使用,即可直接在vue單文件組件使用
// main.js import EasyRing from 'easy-ring' Vue.use(EasyRing)
<!-- 直接使用,無需引入 -->
<template>
<easy-ring
:open="open"
:ring="ring"
:src="src"
/>
</template>
export default {
...
}2)import方式
在vue單文件組件里引入
<template>
<easy-ring
:open="open"
:ring="ring"
:src="src"
/>
</template>
import EasyRing from 'easy-ring'
export default {
components: {
EasyRing
}
...
}組件生效
- 第一步. 開啟鈴聲:將open參數(shù)設為true
- 第二步. 響鈴:將ring參數(shù)設為true
- 第三步. 關鈴:將ring參數(shù)設為false
PS:
- 開啟鈴聲這一步,需要放到一個按鈕下埋點進行觸發(fā)(原因解釋見下文 "關于open參數(shù)的解釋")。為了提升自己產(chǎn)品的使用體驗,可以做到用戶無感知,例如在登錄時,用戶點擊“登錄”按鈕即可設置open參數(shù)為true
- 根據(jù)自己的需求自行決定何時響鈴、何時關鈴,將ring參數(shù)的更改放到對應邏輯下即可
組件參數(shù)
| 參數(shù)名 | 類型 | 默認值 | 說明 |
|---|---|---|---|
| open | Boolean | false | 開啟鈴聲 |
| ring | Boolean | false | 是否響鈴 |
| src | String | 默認鈴聲 | 鈴聲音頻文件地址 |
使用默認音效
若想使用默認音效,請在./main.js文件中引入默認音效
// main.js
require('easy-ring/easy-ring-default.wav')然后將這段代碼合并到你的vue.config.js配置中:
configureWebpack: {
module: {
rules: [
{
test: /easy-ring-default\.(wav)$/i,
loader: 'file-loader',
options: {
name: 'media/[name].[ext]'
},
},
]
}
}需要添加這個配置的原因是,vue-cli默認會對所有打包的靜態(tài)資源加上hash版本號,這樣easy-ring就無法獲取到你目錄下的默認音頻文件的地址。
加上這一項file-loader的配置后,easy-ring的默認音頻文件就不會帶上hash版本號,easy-ring就能找到它。
關于open參數(shù)的解釋
因為當前多數(shù)瀏覽器不支持自動播放音頻,需要用戶自己主動觸發(fā)播放音頻才行。這一過程需要放在諸如click的交互事件里,因此我們需要一個按鈕之類的東西來觸發(fā)這一行為。
但是,你可以通過一些交互來設計這一行為,從而提升用戶體驗,甚至讓用戶對此無感知。例如:在登錄時,在用戶點擊“登錄”按鈕時,在代碼里設置open參數(shù)為true。
項目地址
github上的地址:easy-ring
訪問不了github的可以試試這個鏡像地址:fastgit鏡像
一共有兩個項目文件:
- easy-ring-build:構建npm發(fā)布包
- easy-ring-demo:使用范例
到此這篇關于Vue自定義鈴聲提示音組件的實現(xiàn)的文章就介紹到這了,更多相關Vue自定義組件內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
vue中el-date-picker選擇日期的限制的項目實踐
ElementUI的el-date-picker使用時,有時候想要限制用戶選擇的時間范圍,本文就來介紹了vue中el-date-picker選擇日期的限制的項目實踐,感興趣的可以了解一下2023-10-10
element-ui組件table實現(xiàn)自定義篩選功能的示例代碼
這篇文章主要介紹了element-ui組件table實現(xiàn)自定義篩選功能的示例代碼,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2019-03-03
antfu大佬的v-lazy-show教我學會了怎么編譯模板指令
這篇文章主要介紹了antfu大佬的v-lazy-show,我學會了怎么編譯模板指令示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2023-04-04
如何在vue3.0+中使用tinymce及實現(xiàn)多圖上傳文件上傳公式編輯功能
本文給大家分享tinymce編輯器如何在vue3.0+中使用tinymce及實現(xiàn)多圖上傳文件上傳公式編輯功能,tinymce安裝方法文中也給大家詳細介紹了,對vue tinymce實現(xiàn)上傳公式編輯相關知識感興趣的朋友跟隨小編一起學習下吧2021-05-05
Vue?echarts實例項目商家銷量統(tǒng)計圖實現(xiàn)詳解
Echarts,它是一個與框架無關的?JS?圖表庫,但是它基于Js,這樣很多框架都能使用它,例如Vue,估計IONIC也能用,因為我的習慣,每次新嘗試做一個功能的時候,總要新創(chuàng)建個小項目,做做Demo2022-09-09

