465 字
2 分钟
【开源】WPwebplayer——简洁通用的网页播放器
一款简单,简洁,轻量,通用的开源网站音乐播放器
2025-08-09
加载中...

本文章非站长本人撰写,由他人Pr添加: https://github.com/afoim/fuwari/pull/23

WPWebPlayer(html网站播放组件)#

一款简单,简洁,轻量的网站音乐播放器 体验界面 示例
项目文章(博客) | 体验界面 | NPM包(前端资源)#

项目特性:#

  • 简约:仅需引入css与js文件,统一使用<wp-music-player>标签
  • 简单:无更多冗杂功能,回归最基础的【网站音乐播放】
  • 可控性强:支持多个自定义参数,播放功能 ui颜色均可自定义
  • 易于集成:可用于任何html项目中

使用方式:#

  1. <head>标签中引入css与js文件
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/wpwebplayer@1.1.5/min-css.css">
<script src="https://cdn.jsdelivr.net/npm/wpwebplayer@1.1.5/min-js.js"></script>
  1. <body>中使用<wp-music-player>标签
<wp-music-player
src=""
title=""
artist=""
cover=""
autoplay="true"
loop="true"
volume="0.3"
fixed="true"
mini="true"
theme="#ff6b6b">
</wp-music-player>

(代码示例请前往example.html)#

参数说明#

属性类型默认值描述
srcstring音频文件地址(必须)
titlestring音乐标题
artiststring作者
coverstring封面图片URL
autoplaytrue / falsefalse是否自动播放
looptrue / falsetrue是否循环播放
volumenumber (0~1)1.0初始音量(0~1)
fixedtrue / falsetrue是否固定样式
minitrue / falsetrue是否迷你模式
themestring(色值)#00c3ff主题颜色

说明#

  • src&cover:均需将图片上传至图床并引用
  • autoplay:参数失效 浏览器安全策略禁止未经允许的音频自动播放Chrome 中的自动播放政策(需要用户手动操作后才能播放)
  • volume: 0~1 的小数值,代表 0%~100% 的音量大小
  • fixed:使播放器始终固定在页脚,不会因页面滚动产生的相对位置变化影响播放器实际位置(默认为 true)
  • mini:“迷你模式”和“完整模式”切换 完整模式支持更多功能(有bug 还没修)
  • theme:主题颜色 默认为#00c3ff

特别鸣谢#

@MarSeventh 叁月柒大佬,在开发过程中提供宝贵帮助,解决数个关键bug

【开源】WPwebplayer——简洁通用的网页播放器
https://www.2x.nz/posts/wpwebplayer/
作者
二叉树树
发布于
2025-08-09
许可协议
CC BY-NC-SA 4.0