"I love Home · jquery/sizzle Wiki · GitHub"

2022-05-03 14:31:27

Skip to content Signup Product Features Mobile Actions Codespaces Packages Security Code review Issues Integrations GitHub Sponsors Customer stories Team Enterprise Explore Explore GitHub Learn and contribute Topics Collections Trending Learning Lab Open source guides Connect with others The ReadME Project Events Community forum GitHub Education GitHub Stars program Marketplace Pricing Plans Compare plans Contact Sales Education Sign in Sign up {{ message }} jquery / sizzle Public Notifications Fork 979 Star 6.2k Code Issues 16 Pull requests 2 Actions Wiki Security Insights More Code Issues Pull requests Actions Wiki Security Insights Home Jump to bottom Michał Gołębiowski-Owczarek edited this page Apr 23, 2019 · 22 revisions Pages 2 Home Browser Support Desktop Mobile Selectors CSS3 Other selectors and conventions Changes Additions Form Selector Additions Positional Selector Additions API Public API Sizzle( String selector[, DOMNode context[, Array results]] ) Sizzle.matchesSelector( DOMElement element, String selector ) Sizzle.matches( String selector, Array elements ) Extension API Sizzle.selectors.match.NAME = RegExp Finding Sizzle.selectors.find.NAME = function( match, context, isXML ) {} Filtering Sizzle.selectors.preFilter.NAME = function( match ) {} Sizzle.selectors.filter.NAME: function( element, match[1][, match[2], match[3], ...] ) {} Attributes Sizzle.selectors.attrHandle.LOWERCASE_NAME = function( elem, casePreservedName, isXML ) {} Pseudo-selectors (pseudos) Sizzle.selectors.pseudos.NAME = function( elem ) {} Sizzle.selectors.createPseudo(function) Backwards-compatible plugins for pseudos with arguments Sizzle.selectors.setFilters.LOWERCASE_NAME = function( elements, argument, not ) {} Internal API Sizzle.selectors.cacheLength Sizzle.compile( selector ) Thanks Roadmap Clone this wiki locally Project Home Page | Source Repository | Google Group Discussion Browser SupportNote: Browser support may differ between standalone Sizzle and libraries that include Sizzle. Please report issues on Sizzle's issue tracker, rather than the trackers for disparate libraries. DesktopChrome 16+Edge 12+Firefox 3.6+Internet Explorer 7+1Opera 11.6+Safari 4.0+1Workarounds for Internet Explorer 6 are still in the code but the browser is no longer actively tested. MobileAndroid 2.3+iOS 5.1+To report a bug in any of these browsers, please add an issue with a test case from jsfiddle or jsbin.SelectorsCSS3Sizzle supports virtually all CSS 3 Selectors, including escaped selectors (.foo\+bar), Unicode selectors, and results returned in document order. The only exceptions are those that would require additional DOM event listeners to keep track of the state of elements.As such, the following pseudo-selectors are not supported::hover:active:visited, :linkNote: These CSS3 pseudo-selectors were unsupported prior to version 1.9::target:root:nth-last-child:nth-of-type, :nth-last-of-type, :first-of-type, :last-of-type, :only-of-type:lang()Other selectors and conventionsChangesFull selector lists in :not(); e.g. :not(a.b), :not(div > p), :not(div, p)Nested pseudo-selectors; e.g. :not(:has(div:first-child))Additions[NAME!=VALUE]: Elements whose NAME attribute doesn't match the specified value. Equivalent to :not([NAME=VALUE]).:contains(TEXT): Elements with textContent containing the word 'TEXT'. Case-sensitive.:header: Header elements (h1, h2, h3, h4, h5, h6).:parent: Elements with at least one child node (either text or an element).:selected: (option) elements that are currently selectedForm Selector AdditionsNote: In this context, input, button, select, and textarea are all considered to be input elements.:input: Input elements:button: Input elements that are buttons or have type "button":checkbox, :file, :image, :password, :radio, :reset, :submit, :text: Input elements with the specified typePositional Selector AdditionsIn this context, "positional" refers to an element's placement in the collection after a selection, based on document order. For example, div:first would return an array containing the first div on the page, while div:first em would target the first div on the page and select all em elements within.Note: Positional indexes begin at zero.:first/:last: The first/last matching element:even/:odd: Even/odd-numbered elements:eq/:nth: The nth element; e.g. :eq(5) finds the 6th element:lt/:gt: Elements at positions above/below the specified position APIThe Sizzle API consists of 3 parts:The Public API, which users interact with.The Extension API, for modifications to the selector engine.The Internal API, used internally by Sizzle. Public APISizzle( String selector[, DOMNode context[, Array results]] )The main function for finding elements. Uses querySelectorAll if available.returns (Array): All elements matching the selectorParametersselector: A CSS selectorcontext: An element, document, or document fragment to use as the context for finding elements. Defaults to document.Note: Prior to version 2.1, document fragments were not valid here.results: An array or an array-like object, to which Sizzle will append results. For example, jQuery passes a jQuery collection. An "array-like object" is an object with a nonnegative numeric length property and a push method.Sizzle.matchesSelector( DOMElement element, String selector )Uses native matchesSelector if availablereturns(Boolean): Whether the given element matches the selectorParameterselement: A DOMElement against which Sizzle will test the selectorselector: A CSS selectorSizzle.matches( String selector, Array elements )returns(Array): Elements in the array that match the given selectorParametersselector: A CSS selectorelements: An array of DOMElements to filter against the specified selector Extension APISizzle.selectors.match.NAME = RegExpThis contains the regular expressions used to parse a selector into different parts, to be used for finding and filtering. The name of each of the regular expressions should correspond to the names specified in the Sizzle.selectors.find and Sizzle.selectors.filter objects. FindingIn order to add a new find function:A regular expression must be added to the match object.A function to find must be defined."|" + NAME must be appended to the Sizzle.selectors.order regex.Sizzle.selectors.find.NAME = function( match, context, isXML ) {}A method for finding some elements on a page. The specified function will be called no more than once per selector.match is the array of results returned from matching the specified regex against the selector.context is the DOMElement or DOMDocument from which selection will occur.isXML is a boolean value indicating whether the function is currently operating within an XML document. FilteringIn order to add a new filtering statement:A regular expression must be added to the match object.A function must be added to the filter object.A function may optionally be added to the preFilter object.Sizzle.selectors.preFilter.NAME = function( match ) {}An optional pre-filter function which allows filtering of the matched array against the corresponding regular expression, which will return a new matched array. This matched array will eventually be passed and flattened as arguments against the corresponding filter function. This is intended to clean up some of the repetitive processing that occurs in a filter function.Sizzle.selectors.filter.NAME: function( element, match[1][, match[2], match[3], ...] ) {}Note: match[0] will be deleted prior to being passed to a filter, and must not be used.The arguments for a filter method are the element and the captures from the regex corresponding to this filter (indicated above by what is in the match, starting at index 1). The return result must be boolean: true if the element matches the selector, false if not. AttributesSizzle.selectors.attrHandle.LOWERCASE_NAME = function( elem, casePreservedName, isXML ) {}Handle an attribute which requires specialized processing (such as href, which has cross-browser issues). The return result must be the actual string value of that attribute. Pseudo-selectors (pseudos)Sizzle.selectors.pseudos.NAME = function( elem ) {}The most common extension to a selector engine: adding a new pseudo. The return result from this function must be boolean: true if the element matches the selector, false if not.For example, this defines a simple :fixed pseudo:var $test = jQuery( document );Sizzle.selectors.pseudos.fixed = function( elem ) { $test[ 0 ] = elem; return $test.css( "position" ) === "fixed";};Sizzle.selectors.createPseudo(function)createPseudo is only required if the custom pseudo-selector accepts an argument.Note: In jQuery 1.8 and earlier, the API for creating custom pseudos with arguments was broken. In jQuery 1.8.1+, the API is backwards-compatible. Regardless, the use of createPseudo is greatly encouraged.Now that the parser compiles a single function containing other functions, custom pseudo-selectors with arguments are much cleaner.For example, within Sizzle, the implementation of the :not( ) pseudo is very similar to:Sizzle.selectors.pseudos.not = Sizzle.selectors.createPseudo(function( subSelector ) { var matcher = Sizzle.compile( subSelector ); return function( elem ) { return !matcher( elem ); }; }); Backwards-compatible plugins for pseudos with argumentsIn order to write a custom selector with arguments that can take advantage of the new API, yet still support all versions of Sizzle, check for the createPseudo method.The following example uses jQuery syntax. Live example// An implementation of a case-insensitive contains pseudo// made for all versions of jQuery(function( $ ) {function icontains( elem, text ) { return ( elem.textContent || elem.innerText || $( elem ).text() || "" ).toLowerCase().indexOf( (text || "").toLowerCase() ) > -1;}$.expr.pseudos.icontains = $.expr.createPseudo ? $.expr.createPseudo(function( text ) { return function( elem ) { return icontains( elem, text ); }; }) : function( elem, i, match ) { return icontains( elem, match[3] ); };})( jQuery );Sizzle.selectors.setFilters.LOWERCASE_NAME = function( elements, argument, not ) {}These filters are run after a previous part of a selector has already returned results. setFilters are found from matching Sizzle.selectors.match.POS. When applicable, argument is expected to be an integer. The not argument is a boolean indicating whether the result should be inverted (as in div:not(:first)).For example, the code for the :first setFilter is similar to:var first = function( elements, argument, not ) { // No argument for first return not ? elements.slice( 1 ) : [ elements[0] ];};Sizzle.selectors.setFilters.first = first;It is easy to extend Sizzle -- even Sizzle's POS selectors. For example, to rename :first as :uno:Sizzle.selectors.match.POS = new RegExp( oldPOS.source.replace("first", "uno"), "gi" );Sizzle.selectors.setFilters.uno = Sizzle.selectors.setFilters.first;delete Sizzle.selectors.setFilters.first;Sizzle("div:uno"); // ==> [ ] Internal APINote: Functionality should be accessed via the Public and Extension APIs. While the Internal API is intended specifically for internal use, it has been exposed for edge cases.Sizzle.selectors.cacheLengthSizzle internally caches compiled selector functions and tokenization objects. The length of these caches defaults to 50, but can be set to any positive integer by assigning to this property.Sizzle.compile( selector )This method compiles a selector function and caches it for later use. For example, calling Sizzle.compile(".myWidget:myPseudo") during initialization of a plugin will speed up the first selection of matching elements.returns(Function): The compiled function to be used when filtering the set of possibly matching elementsParametersselector: A CSS selectorThanksSpecial thanks goes out to the following. Without their contributions to the open source community, Sizzle would not be what it is today.Diego Perini and NWMatcher.The creators of the Slick selector engine used in mootools.Samuel Lebeau for writing bouncer, a small bottom-up element matcher. © 2022 GitHub, Inc. Terms Privacy Security Status Docs Contact GitHub Pricing API Training Blog About You can’t perform that action at this time. You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.