H5项目常见问题汇总及解决方案

时间 2019-11-10

标签 h5 项目常见问题汇总解决方案繁體版

原文原文链接

原文连接 - https://github.com/FrontEndRo...javascript

H5项目常见问题及注意事项

Meta基础知识：

H5页面窗口自动调整到设备宽度，并禁止用户缩放页面

<!-- 一、HTML页面结构 -->
<meta name="viewport" content="width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no" />
<!-- width    设置viewport宽度，为一个正整数，或字符串‘device-width’
     height   设置viewport高度，通常设置了宽度，会自动解析出高度，能够不用设置
     initial-scale    默认缩放比例，为一个数字，能够带小数
     minimum-scale    容许用户最小缩放比例，为一个数字，能够带小数
     maximum-scale    容许用户最大缩放比例，为一个数字，能够带小数
     user-scalable    是否容许手动缩放 -->

// 二、JS动态判断
var phoneWidth =  parseInt(window.screen.width);
var phoneScale = phoneWidth/640;
var ua = navigator.userAgent;
if (/Android (\d+\.\d+)/.test(ua)){
    var version = parseFloat(RegExp.$1);
    if(version>2.3){
        document.write('<meta name="viewport" content="width=640, minimum-scale = '+phoneScale+', maximum-scale = '+phoneScale+', target-densitydpi=device-dpi">');
    }else{
        document.write('<meta name="viewport" content="width=640, target-densitydpi=device-dpi">');
    }
} else {
    document.write('<meta name="viewport" content="width=640, user-scalable=no, target-densitydpi=device-dpi">');
}

H5空白页基本meta标签

<!-- 设置缩放 -->
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no, minimal-ui" />
<!-- 可隐藏地址栏，仅针对IOS的Safari（注：IOS7.0版本之后，safari上已看不到效果） -->
<meta name="apple-mobile-web-app-capable" content="yes" />
<!-- 仅针对IOS的Safari顶端状态条的样式（可选default/black/black-translucent ） -->
<meta name="apple-mobile-web-app-status-bar-style" content="black" />
<!-- IOS中禁用将数字识别为电话号码/忽略Android平台中对邮箱地址的识别 -->
<meta name="format-detection"content="telephone=no, email=no" />

PC端基础meta标签

<!-- 页面关键词-->
<meta name="keywords" content="your tags" />
<!-- 页面描述-->
<meta name="description" content="150 words" />
<!-- 搜索引擎索引方式：robotterms是一组使用逗号(,)分割的值，一般有以下几种取值：none，noindex，nofollow，all，index和follow。确保正确使用nofollow和noindex属性值。-->
<meta name="robots" content="index,follow" />
<!--
    all：文件将被检索，且页面上的连接能够被查询；
    none：文件将不被检索，且页面上的连接不能够被查询；
    index：文件将被检索；
    follow：页面上的连接能够被查询；
    noindex：文件将不被检索；
    nofollow：页面上的连接不能够被查询。
 -->
 
 <!-- 页面重定向和刷新：content内的数字表明时间（秒），既多少时间后刷新。若是加url,则会重定向到指定网页（搜索引擎可以自动检测，也很容易被引擎视做误导而受到惩罚）。-->
 <meta http-equiv="refresh" content="0;url=" />

页面缓存设置

<!-- 清除缓存 -->
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">

其余meta标签

<!-- 启用360浏览器的极速模式(webkit) -->
<meta name="renderer" content="webkit">
<!-- 避免IE使用兼容模式 -->
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<!-- 针对手持设备优化，主要是针对一些老的不识别viewport的浏览器，好比黑莓 -->
<meta name="HandheldFriendly" content="true">
<!-- 微软的老式浏览器 -->
<meta name="MobileOptimized" content="320">
<!-- uc强制竖屏 -->
<meta name="screen-orientation" content="portrait">
<!-- QQ强制竖屏 -->
<meta name="x5-orientation" content="portrait">
<!-- UC强制全屏 -->
<meta name="full-screen" content="yes">
<!-- QQ强制全屏 -->
<meta name="x5-fullscreen" content="true">
<!-- UC应用模式 -->
<meta name="browsermode" content="application">
<!-- QQ应用模式 -->
<meta name="x5-page-mode" content="app">
<!-- windows phone 点击无高光 -->
<meta name="msapplication-tap-highlight" content="no">

