---
title: top
slug: Web/CSS/top
translation_of: Web/CSS/top
---
<div>{{CSSRef}}</div>

<p><strong><code>top</code></strong><a href="/zh-CN/docs/Web/CSS">样式</a>属性定义了定位元素的上外边距边界与其包含块上边界之间的偏移，非定位元素设置此属性无效。</p>

<pre><code>/* &lt;length&gt; values */
top: 3px;
top: 2.4em;

/* 参照于包含块高度的百分比 */
top: 10%;

/* Keyword value */
top: auto;

/* Global values */
top: inherit;
top: initial;
top: unset;</code>
</pre>

<p><code>top</code>的效果取决于元素的<code>position</code>属性：</p>

<ul>
 <li>当<code>position</code>设置为<code>absolute</code>或<code>fixed</code>时，<code>top</code>属性指定了定位元素上外边距边界与其包含块上边界之间的偏移。</li>
 <li>当<code>position</code>设置为<code>relative</code>时，<code>top</code>属性指定了元素的上边界离开其正常位置的偏移。</li>
 <li>当<code>position</code>设置为<code>sticky</code>时，如果元素在viewport里面，<code>top</code>属性的效果和position为<code>relative</code>等同；如果元素在viewport外面，<code>top</code>属性的效果和position为<code>fixed</code>等同。</li>
 <li>当<code>position</code>设置为<code>static</code>时，<code>top</code>属性无效。</li>
</ul>

<p>当<code>top</code>和{{cssxref("bottom")}}同时指定时，并且 {{cssxref("height")}}没有被指定或者指定为<code>auto</code>的时候，<code>top</code>和{{cssxref("bottom")}}​​​​​都会生效，在其他情况下，如果 {{cssxref("height")}}被限制，则{{cssxref("top")}}属性会优先设置，<code>bottom</code>属性则会被忽略。</p>

<p>{{cssinfo}}</p>

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

<h3 id="取值">取值</h3>

<dl>
 <dt>{{cssxref("&lt;length&gt;")}}</dt>
 <dd>可以是负的，正的 或者 null {{cssxref("&lt;length&gt;")}} 表示:
 <ul>
  <li>对于<strong>绝对定位的元素</strong>，元素下外边距边界与其包含块下边界之间的偏移。</li>
  <li>对于<strong>相对定位定位的元素，</strong>元素的下边界离开其正常位置的偏移。</li>
 </ul>
 </dd>
 <dt>{{cssxref("&lt;percentage&gt;")}}</dt>
 <dd>代表元素包含块的高度的百分比 {{cssxref("&lt;percentage&gt;")}}。</dd>
 <dt><code>auto</code></dt>
 <dd>这个关键字表示:
 <ul>
  <li>对于绝对定位元素，元素将忽略此属性已{{ Cssxref("bottom") }}属性为准，如果此时设置<code>height: auto</code>，将基于内容需要的高度设置高度；如果<code>bottom</code>也为<code>auto</code>的话，元素的垂直位置就是它假如作为静态(即static)元素时该在的位置。</li>
  <li>对于相对定位元素，元素相对正常位置的偏移量将基于{{ Cssxref("bottom") }}属性；如果<code>bottom</code>也为<code>auto</code>的话，元素将不会有偏移。</li>
 </ul>
 </dd>
 <dt><code>inherit</code></dt>
 <dd>这个关键字表示该值与其父元素 (可能不是它的包含块) 的计算值相同。对这个计算值的处理将和它原本为 {{cssxref("&lt;length&gt;")}}， {{cssxref("&lt;percentage&gt;")}} 或 <code>auto</code> 一样。</dd>
</dl>

<h2 id="Examples" name="Examples">示例</h2>

<pre class="brush: css"><code>body {
  background: beige;
}

div {
  position: absolute;
  top: 10%;
  right: 40%;
  bottom: 20%;
  left: 15%;
  background: gold;
  border: 1px solid blue;
}</code></pre>

<pre><code>&lt;div&gt;The size of this content is determined by the position of its edges.&lt;/div&gt;</code></pre>

<p>{{EmbedLiveSample('Example','100%','200')}}​​​​​​</p>

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

<table>
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('CSS3 Transitions', '#animatable-css', 'top')}}</td>
   <td>{{Spec2('CSS3 Transitions')}}</td>
   <td>Defines <code>top</code> as animatable.</td>
  </tr>
  <tr>
   <td>{{SpecName('CSS3 Positioning', '#propdef-top', 'top')}}</td>
   <td>{{Spec2('CSS3 Positioning')}}</td>
   <td>Adds behavior for sticky positioning.</td>
  </tr>
  <tr>
   <td>{{SpecName('CSS2.1', 'visuren.html#propdef-top', 'top')}}</td>
   <td>{{Spec2('CSS2.1')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

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

<div class="hidden">
<p>The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
</div>

<p>{{Compat("css.properties.top")}}</p>