Pseudo-classes

A CSS pseudo-class is a keyword added to a selector that lets you select elements based on information that lies outside of the document tree, such as a specific state of the selected element(s). For example, the pseudo-class :hover can be used to style a button when a user's pointer hovers over it.

css

/* Any button over which the user's pointer is hovering */
button:hover {
  color: blue;
}

A pseudo-class consists of a colon (:) followed by the pseudo-class name (e.g., :hover). A functional pseudo-class also contains a pair of parentheses to define the arguments (e.g., :dir()). The element that a pseudo-class is attached to is defined as an anchor element (e.g., button in case button:hover).

Pseudo-classes let you apply a style to an element not only in relation to the content of the document tree, but also in relation to external factors like the history of the navigator (:visited, for example), the status of its content (like :checked on certain form elements), or the position of the mouse (like :hover, which lets you know if the mouse is over an element or not).

Note: In contrast to pseudo-classes, pseudo-elements can be used to style a specific part of an element.

Elemental pseudo-classes

These pseudo-classes relate to the core identity of elements.

:defined: Matches any element that is defined.
:heading: Matches any heading element (<h1>-<h6>).

Element display state pseudo-classes

These pseudo-classes enable the selection of elements based on their display states.

:open: Matches an element that can either be open or closed that is currently open.
:popover-open: Matches a popover element that is currently in the showing state.
:modal: Matches an element that is in a state in which it excludes all interaction with elements outside it until the interaction has been dismissed.
:fullscreen: Matches an element that is currently in fullscreen mode.
:picture-in-picture: Matches an element that is currently in picture-in-picture mode.
:xr-overlay: Matches the DOM overlay element during an immersive AR or VR session.

Input pseudo-classes

These pseudo-classes relate to form elements, and enable selecting elements based on HTML attributes and the state that the field is in before and after interaction.

:enabled: Represents a user interface element that is in an enabled state.
:disabled: Represents a user interface element that is in a disabled state.
:read-only: Represents any element that cannot be changed by the user.
:read-write: Represents any element that is user-editable.
:placeholder-shown: Matches an input element that is displaying placeholder text. For example, it will match the placeholder attribute in the <input> and <textarea> elements.
:autofill: Matches when an <input> has been autofilled by the browser.
:default: Matches one or more UI elements that are the default among a set of elements.
:checked: Matches when elements such as checkboxes and radio buttons are toggled on.
:indeterminate: Matches UI elements when they are in an indeterminate state.
:blank: Matches a user-input element which is empty, containing an empty string or other null input.
:valid: Matches an element with valid contents. For example, an input element with the type 'email' that contains a validly formed email address or an empty value if the control is not required.
:invalid: Matches an element with invalid contents. For example, an input element with type 'email' with a name entered.
:in-range: Applies to elements with range limitations. For example, a slider control when the selected value is in the allowed range.
:out-of-range: Applies to elements with range limitations. For example, a slider control when the selected value is outside the allowed range.
:required: Matches when a form element is required.
:optional: Matches when a form element is optional.
:user-valid: Represents an element with correct input, but only when the user has interacted with it.
:user-invalid: Represents an element with incorrect input, but only when the user has interacted with it.

Linguistic pseudo-classes

These pseudo-classes reflect the document language and enable the selection of elements based on language or script direction.

:dir(): The directionality pseudo-class selects an element based on its directionality as determined by the document language.
:lang(): Select an element based on its content language.

Location pseudo-classes

These pseudo-classes relate to links, and to targeted elements within the current document.

:any-link: Matches an element if the element would match either :link or :visited.
:link: Matches links that have not yet been visited.
:visited: Matches links that have been visited.
:local-link: Matches links whose absolute URL is the same as the target URL. For example, anchor links to the same page.
:target: Matches the element which is the target of the document URL.
:scope: Represents elements that are a reference point for selectors to match against.

Note: A :target-within pseudo-class, to match elements that are or have a descendant which is the target of the document URL, was defined but removed from the specification. Use :has(:target) for this purpose.

Resource state pseudo-classes

These pseudo-classes apply to media that is capable of being in a state where it would be described as playing, such as a video.

:playing: Represents a playable element that is playing.
:paused: Represents a playable element that is paused.
:seeking: Represents a playable element that is currently seeking a playback position in the media resource.
:buffering: Represents a playable element that is playing but is temporarily stalled because it is downloading the media resource.
:stalled: Represents a playable element that is playing but is stalled because it cannot download the media resource.
:muted: Represents a sound-producing element that is muted.
:volume-locked: Represents a sound-producing element that has its volume level locked by the browser.

Time-dimensional pseudo-classes

These pseudo-classes apply when viewing something which has timing, such as a WebVTT caption track.

:current: Represents the element or ancestor of the element that is being displayed.
:past: Represents an element that occurs entirely before the :current element.
:future: Represents an element that occurs entirely after the :current element.

Tree-structural pseudo-classes

These pseudo-classes relate to the location of an element within the document tree.

