##はじめに
z-indexを使うことははよくあると思います。
ですがちゃんと理解してないで使うと思った通りにならないということが多々あります。
実際私もなんとなくで使っていてハマりました…
なので自分でも理解できるようにまとめてみました。

##そもそもz-indexとは？
要素の重なり順（スタックレベル）を指定するCSSのプロパティです。
通常は後に書いた要素の方が上に表示されますが、z-indexを使用することによって自由に優先順位を設定することができます。
書き方は以下のように記述します。

z-index: 値;

z-index: 10;
z-index: 20;
z-index: 100;

値は整数またはauto（初期値）を指定します。
指定した値が大きい要素ほど上に表示されます。

##どんなときに使う？
position: absoluteやposition: fixedで要素を重ねた時などに重なり順を指定するのに使うことが多いです。
z-indexを使用するには、その要素にpositionプロパティでstatic（初期値）以外の値が適用されている必要があります。
z-indexはpositionと一緒に使うと覚えればいいですね！

##実際に使ってみよう

See the Pen GRjvoMK by mikoshiba (@s_miko) on CodePen.

scss

 .wrapper{
   position: relative;
 } 

.box {
  position: absolute;
  width: 100px;
  height: 100px;
  
  &.box1{
    top: 0;
    left: 0;
    background-color: #07bc8c;
  }
  
  &.box2{
    top: 50px;
    left: 50px;
    background-color: #e02f2f;
  }
}

z-indexは特に指定してないですね。
z-indexを指定しなければ後に書いた要素の方が上に表示されます。
なのでbox2が上に表示されてます。

ではz-indexを指定するとどうなるでしょう？

scss

 .wrapper {
   position: relative;
 } 

 .box {
   position: absolute;
   width: 100px;
   height: 100px;
  
   &.box1{
     z-index: 1;
     top: 0;
     left: 0;
     background-color: #07bc8c;
   }
  
   &.box2{
     top: 50px;
     left: 50px;
     background-color: #e02f2f;
   }
 }

See the Pen ExgwdZd by mikoshiba (@s_miko) on CodePen.

box1にz-index: 1;を書き足しました。
先に書いたbox1が上に表示されています。
このようにz-indexを使えば重ね順を指定できます。

##意図した通りに動かない…

See the Pen VwKMadv by mikoshiba (@s_miko) on CodePen.

html

<div class="wrapper"> 
  <div class="box box1">box1</div>
  <div class="box box2">box2
    <div class="box box3">box3</div>
  </div>
</div>

scss

 .wrapper {
   position: relative;
 } 

 .box {
   position: absolute;
   width: 100px;
   height: 100px;
  
   &.box1{
     z-index: 2;
     top: 0;
     left: 0;
     background-color: #07bc8c;
   }
  
   &.box2{
     z-index: 1;
     top: 50px;
     left: 50px;
     background-color: #e02f2f;
   }
  
   &.box3{
     z-index: 100;
     top: 50px;
     left: 50px;
     background-color: #ffcc00;
   }
 }

box1、box2、box3それぞれにz-indexを指定しました。
数値だけで見ると box3 > box1 > box2の順番になりそうですよね。
でも実際はbox1が一番上にきています。
それはなぜでしょう？

ここで出てくるのがスタックコンテキストです。

##スタックコンテキスト

重ね合わせコンテキストは、ビューポートまたはウェブページに面していると想定されるユーザーに対する仮想的な Z 軸に沿って並べられた HTML 要素の三次元の概念化です。 HTML 要素は、要素の属性に基づいてこの空間を優先度つきの順序で占有します。

う〜〜〜〜〜ん、わからん！！！

簡単に説明すると、スタックコンテキストとは特定の条件において作られる要素のグループのことです。
特定の条件とは

position:relativeまたはposition:absoluteかつz-index:auto以外の整数を指定すること

です。
他にもありますが、大体この条件が使われます。

html

<!-- スタックコンテキスト -->
<div class="box1" style="position: relative; z-index: 1;">
  <div class="box1-1"></div>
  <div class="box1-2"></div>
</div>
<!-- /スタックコンテキスト -->
<div class="box2">
  <div class="box2-1"></div>
</div>

box1に特定の条件（position:relativeかつz-index:1）指定しているので、
box1を親とするその子要素（box1-1、box1-2）のグループが作られます。
これがスタックコンテキストです。
上の例でいうとbox1、box2、box3それぞれスタックコンテキストを生成しています。

また、htmlはデフォルトでスタックコンテキストを生成しているので、
何も指定しなくてもbox1〜box3はルートスタックコンテキストに所属しています。

##スタックコンテキストとスタックレベル
スタックレベルとは同一スタックコンテキストのなかの重なり順のことです。
下記でいうとbox1とbox2は兄弟要素、つまり同じスタックレベルです。
z-indexで指定している順序は、HTML全体のなかの重なり順ではなく、このスタックレベルのことを指しています。

さっきの意図しないコードをもう一回見てみましょう。

html

<div class="wrapper"> 
  <div class="box box1">box1</div>
  <div class="box box2">box2
    <div class="box box3">box3</div>
  </div>
</div>

scss

 .wrapper{
   position: relative;
 } 

 .box {
   position: absolute;
   width: 100px;
   height: 100px;
  
   &.box1{
     z-index: 2;
     top: 0;
     left: 0;
     background-color: #07bc8c;
   }
  
   &.box2{
     z-index: 1;
     top: 50px;
     left: 50px;
     background-color: #e02f2f;
   }
  
   &.box3{
     z-index: 100;
     top: 50px;
     left: 50px;
     background-color: #ffcc00;
   }
 }

box1とbox２はスタックレベルが同じです。
box1とbox２だと1の方が数値が大きいのでbox1が上に表示されます。
box3は100という大きい値を設定してるにもかかわらずbox1より下に表示されるのはbox３がbox2のスタックコンテキストに属しているからです。
なのでbox3は親要素box2以外の数値の影響を受ける事はありません。

##まとめ
z-idnexが効かないときはpositionにstatic以外が指定されているか確認する、
またはスタックコンテキストとスタックレベルを意識すれば幸せになれそうですね。

##参考文献