Element: clientTop-Eigenschaft
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.
Die Breite des oberen Rands eines Elements in Pixel. Es handelt sich um eine schreibgeschützte, ganzzahlige Eigenschaft des Elements.
Tatsächlich liegt zwischen den beiden Positionen (offsetTop
und dem oberen Bereich des client-Bereichs) nur der Rand des Elements. Das liegt daran, dass offsetTop
die Position des oberen Randes angibt (nicht des äußeren Randes), während der client-Bereich direkt unter dem Rand beginnt (der client-Bereich schließt den inneren Abstand ein). Daher wird der Wert von clientTop immer dem ganzzahligen Teil des .getComputedStyle()
-Wertes für "border-top-width" entsprechen. (Tatsächlich könnte es sich um Math.round(parseFloat()) handeln.) Beispielsweise, wenn der berechnete "border-top-width" null ist, dann ist clientTop
ebenfalls null.
Hinweis:
Diese Eigenschaft rundet den Wert auf eine ganze Zahl. Falls Sie einen Bruchwert benötigen, verwenden Sie element.getBoundingClientRect()
.
Wert
Eine Zahl.
Beispiele
Im folgenden Beispiel hat der client-Bereich einen weißen Hintergrund und eine 24px breite schwarze border-top
. Der clientTop
-Wert ist der Abstand von dort, wo der Randbereich (gelb) endet, zu dem Bereich aus innerem Abstand und Inhalt (weiß) beginnt: also 24px.
HTML
<div id="container">
<div id="contained">
<p>
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
commodo consequat.
</p>
</div>
</div>
CSS
#container {
margin: 3rem;
background-color: rgb(255 255 204);
border: 4px dashed black;
}
#contained {
margin: 1rem;
border-top: 24px black solid;
padding: 0px 28px;
overflow: auto;
background-color: white;
}
Ergebnis
Anmerkungen
clientTop
wurde erstmals im MS IE DHTML-Objektmodell eingeführt.
Spezifikationen
Specification |
---|
CSSOM View Module # dom-element-clienttop |
Browser-Kompatibilität
BCD tables only load in the browser