jQuery API

:only-child Selector

Categories: Selectors > Child Filter

only-child selector

version added: 1.1.4jQuery(':only-child')

Description: Selects all elements that are the only child of their parent.

If the parent has other child elements, nothing is matched.

Example:

Finds the button with no siblings in each matched div and modifies look.

<!DOCTYPE html>
<html>
<head>
  <style>

  div { width:100px; height:80px; margin:5px; float:left; background:#b9e }
  </style>
  <script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
	<div>
    <button>Sibling!</button>
    <button>Sibling!</button>
  </div>

  <div>
    <button>Sibling!</button>
  </div>
  <div>
    None
  </div>

  <div>  
    <button>Sibling!</button>
    <button>Sibling!</button>
    <button>Sibling!</button>

  </div>
  <div>
    <button>Sibling!</button>
  </div>
<script>$("div button:only-child").text("Alone").css("border", "2px blue solid");</script>
</body>
</html>

Demo:

Result:

[ <li>Glen</li> ]

Comments

  • Support requests, bug reports, and off-topic comments will be deleted without warning.

  • Please do post corrections or additional examples for :only-child Selector below. We aim to quickly move corrections into the documentation.
  • If you need help, post at the forums or in the #jquery IRC channel.
  • Report bugs on the bug tracker or the jQuery Forum.
  • Discussions about the API specifically should be addressed in the Developing jQuery Core forum.