发现新文章

我们已经通过 Google Adsense 审核!不出意外,在未开启广告拦截器的情况下,应该已经可以看到广告了

如果您对广告位置不满意(如:占据面积大,挡住主要内容等情况),请前往 置顶文章 告知我们!

465 字
2 分钟
【开源】WPwebplayer——简洁通用的网页播放器
一款简单,简洁,轻量,通用的开源网站音乐播放器
2025年8月9日
0 次

本文章非站长本人撰写,由他人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

这篇文章是否对你有帮助?

发现错误或想要改进这篇文章?

在 GitHub 上编辑此页

文章修订历史 (5 次)

查看变更记录
2026年2月9日 07:50:52 f6e3e17

压缩图片

2026年1月9日 13:13:34 3b002c5

feat(scripts): 添加删除图片路径空格的脚本

2025年8月9日 22:31:03 1651457

Update WPwebplayer.md

2025年8月9日 22:28:48 eb9e131

Update WPwebplayer.md

2025年8月9日 21:41:31 9fcc49c

docs:【开源】WPwebplayer——简洁通用的网页播放器

【开源】WPwebplayer——简洁通用的网页播放器
作者
二叉树树
发布于
2025年8月9日
许可协议
CC BY-NC-SA 4.0