initial commit

1 files changed, 160 insertions, 0 deletions

diff --git a/files/zh-cn/web/css/viewport_concepts/index.html b/files/zh-cn/web/css/viewport_concepts/index.html
new file mode 100644
index 0000000000..bdc7b27831
--- /dev/null
+++ b/files/zh-cn/web/css/viewport_concepts/index.html
@@ -0,0 +1,160 @@
+---
+title: 视口概念
+slug: Web/CSS/Viewport_concepts
+translation_of: Web/CSS/Viewport_concepts
+---
+<p>{{CSSRef}}</p>
+
+<p class="summary">这篇文章阐述了<strong>视口(viewport)</strong>的概念，对 visual viewport 和 布局视口(layout viewport) 进行区分，并让你了解 viewport 的意义是什么，以及它对 CSS, SVG 和移动设备方面的影响。</p>
+
+<h2 id="什么是_viewport">什么是 viewport ?</h2>
+
+<p>视口(viewport)代表当前可见的计算机图形区域。在 Web 浏览器术语中，通常与浏览器窗口相同，但不包括浏览器的 UI， 菜单栏等——即指你正在浏览的文档的那一部分。</p>
+
+<p>文档，比如这篇文章，可能会非常长。你的 viewport 就是你现在所能见到的所有事物。值得注意的是“什么是视口区域”这个问题，页面中的一些导航菜单也包括在其中。Viewport 的大小取决于屏幕的大小，无论浏览器是否处于全屏模式，是否被用户缩放了。Viewport 外的区域，比如这个文档的<em> See Also</em> 部分，可能需要滚动到其所在的区域才会出现在屏幕上。</p>
+
+<ul>
+ <li>在尺寸较大的设备中，在这些设备上，应用显示区域不一定是全屏的，viewport 是浏览器窗口的大小。</li>
+ <li>在大多数移动设备中，浏览器是全屏的，viewport 是整个屏幕的大小。</li>
+ <li>在全屏模式下，viewport 是设备屏幕的范围，窗口是浏览器窗口，浏览器窗口大小小于或等于视口的大小，并且文档是这个网站，文档的大小可比 viewport 长或宽。</li>
+</ul>
+
+<p>概括地说，viewport 基本上是当前文档的可见部分。</p>
+
+<h3 id="Viewport_大小是可变的">Viewport 大小是可变的</h3>
+
+<p>Viewport 的宽度并不总是窗口的宽度。如果你测试 Chrome 或 Firefox 浏览器中 window 和 document 的宽度和高度，你会得到如下值：</p>
+
+<pre class="brush: js">document.documentElement.clientWidth /* 1200 */
+window.innerWidth /* 1200 */
+window.outerWidth /* 1200 */
+</pre>
+
+<pre class="brush: js">document.documentElement.clientHeight /* 800 */
+window.innerHeight /* 800 */
+window.outerHeight /* 900 */
+</pre>
+
+<p>下面是一些帮助你查询查询 viewport 大小和其它类似的长度属性的 DOM 属性:</p>
+
+<ul>
+ <li>文档的 {{DOMxRef("Element.clientWidth")}} 是指一个文档使用 <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Mobile/Viewport_meta_tag#A_pixel_is_not_a_pixel">CSS pixels</a> 单位表示的内部宽度, 包括其 padding (不包括 borders, margins 或垂直滚动条，如果有的话）. <strong>这就是 viewport 的宽度</strong>。</li>
+ <li>{{DOMxRef("Window.innerWidth")}} 是用 CSS pixels 单位表示的浏览器窗口 viewport 宽度，包括垂直滚动条，如果渲染了的话。</li>
+ <li>{{DOMxRef("Window.outerWidth")}} 是指包括了浏览器外边框的窗口宽度。</li>
+</ul>
+
+<p>在实测中，<code>innerWidth</code> 和 <code>outerWidth</code> 是相同的，但是 <code>outerHeight</code> 比 <code>innerHeight</code> 高100px。这是因为 <code>outerHeight</code> 的测量包括浏览器框架在内，包括了地址栏和书签栏总共 100px 的高度，而浏览器没有左右边框。</p>
+
+<p><code>innerHeight</code> 和 <code>innerWidth</code> 所组成的区域通常被认为是<strong>布局视口(layout viewport)</strong> 。浏览器的框架不被认为是 viewport 的一部分.</p>
+
+<p>当缩放时， Firefox 和 Chrome 对 <code>innerWidth</code> 和 <code>clientWidth</code> 给出了新的 CSS 像素大小。浏览器对 <code>outerWidth</code> 和 <code>outerHeight</code> 的返回值有差异。Firefox 返回了缩放后的 CSS 像素值，Chrome 返回了默认的像素值：</p>
+
+<pre class="brush: js">document.documentElement.clientWidth /* 800 */
+window.innerWidth /* 800 */
+window.outerWidth /* 800 in Firefox, 1200 in chrome */
+</pre>
+
+<pre class="brush: js">document.documentElement.clientHeight /* 533 */
+window.innerHeight /* 533 */
+window.outerHeight /* 596 in Firefox, 900 in chrome */
+</pre>
+
+<p>原始的 viewport 大小是 1200 * 800 像素。缩放后变成了 800 * 533。这是 layout viewport。该网页有固定的头部和尾部，带有下列样式，它们将会固定在相对 layout viewport 的顶部和底部。</p>
+
+<pre class="brush: css">body &gt; header {
+  position: fixed;
+  top: 0;
+}
+body &gt; footer {
+  position: fixed;
+  bottom: 0;
+}
+</pre>
+
+<p>缩放后，我们得到了 800 * 533 的测量值。头部和尾部仍然固定在窗口的顶部和底部。但是当使用触屏双指缩放或者当动态键盘在手机上弹出的时候呢？</p>
+
+<p>Web 浏览器包含两个 viewport，<strong>布局视口(layout viewport)</strong>和<strong>视觉视口(visual viewport)</strong>。visual viewport 指当前浏览器中可见的部分，并且可以变化。当使用触屏双指缩放，当动态键盘在手机上弹出的时候，或者之前隐藏的地址栏变得可见的时候，visual viewport 缩小了，但是 layout viewport 却保持不变。</p>
+
+<p>我们上面说到的固定的头部和尾部，固定在 layout viewport 的底部和顶部，所以当 visual viewport 缩小的时候,保留在视觉中。当你缩放页面时，布局视口可能不能被全部看到。如果你放大布局视口的中间部分，内容讲在四个方向上扩展。如果你有一个固定的头部和底部，它们依然固定在布局视口的顶部和底部，因此它们可能会在设备屏幕的底部和顶部不可见-视觉视口。视觉视口是布局视口当前的可见部分如果你向下滚动，视觉视口的内容就会改变，并布局视口的底部就会滚动到可视区域。</p>
+
+<p>T视觉视口是屏幕的可视部分，不包括屏幕键盘，缩放外的区域。视觉视口比布局视口相同或者更小</p>
+
+<p>对于一个包含框架，objects或外部svg的页面，两者都有它们自己的window对象，只有最外层的window的视觉视口不同于布局视口。对于包含的文档，视觉视口与布局视口是相同的。</p>
+
+<h3 id="CSS">CSS</h3>
+
+<p>在上面描述的布局视口(layout viewport)和视觉视口(visual viewport)不是您将遇到的唯一视口。 在布局视口中完全或部分显示的任何子视口都被视为可视视口。</p>
+
+<p>我们通常认为宽度和高度的媒体查询是相对于浏览器窗口的宽度和高度而言的。 它们实际上是相对于视口的，即主文档（document）中的窗口（window对象），但它也是嵌套浏览上下文（如对象，iframe和SVG）中元素父级的本身的大小。 在CSS中，我们也有基于视口大小的长度单位。 1vh单位是1%布局视口的高度，vw单位与此类似。</p>
+
+<h4 id="&lt;iframe>"><code>&lt;iframe&gt;</code></h4>
+
+<p>对于一个 <code>iframe</code> 来说，视觉视口是其内部高度和宽度的大小而不是其父文档的大小。你可以为其高度和宽度设置任意数值，但过大的值可能会使 <code>iframe</code> 部分内容超出视口导致超出部分不可见。</p>
+
+<p>在 CSS 中，可以使用相对于视口的长度单位 <code>vh</code> 和 <code>vw</code>。 <code>1vh</code> 意味着值为视口高度的1%，同理 <code>1vw</code> 即值为视口宽度的1%。</p>
+
+<p>需要注意的是，当你在 CSS 中使用 <code>vw</code> 和 <code>vh</code> 设置 <code>iframe</code> 的样式时，<code>1vh</code> 表示的是 <code>iframe</code> 高度的1%，但 <code>1vw</code> 表示的则是 document 宽度的 1%。</p>
+
+<pre class="brush: css">iframe {
+    width: 50vw;
+}
+</pre>
+
+<p>在上面的例子中，一个 iframe 宽度被设置为 50vw，假设父文档宽度为 1200px，按照上面的规则，它的的实际宽度将会是父文档宽度的 50%，即 600px。在这个例子中，每 1 vw 将折算 6px。如果因为缩放，父文档宽度变为 800px，则 1vw 将代表4px，iframe 的宽度将会是 400px。</p>
+
+<p>此外，一个在 iframe 文档内基于宽度的媒体查询将会使用 iframe 的视口宽度进行参照。</p>
+
+<pre class="brush: css">@media screen and (min-width: 500px) {
+    p {
+        color: red;
+    }
+}</pre>
+
+<p>如果上述 CSS 代码块包含于一个 iframe 所指向的一个文档头部，那么当用户放大该文档时，p 标签颜色将变红；当用户不使用缩放时，该样式则不会被应用。</p>
+
+<h4 id="SVG">SVG</h4>
+
+<p>在 SVG 文档中，视口即 SVG 图片的可视区域。同样，你也可以为 SVG 设置任何高度和宽度，但不恰当的大小可能无法显示整个 SVG 图片。在 SVG 中的可见部分被称为这个 SVG 的视口。你可以使用  {{SVGElement("svg")}} 上的 width 和 height 属性来修改 SVG 的视口大小。</p>
+
+<pre class="brush: html">&lt;svg height="300" width="400"&gt;&lt;/svg&gt;</pre>
+
+<p>在这个示例中，这个 SVG 的视口长宽比被设置为了 3:4，默认情况下长为 400 像素，高为 300 像素。</p>
+
+<p>SVG 参照 <a href="/en-US/docs/Web/SVG/Attribute/viewBox">viewbox</a> 属性，内置了一个与视口无关的坐标系。</p>
+
+<p>如果你在你的 HTML 文档中使用了 SVG，这个 SVG 的视口默认为包含它的块级容器或者 SVG 容器上所设置的宽度和高度大小。当你使用 {{CSSxRef("@media")}} 来对 SVG 进行媒体查询时，其参照的高度和宽度取决于包裹着 SVG 的容器，而不是整个浏览器视口。</p>
+
+<pre class="brush: css">@media screen and (min-width: 400px) and (max-width: 500px) {
+  /* css goes here */
+}</pre>
+
+<p>如果你在其他元素上使用上面这个示例的媒体查询，当视口（通常为浏览器的视口）满足条件：宽度为 400px 至 500px 的范围内时，媒体查询内的 CSS 样式将会自动应用。但对于 SVG 来说，其媒体查询基于包裹着它的元素。</p>
+
+<p>如使用 {{htmlelement("img")}} ，通过设置 src 指向 SVG 文件时，SVG 的外部容器，或者说包裹着 SVG 的元素就是这个 img。如果在这个外部容器上应用了 width 属性，则对应的视口就是这个属性的值，而不是整个文档的视口宽度。</p>
+
+<p>如果把上面的 CSS 媒体查询样式添加到 SVG 文件中去，当 SVG 容器的宽度在 400 - 500 px时，将应用该 CSS 样式。</p>
+
+<h3 id="JavaScript">JavaScript</h3>
+
+<p><a href="/en-US/docs/Web/API/Visual_Viewport_API">视觉视口 API [草案]</a>  提供了查询和修改视觉视口的接口。</p>
+
+<h2 id="移动设备的视口">移动设备的视口</h2>
+
+<p>对于各种不同形状，不同设备像素比移动设备，其浏览器的视口（窗口中显示网页信息的区域）不一定与渲染页面大小相同。移动设备的视口的默认值为 980px，一般情况下都要比这些设备的屏幕尺寸要大。</p>
+
+<p>为了让页面能够全部展示，这些浏览器在渲染时会对页面进行缩放。比如在一个宽 320px 的移动设备显示一个视觉视口宽为 980px 的页面，移动设备浏览器会对这个页面进行缩放直至其视觉视口宽度为 320px（具体取决于浏览器实现）。但直接缩放页面会导致页面字体变小，使得缩放后的页面显示效果都不会很理想。</p>
+
+<p>如果开发者想让移动端浏览器使用屏幕宽度作为视口替换默认的 980px 宽度视口，则可以在 HTML 的头部添加以下标签：</p>
+
+<pre class="brush: html"><code class="language-html"><span class="tag token"><span class="tag token"><span class="punctuation token">&lt;</span>meta</span> <span class="attr-name token">name</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>viewport<span class="punctuation token">"</span></span> <span class="attr-name token">content</span><span class="attr-value token"><span class="punctuation token">=</span><span class="punctuation token">"</span>width<span class="punctuation token">=</span>device-width<span class="punctuation token">"</span></span><span class="punctuation token">&gt;</span></span></code></pre>
+
+<p>这里 <code>width</code> 属性指的是视口宽度，现在视口的宽度被设置为了设备的屏幕宽度，即文档视口宽度大小与设备宽度大小 100% 对应（转换为 CSS 像素值相同）。除了 width 属性外，还有<code>initial-scale<font face="Arial, x-locale-body, sans-serif"><span style="background-color: #ffffff;">、</span></font></code><code>maximum-scale<font face="Arial, x-locale-body, sans-serif"><span style="background-color: #ffffff;">、</span></font>minimum-scale</code>，以及 <code>user-scalable</code> 属性可供设置。这些属性分别设置了文档的初始缩放比例、最大缩放比例、最小缩放比例以及是否允许用户进行缩放操作。但这些属性的默认值已经很好了，开发时可以忽略掉这些属性。</p>
+
+<h2 id="参照">参照</h2>
+
+<ul>
+ <li><a href="/en-US/docs/Web/CSS/@viewport">@viewport CSS at-rule</a></li>
+ <li><a href="/en-US/docs/Web/API/Visual_Viewport_API">Visual Viewport API</a></li>
+ <li>{{HTMLElement("meta")}}, specifically <code>&lt;meta name="viewport"&gt;</code></li>
+ <li><a href="/en-US/docs/Mobile/Viewport_meta_tag">Using the viewport meta tag to control layout on mobile browsers</a></li>
+</ul>