bulma/docs/documentation/layout/hero.html

---
title: Hero
layout: docs
theme: library
fullwidth: true
hide_categories: true
hide_fortyfour: true
doc-tab: layout
doc-subtab: hero
breadcrumb:
  - home
  - documentation
  - layout
  - layout-hero
meta:
  colors: true
  sizes: true
  variables: true
---
<div class="content">
  <p>
    The hero component allows you to add a <strong>full width banner</strong> to your webpage, which can optionally
    cover the full height of the page as well.
  </p>
  <p>The basic requirement of this component are:</p>
  <ul>
    <li>
      <code>hero</code> as the main container
      <ul>
        <li><code>hero-body</code> as a direct child, in which you can put all your content</li>
      </ul>
    </li>
  </ul>
  <p>
    For the <a href="#fullheight-hero">fullheight hero</a> to work, you will also need a <code>hero-head</code> and a
    <code>hero-foot</code>.
  </p>
</div>

{% capture hero_example %}
<section class="hero">
  <div class="hero-body">
    <p class="title">Hero title</p>
    <p class="subtitle">Hero subtitle</p>
  </div>
</section>
{% endcapture %}
{%
  include docs/elements/snippet.html content=hero_example
  horizontal=true fullwidth=true
%}
{%
  include docs/elements/anchor.html
  name="Colors"
%}

<div class="content">
  As with buttons, you can choose one of the
  <strong>8 different colors</strong>:
</div>

{% for color in site.data.colors.justColors %}
  {% capture foobar %}
<section class="hero is-{{ color }}">
  <div class="hero-body">
    <p class="title">{{ color | capitalize }} hero</p>
    <p class="subtitle">{{ color | capitalize }} subtitle</p>
  </div>
</section>
{% endcapture %}
  {%
    include docs/elements/snippet.html content=foobar
    horizontal=true fullwidth=true
  %}
{% endfor %}

<!--  -->

{% include docs/elements/anchor.html name="Sizes" %}

<div class="content">
  <p>
    You can have even more imposing banners by using one of
    <strong>5 different sizes</strong>:
  </p>
  <ul>
    <li><code>is-small</code></li>
    <li><code>is-medium</code></li>
    <li><code>is-large</code></li>
    <li><code>is-halfheight</code></li>
    <li><code>is-fullheight</code></li>
  </ul>
</div>

{% capture small_hero %}
<section class="hero is-small is-primary">
  <div class="hero-body">
    <p class="title">Small hero</p>
    <p class="subtitle">Small subtitle</p>
  </div>
</section>
{% endcapture %}
{%
  include docs/elements/snippet.html content=small_hero
  horizontal=true fullwidth=true
%}
{% capture medium_hero %}
<section class="hero is-medium is-link">
  <div class="hero-body">
    <p class="title">Medium hero</p>
    <p class="subtitle">Medium subtitle</p>
  </div>
</section>
{% endcapture %}
{%
  include docs/elements/snippet.html content=medium_hero
  horizontal=true fullwidth=true
%}
{% capture large_hero %}
<section class="hero is-large is-info">
  <div class="hero-body">
    <p class="title">Large hero</p>
    <p class="subtitle">Large subtitle</p>
  </div>
</section>
{% endcapture %}
{%
  include docs/elements/snippet.html content=large_hero
  horizontal=true fullwidth=true
%}

<div id="halfheight-hero"></div>

{% capture halfheight_example %}
<section class="hero is-success is-halfheight">
  <div class="hero-body">
    <div class="">
      <p class="title">Half height hero</p>
      <p class="subtitle">Half height subtitle</p>
    </div>
  </div>
</section>
{% endcapture %}
{%
  include docs/elements/snippet.html
  content=halfheight_example horizontal=true fullwidth=true
%}

<div id="fullheight-hero"></div>

{% capture fullheight_example %}
<section class="hero is-danger is-fullheight">
  <div class="hero-body">
    <div class="">
      <p class="title">Fullheight hero</p>
      <p class="subtitle">Fullheight subtitle</p>
    </div>
  </div>
</section>
{% endcapture %}
{%
  include docs/elements/snippet.html
  content=fullheight_example horizontal=true fullwidth=true
%}

<!-- Fullheight with navbar -->
{% include docs/elements/anchor.html name="Fullheight with navbar" %}

<div class="content">
  <p>
    If you are using a
    <a href="{{ site.url }}/documentation/components/navbar/#fixed-navbar">fixed navbar</a>, you can use the
    <code>is-fullheight-with-navbar</code> modifier on the hero for it to occupy the viewport height minus the navbar
    height.
  </p>
</div>

{% capture fullheight_with_navbar_example %} {% include
docs/examples/navbar-basic.html %}

<section class="hero is-link is-fullheight-with-navbar">
  <div class="hero-body">
    <p class="title">Fullheight hero with navbar</p>
  </div>
</section>
{% endcapture %}
{%
  include docs/elements/snippet.html
  content=fullheight_with_navbar_example horizontal=true fullwidth=true
%}

<!-- Fullheight with 3 parts -->
{% include docs/elements/anchor.html name="Fullheight hero in 3 parts" %}

<div class="content">
  <p>
    To obtain a hero that will cover the whole height of the viewport, you can split it in
    <strong>3 vertical parts</strong>:
  </p>
  <ul>
    <li>
      <code>hero</code>
      <ul>
        <li><code>hero-head</code> (always at the top)</li>
        <li><code>hero-body</code> (always vertically centered)</li>
        <li><code>hero-foot</code> (always at the bottom)</li>
      </ul>
    </li>
  </ul>
