剖析 iOS 11 网页适配问题

北京时间 9 月 12 日凌晨，苹果在乔布斯剧院发布了 iPhone X。iPhone X 正面的全面屏上方有一条刘海，对于如何适配 iPhone X，苹果的 Human Interface Guidelines 文档已经给出详细的说明。

苹果对于 iPhone X 的设计布局意见如下：

核心内容应该处于 Safe area 确保不会被设备圆角(corners)，传感器外壳(sensor housing，齐刘海) 以及底部的 Home Indicator 遮挡。

本文将剖析两则在 iPhone X 异形屏和 iOS 11 网页适配中遇到的问题及解决方案。

iPhone X Safari 横屏显示左右白边问题

iPhone X Safari 在横屏状态下，网页左右两侧可能会出现白边，如下：

因为 iPhone X 会将网页内容显示在 Safe area 导致的，解决这一问题，我们需要将背景颜色填充整个屏幕区域，而网页内容处于 Safe area。

解决方案一：background-color

如果网页设置了一个背景颜色，那么最简单解决方案是，在 body 节点设置 background-color，使背景颜色填充整个屏幕，从而解决横屏显示左右白边的问题

解决方案二：viewport-fit + safe-area-inset-*

在 iOS 11 中苹果为 Web 新增两个内容 viewport-fit + safe-area-inset-*

注意：viewport-fit 和 safe-area-inset-* 只对于 WKWebView 有效，在 UIWebView 中无效

viewport-fit 用于设置网页在可视窗口的布局方式

文档：CSS Round Display Spec

这个属性可设置为：

• contain: The viewport should fully contain the web content. 可视窗口完全包含网页内容
• cover: The web content should fully cover the viewport. 网页内容完全覆盖可视窗口
• auto: The default value, contain

对于 iPhone X 之前的 iPhone 设备屏幕为规则的矩形，网页内容都可以完整展示；但是对于 iPhone X 是异形屏幕，通过 viewport-fit 可以设置网页内容在可视窗口中的显示规则，通过下图可以辅助理解

我们知道默认情况下 viewport-fit=auto 即为 viewport-fit=contain，在 iPhone X 中，相当于网页内容展示在 Safe area，这样也就是横屏显示时出现白边的原因了，所以我们可以设置 viewport-fit=cover 即可解决问题

<meta name=“viewport” content=“width=device-width, initial-scale=1.0, viewport-fit=cover”>

注意到应用 viewport-fit=cover 之后，网页右上角，menu 按键和 in 按键被圆角，传感器外壳（齐刘海）裁剪掉了

safe-area-inset-*

在设置 viewport-fit=cover 之后，Web 中会新增四个常量：

• safe-area-inset-top
• safe-area-inset-right
• safe-area-inset-left
• safe-area-inset-bottom

分别表示 Safe area 和可视窗口 viewport 顶部，右边，左边，底部的间距，可以用于设置 margin, padding, 或者绝对定位时 left, top

注意：在横屏和竖屏状态下，safe-area-inset-* 的值不同

为了解决应用 viewport-fit=cover 之后，有些显示内容被裁剪的问题，我们可以通过添加边距使得网页主要内容处于 Safe area 中不被裁剪，解决方式如下：

padding: constant(safe–area–inset–top) constant(safe–area–inset–right) constant(safe–area–inset–bottom) constant(safe–area–inset–left);

iOS 11 WebView 中状态栏问题

问题描述：

在 iOS 11 由于 safe area，状态栏的表现有点不同。如果页面顶部有一个 header bar，设置 position: fixed; top: 0px; 那么页面滚动过程中，会出现如下问题：

header bar 没有固定在最顶部，上下滚动过程中，我们可以看到网页内容从 status bar 下方穿过

重现问题：

创建一个 iOS 项目，视图中添加一个 WKWebView，加载百度首页

– (void)viewDidLoad {
[super viewDidLoad];
// Do any additional setup after loading the view, typically from a nib.
WKWebView *webView = [[WKWebView alloc] initWithFrame:self.view.bounds];
[webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@“https://www.baidu.com”]]];
[self.view addSubview:webView];
}

剖析问题：

1、这个问题同样也是由于 safe area 导致，虽然 header bar 位置信息为 position: fixed; top: 0px;，但这个位置也是相对于 safe area 而言的，所以看到 header bar 并没有位于屏幕最顶部。? 在 viewport meta 标签，添加 viewport-fit=cover 即可解决此问题

虽然 header bar 固定到屏幕最上方，但是很明显在 iPhone X 中却被圆角和齐刘海裁剪了内容，这怎么办呢？? 为 header bar 添加 padding-top 即可解决此问题

header {
/* … */
/* Status bar height on iOS 10 */
padding–top: 20px;
/* Status bar height on iOS 11+ */
padding–top: constant(safe–area–inset–top);
}

参考链接

• Human Interface Guidelines-iPhone X
• Removing the White Bars in Safari on iPhone X
• Understanding the WebView Viewport in iOS 11

关于本文

作者：@邓映山

原文：https://objcer.com/2017/09/21/Understanding-the-WebView-Viewport-in-iOS-11-iPhone-X/