zoukankan      html  css  js  c++  java
  • HTML Imports

    为什么需要导入? 先想想你在 web 上是如何加载不同类型的资源。对于 JS,我们有 <script src><link rel="stylesheet"> 应该是 CSS 的首选。图片可以用 <img>。视频则有 <video>。音频,<audio>…… 你明白我在说什么了吧! web 上绝大部分的内容都有简单明了的加载方式。可对于 HTML 呢?下面是可选的几种方案:

    <iframe> - 可用但笨重。iframe 中的内容全部存在于一个不同于当前页的独立上下文中。这是个很棒的特性,但也为开发者们带来了额外的挑战 (将 frame 按照内容尺寸来缩放已经有点难度,在 iframe 和当前页面之间写点 JS 能把人绕晕,更别提操作样式了)。 AJAX - 我喜欢 xhr.responseType="document",可是加载 HTML 要用 JS? 这就不大对劲了。 CrazyHacks™ - 用字符串的方式嵌入页面,像注释一样隐藏 (例如 <script type="text/html">)。呕! 可笑不? 作为 web 上最基础的内容,HTML,竟然需要这么麻烦才能得到我们想要的结果。幸运的是,Web Components 总算找到了一条正确的路。

    开始

    HTML 导入,Web Components 阵容中的一员,是在其他 HTML 文档中包含 HTML 文档的一种方法。当然并非仅限于此,你还可以包含 CSS,JavaScript,或 .html 文件中能包含的任何内容。换句话说,这使得导入成为了加载相关 HTML/CSS/JS 的神器。

    基础

    通过声明 <link rel="import"> 来在页面中包含一个导入 :

    <head>
      <link rel="import" href="/path/to/imports/stuff.html">
    </head>
    

    导入中的 URL 被称为 导入地址。若想跨域导入内容,导入地址必须允许 CORS:

    <!-- 其他域内的资源必须允许 CORS -->
    <link rel="import" href="http://example.com/elements.html">
    

    浏览器的网络协议栈(network stack)会对访问相同 URL 的请求自动去重。这意味着从同一个 URL 导入的内容只会被获取一次。无论这个地址被导入多少次,最终它将只执行一次。

    特性检测与支持

    要检测浏览器是否支持导入,可验证 <link> 元素上是否存在 import:

    function supportsImports() {
      return 'import' in document.createElement('link');
    }
    
    if (supportsImports()) {
      // 支持导入!
    } else {
      // 使用其他的库来加载文件。
    }
    

    目前支持该特性的浏览器比较有限。Chrome 31 最先实现了该特性。你可以在 about:flags 页面中启用 Enable HTML Imports。对于其他浏览器可以使用 Polymer 的 polyfill。

    在 about:flags 中 启用 HTML Imports。 开启 experimental Web Platform features 可以体验 web component 中的其他实验特性。

    打包资源

    可以使用导入将 HTML/CSS/JS (甚至其他 HTML 导入) 打包成一个单独的可传递文件。这是个不容忽视的特点。假设你写了一套主题,库,或仅仅想把你的应用按照逻辑拆分,你也仅需给其他人提供一个 URL。天呐,你甚至可以用导入来传输整个应用,想想这该有多棒。

    仅用一个 URL,你就可以将多个文件打包成一个文件提供给他人使用。 一个现实中的例子是 Bootstrap。Bootstrap 由多个单独的文件组成 (bootstrap.css,bootstrap.js,字体), 它的插件依赖于 jQuery,并提供了带标记的例子。开发者们喜欢拥有像去餐厅点菜一样的灵活性。这允许开发者只加载框架中 他们 想用的内容。

    导入对于类似 Bootstrap 的内容来说意义非凡,下面我将展示未来加载 Bootstrap 的方式:

    <head>
      <link rel="import" href="bootstrap.html">
    </head>
    

    用户只需加载一个 HTML Import 链接。他们再也不用为那些乱七八糟的文件而烦心。相反,整个 Bootstrap 都将包裹在一个导入 bootstrap.html 之中:

    <link rel="stylesheet" href="bootstrap.css">
    <link rel="stylesheet" href="fonts.css">
    <script src="jquery.js"></script>
    <script src="bootstrap.js"></script>
    <script src="bootstrap-tooltip.js"></script>
    <script src="bootstrap-dropdown.js"></script>
    ...
    
    <!-- 脚手架标记 -->
    <template>
      ...
    </template>
    

    让这一切都快点变成现实吧,这玩意简直太棒了!

    Load/error 事件

    当导入成功时 <link> 元素会触发 load 事件,加载失败时 (例如资源出现 404) 则会触发 error。

    导入会尝试立即加载。一个简单的办法是使用 onload/onerror 特性:

    <script async>
      function handleLoad(e) {
        console.log('Loaded import: ' + e.target.href);
      }
      function handleError(e) {
        console.log('Error loading import: ' + e.target.href);
      }
    </script>
    
    <link rel="import" href="file.html"
          onload="handleLoad(event)" onerror="handleError(event)">
    

    注意上面事件处理的定义要早于导入开始加载页面。浏览器一旦解析到导入的标签,它就会立即加载资源。如果此时处理函数不存在,你将在控制台看到函数名未定义的错误。

    或者,你可以动态创建导入:

    var link = document.createElement('link');
    link.rel = 'import';
    link.href = 'file.html'
    link.onload = function(e) {...};
    link.onerror = function(e) {...};
    document.head.appendChild(link);
    

    使用内容

    在页面中包含导入并不意味着 ”把那个文件的内容都塞到这”。它表示 ”解析器,去把这个文档给我取回来好让我用”。若想真正的使用该文档的内容,你得写点脚本。

    当你意识到导入就是一个文档时,你肯定会 啊哈! 一声。事实上,导入的内容被称为 导入文档。你可以 使用标准的 DOM API 来操作导入的内容!

    link.import
    

    若想访问导入的内容,需要使用 link 元素的 import 属性:

    var content = document.querySelector('link[rel="import"]').import;
    

    在下面几种情况下,link.import 值为 null :

    浏览器不支持 HTML 导入。 <link> 没有 rel="import"。 <link> 没有被加入到 DOM 中。 <link> 从 DOM 中被移除。 资源没有开启 CORS。 完整示例

    假设 warnings.html 包含如下内容:

    <div class="warning">
      <style scoped>
        h3 {
          color: red;
        }
      </style>
      <h3>Warning!</h3>
      <p>This page is under construction</p>
    </div>
    
    
    <div class="outdated">
      <h3>Heads up!</h3>
      <p>This content may be out of date</p>
    </div>
    

    你可以获取导入文档中的一部分并把它们复制到当前页面中:

    <head>
      <link rel="import" href="warnings.html">
    </head>
    <body>
      ...
      <script>
        var link = document.querySelector('link[rel="import"]');
        var content = link.import;
    
    
        // 从 warning.html 的文档中获取 DOM。
        var el = content.querySelector('.warning');
    
    
        document.body.appendChild(el.cloneNode(true));
      </script>
    </body>
    

    在导入中使用脚本

    导入的内容并不在主文档中。它们仅仅作为主文档的附属而存在。即便如此,导入的内容还是能够在主页面中生效。导入能够访问它自己的 DOM 或/和包含它的页面中的 DOM:

    示例 - import.html 向主页面中添加它自己的样式表

    <link rel="stylesheet" href="http://www.example.com/styles.css">
    <link rel="stylesheet" href="http://www.example.com/styles2.css">
    ...
    
    
    <script>
      // importDoc 是导入文档的引用
      var importDoc = document.currentScript.ownerDocument;
    
    
      // mainDoc 是主文档(包含导入的页面)的引用
      var mainDoc = document;
    
    
      // 获取导入中的第一个样式表,复制,
      // 将它附加到主文档中。
      var styles = importDoc.querySelector('link[rel="stylesheet"]');
      mainDoc.head.appendChild(styles.cloneNode(true));
    </script>
    

    留意这里的操作。导入中的脚本获得了导入文档的引用 (document.currentScript.ownerDocument),随后将导入文档中的部分内容附加到了主页面中 (mainDoc.head.appendChild(…))。这段代码看起来不怎么优雅。

    导入中的脚本要么直接运行代码,要么就定义个函数留给主页面使用。这很像 Python 中模块定义的方式。

    导入中 JavaScript 的规则: 导入中的脚本会在包含导入文档的 window 上下文中运行。因此 window.document 关联的是主页面文档。这会产生两个有用的推论: 导入中定义的函数最终会出现在 window 上。 你不用将导入文档中的 <script> 块附加到主页面。再重申一遍,脚本会自动执行。 导入不会阻塞主页面的解析。不过,导入文档中的脚本会按照顺序执行。它们对于主页面来说就像拥有了延迟(defer)执行的行为。后面会详细讲解。 传输 Web Component

    HTML 导入的设计很好的契合了在 web 上加载重用资源的需求。尤其是对于分发 Web Component。无论是基本的 HTML <template> 还是十分成熟的自定义元素/Shadow DOM [1,2,3]。当把这些技术结合在一起使用时,导入就充当了 Web Component 中 #include 的角色。 包含模板 HTML Template 元素是 HTML 导入的好搭档。<template> 特别适合于为需要导入的应用搭建必要的标记。将内容包裹在一个 <template> 元素中还为你提供了延迟加载内容的好处。也就是说,在 template 元素加入到 DOM 之前,它包含的脚本不会执行。 import.html

    <template>
      <h1>Hello World!</h1>
      <img src="world.png"> <!-- 只有当模板生效后才会去请求图片 -->
      <script>alert("Executed when the template is activated.");</script>
    </template>
    

    index.html

    <head>
      <link rel="import" href="import.html">
    </head>
    <body>
      <div id="container"></div>
      <script>
        var link = document.querySelector('link[rel="import"]');
    
    
        // 从导入中复制 <template>。
        var template = link.import.querySelector('template');
        var content = template.content.cloneNode(true)
    
    
        document.querySelector('#container').appendChild(content);
      </script>
    </body>
    

    注册自定义元素 自定义元素是 Web Component 技术中的另一位成员,它和 HTML 导入也是出奇的搭配。导入能够运行脚本,既然如此,为什么不定义 + 注册你自己的自定义元素,这样一来用户就避免重复操作了呢? 让我们就叫它..."自动注册(auto-registration)"。

    elements.html

    <script>
      // 定义并注册 <say-hi>。
      var proto = Object.create(HTMLElement.prototype);
    
    
      proto.createdCallback = function() {
        this.innerHTML = 'Hello, <b>' +
                         (this.getAttribute('name') || '?') + '</b>';
      };
    
    
      document.register('say-hi', {prototype: proto});
    
    
      // 定义并注册使用了 Shadow DOM 的 <shadow-element>。
      var proto2 = Object.create(HTMLElement.prototype);
      proto2.createdCallback = function() {
        var root = this.createShadowRoot();
        root.innerHTML = "<style>::content > *{color: red}</style>" +
                         "I'm a " + this.localName +
                         " using Shadow DOM!<content></content>";
      };
      document.register('shadow-element', {prototype: proto2});
    </script>
    

    这个导入定义 (并注册) 了两个元素,<say-hi> 和 <shadow-element>。主页面可以直接使用它们,无需做任何额外操作。

    index.html

    <head>
      <link rel="import" href="elements.html">
    </head>
    <body>
      <say-hi name="Eric"></say-hi>
      <shadow-element>
        <div>( I'm in the light dom )</div>
      </shadow-element>
    </body>
    

    在我看来,这样的工作流程使得 HTML 导入成为了共享 Web Components 的理想方式。 管理依赖和子导入 嘿。听说你挺喜欢导入, 所以我就在你的导入又加了个导入。 子导入(Sub-imports) 若导入能够嵌套将会提供更多便利。例如,如果你想复用或继承另一个组件,使用导入加载其他元素。 下面是 Polymer 中的真实例子。通过复用布局还有选择器组件,我们得到了一个新的选项卡组件 (<polymer-ui-tabs>)。它们的依赖通过 HTML 导入来管理。

    polymer-ui-tabs.html

    <link rel="import" href="polymer-selector.html">
    <link rel="import" href="polymer-flex-layout.html">
    <polymer-element name="polymer-ui-tabs" extends="polymer-selector" ...>
      <template>
        <link rel="stylesheet" href="polymer-ui-tabs.css">
        <polymer-flex-layout></polymer-flex-layout>
        <shadow></shadow>
      </template>
    </polymer-element>
    

    完整源码 应用开发者可以引入这个新元素:

    <link rel="import" href="polymer-ui-tabs.html">
    <polymer-ui-tabs></polymer-ui-tabs>
    

    若以后出现了一个更新,更棒的 <polymer-selector2>,你就可以毫不犹豫的用它替换 <polymer-selector>。多亏有了导入和 web 组件,你再也不用担心惹恼你的用户了。 依赖管理 我们都知道一个页面载入多个 jQuery 会出问题。若是多个组件引用了相同的库,对于 Web 组件来说会不会是个严重的问题? 如果使用 HTML 引用,你就完全不用担心! 导入可以用来管理这些依赖。 将库放进一个 HTML 导入中,就自动避免了重复加载问题。文档只会被解析一次。脚本也只执行一次。来举个例子吧,比如说你定义了一个导入,jquery.html,它会加载 JQuery。 jquery.html

    <script src="http://cdn.com/jquery.js"></script>
    

    这个导入可以被其他导入复用: import2.html

    <link rel="import" href="jquery.html">
    <div>Hello, I'm import 2</div>
    

    ajax-element.html

    <link rel="import" href="jquery.html">
    <link rel="import" href="import2.html">
    <script>
      var proto = Object.create(HTMLElement.prototype);
      proto.makeRequest = function(url, done) {
        return $.ajax(url).done(function() {
          done();
        });
      };
      document.register('ajax-element', {prototype: proto});
    </script>
    

    若主页面也需要这个库,连它也可以包含 jquery.html:

    <head>
      <link rel="import" href="jquery.html">
      <link rel="import" href="ajax-element.html">
    </head>
    <body>
    ...
    <script>
      $(document).ready(function() {
        var el = document.createElement('ajax-element');
        el.makeRequest('http://example.com');
      });
    </script>
    </body>
    

    尽管 jquery.html 被加进了多个导入树中,浏览器也只会获取一次它的文档。查看网络面板就能证明这一切: jquery.html is requested once 性能注意事项 HTML 导入绝对是个好东西,但就像许多其他新技术一样,你得明智的去使用它。Web 开发的最佳实践还是需要遵守。下面是一些需要留意的地方。 合并导入 减少网络请求始终是重点。如果需要很多最顶层的导入,那就考虑把它们合并在一个资源里,然后导入该资源! Vulcanizer 是由 Polymer 团队开发的 npm 构建工具,它能够递归的展开一组 HTML 导入并生成一个单独的文件。可以把它看成构建 Web 组件中合并的步骤。 导入影响浏览器缓存 许多人似乎都忘记了浏览器的网络协议栈经过了多年的精心调整。导入 (包括子导入) 也从中受益。导入 http://cdn.com/bootstrap.html 可能包含子资源,但它们都将被缓存起来。 内容只有在被添加后才是可用的 把导入的内容看成是惰性的,只有当你调用它的服务时它才生效。 看看这个动态创建的样式表:

    var link = document.createElement('link');
    link.rel = 'stylesheet';
    link.href = 'styles.css';
    

    在 link 被加入到 DOM 之前,浏览器不会去请求 styles.css:

    document.head.appendChild(link); // 浏览器请求 styles.css
    

    另一个例子就是动态创建标签:

    var h2 = document.createElement('h2');
    h2.textContent = 'Booyah!';
    

    在你把 h2 添加到 DOM 之前它没有意义。 同样的概念对于导入文档也适用。在你将内容追加到 DOM 之前,它就是一个空操作。实际上,在导入文档中直接 "运行" 的只有 <script>。参见导入中的脚本操作。 优化异步载入 导入不会阻塞主页面解析。导入中的脚本会按照顺序执行,但也不会阻塞主页面。这意味着你在维护脚本顺序时获得了类似于延迟加载的行为。将导入放到 <head> 的好处在于它可以让解析器尽快的去解析导入的内容。即便如此,你还得记得主页面中的 <script> 仍然 会阻塞页面:

    <head>
      <link rel="import" href="/path/to/import_that_takes_5secs.html">
      <script>console.log('I block page rendering');</script>
    </head>
    

    根据你的应用架构和使用场景不同,有几种方法可以优化异步行为。下面要使用的技巧可以缓解对主页面渲染的阻塞。

    场景 #1 (推荐): <head> 中没有脚本或 <body> 没有内联脚本

    我对放置 <script> 的建议就是不要紧跟着你的导入。把它们尽可能远的放置…你肯定早就按照最佳实践这么做了,不是吗!?;)

    看个例子:

    <head>
      <link rel="import" href="/path/to/import.html">
      <link rel="import" href="/path/to/import2.html">
      <!-- 避免在这放脚本 -->
    </head>
    <body>
      <!-- 避免在这放脚本 -->
    
    
      <div id="container"></div>
    
    
      <!-- 避免在这放脚本 -->
      ...
    
    
      <script>
        // 其他的脚本。
    
    
        // 获得导入内容。
        var link = document.querySelector('link[rel="import"]');
        var post = link.import.querySelector('#blog-post');
    
    
        var container = document.querySelector('#container');
        container.appendChild(post.cloneNode(true));
      </script>
    </body>
    

    所有内容都放到底部。

    场景 1.5: 导入添加自己的内容

    另一个选择是让导入添加自己的内容. 若导入的作者和应用开发者之间达成了某种约定,那么导入就可以将它自身加入到主页面的某个位置:

    import.html:

    <div id="blog-post">...</div>
    <script>
      var me = document.currentScript.ownerDocument;
      var post = me.querySelector('#blog-post');
    
    
      var container = document.querySelector('#container');
      container.appendChild(post.cloneNode(true));
    </script>
    

    index.html

    <head>
      <link rel="import" href="/path/to/import.html">
    </head>
    <body>
      <!-- 不需要写脚本。导入会自己处理 -->
    </body>
    

    场景 #2: <head> 或 <body> 中有(内联)脚本

    若某个导入的加载需要耗费很长时间,跟在导入后面的第一个 <script> 将会阻塞页面渲染。以 Google Analytics 为例,它推荐将跟踪代码放在 <head> 中,若你必须将 <script> 放到 <head> 中,那么动态的添加导入将会避免阻塞页面:

    <head>
      <script>
        function addImportLink(url) {
          var link = document.createElement('link');
          link.rel = 'import';
          link.href = url;
          link.onload = function(e) {
            var post = this.import.querySelector('#blog-post');
    
    
            var container = document.querySelector('#container');
            container.appendChild(post.cloneNode(true));
          };
          document.head.appendChild(link);
        }
    
    
        addImportLink('/path/to/import.html'); // 导入被提前添加 :)
      </script>
      <script>
        // 其他脚本
      </script>
    </head>
    <body>
       <div id="container"></div>
       ...
    </body>
    

    或者,将导入放到 <body> 结束处:

    <head>
      <script>
        // 其他脚本
      </script>
    </head>
    <body>
      <div id="container"></div>
      ...
    
    
      <script>
        function addImportLink(url) { ... }
        addImportLink('/path/to/import.html'); // 导入很晚才能被添加 :(
      </script>
    </body>
    

    注意: 不推荐最后的方法。解析器在解析页面结束之前不会去操作导入的内容。

    要点 导入的 MIME 类型是 text/html。

    导入跨域资源需要启用 CORS。

    来自相同 URL 的导入仅获取和解析一次。这表示导入中的脚本只在第一次导入的时候执行。 导入中的脚本按顺序执行,它们不会阻塞主页面解析。 导入链接不代表 "#把内容添加到这里"。它代表 "解析器,去把这个文档取过来,我一会要用"。脚本在导入期间运行,而样式,标记,还有其他资源需要明确的加入到主页面中。这是 HTML 导入和<iframe> 之间的最大区别,后者表示 "在这里加载并渲染资源"。 总结 HTML 导入允许将 HTML/CSS/JS 打包成一个单独资源。这个想法在 Web 组件开发世界中显得极为重要。开发者可以创建重用的组件,其他人通过引入 <link rel="import"> 就能够在自己的应用中使用这些组件。 HTML 导入是个简单的概念,但却促成了许多有趣的使用案例。

    使用案例

    将相关的HTML/CSS/JS 作为一个单独的包 来分发。理论上来说,你可以在应用里面导入一个完整的 web 应用。 代码组织 - 将概念按照逻辑划分为不同的文件,鼓励模块化 & 复用性**。 传输 一或多个自定义元素 的定义。可以在应用内使用导入来注册 和包含自定义元素。这符合良好的软件模式,即将接口/定义与使用分离。 管理依赖 - 自动解决资源的重复加载。 脚本块 - 没有导入之前,一个大型的 JS 库需要在使用前全部解析,这通常很慢。有了导入,只要块 A 解析完毕,库就能够立即使用。延迟更少了!

    <link rel="import" href="chunks.html">:
    <script>/* script chunk A goes here */</script>
    <script>/* script chunk B goes here */</script>
    <script>/* script chunk C goes here */</script>
    

    ... 并行 HTML 解析 - 这是首次能够让浏览器并行运行两个 (或多个) HTML 解析器。

    允许在调试和非调试模式下切换,只需要修改导入的目标。你的应用无需知道导入的目标是打包/编译好的资源还是一棵导入树。

  • 相关阅读:
    SpringMVC工作原理
    Centosyum方式安装nginx
    centos7通过yum安装JDK1.8
    经典SQL语句
    Jquery选择器
    JS获取当前日期并定时刷新
    MyEclipse快捷键大全
    强大的Layui前端框架地址
    MFC 实现来回滚动效果的进度条
    CImageList* 转 LPDISPATCH 在控件中显示图片
  • 原文地址:https://www.cnblogs.com/zoucaitou/p/4377763.html
Copyright © 2011-2022 走看看