• 首页
  • css3教程
  • html5教程
  • jQuery手册
  • php7教程
  • MySQL手册
  • apache手册
  • appendTo()

    将匹配的元素插入到目标元素的最后面。

    .appendTo(target)

    target类型: Selector, Element, jQuery。一个选择符,元素,HTML字符串,DOM元素数组,或者jQuery对象;符合的元素们会被插入到由参数指定的目标的末尾。

    .append().appendTo()两种方法功能相同,主要的不同是语法——内容和目标的位置不同。对于.append(),选择表达式在函数的前面,参数是将要插入的内容。对于.appendTo()刚好相反,内容在方法前面,无论是一个选择器表达式或创建作为标记上的标记,它都将被插入到目标容器的末尾。

    请看下面的HTML:

    <h2>Greetings</h2>
    <div class="container">
      <div class="inner">Hello</div>
      <div class="inner">Goodbye</div>
    </div>
    

    我们可以创建内容然后同时插入到好几个元素里面:

    $('<p>Test</p>').appendTo('.inner');
    

    每个新的inner <div>元素会得到新的内容:

    <h2>Greetings</h2>
    <div class="container">
      <div class="inner">
        Hello
        <p>Test</p>
      </div>
      <div class="inner">
        Goodbye
        <p>Test</p>
      </div>
    </div>
    

    我们也可以在页面上选择一个元素然后插在另一个元素里面:

    $('h2').appendTo($('.container'));
    

    如果这种方式选择的元素被插入到一个DOM中单一的位置的地方(注:文档中只有一个目标元素),它将被移动到目标中(不是克隆),并返回一组新的插入后的元素集合:

    <div class="container">
      <div class="inner">Hello</div>
      <div class="inner">Goodbye</div>
      <h2>Greetings</h2>
    </div>
    

    如果有多个目标元素,内容将被复制然后按顺序插入到每个目标里面。新的集合(原始元素加克隆元素)被返回。


    在jQuery 1.9之前, append-to-element-element案例没有创建一个新集合,而是返回了原始集合,这使得.end()在与未知数量的元素一起使用时,很难可靠地使用该方法。

    补充笔记:

    • 通过设计,它接受的HTML字符串的jQuery任何构造或方法-jQuery(),.append(),.after()等-可以潜在地执行代码。这可以通过注入脚本标签或使用执行代码的HTML属性(例如,<img onload="">)来发生。请勿使用这些方法插入从不受信任的来源(例如URL查询参数,cookie或表单输入)获得的字符串。这样做可能会引入跨站点脚本(XSS)漏洞。在向文档添加内容之前,请删除或转义任何用户输入。
    • jQuery并不正式支持SVG。除非为该方法明确记录,否则在SVG文档上使用jQuery方法可能会导致意外行为。从jQuery 3.0开始支持SVG的方法示例包括addClassremoveClass


    例子

    将所有的 span 插入到 ID 为"foo"的元素内的末尾。

    <!doctype html>
    <html lang="en">
    <head>
      <meta charset="utf-8">
      <title>appendTo demo</title>
      <style>
      #foo {
        background: yellow;
        padding:10px;
        width:20em;
      }
      </style>
      <script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script>
    </head>
    <body>
     
    <span style="color:blue;">I have nothing more to say... </span> 
    <div id="foo">FOO! </div>
     
    <script>
    $( "span" ).appendTo( "#foo" );
    </script>
     
    </body>
    </html>
    
    I have nothing more to say...
    FOO!

    上篇:append()

    下篇:text()