<meta name="author" content="author name" /> <!-- 定义网页做者 -->
<meta name="google" content="index,follow" />
<meta name="googlebot" content="index,follow" />
<meta name="verify" content="index,follow" />

常见问题：

移动端如何定义字体font-family

@ --------------------------------------中文字体的英文名称
@ 宋体      SimSun
@ 黑体      SimHei
@ 微信雅黑   Microsoft Yahei
@ 微软正黑体 Microsoft JhengHei
@ 新宋体    NSimSun
@ 新细明体  MingLiU
@ 细明体    MingLiU
@ 标楷体    DFKai-SB
@ 仿宋     FangSong
@ 楷体     KaiTi
@ 仿宋_GB2312  FangSong_GB2312
@ 楷体_GB2312  KaiTi_GB2312  
@
@ 说明：中文字体多数使用宋体、雅黑，英文用Helvetica

body { font-family: Microsoft Yahei,SimSun,Helvetica; }

打电话发短信写邮件怎么实现

<!-- 1、打电话 -->
<a href="tel:0755-10086">打电话给:0755-10086</a>

<!-- 2、发短信，winphone系统无效 -->
<a href="sms:10086">发短信给: 10086</a>

<!-- 3、写邮件 -->
<!-- 注：在添加这些功能时，第一个功能以"?"开头，后面的以"&"开头 -->
<!-- 1.普通邮件 -->
<a href="mailto:863139978@qq.com">点击我发邮件</a>
<!-- 2.收件地址后添加?cc=开头，可添加抄送地址（Android存在兼容问题） -->
<a href="mailto:863139978@qq.com?cc=zhangqian0406@yeah.net">点击我发邮件</a>
<!-- 3.跟着抄送地址后，写上&bcc=,可添加密件抄送地址（Android存在兼容问题） -->
<a href="mailto:863139978@qq.com?cc=zhangqian0406@yeah.net&bcc=384900096@qq.com">点击我发邮件</a>
<!-- 4.包含多个收件人、抄送、密件抄送人，用分号(;)隔开多个邮件人的地址 -->
<a href="mailto:863139978@qq.com;384900096@qq.com">点击我发邮件</a>
<!-- 5.包含主题，用?subject= -->
<a href="mailto:863139978@qq.com?subject=邮件主题">点击我发邮件</a>
<!-- 6.包含内容，用?body=;如内容包含文本，使用%0A给文本换行 -->
<a href="mailto:863139978@qq.com?body=邮件主题内容%0A腾讯诚信%0A期待您的到来">点击我发邮件</a>
<!-- 7.内容包含连接，含http(s)://等的文本自动转化为连接 -->
<a href="mailto:863139978@qq.com?body=http://www.baidu.com">点击我发邮件</a>
<!-- 8.内容包含图片（PC不支持） -->
<a href="mailto:863139978@qq.com?body=<img src='images/1.jpg' />">点击我发邮件</a>
<!-- 9.完整示例 -->
<a href="mailto:863139978@qq.com;384900096@qq.com?cc=zhangqian0406@yeah.net&bcc=993233461@qq.com&subject=[邮件主题]&body=腾讯诚邀您参与%0A%0Ahttp://www.baidu.com%0A%0A<img src='images/1.jpg' />">点击我发邮件</a>

移动端touch事件（区分webkit和winphone）

// 当用户手指放在移动设备在屏幕上滑动会触发的touch事件
// 如下支持webkit
touchstart // 当手指触碰屏幕时候发生。无论当前有多少只手指
touchmove // 当手指在屏幕上滑动时连续触发。一般咱们在滑屏页面，会调用event的preventDefault()能够阻止默认状况的发生：阻止页面滚动
touchend // 当手指离开屏幕时触发
touchcancel // 系统中止跟踪触摸时候会触发。例如在触摸过程当中忽然页面alert()一个提示框，此时会触发该事件，这个事件比较少用

//TouchEvent说明：
touches：屏幕上全部手指的信息
targetTouches：手指在目标区域的手指信息
changedTouches：最近一次触发该事件的手指信息
touchend时，touches与targetTouches信息会被删除，changedTouches保存的最后一次的信息，最好用于计算手指信息

