initial commit

1 files changed, 119 insertions, 0 deletions

diff --git a/files/zh-cn/web/css/top/index.html b/files/zh-cn/web/css/top/index.html
new file mode 100644
index 0000000000..77ae30c7c7
--- /dev/null
+++ b/files/zh-cn/web/css/top/index.html
@@ -0,0 +1,119 @@
+---
+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>