What does the "~" (tilde/squiggle/twiddle) CSS selector mean?
Searching for the ~
character isn't easy. I was looking over some CSS and found this
.check:checked ~ .content {
}
What does it mean?
The ~
selector is in fact the General sibling combinator (renamed to Subsequent-sibling combinator in selectors Level 4):
The general sibling combinator is made of the "tilde" (U+007E, ~) character that separates two sequences of simple selectors. The elements represented by the two sequences share the same parent in the document tree and the element represented by the first sequence precedes (not necessarily immediately) the element represented by the second one.
Consider the following example:
.a ~ .b {
background-color: powderblue;
}
<ul>
<li class="b">1st</li>
<li class="a">2nd</li>
<li>3rd</li>
<li class="b">4th</li>
<li class="b">5th</li>
</ul>
.a ~ .b
matches the 4th and 5th list item because they:
- Are
.b
elements - Are siblings of
.a
- Appear after
.a
in HTML source order.
Likewise, .check:checked ~ .content
matches all .content
elements that are siblings of .check:checked
and appear after it.
Good to also check the other combinators in the family and to get back to what is this specific one.
ul li
ul > li
-
ul + ul
ul ~ ul
Example checklist:
-
ul li
- Looking inside - Selects all theli
elements placed (anywhere) inside theul
; Descendant selector -
ul > li
- Looking inside - Selects only the directli
elements oful
; i.e. it will only select direct childrenli
oful
; Child Selector or Child combinator selector -
ul + ul
- Looking outside - Selects theul
immediately following theul
; It is not looking inside, but looking outside for the immediately following element; Adjacent Sibling Selector -
ul ~ ul
- Looking outside - Selects all theul
which follows theul
doesn't matter where it is, but bothul
should be having the same parent; General Sibling Selector
The one we are looking at here is General Sibling Selector
General sibling combinator
The general sibling combinator selector is very similar to the adjacent sibling combinator selector. The difference is that the element being selected doesn't need to immediately succeed the first element, but can appear anywhere after it.
More info
It is General sibling combinator
and is explained in @Salaman's answer very well.
What I did miss is Adjacent sibling combinator
which is +
and is closely related to ~
.
example would be
.a + .b {
background-color: #ff0000;
}
<ul>
<li class="a">1st</li>
<li class="b">2nd</li>
<li>3rd</li>
<li class="b">4th</li>
<li class="a">5th</li>
</ul>
- Matches elements that are
.b
- Are adjacent to
.a
- After
.a
in HTML
In example above it will mark 2nd li
but not 4th.
.a + .b {
background-color: #ff0000;
}
<ul>
<li class="a">1st</li>
<li class="b">2nd</li>
<li>3rd</li>
<li class="b">4th</li>
<li class="a">5th</li>
</ul>
JSFiddle