//参数信息(changedTouches[0])
clientX、clientY在显示区的坐标
target：当前元素

//事件响应顺序
ontouchstart  > ontouchmove  > ontouchend > onclick

// 如下支持winphone 8
MSPointerDown // 当手指触碰屏幕时候发生。无论当前有多少只手指
MSPointerMove // 当手指在屏幕上滑动时连续触发。一般咱们再滑屏页面，会调用css的html{-ms-touch-action: none;}能够阻止默认状况的发生：阻止页面滚动
MSPointerUp // 当手指离开屏幕时触发

移动端click屏幕产生200-300ms的延时响应

说明：移动设备上的web网页是有300ms延迟的，每每会形成按钮点击延迟甚至是点击失效。css

如下是历史缘由，来源一个公司内一个同事的分享：
2007年苹果发布首款iphone上IOS系统搭载的safari为了将适用于PC端上大屏幕的网页能比较好的展现在手机端上，使用了双击缩放(double tap to zoom)的方案，好比你在手机上用浏览器打开一个PC上的网页，你可能在看到页面内容虽然能够撑满整个屏幕，可是字体、图片都很小看不清，此时能够快速双击屏幕上的某一部分，你就能看清该部分放大后的内容，再次双击后能回到原始状态。html

双击缩放是指用手指在屏幕上快速点击两次，iOS 自带的 Safari 浏览器会将网页缩放至原始比例。前端

缘由就出在浏览器须要如何判断快速点击上，当用户在屏幕上单击某一个元素时候，例如跳转连接，此处浏览器会先捕获该次单击，但浏览器不能决定用户是单纯要点击连接仍是要双击该部分区域进行缩放操做，因此，捕获第一次单击后，浏览器会先Hold一段时间t，若是在t时间区间里用户未进行下一次点击，则浏览器会作单击跳转连接的处理，若是t时间里用户进行了第二次单击操做，则浏览器会禁止跳转，转而进行对该部分区域页面的缩放操做。那么这个时间区间t有多少呢？在IOS safari下，大概为300毫秒。这就是延迟的由来。形成的后果用户纯粹单击页面，页面须要过一段时间才响应，给用户慢体验感受，对于web开发者来讲是，页面js捕获click事件的回调函数处理，须要300ms后才生效，也就间接致使影响其余业务逻辑的处理。java

解决方案：android
- fastclick能够解决在手机上点击事件的300ms延迟ios
- zepto的touch模块，tap事件也是为了解决在click的延迟问题git

Rentina显示屏原理及设计方案

说明：retina屏是一种具有超高像素密度的液晶屏，一样大小的屏幕上显示的像素点由1个变为多个，如在一样带下的屏幕上，苹果设备的retina显示屏中，像素点1个变为4个。github

在高清显示屏中的位图被放大，图片会变得模糊，所以移动端的视觉稿一般会设计为传统PC的2倍。web

那么，前端的应对方案是：设计稿切出来的图片长宽保证为偶数，并使用backgroud-size把图片缩小为原来的1/2

/* 例如图片宽高为：200px*200px，那么写法以下 */
.css { width:100px; height:100px; background-size:100px 100px; }
/* 其它元素的取值为原来的1/2，例如视觉稿40px的字体，使用样式的写法为20px */
.css { font-size:20px }

/* image-set设计Rentina背景图 */
image-set,webkit私有属性，也是CSS4的属性，为解决Rentina屏幕下的图像而生。
.css {
    background: url(images/bg.jpg) no-repeat center;
    background: -webkit-image-set(
    url(images/bg.jpg) 1x,     /* 支持image-set普通屏 */
    url(images/bg-2x.jpg) 2x); /* 支持image-set的Rentinan */
}

点击元素产生背景或边框怎么去掉

ios用户点击一个连接，会出现一个半透明灰色遮罩, 若是想要禁用，可设置-webkit-tap-highlight-color的alpha值为0去除灰色半透明遮罩；

android用户点击一个连接，会出现一个边框或者半透明灰色遮罩, 不一样生产商定义出来额效果不同，可设置-webkit-tap-highlight-color的alpha值为0去除部分机器自带的效果；

