`column-rule-inset-junction` CSS property
The column-rule-inset-junction CSS shorthand property can be used to offset both the top and bottom endpoints of column rule segments that are junction endpoints; that is, endpoints at gap junctions where rule segments intersect.
The column-rule-inset-junction CSS shorthand property can be used to offset both the top and bottom endpoints of column rule segments that are junction endpoints; that is, endpoints at gap junctions where rule segments intersect.
CSS Demo: column-rule-inset-junction
```css interactive-example-choice column-rule-inset-junction: 0;
```css interactive-example-choice
column-rule-inset-junction: 10px;
```css interactive-example-choice column-rule-inset-junction: 0.5em -0.5em;
```css interactive-example-choice
column-rule-inset-junction: overlap-join;
```css interactive-example-choice column-rule-inset-junction: overlap-join 10px;
```html interactive-example
<section id="default-example">
<div id="example-element">
<i>A</i>
<i>B</i>
<i>C</i>
<i>D</i>
<i>E</i>
<i>F</i>
<i>G</i>
<i>H</i>
<i>I</i>
<i>J</i>
<i>K</i>
<i>L</i>
</div>
</section>
```css interactive-example
example-element {
display: grid; grid-template-columns: repeat(5, 1fr); rule: solid thick lightpink; column-rule-color: magenta; column-rule-break: intersection; gap: 1.5em; rule-overlap: column-over-row; border: 1px solid rebeccapurple; margin: auto; rule-visibility-items: around; }
example-element i {
background-color: #efefef; color: #333333; padding: 1em; }
## Constituent properties
This property is a shorthand for the following CSS properties:
- column-rule-inset-junction-end
- column-rule-inset-junction-start
## Syntax
```css
/* Keywords */
column-rule-inset-junction: overlap-join;
/* <length-percentage> values */
column-rule-inset-junction: 0;
column-rule-inset-junction: 1em;
column-rule-inset-junction: -5px;
column-rule-inset-junction: -25%;
/* Two values */
column-rule-inset-junction: 0 1em;
column-rule-inset-junction: -5px -25%;
column-rule-inset-junction: overlap-join 10px;
/* Global values */
column-rule-inset-junction: inherit;
column-rule-inset-junction: initial;
column-rule-inset-junction: revert;
column-rule-inset-junction: revert-layer;
column-rule-inset-junction: unset;
Values
This property is specified as one or two values from the following list:
overlap-join- : Specifies that the junction segment should extend across the row-rule, resolving to half the row-gap value plus half the used row-rule-width value.
- length-percentage
- : Specifies the size of the inset. Percentage values are relative to the junction endpoint, which is the
row-gapvalue.
Description
The column-rule-inset-junction shorthand property can be used to set the column-rule-inset-junction-start and column-rule-inset-junction-end properties, insetting or outsetting both the top and bottom endpoints of column rule segments that are junction segments.
If one value is specified, both properties are set to that value. If two values are specified, -start is set to the first value and -end is set to the second. Positive values reduce (or inset) the segment size, while negative values and the overlap-join keyword increase (or outset) it. The default value is 0.
The column-rule-inset-junction property is a constituent property of a few shorthand properties:
-
To inset both column and row segment junction endpoints, the
column-rule-inset-junctionshorthand property, along with the row-rule-inset-junction shorthand property, can be set using the rule-inset-junction shorthand. -
To inset both column cap and junction segment endpoints, the
column-rule-inset-junctionshorthand property, along with the column-rule-inset-cap shorthand property, can be set using the column-rule-inset shorthand.
All segment endpoints, including this property's -cap and -row equivalents, can be set using the rule-inset shorthand.
Formal definition
Formal syntax
Examples
Basic usage
This example demonstrates setting column-rule-inset-junction to inset the edges of column junction segments on flex containers.
HTML
The markup includes two div elements, each containing seven children. The only difference between the two containers is that the second one has an added column class.
<h1>Insetting junction column rule endpoints</h1>
<article>
<section>
<h2>flex-direction: row</h2>
<div class="flexbox">
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
</div>
</section>
<section>
<h2>flex-direction: column</h2>
<div class="flexbox column">
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
<div></div>
</div>
</section>
</article>
```html hidden
#### CSS
We use the display property to turn the `.flexbox` elements into flex containers. We balance the items into three flex lines using flex-wrap and flex-line-count. We define a light blue rule to paint both row and column gaps, then overwrite the column-rule-color, setting darker `blue` column gap decorations. We also set the rule-overlap property to `column-over-row` to ensure the column segments are drawn on top of the row segments when the segments overlap. Finally, we set the `column-rule-inset-junction` to `16px`.
```css
.flexbox {
display: flex;
flex-wrap: balance;
flex-line-count: 3;
gap: 20px;
rule: 5px solid lightblue;
column-rule-color: blue;
rule-overlap: column-over-row;
column-rule-inset-junction: 16px;
}
We also set the flex-direction on the .column container to column, changing the main axis of the flex container to run up and down the page and making the items flow in columns rather than rows.
.column {
flex-direction: column;
}
The rest of the CSS is hidden for brevity.
```css hidden h1, article { font-family: sans-serif; text-align: center; } h1 { font-size: 1.25em; } h2 { font-size: 1em; } article { display: flex; gap: 5vw; rule: 1px solid black; width: 100vw; } section { flex-basis: 45vw; } .flexbox > div { border: 1px solid green; background-color: lime; flex: 1 1 auto; height: 30px; } output { display: inline-block; width: 2em; } p { margin-top: 2.5em; } @layer no-support { @supports not (column-rule-inset-junction: 16px) { body::before { content: "Your browser doesn't support the column-rule-inset-junction property"; background-color: wheat; display: block; text-align: center; padding: 1rem 0; } } }
```js hidden live-sample___basic
const inset = document.getElementById("inset");
const containers = document.querySelectorAll(".flexbox");
const output = document.getElementById("o");
inset.addEventListener("input", () => {
const val = `${inset.value}px`;
containers[0].style.columnRuleInsetJunction = val;
containers[1].style.columnRuleInsetJunction = val;
output.innerText = val;
});
Result
Change the size of the inset. Note that this property affects only column rules split into multiple segments. When a column rule is a single segment that spans the height of the container, the segment has two cap endpoints and no junction endpoints, and remains unaffected by changes to the column-rule-inset-junction value.
With grid layout
This example demonstrates using the column-rule-inset-junction property to inset the top and bottom junction segment endpoints to two different values on a grid container.
HTML
We include the ul element as a container with several li children which will each be converted into a grid item.
```html live-sample___junctions
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 15
- 16
```html hidden live-sample___junctions
<p>
<label
>Change the <code>-start</code> value.
<input type="range" min="-40" max="40" value="16" id="start" data-unit="px"
/></label>
<output id="og">16px</output>
</p>
<p>
<label
>Change the <code>-end</code> value.
<input type="range" min="-40" max="40" value="0" id="end" data-unit="px"
/></label>
<output id="ow">0px</output>
</p>
CSS
We turn the <ul> into a grid container by setting the display property to grid. The grid-template-columns property specifies that the grid has six columns. We remove the bullets with list-style-type and set the row and column gaps to 20px with the gap shorthand. We set the color, size, and line style of all the rules using the rule shorthand, then change just the row rule color with the row-rule-color property.
We break the column rules at every intersection using the column-rule-break property. If the column rules didn't break, there would be no column junction segments to style!
Finally, we set the start of each column junction to be inset by 16px and the end to not be inset using the column-rule-inset-junction property.
We also set the 6th grid item to span three columns.
```css live-sample___junctions ul { display: grid; grid-template-columns: repeat(6, auto); list-style-type: ""; gap: 20px; rule: 10px solid olive; row-rule-color: palegoldenrod; column-rule-break: intersection;
column-rule-inset-junction: 16px 0; }
li:nth-of-type(8) { grid-column-end: span 3; }
The rest of the CSS is hidden for brevity.
```css hidden live-sample___junctions
ul {
border: 1px solid;
place-items: center;
width: 95vw;
padding: 0;
}
li {
text-align: center;
font-family: sans-serif;
background-color: #ededed;
padding: 2em 1em;
width: 100%;
box-sizing: border-box;
}
li:nth-of-type(8) {
background-color: transparent;
}
li code {
display: block;
margin: 0 auto;
text-align: left;
width: 30vw;
}
output {
font-family: monospace;
}
input {
accent-color: olive;
}
@layer no-support {
@supports not (column-rule-inset-junction: 16px) {
body::before {
content: "Your browser doesn't support the column-rule-inset-junction property";
background-color: wheat;
display: block;
text-align: center;
padding: 1rem 0;
}
}
}
``js hidden live-sample___junctions
const ul = document.querySelector("ul");
const startSize = document.getElementById("start");
const og = document.getElementById("og");
const endSize = document.getElementById("end");
const ow = document.getElementById("ow");
const cell = document.querySelector("li:nth-of-type(8)");
let text = "";
function update() {
ul.style.columnRuleInsetJunction =
text =${startSize.value}px ${endSize.value}px;
cell.innerHTML =rule-inset-cap: ${text};`;
}
update();
startSize.addEventListener("input", () => {
og.innerText = ${startSize.value}px;
update();
});
endSize.addEventListener("input", () => {
ow.innerText = ${endSize.value}px;
update();
});
```
Result
Specifications
Browser compatibility
See also
- column-rule-inset-junction-start
- column-rule-inset shorthand
- rule-inset shorthand
- column-rule-break
- rule-break shorthand
- rule-overlap
- rule-visibility-items
- rule shorthand
- CSS gaps module