---
title: viewport-fit
slug: Web/CSS/@viewport/viewport-fit
translation_of: Web/CSS/@viewport
---
<div>{{CSSRef}} {{Draft}} {{SeeCompatTable}}</div>

<p><strong><code>viewport-fit</code></strong> CSS {{CSSxRef("@viewport")}}  {{Glossary("Descriptor (CSS)", "descriptor")}} 是为了控制文档是如何填充满屏幕的。</p>

<h2 id="语法">语法</h2>

<pre class="brush: css; no-line-numbers">/* 关键值*/
viewport-fit: auto;
viewport-fit: contain;
viewport-fit: cover;
</pre>

<h3 id="属性值">属性值</h3>

<dl>
 <dt><code>auto</code></dt>
 <dd>此值不影响初始布局视图端口，并且整个web页面都是可查看的。</dd>
 <dt><code>contain</code></dt>
 <dd>视图端口按比例缩放，以适合显示内嵌的最大矩形。</dd>
 <dt><code>cover</code></dt>
 <dd>视图端口被缩放以填充设备显示。强烈建议使用 <a href="/en-US/docs/Web/CSS/env">safe area inset 变量</a>，以确保重要内容不会出现在显示之外。</dd>
</dl>

<h3 id="形式语法">形式语法</h3>

<pre><span style="color: #0000ff;">&lt;</span><span style="color: #800000;">meta </span><span style="color: #ff0000;">name</span><span style="color: #0000ff;">="viewport"</span><span style="color: #ff0000;"> content</span><span style="color: #0000ff;">="width=device-width, initial-scale=1.0, <strong>viewport-fit=cover</strong>"</span><span style="color: #0000ff;">&gt;</span></pre>

<h2 id="注意">注意</h2>

<p>在使用 <code>viewport-fit</code> 描述符时，必须记住并不是所有的设备显示都是矩形的，因此应该使用<a href="/en-US/docs/Web/CSS/env">safe area inset 变量</a>。</p>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName("CSS Round Display", "#viewport-fit-descriptor", '"viewport-fit" descriptor')}}</td>
   <td>{{Spec2("CSS Round Display")}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<div class="hidden">兼容性表是由结构化数据生成的。如果您要为数据做出贡献，请点击连接 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 向我们发送请求。</div>

<p>{{Compat("css.at-rules.viewport.viewport-fit")}}</p>

<h2 id="另请参见">另请参见</h2>

<ul>
 <li>{{CSSxRef("env", "env()")}}</li>
</ul>