- .before()
- .before( content [, content ] ) Возвращает: jQuery
- Добавлен в версии: 1.0 .before( content [, content ] )
- Добавлен в версии: 1.4 .before( function )
- Добавлен в версии: 1.10 .before( function-html )
- Additional Arguments
- Дополнительные замечания:
- .before()
- .before( content [, content ] ) Returns: jQuery
- version added: 1.0 .before( content [, content ] )
- version added: 1.4 .before( function )
- version added: 1.10-and-2.0 .before( function-html )
- Additional Arguments
- Additional Notes:
- Examples:
- Работа с CSS псевдоэлементами через JavaScript и jQuery
- Использование JavaScript
- Использование jQuery
- jQuery before() Method
- Syntax
- Try it Yourself - Examples
- COLOR PICKER
- Report Error
- Thank You For Helping Us!
.before()
.before( content [, content ] ) Возвращает: jQuery
Описание: Функция помещает заданное содержимое перед определенными элементами страницы.
Добавлен в версии: 1.0 .before( content [, content ] )
HTML string, DOM element, text node, array of elements and text nodes, or jQuery object to insert before each element in the set of matched elements.
One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert before each element in the set of matched elements.
Добавлен в версии: 1.4 .before( function )
A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
Добавлен в версии: 1.10 .before( function-html )
A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
The .before() and .insertBefore() methods perform the same task. The major difference is in the syntax—specifically, in the placement of the content and target. With .before() , the content to be inserted comes from the method’s argument: $(target).before(contentToBeInserted) . With .insertBefore() , on the other hand, the content precedes the method and is inserted before the target, which in turn is passed as the .insertBefore() method’s argument: $(contentToBeInserted).insertBefore(target) .
Consider the following HTML:
div class="container">
h2>Greetings h2>
div class="inner">Hello div>
div class="inner">Goodbye div>
div>
You can create content and insert it before several elements at once:
Each inner element gets this new content:
div class="container">
h2>Greetings h2>
p>Test p>
div class="inner">Hello div>
p>Test p>
div class="inner">Goodbye div>
div>
You can also select an element on the page and insert it before another:
If an element selected this way is inserted into a single location elsewhere in the DOM, it will be moved before the target (not cloned):
h2>Greetings h2>
div class="container">
div class="inner">Hello div>
div class="inner">Goodbye div>
div>
Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.
Additional Arguments
Similar to other content-adding methods such as .prepend() and .after() , .before() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.
For example, the following will insert two new s and an existing before the first paragraph:
var newdiv1 = $( " " ),
newdiv2 = document.createElement( "div" ),
existingdiv1 = document.getElementById( "foo" );
$( "p" ).first().before( newdiv1, [ newdiv2, existingdiv1 ] );
Since .before() can accept any number of additional arguments, the same result can be achieved by passing in the three s as three separate arguments, like so: $( «p» ).first().before( $newdiv1, newdiv2, existingdiv1 ) . The type and number of arguments will largely depend on how you collect the elements in your code.
Дополнительные замечания:
- Prior to jQuery 1.9, .before() would attempt to add or change nodes in the current jQuery set if the first node in the set was not connected to a document, and in those cases return a new jQuery set rather than the original set. The method might or might not have returned a new result depending on the number or connectedness of its arguments! As of jQuery 1.9, .after() , .before() , and .replaceWith() always return the original unmodified set. Attempting to use these methods on a node without a parent has no effect—that is, neither the set nor the nodes it contains are changed.
- By design, any jQuery constructor or method that accepts an HTML string — jQuery(), .append(), .after(), etc. — can potentially execute code. This can occur by injection of script tags or use of HTML attributes that execute code (for example, ). Do not use these methods to insert strings obtained from untrusted sources such as URL query parameters, cookies, or form inputs. Doing so can introduce cross-site-scripting (XSS) vulnerabilities. Remove or escape any user input before adding content to the document.
.before()
.before( content [, content ] ) Returns: jQuery
Description: Insert content, specified by the parameter, before each element in the set of matched elements.
version added: 1.0 .before( content [, content ] )
HTML string, DOM element, text node, array of elements and text nodes, or jQuery object to insert before each element in the set of matched elements.
One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert before each element in the set of matched elements.
version added: 1.4 .before( function )
A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, this refers to the current element in the set.
version added: 1.10-and-2.0 .before( function-html )
A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, this refers to the current element in the set.
The .before() and .insertBefore() methods perform the same task. The major difference is in the syntax—specifically, in the placement of the content and target. With .before() , the content to be inserted comes from the method’s argument: $(target).before(contentToBeInserted) . With .insertBefore() , on the other hand, the content precedes the method and is inserted before the target, which in turn is passed as the .insertBefore() method’s argument: $(contentToBeInserted).insertBefore(target) .
Consider the following HTML:
div class="container">
h2>Greetings h2>
div class="inner">Hello div>
div class="inner">Goodbye div>
div>
You can create content and insert it before several elements at once:
Each inner element gets this new content:
div class="container">
h2>Greetings h2>
p>Test p>
div class="inner">Hello div>
p>Test p>
div class="inner">Goodbye div>
div>
You can also select an element on the page and insert it before another:
If an element selected this way is inserted into a single location elsewhere in the DOM, it will be moved before the target (not cloned):
h2>Greetings h2>
div class="container">
div class="inner">Hello div>
div class="inner">Goodbye div>
div>
Important: If there is more than one target element, however, cloned copies of the inserted element will be created for each target except for the last one.
Additional Arguments
Similar to other content-adding methods such as .prepend() and .after() , .before() also supports passing in multiple arguments as input. Supported input includes DOM elements, jQuery objects, HTML strings, and arrays of DOM elements.
For example, the following will insert two new s and an existing before the first paragraph:
var newdiv1 = $( "
newdiv2 = document.createElement( "div" ),
existingdiv1 = document.getElementById( "foo" );
$( "p" ).first().before( newdiv1, [ newdiv2, existingdiv1 ] );
Since .before() can accept any number of additional arguments, the same result can be achieved by passing in the three s as three separate arguments, like so: $( "p" ).first().before( $newdiv1, newdiv2, existingdiv1 ) . The type and number of arguments will largely depend on how you collect the elements in your code.
Additional Notes:
- Prior to jQuery 1.9, .before() would attempt to add or change nodes in the current jQuery set if the first node in the set was not connected to a document, and in those cases return a new jQuery set rather than the original set. The method might or might not have returned a new result depending on the number or connectedness of its arguments! As of jQuery 1.9, .after() , .before() , and .replaceWith() always return the original unmodified set. Attempting to use these methods on a node without a parent has no effect—that is, neither the set nor the nodes it contains are changed.
- By design, any jQuery constructor or method that accepts an HTML string — jQuery(), .append(), .after(), etc. — can potentially execute code. This can occur by injection of script tags or use of HTML attributes that execute code (for example, ). Do not use these methods to insert strings obtained from untrusted sources such as URL query parameters, cookies, or form inputs. Doing so can introduce cross-site-scripting (XSS) vulnerabilities. Remove or escape any user input before adding content to the document.
Examples:
Inserts some HTML before all paragraphs.
Работа с CSS псевдоэлементами через JavaScript и jQuery
Часто разработчики сталкиваются с необходимостью манипулировать CSS псевдоэлементами, такими как ::before или ::after , через JavaScript или jQuery. Например, в стилевом файле CSS может быть правило, которое добавляет псевдоэлемент ::after с определенным содержимым к элементам с классом example :
Возникает задача изменить это содержимое с ‘original content’ на ‘new content’ с использованием JavaScript или jQuery. К сожалению, прямое взаимодействие с псевдоэлементами ::before и ::after через JavaScript или jQuery невозможно, так как они не являются частью DOM.
Однако есть обходные способы решения этой задачи.
Использование JavaScript
Один из подходов — изменить CSS-правила для псевдоэлемента ::after через JavaScript. Можно добавить новое правило в стилевой элемент на странице:
let style = document.createElement('style'); style.innerHTML = ` .example::after < content: 'new content'; >`; document.head.appendChild(style);В этом случае, когда браузер перерисовывает страницу, он найдет новое CSS-правило и применит его, заменяя содержимое псевдоэлемента ::after на ‘new content’.
Использование jQuery
С помощью jQuery можно воспользоваться методом .css() , чтобы изменить CSS-свойства элемента. Однако, как уже отмечалось, псевдоэлементы не являются частью DOM, и изменение их свойств напрямую не будет работать.
Вместо этого можно изменить CSS-класс самого элемента, а затем в CSS-файле определить новый класс с нужным свойством content для псевдоэлемента ::after :
Это решение требует некоторой предварительной подготовки и хорошо подходит для ситуаций, когда возможные значения content известны заранее.
jQuery before() Method
The before() method inserts specified content in front of (before) the selected elements.
Tip: To insert content after selected elements, use the after() method.
Syntax
- HTML elements
- jQuery objects
- DOM elements
- index - Returns the index position of the element in the set
Try it Yourself - Examples
Insert content using a function
How to use a function to insert content before selected elements.
COLOR PICKER
Report Error
If you want to report an error, or if you want to make a suggestion, do not hesitate to send us an e-mail:
Thank You For Helping Us!
Your message has been sent to W3Schools.
Top Tutorials
Top References
Top Examples
Get Certified
W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookie and privacy policy.