ContextQMD
Back to Content

align-self

files/en-us/web/css/reference/properties/align-self/index.md

latest6.0 KB
Original Source

The align-self CSS property overrides a grid or flex item's {{cssxref("align-items")}} value. In grid, it aligns the item inside the {{glossary("Grid Areas", "grid area")}}. In flexbox, it aligns the item on the {{glossary("cross axis")}}.

The property doesn't apply to block-level boxes, or to table cells. If a flexbox item's cross-axis margin is auto, then align-self is ignored.

{{InteractiveExample("CSS Demo: align-self")}}

css
align-self: stretch;
css
align-self: center;
css
align-self: start;
css
align-self: end;
html
<section class="default-example" id="default-example">
  <div class="example-container">
    <div class="transition-all" id="example-element">One</div>
    <div>Two</div>
    <div>Three</div>
  </div>
</section>
css
.example-container {
  border: 1px solid #c5c5c5;
  display: grid;
  width: 200px;
  grid-template-columns: 1fr 1fr;
  grid-auto-rows: 80px;
  grid-gap: 10px;
}

.example-container > div {
  background-color: rgb(0 0 255 / 0.2);
  border: 3px solid blue;
}

Syntax

css
/* Keyword values */
align-self: auto;
align-self: normal;

/* Positional alignment */
/* align-self does not take left and right values */
align-self: center; /* Put the item around the center */
align-self: start; /* Put the item at the start */
align-self: end; /* Put the item at the end */
align-self: self-start; /* Align the item flush at the start */
align-self: self-end; /* Align the item flush at the end */
align-self: flex-start; /* Put the flex item at the start */
align-self: flex-end; /* Put the flex item at the end */
align-self: anchor-center;

/* Baseline alignment */
align-self: baseline;
align-self: first baseline;
align-self: last baseline;
align-self: stretch; /* Stretch 'auto'-sized items to fit the container */

/* Overflow alignment */
align-self: safe center;
align-self: unsafe center;

/* Global values */
align-self: inherit;
align-self: initial;
align-self: revert;
align-self: revert-layer;
align-self: unset;

Values

  • auto

    • : Computes to the parent's {{cssxref("align-items")}} value.

  • normal

    • : The effect of this keyword is dependent of the layout mode we are in:
      • In absolutely-positioned layouts, the keyword behaves like start on replaced absolutely-positioned boxes, and as stretch on all other absolutely-positioned boxes.
      • In static position of absolutely-positioned layouts, the keyword behaves as stretch.
      • For flex items, the keyword behaves as stretch.
      • For grid items, this keyword leads to a behavior similar to the one of stretch, except for boxes with an {{glossary("aspect ratio")}} or an intrinsic size where it behaves like start.
      • The property doesn't apply to block-level boxes, and to table cells.

  • self-start

    • : Aligns the items to be flush with the edge of the alignment container corresponding to the item's start side in the cross axis.

  • self-end

    • : Aligns the items to be flush with the edge of the alignment container corresponding to the item's end side in the cross axis.

  • flex-start

    • : The cross-start margin edge of the flex item is flushed with the cross-start edge of the line.

  • flex-end

    • : The cross-end margin edge of the flex item is flushed with the cross-end edge of the line.

  • center

    • : The flex item's margin box is centered within the line on the cross-axis. If the cross-size of the item is larger than the flex container, it will overflow equally in both directions.

  • baseline, first baseline, last baseline

    • : Specifies participation in first- or last-baseline alignment: aligns the alignment baseline of the box's first or last baseline set with the corresponding baseline in the shared first or last baseline set of all the boxes in its baseline-sharing group. The fallback alignment for first baseline is start, the one for last baseline is end.

  • stretch

    • : If the item's cross-size is auto, the used size is set to the length necessary to be as close to filling the container as possible, respecting the item's width and height limits. If the item is not auto-sized, this value falls back to flex-start, and to self-start or self-end if the container's {{cssxref("align-content")}} is first baseline (or baseline) or last baseline.

  • anchor-center

  • safe

    • : If the size of the item overflows the alignment container, the item is instead aligned as if the alignment mode were start.

  • unsafe

    • : Regardless of the relative sizes of the item and alignment container, the given alignment value is honored.

Formal definition

{{CSSInfo}}

Formal syntax

{{csssyntax}}

Examples

HTML

html
<section>
  <div>Item #1</div>
  <div>Item #2</div>
  <div>Item #3</div>
</section>

CSS

css
section {
  display: flex;
  align-items: center;
  height: 120px;
  background: beige;
}

div {
  height: 60px;
  background: cyan;
  margin: 5px;
}

div:nth-child(3) {
  align-self: flex-end;
  background: pink;
}

Result

{{EmbedLiveSample('Examples')}}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also