Свойство CSS `max-height`

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

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

Попробуйте

max-height: 150px;

max-height: 7em;

max-height: 75%;

max-height: 10px;

<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    This is a box where you can change the maximum height. <br />This will limit
    how tall the box can be, potentially causing an overflow.
  </div>
</section>

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

Синтаксис

/* <length> value */
max-height: 3.5em;
max-height: anchor-size(height);
max-height: calc(anchor-size(--my-anchor self-block, 250px) + 2em);

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

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

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

Значения

<length>

Задаёт max-height в виде абсолютного значения.

<percentage>

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

none

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

max-content

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

min-content

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

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-height, не обрезается и/или не перекрывает другое содержимое при увеличении масштаба страницы для повышения размера текста.

• Пояснения MDN к руководству WCAG 1.4

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

  Понимание WCAG 2.0 от W3C](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-scale.html)

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

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

max-height = 
  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

Примеры

Задание max-height с помощью процентных значений и ключевых слов

table {
  max-height: 75%;
}

form {
  max-height: none;
}

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

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

См. также

• min-height
• height
• max-inline-size
• max-block-size
• box-sizing
• Введение в блочную модель CSS: руководство
• Блочная модель CSS: модуль