CSS-свойство `max-width`

max-width — свойство CSS, задающее максимальную ширину элемента. Оно не позволяет используемому значению свойства width превышать значение, заданное с помощью max-width.

max-width переопределяет width, но min-width переопределяет max-width.

Попробуйте

max-width: 150px;

max-width: 20em;

max-width: 75%;

max-width: 20ch;

<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    Change the maximum width.
  </div>
</section>

#example-element {
  display: flex;
  flex-direction: column;
  background-color: #5b6dcd;
  height: 80%;
  justify-content: center;
  color: white;
}

Синтаксис

/* <length> value */
max-width: 3.5em;
max-width: anchor-size(--my-anchor inline, 245px);
max-width: calc(anchor-size(width) + 4em);

/* <percentage> value */
max-width: 75%;

/* Keyword values */
max-width: none;
max-width: max-content;
max-width: min-content;
max-width: fit-content;
max-width: fit-content(20em);
max-width: stretch;

/* Global values */
max-width: inherit;
max-width: initial;
max-width: revert;
max-width: revert-layer;
max-width: unset;

Значения

<length>

Задаёт max-width абсолютным значением.

<percentage>

Задаёт max-width в процентах от ширины содержащего блока.

none

Размер блока не ограничен.

max-content

Внутренний предпочтительный max-width.

min-content

Внутренний минимальный max-width.

fit-content

Использует доступное пространство, но не больше, чем max-content, то есть min(max-content, max(min-content, stretch)).

fit-content(<length-percentage>)

Использует формулу fit-content, заменяя доступное пространство заданным аргументом, то есть min(max-content, max(min-content, argument)).

stretch

Ограничивает максимальную ширину блока внешних отступов элемента шириной его содержащего блока. Это значение пытается заполнить блоком внешних отступов всё доступное пространство содержащего блока, поэтому в некотором смысле ведёт себя подобно 100%, но применяет итоговый размер к блоку внешних отступов, а не к блоку, размеры которого определяются свойством box-sizing.

Примечание: Сведения об используемых браузерами псевдонимах значения stretch и состоянии его реализации см. в разделе Совместимость с браузерами.

Доступность

Убедитесь, что элементы с заданным max-width не обрезаются и/или не перекрывают другой контент при увеличении масштаба страницы для повышения размера текста.

• Руководство MDN по WCAG: пояснения к критерию 1.4

• [Понимание критерия успеха 1.4.4

  Руководство W3C по WCAG 2.0](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-scale.html)

Формальное определение

Формальный синтаксис

max-width = 
  none |
  <length-percentage [0,∞]> |
  min-content |
  max-content |
  fit-content |
  fit-content(<length-percentage [0,∞]>) |
  <calc-size()> |
  <anchor-size()>

<length-percentage> = 
  <length> |
  <percentage>

<calc-size()> = 
  calc-size( <calc-size-basis>, <calc-sum> )

<anchor-size()> = 
  anchor-size( [ <anchor-name> || <anchor-size> ]? , <length-percentage>? )

<calc-size-basis> = 
  <intrinsic-size-keyword> |
  <calc-size()> |
  any |
  <calc-sum>

<calc-sum> = 
  <calc-product> [ [ '+' | '-' ] <calc-product> ]*

<anchor-name> = 
  <dashed-ident>

<anchor-size> = 
  width |
  height |
  block |
  inline |
  self-block |
  self-inline

<calc-product> = 
  <calc-value> [ '*' <calc-value> | '/' <number> ]*

<calc-value> = 
  <number> |
  <dimension> |
  <percentage> |
  <calc-constant> |
  ( <calc-sum> )

<calc-constant> = 
  e |
  pi |
  infinity |
  -infinity |
  NaN

Примеры

Задание максимальной ширины в пикселях

В этом примере ширина «дочернего» элемента будет равна 150 пикселям или ширине «родительского» элемента — в зависимости от того, какая величина меньше.

HTML

<div id="parent">
  <div id="child">
    Fusce pulvinar vestibulum eros, sed luctus ex lobortis quis.
  </div>
</div>

CSS

#parent {
  background: lightblue;
  width: 300px;
}

#child {
  background: gold;
  width: 100%;
  max-width: 150px;
}

Результат

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

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

См. также

• min-width
• width
• max-inline-size
• max-block-size
• box-sizing
• Руководство «Введение в блочную модель CSS»
• Модуль «Блочная модель CSS»