top
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
* Some parts of this feature may have varying levels of support.
Die top
CSS Eigenschaft legt die vertikale Position eines positionierten Elements fest. Diese inset-Eigenschaft hat keine Wirkung auf nicht-positionierte Elemente.
Probieren Sie es aus
top: 0;
top: 4em;
top: 10%;
top: 20px;
<section id="default-example">
<div class="example-container">
<div id="example-element">I am absolutely positioned.</div>
<p>
As much mud in the streets as if the waters had but newly retired from the
face of the earth, and it would not be wonderful to meet a Megalosaurus,
forty feet long or so, waddling like an elephantine lizard up Holborn
Hill.
</p>
</div>
</section>
.example-container {
border: 0.75em solid;
padding: 0.75em;
text-align: left;
position: relative;
width: 100%;
min-height: 200px;
}
#example-element {
background-color: #264653;
border: 4px solid #ffb500;
color: white;
position: absolute;
width: 140px;
height: 60px;
}
Die Wirkung von top
hängt davon ab, wie das Element positioniert ist (d. h. der Wert der position
Eigenschaft):
- Wenn
position
aufabsolute
oderfixed
gesetzt ist, gibt dietop
Eigenschaft die Entfernung zwischen dem äußeren Rand der oberen Kante des Elements und dem inneren Rand der oberen Kante seines enthaltenden Blocks an oder – im Fall von ankerpositionierten Elementen bei Verwendung der Funktionanchor()
im Wert – relativ zur angegebenen<anchor-side>
Kante. Dietop
Eigenschaft ist kompatibel mit den Wertentop
,bottom
,start
,end
,self-start
,self-end
,center
und<percentage>
. - Wenn
position
aufrelative
gesetzt ist, gibt dietop
Eigenschaft die Entfernung an, um die die obere Kante des Elements von ihrer normalen Position verschoben wird. - Wenn
position
aufsticky
gesetzt ist, wird dietop
Eigenschaft zur Berechnung des sticky-constraints Rechtecks verwendet. - Wenn
position
aufstatic
gesetzt ist, hat dietop
Eigenschaft keine Wirkung.
Wenn sowohl top
als auch die Werte von bottom
angegeben sind, gibt es drei verschiedene Fälle:
- Wenn
position
aufabsolute
oderfixed
gesetzt ist undheight
nicht angegeben ist (entwederauto
oder100%
), werden sowohl dietop
als auch diebottom
Werte berücksichtigt. - Wenn
position
aufrelative
gesetzt ist oder dieheight
eingeschränkt ist, hat dietop
Eigenschaft Vorrang und diebottom
Eigenschaft wird ignoriert. - Wenn
position
aufsticky
gesetzt ist, werden sowohl dietop
als auch diebottom
Werte berücksichtigt. Dies bedeutet, dass sich ein sticky Element potentiell basierend auf den Werten dieser beiden Eigenschaften innerhalb seines enthaltenden Blocks auf und ab bewegen kann, solange die Positionsbox des Elements innerhalb seines enthaltenden Blocks bleibt.
Syntax
/* <length> values */
top: 3px;
top: 2.4em;
top: anchor(bottom);
top: anchor-size(--myAnchor self-block, 10%);
/* <percentage>s of the height of the containing block */
top: 10%;
/* Keyword value */
top: auto;
/* Global values */
top: inherit;
top: initial;
top: revert;
top: revert-layer;
top: unset;
Werte
<length>
-
Ein negativer, null oder positiver
<length>
:- für absolut positionierte Elemente bedeutet dies die Distanz zur oberen Kante des enthaltenden Blocks.
- für ankerpositionierte Elemente löst die Funktion
anchor()
sich zu einem<length>
Wert relativ zur Position der oberen oder unteren Kante des verbundenen Ankerelements auf (siehe Verwendung von inset-Eigenschaften mitanchor()
Funktionswerten), und die Funktionanchor-size()
löst sich zu einem<length>
Wert relativ zur Breite oder Höhe des verbundenen Ankerelements auf (siehe Festlegung der Elementposition basierend auf der Ankergröße). - für relativ positionierte Elemente bedeutet es die Distanz, um die das Element von seiner normalen Position verschoben wird.
<percentage>
-
Ein
<percentage>
der Höhe des enthaltenden Blocks. auto
-
Bestimmt, dass:
- für absolut positionierte Elemente die Position des Elements basierend auf der
bottom
Eigenschaft erfolgt, währendheight: auto
als auf dem Inhalt basierende Höhe behandelt wird; oder wennbottom
ebenfallsauto
ist, wird das Element dort positioniert, wo es vertikal positioniert wäre, wenn es ein statisches Element wäre. - für relativ positionierte Elemente die Entfernung des Elements von seiner normalen Position basierend auf der
bottom
Eigenschaft erfolgt; oder wennbottom
ebenfallsauto
ist, wird das Element überhaupt nicht vertikal verschoben.
- für absolut positionierte Elemente die Position des Elements basierend auf der
inherit
-
Bestimmt, dass der Wert derselbe ist wie der berechnete Wert von seinem Elternelement (das möglicherweise nicht sein enthaltender Block ist). Dieser berechnete Wert wird dann behandelt, als wäre er ein
<length>
,<percentage>
, oder dasauto
Schlüsselwort.
Formale Definition
Anfangswert | auto |
---|---|
Anwendbar auf | positionierte Elemente |
Vererbt | Nein |
Prozentwerte | bezieht sich auf die Höhe des äußeren Elements |
Berechneter Wert | falls als Länge angegeben, die zugehörige absolute Länge; falls als Prozentwert angegeben, der angegebene Wert; ansonsten auto |
Animationstyp | Längenangabe, Prozentsatz oder calc() ; |
Formale Syntax
top =
auto |
<length-percentage> |
<anchor()> |
<anchor-size()>
<length-percentage> =
<length> |
<percentage>
<anchor()> =
anchor( <anchor-name>? &&
<anchor-side> , <length-percentage>? )
<anchor-size()> =
anchor-size( [ <anchor-name> || <anchor-size> ]? , <length-percentage>? )
<anchor-name> =
<dashed-ident>
<anchor-side> =
inside |
outside |
top |
left |
right |
bottom |
start |
end |
self-start |
self-end |
<percentage> |
center
<anchor-size> =
width |
height |
block |
inline |
self-block |
self-inline
Beispiele
Ein positioniertes Element, 10% von oben gesetzt
body {
background: beige;
}
div {
position: absolute;
top: 10%;
right: 40%;
bottom: 20%;
left: 15%;
background: gold;
border: 1px solid blue;
}
<div>The size of this content is determined by the position of its edges.</div>
Spezifikationen
Specification |
---|
CSS Positioned Layout Module Level 3 # insets |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
bottom
,left
, undright
inset
Kurzforminset-block-start
,inset-block-end
,inset-inline-start
, undinset-inline-end
inset-block
undinset-inline
Kurzformenposition
- CSS positioniertes Layout Modul