翻译的不好，轻拍

Polymer是google的一款前端开发框架，其基于Shadow DOM、Custom Elements、MDV等最新浏览器特性构建，代表了下一代Web框架的方向：一切皆组件、尽量减少代码量、尽量减少框架限制。

名词解释

• Attribute： 元素声明或者创建时需要的属性。
• Property： 属性、元素或者类向外提供的数据区域，例如js对象的属性。
• Polyfill： 指的是通过第三方脚本对老旧浏览器进行的修补，通过这些修补使之能够支持新浏览器的特性。

Web components标准主要由以下3个部分组成：

• Custom Elements
• Shadow DOM
• HTML Imports

元素声明

Polymer的核心是Custom Elements，定义一个Polymer元素和定义一个普通的Custom Elements是差不多的。主要的区别就是Polymer使用polymer-element标签进行声明。

<polymer-element name="tag-name" constructor="TagName">
  <template>
    <!-- 在这里放置shadow DOM -->
  </template>
  <script>Polymer('tag-name');</script>
</polymer-element>

Attrubtes

Polymer在polymer-element标签上预留了一些特殊的attribute。

默认 Attribute

你在polymer-elemnet上设置的其他 attribute 将会自动添加到元素实例上。例如：

<polymer-element name="tag-name" class="active" mycustomattr>
  <template>...</template>
  <script>Polymer('tag-name');</script>
</polymer-element>

当一个tag-name实例被创建的时候，它就会自带两个默认 attribute ： class="active"和mycustomattr。

<tag-name class="active" mycustomattr></tag-name>

Attribute大小写

HTML解析器对 attribute 大小写敏感是没有必要的，但是Javascript却对大小写敏感。

书写时你可以忽略属性名的大小写，但是当你运行并查看元素的属性列表时，属性名永远都是小写的，Polymer会谨慎的将* property* 和 attribute 一一配对。例如：

<name-tag nameColor="blue" name="Blue Name"></name-tag>

在DOM中nameColor是小写的，并且通常都会被忽略不处理。

下面例子也都会正常工作：

<name-tag NaMeCoLoR="blue" name="Blue Name"></name-tag>
<name-tag NAMECOLOR="red" name="Red Name"></name-tag>
<name-tag NAMEcolor="green" name="Green Name"></name-tag>

其它声明元素的方法

考虑到重构的需要，我们有时候不会将脚本放置在元素标签里,而是独立成一个文件。Polymer元素也可以通过外部脚本中调用Polymer('tag-name')来创建。

<!-- 1. 在元素声明内部添加外部脚本 -->
<polymer-element name="tag-name">
  <template>...</template>
  <script src="path/to/tagname.js"></script>
</polymer-element>

<!-- 2. 在元素声明之前添加外部脚本 -->
<script src="path/to/tagname.js"></script>
<polymer-element name="tag-name">
  <template>...</template>
</polymer-element>

<!-- 3. 没有脚本 -->
<polymer-element name="tag-name" constructor="TagName" noscript>
  <template>
    <!-- shadow DOM here -->
  </template>
</polymer-element>

快速注册

元素也可以只通过JS来注册：

<script>
  Polymer('name-tag', {nameColor: 'red'});
  var el = document.createElement('div');
  el.innerHTML = '\
    <polymer-element name="name-tag" attributes="name">\
      <template>\
        Hello <span style="color:{{nameColor}}">{{name}}</span>\
      </template>\
    </polymer-element>';
  //如果不将这个元素声明放入DOM内的话，custom elements的polyfill就找不到它。
  document.body.appendChild(el);
</script>



<name-tag name="John"></name-tag>

需要注意的是，要将polymer-element放入DOM中，这样custom element的polyfill才能找到它。

添加公开的property和方法

如果你想要定义一些方法或者 property 时（可选），在Polymer()的第二个参数中传递包含定义信息的对象即可。

下面这个例子中，定义了一个property： message ， 一个使用到了ES5 getter特性的property： greeting， 还有一个方法：foo。

<polymer-element name="tag-name">
  <template></template>
  <script>
    Polymer('tag-name', {
      message: "Hello!",
      get greeting() {
        return this.message + ' there!';
      },
      foo: function() {...}
    });
  </script>
</polymer-element>

