右侧菜单栏全局aplayer播放器

前言

起因是觉得原有的全局吸底播放器放在左侧，一图流背景下有点碍眼，就想到把它放到右边菜单栏，跟着菜单栏一起移动。

效果预览

适配了暗黑模式，并修改了毛玻璃效果。

教程

基础配置

首先安装 Aplayer 插件，输入以下命令安装：
1
npm install --save hexo-tag-aplayer
在配置文件 [Blogroot]\_config.yml 或主题配置文件 [Blogroot]\_config.butterfly.yml 中添加以下配置项：
1
2
3
aplayer: meting: true asset_inject: false
在主题配置文件 [Blogroot]\_config.butterfly.yml 中开启 aplayerInject 配置项：
1
2
3
aplayerInject: enable: true per_page: true

在主题配置文件 [Blogroot]\_config.butterfly.yml 的 inject 配置项中添加以下内容：

inject:
   head:
     # - <link rel="stylesheet" href="/xxx.css">
   bottom:
     # - <script src="xxxx"></script>
     - <div class="aplayer rightside-aplayer no-destroy" id="aplayer" data-id="8429082619" data-server="tencent" data-type="playlist" data-fixed="true" data-autoplay="false" data-lrcType="-1"> </div>

参数说明

Option	Default	Description
id	required	song id / playlist id / album id / search keyword
server	required	Music platform: `netease`, `tencent`, `kugou`, `xiami`, `baidu`
type	required	`song`, `playlist`, `album`, `search`, `artist`
fixed	`false`	Enable fixed mode
mini	`false`	Enable mini mode
loop	`all`	Player loop play, values: ‘all’, ‘one’, ‘none’
order	`list`	Player play order, values: ‘list’, ‘random’
volume	0.7	Default volume, notice that player will remember user setting, default volume will not work after user set volume themselves
lrctype	0	Lyric type
listfolded	`false`	Indicate whether list should folded at first
autoplay	`false`	Autoplay song(s), not supported by mobile browsers
mutex	`true`	Pause other players when this player playing
listmaxheight	`340px`	Max height of play list
preload	`auto`	The way to load music, can be `none`, `metadata`, `auto`
storagename	`metingjs`	LocalStorage key that store player setting
theme	`#ad7a86`	Theme color

魔改步骤

在 [Blogroot]\themes\butterfly\source\css\custom\ 目录下新建 rightside_aplayer.css 文件：

#aplayer.rightside-aplayer {
  bottom: -38px;
  border-radius: 0.75rem;
  /* right: -48px; */
  width: 38px;
  height: 38px;
  opacity: 0;
  visibility: hidden;
  /* 关键：确保 transition 包含 opacity 和 transform (或 right) */
  transition: all 0.5s ease-in-out;
  transform: translateX(100%);
}

#aplayer.rightside-aplayer.aplayer-active {
  right: 20px;
  opacity: 1;
  visibility: visible;
  transform: translateX(0);

}


#aplayer.rightside-aplayer .aplayer-pic {
  width: 38px !important;
  height: 38px !important;
  border-radius: 0.75rem;
}

#aplayer.rightside-aplayer .aplayer-body {
  margin-top: 100px;
  /* left: calc(100% - 48px) !important;
  right: 11px; */
  width: 38px !important;
  height: 38px;
  /* bottom: 49px; */
  padding-right: 0px;
  border-radius: 0.75rem;
  /* animation: slideInFromLeft 1s ease forwards; */
}

#aplayer.rightside-aplayer.aplayer-fixed {
  left: revert;
  right: 10px;
  bottom: 49px;
  position: fixed;
}

#aplayer.rightside-aplayer .aplayer-info {
  position: absolute;
  right: 44px;
  width: 0;
  padding: 0 6px 0 5px;
   width: 0;
    opacity: 0;
    overflow: hidden;
    transition: width 0.3s ease, opacity 0.3s ease; /* 宽度动画 */
  height: 38px;
  border-radius: 0.75rem;
  /* 背景颜色 */
  background: rgba(255, 255, 255, 0.3);
  backdrop-filter: blur(19px) saturate(170%);
  -webkit-backdrop-filter: blur(19px) saturate(170%);
  border: 1px solid rgba(255, 255, 255, 0.3);
  box-shadow:
    0 4px 30px rgba(0, 0, 0, 0.1),
    0 10px 20px rgba(0, 0, 0, 0.1);
}

#aplayer.rightside-aplayer .aplayer-info.aplayer-info-show{
  width: 400px; /* 设置你想要的展开宽度 */
    opacity: 1;
}

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-info {
  background: rgba(18, 18, 18, 0.15) !important;
}

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-info .aplayer-music {
  color: rgba(255, 255, 255, 0.7);
}

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-info .aplayer-title {
  color: rgba(255, 255, 255, 0.7);
}

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-info .aplayer-music .aplayer-author {
  color: rgba(255, 255, 255, 0.7);
}