winphone系统,点击标签产生的灰色半透明背景，能经过设置<meta name="msapplication-tap-highlight" content="no">去掉；

特殊说明：有些机型去除不了，如小米2。对于按钮类还有个办法，不使用a或者input标签，直接用div标签

a,button,input,textarea { 
    -webkit-tap-highlight-color: rgba(0,0,0,0); 
    -webkit-user-modify:read-write-plaintext-only;
    /* -webkit-user-modify有个反作用，就是输入法再也不可以输入多个字符 */
}   
/* 也能够 */
* { -webkit-tap-highlight-color: rgba(0,0,0,0); }
/* winphone下 */
<meta name="msapplication-tap-highlight" content="no">

美化表单元素

/* 1、使用appearance改变webkit浏览器的默认外观 */
input,select { -webkit-appearance:none; appearance: none; }

/* 2、winphone下，使用伪元素改变表单元素默认外观 */
/* 1.禁用select默认箭头，::-ms-expand修改表单控件下拉箭头，设置隐藏并使用背景图片来修饰 */
select::-ms-expand { display:none; }

/* 2.禁用radio和checkbox默认样式，::-ms-check修改表单复选框或单选框默认图标，设置隐藏并使用背景图片来修饰 */
input[type=radio]::-ms-check,
input[type=checkbox]::-ms-check { display:none; }

/* 3.禁用pc端表单输入框默认清除按钮，::-ms-clear修改清除按钮，设置隐藏并使用背景图片来修饰 */
input[type=text]::-ms-clear,
input[type=tel]::-ms-clear,
input[type=number]::-ms-clear { display:none; }

移动端字体单位font-size选择px仍是rem

/* 如需适配多种移动设备，建议使用rem。如下为参考值： */
html { font-size: 62.5%; }   /* 10*16 = 62.5% */
/* 设置12px字体，这里注意在rem前要加上对应的px值，解决不支持rem的浏览器的兼容问题，作到优雅降级 */
body { font-size:12px; font-size:1.2rem; }

超实用的CSS样式

/* 去掉webkit的滚动条——display: none; */
/* 其余参数 */
::-webkit-scrollba /* 滚动条总体部分 */
::-webkit-scrollbar-thumb /* 滚动条内的小方块 */
::-webkit-scrollbar-track /* 滚动条轨道 */
::-webkit-scrollbar-button /* 滚动条轨道两端按钮 */
::-webkit-scrollbar-track-piece /* 滚动条中间部分，内置轨道 */
::-webkit-scrollbar-corner /* 边角，两个滚动条交汇处 */
::-webkit-resizer /* 两个滚动条的交汇处上用于经过拖动调整元素大小的小控件 */

/* 禁止长按连接与图片弹出菜单 */
a,img { -webkit-touch-callout: none }    

/* 禁止ios和android用户选中文字 */
html,body { -webkit-user-select:none; user-select: none; }

