.before( content [, content ] )返回: jQuery
描述: 根据参数设定,在匹配元素的前面插入内容(译者注:外部插入)
- 
        
添加的版本: 1.0.before( content [, content ] )
- 
                contentHTML字符串,DOM 元素,文本节点,元素和文本节点的数组,或者jQuery对象,用来插入到集合中每个匹配元素的前面(注:外部插入)。
 - 
                content一个或多个附加的DOM元素,文本节点,元素和文本节点的数组,HTML字符串,或jQuery对象,用来插入到集合中每个匹配元素的前面(注:外部插入)。
 
 - 
                
 - 
        
添加的版本: 1.4.before( function )
- 
                function一个返回HTML字符串,DOM元素(或多个),文本节点(或多个),或jQuery对象的函数,返回的内容用来插入到集合中每个匹配元素的前面(注:外部插入)。 接收元素集合中该元素的索引位置作为一个参数(index 参数)。在函数中
this指向元素集合中的当前元素。 
 - 
                
 - 
        
添加的版本: 1.10.before( function-html )
- 
                function一个返回HTML字符串,DOM元素(或多个),文本节点(或多个),jQuery对象的函数,返回的内容用来插入到集合中每个匹配元素的前面(注:外部插入)。接收元素集合中该元素的索引位置(注:index 参数)和元素的原来HTML值(注:html 参数)作为参数。在函数中
this指向元素集合中的当前元素。 
 - 
                
 
.before() 和.insertBefore()实现同样的功能。主要的不同是语法——内容和目标的位置不同。
        对于.before(),要插入的内容来自方法的参数:$(target).before(contentToBeInserted)
        (注:即,选择器表达式在方法的前面,参数是将要插入的内容)  。
        对于.insertBefore(),
        刚好相反,内容在方法前面并且插入到目标的前面,
        而目标是传递给.insertBefore()方法的参数: $(contentToBeInserted).insertBefore(target)。
请看下面的HTML:
| 
          
             1 
          
            2 
          
            3 
          
            4 
          
            5 
          
         | 
        
          
  | 
      
你可以创建内容然后同时插入到多个元素前面:
| 
          
             1 
          
         | 
        
          
  | 
      
    每个新的inner <div>元素会得到新的内容:
| 
          
             1 
          
            2 
          
            3 
          
            4 
          
            5 
          
            6 
          
            7 
          
         | 
        
          
  | 
      
你也可以在页面上选择一个元素然后插在另一个元素前面:
| 
          
             1 
          
         | 
        
          
  | 
      
如果这样,一个被选中的元素插入被到DOM中的一个别的位置, 它将移动到目标的前面(而不是克隆):
| 
          
             1 
          
            2 
          
            3 
          
            4 
          
            5 
          
         | 
        
          
  | 
      
重要提示: 如果有多个目标元素,将要为每个目标元素创建插入元素的克隆副本,除了最后一个。 然而,对于除了最后一个每个目标将要创建的插入元件的克隆副本。
在jQuery 1.4中, .before()和.after()同样对脱离文档的DOM节点(注:脱离文档的DOM节点,即,可能时javascript动态创建的,还没被插入到html文档中)有效:
| 
          
             1 
          
         | 
        
          
  | 
      
结果是一个jQuery集合包含一个段落和一个 div(按此顺序)。
Additional Arguments(额外的参数)
      类似的其他内容的添加方法  如.prepend() 和 .after() ,.before()还支持传递输入多个参数。支持的输入包括DOM元素,jQuery对象,HTML字符串,DOM元素的数组。
例如,下面将插入两个新的<div>和现有的<div>到 第一个段落:
| 
          
             1 
          
            2 
          
            3 
          
            4 
          
            5 
          
         | 
        
          
  | 
      
.before() 可以接受任何数量的额外的参数,所以上面的例子中,也可以将三个独立的 <div> 分别作为参数传给该方法,就像这样$('p').first().before($newdiv1, newdiv2, existingdiv1)。参数的类型和数量
将在很大程度上取决于在代码中被收集的元素。
      
其他注意事项:
- 在此之前的jQuery1.9,  如果该集合中的第一个节点没有在文档中,
            
.before()将尝试添加 或 在当前的jQuery集合改变节点,在这种情况下返回一个新的jQuery集合,而不是原来的集合。 该方法可能会或可能不会返回一个新的结果,这取决于它的参数个数或参数的连贯性! 从jQuery1.9开始,.after(),.before(), 和.replaceWith()总是返回原始未修改的集合。 试图在一个没有父级元素的节点上使用这些方法是没有效果的,也就是说,集合和它包含的节点都不会改变。 -  设计上,任何jQuery的构造或方法,都接受一个HTML字符串(作为参数) - jQuery(),
                            .append(), .after()等 -
                可以潜在地执行代码。   这可能会出现注入script标签或使用HTML属性
                 执行的代码(例如,
<img onload="">)。 不要使用这些方法来插入来自不受信任的来源,如网址查询参数,Cookie或表单输入获得的字符串。 这样做可能会引起跨站点脚本(XSS)漏洞。 将内容添加到文档之前删除或避开用户任何输入内容。 
例子:
Example: 在所有段落前插入一些HTML。
| 
          
             1 
          
            2 
          
            3 
          
            4 
          
            5 
          
            6 
          
            7 
          
            8 
          
            9 
          
            10 
          
            11 
          
            12 
          
         | 
        
          
  | 
      
Demo:
Example: 在所有段落前插入一个DOM元素。
| 
          
             1 
          
            2 
          
            3 
          
            4 
          
            5 
          
            6 
          
            7 
          
            8 
          
            9 
          
            10 
          
            11 
          
            12 
          
         | 
        
          
  | 
      
Demo:
Example: 在所有段落前插入一个jQuery对象(类似于一个DOM元素数组)。
| 
          
             1 
          
            2 
          
            3 
          
            4 
          
            5 
          
            6 
          
            7 
          
            8 
          
            9 
          
            10 
          
            11 
          
            12 
          
         | 
        
          
  |