aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/css/top/index.html
blob: 77ae30c7c73b577390bcd7d59b6ed10ce350fc3e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
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>