</div>

{% capture heroNavbarA %}
<section class="hero is-primary is-medium">
  <!-- Hero head: will stick at the top -->
  <div class="hero-head">
    <nav class="navbar">
      <div class="container">
        <div class="navbar-brand">
          <a class="navbar-item">
            <img src="{{ site.url }}/assets/images/bulma-type-white.png" alt="Logo" />
          </a>
          <span class="navbar-burger" data-target="navbarMenuHeroA">
            <span></span>
            <span></span>
            <span></span>
            <span></span>
          </span>
        </div>
        <div id="navbarMenuHeroA" class="navbar-menu">
          <div class="navbar-end">
            <a class="navbar-item is-active"> Home </a>
            <a class="navbar-item"> Examples </a>
            <a class="navbar-item"> Documentation </a>
            <span class="navbar-item">
              <a class="button is-primary is-inverted">
                <span class="icon">
                  <i class="fab fa-github"></i>
                </span>
                <span>Download</span>
              </a>
            </span>
          </div>
        </div>
      </div>
    </nav>
  </div>

  <!-- Hero content: will be in the middle -->
  <div class="hero-body">
    <div class="container has-text-centered">
      <p class="title">Title</p>
      <p class="subtitle">Subtitle</p>
    </div>
  </div>

  <!-- Hero footer: will stick at the bottom -->
  <div class="hero-foot">
    <nav class="tabs">
      <div class="container">
        <ul>
          <li class="is-active"><a>Overview</a></li>
          <li><a>Modifiers</a></li>
          <li><a>Grid</a></li>
          <li><a>Elements</a></li>
          <li><a>Components</a></li>
          <li><a>Layout</a></li>
        </ul>
      </div>
    </nav>
  </div>
</section>
{% endcapture %}
{% capture heroNavbarB %}
<section class="hero is-info is-large">
  <div class="hero-head">
    <nav class="navbar">
      <div class="container">
        <div class="navbar-brand">
          <a class="navbar-item">
            <img src="{{ site.url }}/assets/images/bulma-type-white.png" alt="Logo" />
          </a>
          <span class="navbar-burger" data-target="navbarMenuHeroB">
            <span></span>
            <span></span>
            <span></span>
            <span></span>
          </span>
        </div>
        <div id="navbarMenuHeroB" class="navbar-menu">
          <div class="navbar-end">
            <a class="navbar-item is-active"> Home </a>
            <a class="navbar-item"> Examples </a>
            <a class="navbar-item"> Documentation </a>
            <span class="navbar-item">
              <a class="button is-info is-inverted">
                <span class="icon">
                  <i class="fab fa-github"></i>
                </span>
                <span>Download</span>
              </a>
            </span>
          </div>
        </div>
      </div>
    </nav>
  </div>

  <div class="hero-body">
    <div class="container has-text-centered">
      <p class="title">Title</p>
      <p class="subtitle">Subtitle</p>
    </div>
  </div>

  <div class="hero-foot">
    <nav class="tabs is-boxed is-fullwidth">
      <div class="container">
        <ul>
          <li class="is-active">
            <a>Overview</a>
          </li>
          <li>
            <a>Modifiers</a>
          </li>
          <li>
            <a>Grid</a>
          </li>
          <li>
            <a>Elements</a>
          </li>
          <li>
            <a>Components</a>
          </li>
          <li>
            <a>Layout</a>
          </li>
        </ul>
      </div>
    </nav>
  </div>
</section>
{% endcapture %}
{% capture heroNavbarC %}
<section class="hero is-success is-fullheight">
  <!-- Hero head: will stick at the top -->
  <div class="hero-head">
    <header class="navbar">
      <div class="container">
        <div class="navbar-brand">
          <a class="navbar-item">
            <img src="{{ site.url }}/assets/images/bulma-type-white.png" alt="Logo" />
          </a>
          <span class="navbar-burger" data-target="navbarMenuHeroC">
            <span></span>
            <span></span>
            <span></span>
            <span></span>
          </span>
        </div>
        <div id="navbarMenuHeroC" class="navbar-menu">
          <div class="navbar-end">
            <a class="navbar-item is-active"> Home </a>
            <a class="navbar-item"> Examples </a>
            <a class="navbar-item"> Documentation </a>
            <span class="navbar-item">
              <a class="button is-success is-inverted">
                <span class="icon">
                  <i class="fab fa-github"></i>
                </span>
                <span>Download</span>
              </a>
            </span>
          </div>
        </div>
      </div>
    </header>
  </div>

  <!-- Hero content: will be in the middle -->
  <div class="hero-body">
    <div class="container has-text-centered">
      <p class="title">Title</p>
      <p class="subtitle">Subtitle</p>
    </div>
  </div>

  <!-- Hero footer: will stick at the bottom -->
  <div class="hero-foot">
    <nav class="tabs is-boxed is-fullwidth">
      <div class="container">
        <ul>
          <li class="is-active"><a>Overview</a></li>
          <li><a>Modifiers</a></li>
          <li><a>Grid</a></li>
          <li><a>Elements</a></li>
          <li><a>Components</a></li>
          <li><a>Layout</a></li>
        </ul>
      </div>
    </nav>
  </div>
</section>
{% endcapture %}
{%
  include docs/elements/snippet.html content=heroNavbarA
  horizontal=true fullwidth=true more=true
%}
{%
  include docs/elements/snippet.html content=heroNavbarB horizontal=true fullwidth=true
  more=true
%}
{%
  include docs/elements/snippet.html content=heroNavbarC
  horizontal=true fullwidth=true more=true
%}