Содержание:
.outerHeight( [includeMargin ] )Возвращает: Число
Описание: Получение текущей вычисленной внешней высоты (включая отступы, границы и необязательно отступы) для первого элемента в наборе сопоставленных элементов.
-
версия добавлена: 1.2.6.outerHeight( [includeMargin ] )
- includeMargin (по умолчанию:
false)Тип: БулевоБулево значение, указывающее, следует ли включать отступ элемента в вычисление.
-
Возвращает высоту элемента, включая верхний и нижний отступы, границы и необязательно отступы, в пикселях. Если вызов осуществляется для пустого набора элементов, возвращает undefined (null до jQuery 3.0).
Этот метод не применим к window и document объектам; для них используйте .height() вместо этого. Хотя .outerHeight() можно использовать для элементов таблицы, он может давать непредсказуемые результаты для таблиц, использующих свойство CSS border-collapse: collapse.
Дополнительные замечания:
- Число, возвращаемое API, связанными с размерами, включая
.outerHeight(), может быть дробным в некоторых случаях. Код не должен предполагать, что это целое число. Кроме того, размеры могут быть неверными, когда страница масштабируется пользователем; браузеры не предоставляют API для обнаружения этого состояния. - Значение, сообщаемое
.outerHeight(), не гарантируется точным, когда элемент или его родитель скрыт. Для получения точного значения убедитесь, что элемент виден перед использованием.outerHeight(). jQuery попытается временно отобразить и затем снова скрыть элемент для измерения его размеров, но это ненадежно и (даже когда точно) может значительно повлиять на производительность страницы. Эта функция измерения отображения и повторного скрытия может быть удалена в будущих версиях jQuery.
Пример:
Получить outerHeight абзаца.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>outerHeight demo</title>
<style>
p {
margin: 10px;
padding: 5px;
border: 2px solid #666;
}
</style>
<script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
<p>Hello</p><p></p>
<script>
var p = $( "p" ).first();
$( "p" ).last().text(
"outerHeight:" + p.outerHeight() +
" , outerHeight( true ):" + p.outerHeight( true ) );
</script>
</body>
</html> Демо:
.outerHeight( значение [, includeMargin ] )Возвращает: jQuery
Описание: Установка CSS внешней высоты каждого элемента в наборе сопоставленных элементов.
-
версия добавлена: 1.8.outerHeight( значение [, includeMargin ] )
- значениеЧисло, представляющее количество пикселей, или число вместе с необязательным обозначением единицы измерения (как строка).
- includeMargin (по умолчанию:
false)Тип: БулевоБулево значение, указывающее, учитывает ли новое значение отступ элемента.
-
-
версия добавлена: 1.8.outerHeight( функция )
- функцияФункция, возвращающая внешнюю высоту для установки. Принимает индекс элемента в наборе и старую внешнюю высоту в качестве аргументов. Внутри функции,
thisотносится к текущему элементу в наборе.
-
При вызове .outerHeight(value), значение может быть строкой (число и единица) или числом. Если для значения предоставлено только число, jQuery предполагает единицу измерения пикселей. Однако, если предоставлена строка, может быть использовано любое допустимое измерение CSS (например, 100px, 50%, или auto).
Пример:
Изменить внешнюю высоту каждого div при первом клике (и изменить его цвет).
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>outerHeight demo</title>
<style>
div {
width: 50px;
padding: 10px;
height: 60px;
float: left;
margin: 5px;
background: red;
cursor: pointer;
}
.mod {
background: blue;
cursor: default;
}
</style>
<script src="https://code.jquery.com/jquery-3.7.0.js"></script>
</head>
<body>
<div>d</div>
<div>d</div>
<div>d</div>
<div>d</div>
<div>d</div>
<script>
var modHeight = 60;
$( "div" ).one( "click", function() {
$( this ).outerHeight( modHeight ).addClass( "mod" );
modHeight -= 8;
});
</script>
</body>
</html> 