/* 改变输入框placeholder的颜色值 */
::-webkit-input-placeholder { /* WebKit browsers */ color: #999; }
:-moz-placeholder { /* Mozilla Firefox 4 to 18 */ color: #999; }
::-moz-placeholder { /* Mozilla Firefox 19+ */ color: #999; }
:-ms-input-placeholder { /* Internet Explorer 10+ */ color: #999; }
input:focus::-webkit-input-placeholder{ color:#999; }

/* android上去掉语音输入按钮 */
input::-webkit-input-speech-button {display: none}

/* 阻止windows Phone的默认触摸事件 */
/* 说明：winphone下默认触摸事件事件使用`e.preventDefault`是无效的，可经过样式来禁用，如：*/
html { -ms-touch-action:none; } /* 禁止winphone默认触摸事件 */

取消input在ios下，输入的时候英文首字母的默认大写

<input autocapitalize="off" autocorrect="off" />

手机拍照和上传图片

<!-- OS有拍照、录像、选取本地图片功能，部分Android只有选择本地图片功能。Winphone不支持 -->
<input type="file" accept="images/*" />
<input type="file" accept="video/*" />

屏幕旋转的事件和样式

// JS处理
function orientInit(){
    var orientChk = document.documentElement.clientWidth > document.documentElement.clientHeight?'landscape':'portrait';
    if (orientChk =='lapdscape'){
        // 这里是横屏下须要执行的事件
    } else {
        // 这里是竖屏下须要执行的事件
    }
}

orientInit();
window.addEventListener('onorientationchange' in window?'orientationchange':'resize', function(){
    setTimeout(orientInit, 100);
},false)

/* CSS处理 */
/* 竖屏时样式 */
@media all and (orientation:portrait){   }
/* 横屏时样式 */
@media all and (orientation:landscape){   }

audio元素和video元素在ios和andriod中没法自动播放

<!-- 音频，写法一 -->
<audio src="music/bg.mp3" autoplay loop controls>你的浏览器还不支持哦</audio>

<!-- 音频，写法二 -->
<audio controls="controls">    
    <source src="music/bg.ogg" type="audio/ogg"></source>
    <source src="music/bg.mp3" type="audio/mpeg"></source>
    优先播放音乐bg.ogg，不支持在播放bg.mp3
</audio>

// JS绑定自动播放（操做window时，播放音乐）
$(window).one('touchstart', function(){
    music.play();
})

// 微信下兼容处理
document.addEventListener("WeixinJSBridgeReady", function () {
    music.play();
}, false);

// 小结
// 1.audio元素的autoplay属性在IOS及Android上没法使用，在PC端正常
// 2.audio元素没有设置controls时，在IOS及Android会占据空间大小，而在PC端Chrome是不会占据任何空间

重力感应事件

// 运用HTML5的deviceMotion，调用重力感应事件
if(window.DeviceMotionEvent){
    document.addEventListener('devicemotion', deviceMotionHandler, false)
}    

var speed = 30;
var x = y = z = lastX = lastY = lastZ = 0;
function deviceMotionHandler(eventData){
    var acceleration = event.accelerationIncludingGravity;
    x = acceleration.x;
    y = acceleration.y; 
    z = acceleration.z;
    if(Math.abs(x-lastX)>speed || Math.abs(y-lastY)>speed || Math.abs(z-lastZ)>speed ){
        // 这里是摇动后要执行的方法 
        yaoAfter();
    }
    lastX = x;
    lastY = y;
    lastZ = z;
}

function yaoAfter(){
    // do something
}

// 说明：说见案例摇一摇效果中yao.js

微信浏览器用户调整字体大小后页面矬了，怎么阻止用户调整

// 如下代码可以使Android机页面再也不受用户字体缩放强制改变大小，可是会有1S左右延时，期间能够考虑loading来处理
if (typeof(WeixinJSBridge) == "undefined") {
    document.addEventListener("WeixinJSBridgeReady", function (e) {
        setTimeout(function(){
            WeixinJSBridge.invoke('setFontSizeCallback', { 'fontSize':0}, function(res){
                alert(JSON.stringify(res));
            })
        }, 0)
    });
}else{    
    setTimeout(function(){
        WeixinJSBridge.invoke('setFontSizeCallback', { 'fontSize':0}, function(res){
            alert(JSON.stringify(res));
        })
    }, 0)    
}

/* IOS下可以使用 -webkit-text-size-adjust禁止用户调整字体大小 */
body { -webkit-text-size-adjust:100%!important; }

/* 最好的解决方案：最好使用rem或百分比布局 */

定位的坑

fixed定位
- ios下fixed元素容易定位出错，软键盘弹出时，影响fixed元素定位
- android下fixed表现要比iOS更好，软键盘弹出时，不会影响fixed元素定位
- ios4下不支持position:fixed
- 解决方案：使用Iscroll，如：

<div id="wrapper">
    <ul>
        <li></li>
        .....
    </ul>
</div>
<script src="iscroll.js"></script>
<script>
    var myscroll;
    function loaded(){
        myscroll=new iScroll("wrapper");
    }
    window.addEventListener("DOMContentLoaded",loaded,false);
</script>

position定位
- Android下弹出软键盘弹出时，影响absolute元素定位

//解决方案:
var ua = navigator.userAgent.indexOf('Android');
if(ua>-1){
    $('.ipt').on('focus', function(){
        $('.css').css({'visibility':'hidden'})
    }).on('blur', function(){
        $('.css').css({'visibility':'visible'})
    })
}

播放视频不全屏

<!--
1.ios7+支持自动播放
2.支持Airplay的设备（如：音箱、Apple TV)播放
x-webkit-airplay="true" 
3.播放视频不全屏
webkit-playsinline="true" 
-->
<video x-webkit-airplay="true" webkit-playsinline="true" preload="auto" autoplay src="http://"></video>

JS判断设备

function deviceType(){
    var ua = navigator.userAgent;
    var agent = ["Android", "iPhone", "SymbianOS", "Windows Phone", "iPad", "iPod"];    
    for(var i=0; i<len,len = agent.length; i++){
        if(ua.indexOf(agent[i])>0){            
            break;
        }
    }
}
deviceType();
window.addEventListener('resize', function(){
    deviceType();
})

JS判断微信浏览器

function isWeixin(){
    var ua = navigator.userAgent.toLowerCase();
    if(ua.match(/MicroMessenger/i)=='micromessenger'){
        return true;
    }else{
        return false;
    }
}

android 2.3 bug

//1.@-webkit-keyframes 须要以0%开始100%结束，0%的百分号不能去掉
//2.after和before伪类没法使用动画animation
//3.border-radius不支持%单位，如要兼容，能够给radius设置一下较大的值
//4.translate百分比的写法和scale在一块儿会致使失效，例如：
-webkit-transform: translate(-50%,-50%) scale(-0.5, 1)

android 4.x bug

//1.三星 Galaxy S4中自带浏览器不支持border-radius缩写
//2.同时设置border-radius和背景色的时候，背景色会溢出到圆角之外部分
//3.部分手机(如三星)，a连接支持鼠标:visited事件，也就是说连接访问后文字变为紫色
//4.android没法同时播放多音频audio

消除transition闪屏

.css {
    -webkit-transform-style: preserve-3d;
    -webkit-backface-visibility: hidden;
    -webkit-perspective: 1000;
}

开启硬件加速

目前，像Chrome/Filefox/Safari/IE9+以及最新版本Opera都支持硬件加速，当检测到某个DOM元素应用了某些CSS规则时就会自动开启，从而解决页面闪白，保证动画流畅。

.css {
    -webkit-transform: translate3d(0,0,0);
    -moz-transform: translate3d(0,0,0);
    -ms-transform: translate3d(0,0,0);
    transform: translate3d(0,0,0);
}

渲染优化

一、禁止使用iframe（阻塞父文档onload事件）
二、禁止使用gif图片实现loading效果（下降CPU消耗，提高渲染性能）
三、使用CSS3代码代替JS动画；
四、开启GPU加速；
五、使用base64位编码图片(仅小图而言，大图不建议使用)

对于一些小图标，可使用base64位编码，以减小网络请求。但不建议大图使用，比较耗费CPU。小图标优点在于：
- 减小HTTP请求；
- 避免文件跨域；
- 修改及时生效；

腾讯方案

var autoScale = function(){
    var ratio = 320/504,   //这是设计稿的宽高比（504是Iphone的高度去掉标题栏高度）
        winW = document.getElement.clientWidth,
        winH = document.getElement.clientHeight,
        ratio2 = winW/winH,
        scale;
    if(ratio<ratio2){
        scale = (winH/504).toString().substring(0, 6);
    }else{
        scale = (winW/320).toString().substring(0, 6);  
    }
    var cssText = '-webkit-transform: scale('+scale+');-webkit-transform-origin: top; opacity:1;'  
    $('.wrap').attr('style', cssText);
}
setTimeout(function(){
    if(document.documentElement.clientWidth/document.documentElement.clientHeight !== 320/504){
        autoScale();
    }else{
        $('.page').css({'opacity': 1});
    }
}, 300)  //添加必定时长以确保宽高获取正确
window.addEventListener('onorientationchange' in window?'orientationchange':'resize', autoScale, false){
        detectOrientatioin();
}   //切换横竖屏

function detectOrientatioin(){
    if(window.orientation==180 || window.orientation==0){
        //竖屏
    }
    if(window.orientation==90 || window.orientation==-90){
        //横屏
    }
}