This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Element.clientTop

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

Толщина верхней границы элемента в пикселях. Не включает в себя margin и padding. Свойство только для чтения.

Всё, что лежит между двумя местами (offsetTop и верх клиентской области) является границей элемента, потому что offsetTop показывает местоположение верха border элемента (не margin), в то время как верх клиентской области начинается сразу под border (клиентская область включает padding). Поэтому значение clientTop всегда будет равно значению .getComputedStyle() для "border-top-width". Например, если значение "border-top-width" равно нулю, то и clientTop тоже равно нулю.

Примечание: Это свойство округляет значение до целого. Если вам нужно дробное значение, используйте element.getBoundingClientRect().

Основанные на Gecko приложения поддерживают clientTop начиная с Gecko 1.9 (Firefox 3, реализовано в Firefox bug 111207). Это свойство не поддерживается в Firefox 2 и более ранних.

Синтаксис

vartop = element.clientTop;

Пример

В следующей иллюстрации клиентская область показана белым (части под названиями "Top", "Right" и т. д. не имеют никакого отношения к клиентской области). Значение clientTop - расстояние между окончанием области margin (жёлтый) или padding и началом области контента (белый)

Примечание

clientTop был впервые введён в MS IE DHTML object model.

Спецификации

Specification
CSSOM View Module
# dom-element-clienttop

Совместимость с браузерами

Смотрите также