:root: Represents an element that is the root of the document. In HTML this is usually the <html> element.
:empty: Represents an element with no children other than white-space characters.
:nth-child(): Uses An+B notation to select elements from a list of sibling elements.
:nth-last-child(): Uses An+B notation to select elements from a list of sibling elements, counting backwards from the end of the list.
:first-child: Matches an element that is the first of its siblings.
:last-child: Matches an element that is the last of its siblings.
:only-child: Matches an element that has no siblings. For example, a list item with no other list items in that list.
:heading(): Uses An+B notation to select heading elements (<h1>-<h6>).
:nth-of-type(): Uses An+B notation to select elements from a list of sibling elements that match a certain type from a list of sibling elements.
:nth-last-of-type(): Uses An+B notation to select elements from a list of sibling elements that match a certain type from a list of sibling elements counting backwards from the end of the list.
:first-of-type: Matches an element that is the first of its siblings, and also matches a certain type selector.
:last-of-type: Matches an element that is the last of its siblings, and also matches a certain type selector.
:only-of-type: Matches an element that has no siblings of the chosen type selector.

Shadow-structural pseudo-classes

These pseudo-classes relate to the shadow DOM.

:host: Matches the shadow tree's shadow host.
:host(): Matches an element that matches :host and matches any of the selectors in the list provided.
:host-context(): Selects elements outside of the shadow tree in the context of the shadow host.
:has-slotted: Matches slot elements that have been assigned content.

User action pseudo-classes

These pseudo-classes require some interaction by the user in order for them to apply, such as holding a mouse pointer over an element.

:hover: Matches when a user designates an item with a pointing device, such as holding the mouse pointer over the item.
:active: Matches when an item is being activated by the user. For example, when the item is clicked on.
:focus: Matches when an element has focus.
:focus-visible: Matches when an element has focus and the user agent identifies that the element should be visibly focused.
:focus-within: Matches an element to which :focus applies, plus any element that has a descendant to which :focus applies.
:target-current: Matches the ::scroll-marker pseudo-element of a scroll-marker-group that is currently scrolled to, in other words, the active scroll marker.

Top-layer ancestor matching boundary

When setting styles using a :hover, :active, or :focus-within pseudo-class selector, a nested set of elements will match the selector up the DOM tree. If the hierarchy includes an element in the top layer (for example, a popover or customizable <select> picker), the matching will stop at that element.

For example, the following code features a customizable <select> element and a popover. We've set every element in the page to have a thick blue dashed border on hover.

html

<main>
  <select>
    <option>One</option>
    <option>Two</option>
    <option>Three</option>
  </select>

  <div>
    <button popovertarget="mypopover">Toggle popover</button>
    <section id="mypopover" popover>
      <p>I am a popover</p>
      <button>I am a popover button</button>
    </section>
  </div>
</main>

* {
  padding: 5px;
}

css

select,
::picker(select) {
  appearance: base-select;
}

:hover {
  border: 5px dashed blue;
}

Note how when you hover the <select> or the popover toggle button, all ancestors of those elements will get the border. However, when you open the select picker or the popover and hover one of their descendants, the matching stops at the top-layer ancestor (the select picker or popover themselves).

This behavior stops component styles set on those pseudo-classes from spilling out of a top layer component into the surrounding page, which can cause a user interface to look broken.

Functional pseudo-classes

These pseudo-classes accept a selector list or forgiving selector list as a parameter.

:is(): The matches-any pseudo-class matches any element that matches any of the selectors in the list provided. The list is forgiving.
:not(): The negation, or matches-none, pseudo-class represents any element that is not represented by its argument.
:where(): The specificity-adjustment pseudo-class matches any element that matches any of the selectors in the list provided without adding any specificity weight. The list is forgiving.
:has(): The relational pseudo-class represents an element if any of the relative selectors match when anchored against the attached element.

Custom state pseudo-classes

These pseudo-classes apply to custom elements.

:state(): Matches custom elements that have the specified custom state.

Page pseudo-classes

These pseudo-classes relate to pages in a printed document and are used with the @page at-rule.

:left: Represents all left-hand pages of a printed document.
:right: Represents all right-hand pages of a printed document.
:first: Represents the first page of a printed document.
:blank: Represents a blank page in a printed document.

View transition pseudo-classes

These pseudo-classes relate to elements involved in a view transition.

:active-view-transition: Matches the root element of a document when a view transition is in progress (active) and stops matching once the transition has completed.
:active-view-transition-type(): Matches the root element of a document when a specified view transition is in progress (active) and stops matching once the transition has completed.

Syntax

css

selector:pseudo-class {
  property: value;
}

Like regular classes, you can chain together as many pseudo-classes as you want in a selector.

Alphabetical index

Pseudo-classes defined by a set of CSS specifications include the following:

:blank (input)
:blank (page)
:buffering

:where()

:xr-overlay

Non-standard pseudo-classes

Non-standard vendor-prefixed pseudo-classes include:

`-moz-` prefix

Specifications

Specification
HTML # pseudo-classes
Selectors Level 4
CSS Scope
CSS Paged Media Module Level 3

Help improve MDN

Learn how to contribute

This page was last modified on Jan 1, 1970 by MDN contributors.

View this page on GitHub • Report a problem with this content

Pseudo-classes

-moz- prefix

Help improve MDN

`-moz-` prefix