#aplayer.rightside-aplayer .aplayer-icon-play {
  bottom: 20px;
  width: 20px;
  height: 16px;
  left: 30.5px;
}

#aplayer.rightside-aplayer .aplayer-icon-play svg{
  margin: 2px 0 0 0;
}

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-info .aplayer-controller .aplayer-time .aplayer-icon path {
  fill: rgba(255, 255, 255, 0.7);
}

#aplayer.rightside-aplayer .aplayer-icon-back {
  bottom: 20px;
  width: 20px;
  height: 16px;
  left: 6px;
}

#aplayer.rightside-aplayer .aplayer-icon-back svg{
  margin-top: 2px;
}

#aplayer.rightside-aplayer .aplayer-icon-forward {
  bottom: 20px;
  width: 20px;
  height: 16px;
  left: 55px;
}

#aplayer.rightside-aplayer .aplayer-icon-forward svg{
  margin-top: -2px;
}

#aplayer.rightside-aplayer .aplayer-icon-menu {
  bottom: 20px;
  width: 15px;
  height: 16px;
}

#aplayer.rightside-aplayer .aplayer-miniswitcher {
  right: 25px;
  width: 13px;
  border-radius: 8px 0 0 8px;
  border: none;
  background: transparent;
}

#aplayer.rightside-aplayer .aplayer-miniswitcher .aplayer-icon svg path{
  fill: #fff;
      box-shadow: 0 2px 2px rgba(0, 0, 0, 0.5), 0 2px 2px rgba(0, 0, 0, 0.5);
}

#aplayer.rightside-aplayer .aplayer-info .aplayer-music {
  height: 16px;
  margin: 3px 0 0 3px;
}

#aplayer.rightside-aplayer .aplayer-info .aplayer-music .aplayer-title {
  font-size: 10px;
}



#aplayer.rightside-aplayer .aplayer-info .aplayer-controller .aplayer-bar-wrap {
  padding: 5px 0;
  margin-left: 3px;
}
#aplayer.rightside-aplayer .aplayer-info .aplayer-controller .aplayer-bar-wrap .aplayer-bar .aplayer-played {
  background: rgba(245, 166, 185, 0.7)!important;
}

#aplayer.rightside-aplayer .aplayer-info .aplayer-controller .aplayer-bar-wrap .aplayer-bar .aplayer-played .aplayer-thumb{
  background: rgba(245, 166, 185, 0.85)!important;
}
#aplayer.rightside-aplayer .aplayer-info .aplayer-controller .aplayer-time {
  bottom: 1px;
}

#aplayer.rightside-aplayer .aplayer-list {
  position: fixed;
  right: 44px;
  margin-bottom: 102px;
  bottom: -75px;
  border: none;
  border-radius: 0.75rem 0.75rem 0 0;
  width: 0;
  opacity: 0;
  padding-bottom: 7px;
  visibility: visible;
   overflow: hidden;
  transition: width 0.3s ease, opacity 0.3s ease; /* 宽度动画 */
  display: block !important; 
  overflow: hidden;
  /* 背景颜色 */
  background: rgba(255, 255, 255, 0.3);
  backdrop-filter: blur(19px) saturate(170%);
  -webkit-backdrop-filter: blur(19px) saturate(170%);
  border: 1px solid rgba(255, 255, 255, 0.3);
  box-shadow:
    0 4px 30px rgba(0, 0, 0, 0.1),
    0 10px 20px rgba(0, 0, 0, 0.1);
  
}

#aplayer.rightside-aplayer .aplayer-list.aplayer-list-show {
    width: 398.5px; /* 设置你想要的展开宽度 */
    opacity: 1;
}


#aplayer.rightside-aplayer .aplayer-list ol {
  scrollbar-width: none;
  /* 隐藏滚动条 */
}

#aplayer.rightside-aplayer .aplayer-list ol li {
  border-top: 0.5px solid rgba(255, 255, 255, 0.3);
}

#aplayer.rightside-aplayer .aplayer-list ol li:first-child {
  border: none;
}

#aplayer.rightside-aplayer .aplayer-list ol .aplayer-list-light .aplayer-list-cur {
  background-color: rgba(245, 166, 185, 0.45) !important;
}

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-list {
  background: rgba(18, 18, 18, 0.15) !important;

}

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-list ol li {
  color: rgba(255, 255, 255, 0.7) !important;
}

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-list ol li .aplayer-list-author {
  color: rgba(255, 255, 255, 0.7) !important;
}

