align-items

Description
Syntax
Examples
Links

Description

The align-items property for CSS specifies the default align-self for all of the child boxes (including anonymous boxes) participating in this box's formatting context.

Syntax

CSS

align-items: value;

JS

object.style.alignItems = "value";

Values

<'align-items'> = normal | stretch | <baseline-position> | [ <overflow-position>? <self-position> ]

normal

Represents the default alignment for the content.

stretch

If the combined size of the alignment subjects is less than the size of the alignment container, any auto-sized alignment subjects have their size increased equally (not proportionally), while still respecting the constraints imposed by max-height/max-width (or equivalent functionality), so that the combined size exactly fills the alignment container.

<baseline-position> = [ first | last ]? baseline

first baseline

Specifies participation in first-baseline alignment: aligns the alignment baseline of the box's first baseline set with the corresponding baseline of its baseline-sharing group.

last baseline

Specifies participation in last-baseline alignment: aligns the alignment baseline of the box's last baseline set with the corresponding baseline of its baseline-sharing group.

baseline

Computes to first baseline.

<overflow-position> = unsafe | safe

unsafe

Regardless of the relative sizes of the alignment subject and alignment container, the given alignment value is honored.

safe

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

<self-position> = center | start | end | self-start | self-end | flex-start | flex-end

center

Centers the alignment subject within its alignment container.

start

Aligns the alignment subject to be flush with the alignment container's start edge in the appropriate axis.

end

Aligns the alignment subject to be flush with the alignment container's end edge in the appropriate axis.

self-start

Aligns the alignment subject to be flush with the edge of the alignment container corresponding to the alignment subject's start side in the appropriate axis.

self-end

Aligns the alignment subject to be flush with the edge of the alignment container corresponding to the alignment subject's end side in the appropriate axis.

flex-start

Aligns the alignment subject to be flush with the edge of the alignment container corresponding to the flex container's main-start or cross-start side, as appropriate. Only used in flex layout.

flex-end

Aligns the alignment subject to be flush with the edge of the alignment container corresponding to the flex container's main-end or cross-end side, as appropriate. Only used in flex layout.

Initial

normal

Examples

1 · normal

2 · stretch

3 · baseline-position · first baseline

4 · baseline-position · last baseline

5 · baseline-position · baseline

6 · overflow-position · unsafe

7 · overflow-position · safe

8 · self-position · center

9 · self-position · start

10 · self-position · end

11 · self-position · self-start

12 · self-position · self-end

13 · self-position · flex-start

14 · self-position · flex-end

15 · JS

<!doctype html>
<html>
<head>
    <style>
        body
        {
            height: 100vh;
        }
        .myclass
        {
            align-content: center;
            display: grid;
            grid-auto-columns: 100px;
            grid-auto-rows: 100px;
            height: 100%;
        }
        .myclass > div
        {
            background-image: linear-gradient(135deg, white, lightgray);
        }
    </style>
</head>
<body>
    <button>initial</button><br>
    <button>normal</button>
    <button>stretch</button><br>
    <button>first baseline</button>
    <button>last baseline</button>
    <button>baseline</button><br>
    <button value="unsafe center">unsafe</button>
    <button value="safe center">safe</button><br>
    <button>center</button>
    <button>start</button>
    <button>end</button>
    <button>self-start</button>
    <button>self-end</button>
    <button>flex-start</button>
    <button>flex-end</button>
    <div class="myclass">
        <div>align-items</div>
        <div>align-items</div>
        <div>align-items</div>
    </div>
    <script>
        function myfunction(myparameter)
        {
            const mytarget = myparameter.target;
            const myproperty = mytarget.value || mytarget.innerHTML;
            const mystyle = document.querySelector(".myclass").style;
            mystyle.alignItems = myproperty;
            mystyle.gridAutoColumns = "100px";
            mystyle.gridAutoRows = "100px";
            if(myproperty.includes("safe"))
            {
                mystyle.gridAutoColumns = "0";
                mystyle.gridAutoRows = "0";
            }
        }
        for(const mybutton of document.querySelectorAll("button"))
        {
            mybutton.addEventListener("mouseover", myfunction);
        }
    </script>
</body>
</html>