Revision 1046716 of max-height

<p>{{CSSRef}}</p>

<h2 id="Summary" name="Summary">Summary</h2>

<p>The <strong><code>max-height</code></strong> property is used to set the maximum height of an element. It prevents the used value of the {{ Cssxref("height") }} property from becoming larger than the value specified for <code>max-height</code>.</p>

<p>{{ Cssxref("max-height") }} overrides {{cssxref("height")}}, but {{ Cssxref("min-height") }} overrides {{ Cssxref("max-height") }}.</p>

<p>{{cssinfo}}</p>

<h2 id="Syntax" name="Syntax">Syntax</h2>

<pre class="brush:css">
/* &lt;length&gt; value */
max-height: 3.5em;

/* &lt;percentage&gt; value */
max-height: 75%;

/* Keyword values */
max-height: none;
max-height: max-content;
max-height: min-content;
max-height: fit-content;
max-height: fill-available;

/* Global values */
max-height: inherit;
max-height: initial;
max-height: unset;
</pre>

<h3 id="Values" name="Values">Values</h3>

<dl>
 <dt><code>&lt;length&gt;</code></dt>
 <dd>A fixed maximum height. See {{cssxref("&lt;length&gt;")}} for possible units.</dd>
 <dt><code>&lt;percentage&gt;</code></dt>
 <dd>The {{cssxref("&lt;percentage&gt;")}} is calculated with respect to the height of the containing block. If the height of the containing block is not specified explicitly, the percentage value is treated as <code>none</code>.</dd>
 <dt><code>none</code></dt>
 <dd>No limit on the height of the box.</dd>
 <dt><code>max-content</code>{{experimental_inline()}}</dt>
 <dd>The intrinsic preferred height.</dd>
 <dt><code>min-content</code>{{experimental_inline()}}</dt>
 <dd>The intrinsic minimum height.</dd>
 <dt><code>fill-available</code>{{experimental_inline()}}</dt>
 <dd>The containing block height minus vertical margin, border and padding. Some browsers implement an ancient name for this keyword, <code>available</code>.</dd>
 <dt><code>fit-content</code>{{experimental_inline()}}</dt>
 <dd>The same as <code>max-content.</code></dd>
</dl>

<h3 id="Formal_syntax">Formal syntax</h3>

<pre class="syntaxbox">
{{csssyntax}}</pre>

<h2 id="Examples">Examples</h2>

<pre class="brush: css">
table { max-height: 75%; }

form { max-height: none; }
</pre>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{ SpecName('CSS3 Sizing', '#width-height-keywords', 'max-height') }}</td>
   <td>{{ Spec2('CSS3 Sizing') }}</td>
   <td>Adds the <code>max-content</code>, <code>min-content</code>, <code>fit-content</code>, and <code>fill-available</code> keywords.<br />
    <em>Both CSS3 Box and CSS3 Writing Modes drafts defined at some point these keywords. These drafts are superseded by this spec.</em></td>
  </tr>
  <tr>
   <td>{{ SpecName('CSS3 Transitions', '#animatable-css', 'max-height') }}</td>
   <td>{{ Spec2('CSS3 Transitions') }}</td>
   <td>Defines <code>max-height</code> as animatable.</td>
  </tr>
  <tr>
   <td>{{ SpecName('CSS2.1', 'visudet.html#min-max-heights', 'max-height') }}</td>
   <td>{{ Spec2('CSS2.1') }}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_Compatibility" name="Browser_Compatibility">Browser compatibility</h2>

<p>{{ CompatibilityTable() }}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>1.0</td>
   <td>{{CompatGeckoDesktop("1.0")}}</td>
   <td>7.0</td>
   <td>7.0</td>
   <td>1.0</td>
  </tr>
  <tr>
   <td>applies to <code>&lt;table&gt; </code>[1]</td>
   <td>{{ CompatNo() }}</td>
   <td>{{CompatVersionUnknown()}}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{CompatVersionUnknown()}}</td>
   <td>{{ CompatNo() }}</td>
  </tr>
  <tr>
   <td rowspan="1"><code>max-content</code>, <code>min-content</code>, and <code>fit-content</code> {{ experimental_inline() }}</td>
   <td>{{ CompatNo() }} [3]</td>
   <td>{{CompatGeckoDesktop("1.9")}}{{property_prefix("-moz")}} [2]</td>
   <td rowspan="1">{{ CompatNo() }}</td>
   <td rowspan="1">{{ CompatNo() }}</td>
   <td>9[3](<a href="https://bugs.webkit.org/show_bug.cgi?id=113610">bug</a>)</td>
  </tr>
  <tr>
   <td rowspan="1"><code>fill-available</code> {{ experimental_inline() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }} {{ bug(527285) }}</td>
   <td rowspan="1">{{ CompatNo() }}</td>
   <td rowspan="1">{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td>applies to <code>&lt;table&gt; </code>[1]</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td rowspan="1"><code>max-content</code>, <code>min-content</code>, and <code>fit-content</code> {{ experimental_inline() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td rowspan="1">{{ CompatUnknown() }}</td>
   <td rowspan="1">{{ CompatUnknown() }}</td>
   <td>9[3](<a href="https://bugs.webkit.org/show_bug.cgi?id=113610">bug</a>)</td>
  </tr>
  <tr>
   <td rowspan="1"><code>fill-available</code> {{ experimental_inline() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td rowspan="1">{{ CompatUnknown() }}</td>
   <td rowspan="1">{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] CSS 2.1 explicitely leaves the behavior of <code>max-height</code> with {{ HTMLElement("table") }} undefined. Therefore any behavior is CSS2.1-compliant; newer CSS specifications may define this behavior, so Web developers shouldn't rely on a specific one now.</p>

<p>[2] Gecko experimentally implements the definitions given in CSS3 Basic Box. This one defines <code>available</code> and not <code>fill-available</code>. Also the definition of <code>fit-content</code> is simpler than in CSS3 Sizing.</p>

<p>[3] WebKit implements an earlier proposal for setting the height to an intrinsic height: the keywords <code>intrinsic</code>, instead of <code>max-content</code>, and <code>min-intrinsic</code>, instead of <code>min-content</code>. There is no equivalent for <code>fill-available</code> or <code>fit-content</code>.</p>

<h2 id="See_also" name="See_also">See also</h2>

<ul>
 <li><a href="/en-US/docs/CSS/box_model" title="en/CSS/box_model">The box model</a></li>
 <li>{{ Cssxref("max-width") }}, {{ Cssxref("box-sizing") }}, {{ Cssxref("height") }}, {{ Cssxref("min-height") }}</li>
</ul>