#aplayer.rightside-aplayer .aplayer-list ol .aplayer-list-light {
  background: rgba(255, 255, 255, 0.2);
}

/* [data-theme="dark"] #aplayer.rightside-aplayer .aplayer-list ol .aplayer-list-light{
  background: rgba(255, 255, 255, 0.2);
} */

[data-theme="dark"] #aplayer.rightside-aplayer .aplayer-list ol .aplayer-list-index {
  color: rgba(255, 255, 255, 0.7);
}

#aplayer.rightside-aplayer .aplayer-list ol li:hover {

  background: rgba(255, 255, 255, 0.2);
}

#aplayer.rightside-aplayer .aplayer-pic .aplayer-play {
  width: 16px;
  height: 16px;
  border: 2px solid #fff;
  bottom: 27px;
  right: 29px;
  margin: 0 -25px -23px 0;
}

#aplayer.rightside-aplayer .aplayer-pic .aplayer-play svg {
  position: absolute;
  top: 1.5px;
  left: 2.5px;
  height: 13px;
  width: 13px;
}

#aplayer.rightside-aplayer .aplayer-notice {
  display: none;
}

.aplayer.aplayer-fixed>.aplayer-lrc {
  display: none;
}



@media (max-width: 460px) {
  #aplayer.rightside-aplayer .aplayer-info.aplayer-info-show {
    overflow: hidden;
    display: inline-block;
    width: 300px;
  }
}

@media (max-width: 460px) {
  #aplayer.rightside-aplayer .aplayer-list.aplayer-list-show {
    width: 298.5px; /* 设置你想要的展开宽度 */
    opacity: 1;
}
}

我这里通过添加自建 css 文件覆盖原有的样式，有点乱，也可以将原始的 css 文件下载到本地修改。

在主题配置文件 [Blogroot]\_config.butterfly.yml 的 inject 配置项中添加以下内容：

inject:
    head:
      - <link rel="stylesheet" href="/css/custom/rightside_aplayer.css">
    bottom:
      # - <script src="xxxx"></script>

在 [Blogroot]\themes\butterfly\source\js\custom\ 目录下新建 rightside_aplayer.js 文件：

(function () {
  const initAplayerScroll = () => {
    // 1. 获取目标元素
    const target = document.getElementById('aplayer');

    // 2. 容错判断：如果当前页面没这个元素，直接结束，不执行后续逻辑
    if (!target) return;

    // 3. 核心滚动逻辑
    const handleScroll = () => {
      // 获取滚动距离（兼容各浏览器）
      const scrollTop = window.scrollY || document.documentElement.scrollTop;

      // 超过 100px 则添加类名，否则移除
      if (scrollTop > 95) {
        target.classList.add('aplayer-active');
      } else {
        target.classList.remove('aplayer-active');
      }
    };

    // 4. 监听滚动事件（增加节流以优化性能）
    let ticking = false;
    window.addEventListener('scroll', () => {
      if (!ticking) {
        window.requestAnimationFrame(() => {
          handleScroll();
          ticking = false;
        });
        ticking = true;
      }
    }, { passive: true });

    // 5. 初始化执行一次，防止刷新页面时已在滚动条下方
    handleScroll();
  };

  // 确保 DOM 加载后运行
  if (document.readyState === 'loading') {
    document.addEventListener('DOMContentLoaded', initAplayerScroll);
  } else {
    initAplayerScroll();
  }
})();


const btn = document.querySelector('.aplayer-miniswitcher .aplayer-icon');
const list = document.querySelector('.aplayer-list');

document.addEventListener('click', (e) => {
    // 1. 检查点击的是否是切换按钮或其图标
    const toggleBtn = e.target.closest('.aplayer-miniswitcher .aplayer-icon');
    
    if (toggleBtn) {
        const list = document.querySelector('.aplayer-list');
        if (list) {
            list.classList.toggle('aplayer-list-show');
        }
    }
});

const info = document.querySelector('.aplayer-info');

document.addEventListener('click', (e) => {
    // 1. 检查点击的是否是切换按钮或其图标
    const toggleBtn = e.target.closest('.aplayer-miniswitcher .aplayer-icon');
    
    if (toggleBtn) {
        const list = document.querySelector('.aplayer-info');
        if (list) {
            list.classList.toggle('aplayer-info-show');
        }
    }
});

这个是用于监听页面滚动，控制播放器的显示和隐藏，并与侧边按钮的显隐同步。

在主题配置文件 [Blogroot]\_config.butterfly.yml 的 inject 配置项中添加以下内容：

inject:
    head:
      # - <link rel="stylesheet" href="/xxx.css">
    bottom:
      # - <script src="xxxx"></script>
      - <script src="/js/custom/rightside_aplayer.js"></script>