Содержание:
.outerWidth( [includeMargin ] )Возвращает: Число
Описание: Получение текущей вычисленной внешней ширины (включая отступы, границы и необязательно отступы) для первого элемента в наборе сопоставленных элементов.
-
версия добавлена: 1.2.6.outerWidth( [includeMargin ] )
- includeMargin (по умолчанию:
false)Тип: БулевоБулево значение, указывающее, следует ли включать отступ элемента в вычисление.
-
Возвращает ширину элемента, включая левые и правые отступы, границы и необязательно отступы, в пикселях. Если вызвана на пустом наборе элементов, возвращает undefined (null до jQuery 3.0).
Этот метод не применим к window и document объектам; для них используйте .width() вместо этого. Хотя .outerWidth() может использоваться с элементами таблицы, он может давать неожиданные результаты для таблиц, использующих свойство border-collapse: collapse CSS.
Дополнительные заметки:
- Число, возвращаемое API, связанными с размерами, включая
.outerWidth(), в некоторых случаях может быть дробным. Код не должен предполагать, что это целое число. Кроме того, размеры могут быть некорректными, когда пользователь увеличивает масштаб страницы; браузеры не предоставляют API для обнаружения этого условия. - Значение, сообщённое
.outerWidth(), не гарантируется как точное, когда элемент или его родитель скрыты. Чтобы получить точное значение, убедитесь, что элемент виден перед использованием.outerWidth(). jQuery попытается временно показать, а затем снова скрыть элемент, чтобы измерить его размеры, но это ненадежно и (даже когда точно) может значительно повлиять на производительность страницы. Эта функция измерения с показом и скрытием может быть удалена в будущих версиях jQuery.
Пример:
Получение outerWidth абзаца.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>outerWidth 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(
"outerWidth:" + p.outerWidth() +
" , outerWidth( true ):" + p.outerWidth( true ) );
</script>
</body>
</html> Демо:
.outerWidth( value [, includeMargin ] )Возвращает: jQuery
Описание: Установка CSS внешней ширины каждого элемента в наборе сопоставленных элементов.
-
версия добавлена: 1.8.outerWidth( value [, includeMargin ] )
- значениеЧисло, представляющее число пикселей, или число с необязательным указанным измерением (в виде строки).
- includeMargin (по умолчанию:
false)Тип: БулевоБулево значение, указывающее, должно ли новое значение учитывать отступ элемента.
-
-
версия добавлена: 1.8.outerWidth( function )
- функцияФункция, возвращающая внешнюю ширину для установки. Принимает в качестве аргументов позицию индекса элемента в наборе и старую внешнюю ширину. Внутри функции
thisотносится к текущему элементу в наборе.
-
При вызове .outerWidth(value), значение может быть строкой (число и единица измерения) или числом. Если для значения предоставлено только число, jQuery предполагает единицу измерения пикселей. Однако, если предоставлена строка, может быть использовано любое допустимое измерение CSS (например, 100px, 50%, или auto).
Пример:
Изменение внешней ширины каждого div при первом щелчке (и изменение его цвета).
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>outerWidth demo</title>
<style>
div {
width: 60px;
padding: 10px;
height: 50px;
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 modWidth = 60;
$( "div" ).one( "click", function() {
$( this ).outerWidth( modWidth ).addClass( "mod" );
modWidth -= 8;
});
</script>
</body>
</html> 