注释： this是这个Polymer元素在自己内部他本身的引用。例如：this.localName == 'tag-name'.

注意： 当元素的property是一个js对象或者数组时需要注意，由于prototype的一些特性，你可能会在同一类元素的不同实体中，陷入shared state问题。如果你想初始化一个property为对象或者数组的时候，不要在prototype中赋值，而应该在created回调中赋值。

// 正确
Polymer('x-foo', {
  created: function() {
    this.list = []; // Initialize and hint type to be array.
    this.person = {}; // Initialize and hint type to an object.
  }
});

// 错误
Polymer('x-foo', {
  list: [], // Don't initialize array or objects on the prototype.
  person: {}
});

添加私有或者静态property

如果需要私有对象的话，将Polymer()放置在匿名自调函数里即可。

<polymer-element name="tag-name">
  <template>...</template>


<script>
    (function() {
      // 只会运行一次
      var foo_ = new Foo();

      // 每一个实例创建时都会运行
      Polymer('tag-name', {
        get foo() { return foo_; }
      });
    })();
  </script>


</polymer-element>

支持全局变量

有时候你希望定义一个全局变量，并且在不同的元素中使用它。比如你会定义一个配置信息，然后在其它部件中引用这个配置。或者一个运动曲线用于处理不同的动画效果，或者一个变量用于保存当前登录用户的信息。

你可以使用MonoState Pattern来实现这个目标。当定义一个Polymer元素时，定义一个闭包，将需要的变量放入进去，然后在元素的prototype上设置访问器，或者在构造器里把他们赋值到不同的实例上。

<polymer-element name="app-globals">


<script>
  (function() {
    var firstName = 'John';
    var lastName = 'Smith';

    Polymer('app-globals', {
       ready: function() {
         this.firstName = firstName;
         this.lastName = lastName;
       }
    });
  })();
  </script>


</polymer-element>

然后像使用其他元素一样把它放置到另一个元素声明里，将需要的property绑定到实例上，这样就可以使用Polymer的数据绑定技术来访问它了。

<polymer-element name="my-component">
  <template>
    <app-globals id="globals"></app-globals>
    <div id="firstname"></div>
    <div id="lastname"></div>
  </template>
  <script>
    Polymer('my-component', {
      ready: function() { this.globals = this.$.globals; }
     });
  </script>
</polymer-element>

只要做一些轻微的调整，就可以在外部配置全局变量的值了。

<polymer-element name="app-globals">


<script>
  (function() {
    var values = {};

    Polymer('app-globals', {
       ready: function() {
         for (var i = 0; i < this.attributes.length; ++i) {
           var attr = this.attributes[i];
           values[attr.nodeName] = attr.nodeValue;
         }
       }
    });
  })();
  </script>


</polymer-element>

在主页中，专递 attribute 就可以配置全局变量了。

<app-globals firstName="Addy" lastName="Osmani"></app-globals>

元素生命周期方法

Polymer对于元素声明周期回调有着一流的支持，为了方便，回调函数都用了简短的名称。

所有这些回调都是可选的：

Polymer('tag-name', {
  created: function() { ... },
  ready: function() { ... },
  attached: function () { ... },
  domReady: function() { ... },
  detached: function() { ... },
  attributeChanged: function(attrName, oldVal, newVal) {
    //var newVal = this.getAttribute(attrName);
    console.log(attrName, 'old: ' + oldVal, 'new:', newVal);
  },
});

下面是custom elements和Polymer元素的生命周期方法的对照表：

polymer-ready 事件

Polymer通过异步的方式来处理自定义元素定义和升级。如果你在元素还没有升级的时候，就通过DOM来获取它，你只会得到一个HTMLUnknownElement。Polymer元素有时还会使用外部元素，例如css，如果他们还没有完全加载完毕，就可能引起FOUC的问题。为了避免FOUC，Polymer只有在css等资源全部加载完毕之后才会注册元素。

通过polymer-ready事件就可以得知元素何时注册/升级完。

<head>
  <link rel="import" href="path/to/x-foo.html">
</head>
<body>
  <x-foo></x-foo>
  <script>
    window.addEventListener('polymer-ready', function(e) {
      var xFoo = document.querySelector('x-foo');
      xFoo.barProperty = 'baz';
    });
  </script>
</body>