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
-Eigenschaft (CSS) legt die vertikale Position eines positionierten Elements fest. Diese Inset-Eigenschaft hat keine Auswirkung 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 den Abstand zwischen dem äußeren Rand der oberen Kante des Elements und dem inneren Rand der oberen Kante seines umschließenden Blocks an oder, im Fall von ankergepositionierten Elementen, wenn dieanchor()
-Funktion innerhalb des Wertes verwendet wird, 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 den Abstand an, um den die obere Kante des Elements unterhalb ihrer normalen Position verschoben wird. - Wenn
position
aufsticky
gesetzt ist, wird dietop
-Eigenschaft verwendet, um das Sticky-Constraint-Rechteck zu berechnen. - Wenn
position
aufstatic
gesetzt ist, hat dietop
-Eigenschaft keine Wirkung.
Wenn sowohl top
- als auch bottom
-Werte angegeben sind, gibt es drei verschiedene Fälle:
- Wenn
position
aufabsolute
oderfixed
gesetzt ist undheight
nicht spezifiziert 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 sowohltop
- als auchbottom
-Werte berücksichtigt. Das bedeutet, dass ein klebendes Element möglicherweise innerhalb seines umschließenden Blocks basierend auf den Werten dieser beiden Eigenschaften auf und ab bewegt werden kann, solange die Positionsbox des Elements innerhalb seines umschließenden Blocks bleibt.
Syntax
/* <length> values */
top: 3px;
top: 2.4em;
top: anchor(bottom);
top: anchor-size(--my-anchor 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 repräsentiert er den Abstand zur oberen Kante des umschließenden Blocks.
- für ankerpositionierte Elemente löst sich die
anchor()
-Funktion zu einem<length>
-Wert relativ zur Position der oberen oder unteren Kante des zugehörigen Ankerelements auf (siehe Using inset properties withanchor()
function values), und dieanchor-size()
-Funktion löst sich zu einem<length>
-Wert relativ zur Breite oder Höhe des zugehörigen Ankerelements auf (siehe Setting element position based on anchor size). - für relativ positionierte Elemente repräsentiert er den Abstand, um den das Element unterhalb seiner normalen Position verschoben wird.
<percentage>
-
Ein
<percentage>
der Höhe des umschließenden Blocks. auto
-
Gibt an, dass:
- für absolut positionierte Elemente die Position des Elements basierend auf der
bottom
-Eigenschaft festgelegt wird, währendheight: auto
als höhenabhängig vom Inhalt behandelt wird; oder wennbottom
ebenfallsauto
ist, wird das Element dort positioniert, wo es vertikal positioniert werden sollte, wenn es sich um ein statisches Element handeln würde. - für relativ positionierte Elemente der Abstand des Elements von seiner normalen Position basierend auf der
bottom
-Eigenschaft festgelegt wird; oder wennbottom
ebenfallsauto
ist, wird das Element überhaupt nicht vertikal verschoben.
- für absolut positionierte Elemente die Position des Elements basierend auf der
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
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
Siehe auch
bottom
,left
, undright
inset
-Kurzschreibweiseinset-block-start
,inset-block-end
,inset-inline-start
, undinset-inline-end
inset-block
undinset-inline
-Kurzschreibweisenposition
- CSS positioniertes Layout-Modul