大事记 - 安卓微信浏览器 video 标签层级过高

时间:2021-01-22 19:37:05

// 为什么叫《大事记》?

// 以前总有面试官问这样一个问题:“你在项目中遇到过最头疼的问题是什么,是怎么解决的?”

// 当时总觉得,已解决的问题都算不上头疼,所以回答总是不尽人意。

// 最近遇到微信端的这个问题,非常让人头疼,正好有小伙伴和我聊到面试经验,灵机一动,《大事记》由此而生

问题描述:

在安卓系统的微信浏览器里面,<video> 标签触发了 play() 事件,即开始播放之后

<video> 标签的层级会变成 MAX 级别,无论如何设置 z-index,都会遮挡别的脱离文档流的元素

大事记 - 安卓微信浏览器 video 标签层级过高

分析原因:

微信的 X5 内核为了统一 <video> 在不同的手机上的呈现形式,对 <video> 进行了改造

这样的改造在 IOS 系统上一切正常,但在安卓系统就会有各种问题,比如这里的层级太高

解决方案:

当测试的同事将这个 bug 提给我的时候,我根本没想到,我即将面对一场苦不堪言的角斗

第一回合:隐藏 video

最初暴露的问题并不是页面底部的按钮,而是一个弹窗

在了解了问题的原因之后,我当时的思路是:

打开弹窗的时候,将 <video> 标签隐藏掉,关闭弹窗的时候再显示 <video>

隐藏标签的方法有很多:display:none;   visibility: hidden;  z-index: -1;   left: -9999px;  opacity: 0;

但 display:none 没有占位,visibility 和 z-index 不起作用,opacity 虽然不显示元素,但依旧点不到下面的元素

所以只有用定位的办法了

  let tag = document.createElement('style')
tag.id = id
tag.innerHTML = `video { position: relative; left: -9999; }`
body.appendChild(tag)

在打开弹窗的时候,通过上面的代码添加一个带有特殊 id 的 <style> 标签,然后在关闭时候根据 id 删除节点

为了防止多级弹窗的时候重复创建 <style>,在方法前面需要验证是否存在该 id

想通了这一系列逻辑之后,我猛然发现,页面底部的按钮也会被遮挡!

第二回合:跳转到单独页面播放

深思熟虑之后,我得出结论:遮挡问题无解

但问题还是要解决,于是我向 PM 提出,单独写一个播放页面,点击 <video> 的时候跳转到这个页面进行播放

经过一番唇枪舌剑的交锋,PM 妥协了,但要求尽量优化体验,打开的播放页看起来要像全屏播放一样

“这都不是事儿!” 我如是回道

播放页面确实不是事儿,可 <video> 真不是省油的灯

我原本想的是,全局添加一个 addEventListener('click'),如果点击的是 <video> 标签,就保存视频信息,并跳转到播放页面

document.addEventListener('click', (e) => {
let target = e.target
if (target.nodeName.toUpperCase() === 'VIDEO') {
this.setVideoUrl({
  url: target.src,
  poster: target.poster
})
this.$router.push(`/video`)
}
})

这下跳转是没问题了,但在点击的时候,实际上还触发了 <video> 的 play() 事件

从理论上来说,已经跳转页面了,这个 play() 事件并不需要阻止,但为了逻辑严谨,我还是做了尝试

e.preventdefault()
e.stopPropagation()
e.cancelBubble()
return false

然而这并不能阻止播放事件 play()

那就不阻止了

然后又了新的 Bug:部分机型从播放返回之后,<video> 是播放的状态,而且有层级问题

第三回合:禁用 controls

我重新回到那个问题:如何阻止播放事件?

稍作挣扎,我就换了一个思路:如果没有播放按钮,那就不需要阻止播放事件了

于是我给 <video> 添加了 controls=""

这样就没有播放工具栏,之后只需要手动添加一个三角形的播放图标,一切就完美了

页面上的 <video> 是作为描述内容的一部分,包含在一段富文本里面,从后端返回的

这样一来,<video> 相关的 DOM 节点只能通过 JS 修改,成本太高,所以我打算只用 CSS 来解决播放图标的问题

然后我画了一个播放的图标,给 <video> 添加了一个伪元素 :before,在伪元素里写好了样式,但毫无作用

原来 <video> 并不支持伪元素

“如果无法解决问题,那就让问题不存在”

我脑海中闪过这段话,然后有了新的方案:

大事记 - 安卓微信浏览器 video 标签层级过高

我又画了一张图,然后将 <video> 的 poster 改成了这张图,问题解决了!

然后产品小姐姐跑过来:你对我的视频封面图做了什么?

决战:js 王道

既然 poster 不能改,那就只有通过 js 去操作 DOM,给 <video> 添加一个兄弟节点 <i class="video-play_btn"> 作为播放按钮

然后将 <video> 和播放按钮一起包在一个容器 <div class="video-wrapper"> 中

setVideoWrapper () {
this.$nextTick(() => {
let v = document.getElementsByTagName('video')
if (v && v[]) {
// 产品规定 页面中只会有一个 <video>
let target = v[]
// 防止重复创建 wrapper
if (target.parentNode.className === 'video-wrapper') return
// 清除 <video> 播放工具栏
target.controls = ''
target.className = 'video-hack'
// 创建播放按钮
let btn = document.createElement('i')
btn.className = 'video-play_btn'
// 创建容器
let wrap = document.createElement('div')
wrap.className = 'video-wrapper'
wrap.appendChild(btn)
wrap.appendChild(target.cloneNode())
// 插入容器并删除原本的 <video>
target.parentNode.insertBefore(wrap, target)
target.parentNode.removeChild(target)
}
})
}

再添加对应的 LESS 样式:

.video {
&-wrapper {
position: relative;
font-size:;
}
&-play {
&_btn {
position: absolute;
top:;
left:;
right:;
bottom:;
background: rgba(0, 0, 0, .1) url('img/url') center/80px 80px no-repeat;
}
}
}

终于,<video> 的问题彻底解决了,皆大欢喜,普天同庆

但我还是要吐槽一下,微信 <video> 的问题由来已久,开发团队也曾经说过要解决,但最后都不了了之

这大约都是时辰的错