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

    获取集合中第一个匹配元素的HTML内容或设置每一个匹配元素的html内容。

    Contents:

    • .html()
      • html()
    • .html(htmlString)
      • html(htmlString)
      • html(function(index, oldhtml))

    html()

    获取集合中第一个匹配元素的HTML内容

    • .html()
      • 这个方法不接收任何元素。

    获取集合中第一个匹配元素的HTML内容

    在一个 HTML 文档中,我们可以使用.html()方法来获取任意一个元素的内容。如果选择器匹配多个元素,那么只有第一个匹配元素的 HTML 内容会被获取。考虑下面的代码:

    $('div.demo-container').html();
    

    下文的获取的<div>的内容,必定是在文档中的第一个的div中获取的:

    <div class="demo-container">
      <div class="demo-box">Demonstration Box</div>
      </div>
    

    结果如下:

    <div class="demo-box">Demonstration Box</div>
    

    这种方法使用浏览器的innerHTML属性。有些浏览器返回的结果可能不是原始文档的 HTML 源代码。例如,如果属性值只包含字母数字字符,Internet Explorer有时丢弃包裹属性值的引号。

    例子

    点击段落将HTML转化为文本

    <!DOCTYPE html>
    <html>
    <head>
      <style>
      p { margin:8px; font-size:20px; color:blue;
          cursor:pointer; }
      b { text-decoration:underline; }
      button { cursor:pointer; }
      </style>
      <script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script>
    </head>
    <body>
      <p>
        <b>Click</b> to change the <span id="tag">html</span>
      </p>
      <p>
        to a <span id="text">text</span> node.
      </p>
      <p>
        This <button name="nada">button</button> does nothing.
      </p>
    <script>
    $("p").click(function () {
      var htmlStr = $(this).html();
      $(this).text(htmlStr);
    });
    </script>
     
    </body>
    </html>
    

    html(htmlString)

    设置每一个匹配元素的html内容。

    • .html(htmlString)
      • htmlString类型: String。用来设置每个匹配元素的一个HTML 字符串。
    • .html(function(index, oldhtml))
      • function(index, oldhtml)类型:Function()。用来返回设置HTML内容的一个函数。接收元素的索引位置和元素原先的HTML作为参数。jQuery的调用这个函数之前会清空元素;使用oldhtml参数引用先前的内容。在这个函数中,this指向元素集合中的当前元素。

    这个.html()方法对 XML 文档无效.

    我们可以使用.html()来设置元素的内容,这些元素中的任何内容会完全被新的内容取代。此外,用新的内容替换这些元素前,jQuery从子元素删除其他结构,如数据和事件处理程序。(注:这样可以防止内存溢出。)

    考虑以下的HTML:

    <div class="demo-container">
      <div class="demo-box">Demonstration Box</div>
    </div>
    

    我们可以像这样设置<div>的HTML内容:

    $('div.demo-container')
      .html('<p>All new content. <em>You bet!</em></p>');
    

    这行代码将替换<div>里的所有内容

    <div class="demo-container">
      <p>All new content. <em>You bet!</em></p>
    </div>
    

    在 jQuery 1.4中,.html()方法允许我们通过函数来传递HTML内容。

    $('div.demo-container').html(function() {
      var emph = '<em>' + $('p').length + ' paragraphs!</em>';
      return '<p>All new content for ' + emph + '</p>';
    });
    

    给定一个拥有6个段落的HTML文档,在这个例子中将设置<p>All new content for <em>6 paragraphs!</em></p><div>的新HTML内容。

    这种方法使用浏览器的innerHTML属性。有些浏览器可能不完全复制所提供的HTML源代码生成DOM。例如,Internet Explorer的版本8之前转换所有链接的href属性为绝对URL路径,和Internet Explorer第9版之前,不增加一个单独的兼容层的情况下,将无法正确处理HTML5元素。

    注意:在Internet Explorer中,包括第9版,设置HTML元素的文本内容可能会破坏其子节点的文本节点,结果导致子节点的文本节点从文档中被删除。如果你想保留这些 DOM 元素的引用,需要他们将保持不变,请使用.empty().html(string)来代替.html(string),以便从文档中删除元素之前的元素被分配到新的字符串。

    例子

    为每个div设置一些内容。

    <!DOCTYPE html>
    <html>
    <head>
      <style>
      .red { color:red; }
      </style>
      <script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script>
    </head>
    <body>
      <span>Hello</span>
      <div></div>
      <div></div>
      <div></div>
    <script>$("div").html("<span class='red'>Hello <b>Again</b></span>");</script>
     
    </body>
    </html>
    

    添加了一些html到每个div,然后立刻做进一步的操作来插入的HTML。

    <!DOCTYPE html>
    <html>
    <head>
      <style>
      div { color:blue; font-size:18px; }
      </style>
      <script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script>
    </head>
    <body>
      <div></div>
      <div></div>
      <div></div>
    <script>
        $("div").html("<b>Wow!</b> Such excitement...");
        $("div b").append(document.createTextNode("!!!"))
                  .css("color", "red");
    </script>
     
    </body>
    </html>
    

    下篇:text()