Ember.js 入门指南——自定义包裹组件的HTML标签

按照惯例，先作好准备工做，使用Ember CLI命令生成演示所需的文件：

       ember g route customizing-component-element

ember g component customizing-component-element

ember g route home

ember g route about

 

默认状况下，组件会被包裹在div标签内。好比，组件渲染以后获得下面的代码：

<div id="ember180">
  <h1>My Component</h1>
</div>

h1标签就是组件的内容。以“ember”开头的id和class都是Ember自动生成的。若是你须要修改渲染以后生成的HTML不是被包裹在div标签，或者修改id和class等属性值为自定义的值，你能够在组件类中设置。

 

1，自定义包裹组件的HTML标签

       默认状况下，组件会被包裹在div标签内，若是你须要修改这个默认值你能够在组件类中指定这个包裹的HTML标签。

//  app/components/customizing-component-element.js
 
import Ember from 'ember';
 
export default Ember.Component.extend({
       // 使用tabName属性指定渲染以后HTML标签
       // 注意属性的值必须是标准的HTML标签名
       tagName: 'nav'
});

 

       下面自定义一个组件。

<!--  app/templates/components/customizing-component-element.hbs  -->
 
<ul>
       <li>{{#link-to 'home'}}Home{{/link-to}}</li>
       <li>{{#link-to 'about'}}About{{/link-to}}</li>
</ul>

 

       下面是调用组件的模板代码。注意组件被包裹在那个HTML标签内，正确状况下应该是被包裹在nav标签中。

<!--  app/templates/customizing-component-element.hbs  -->
 
{{customizing-component-element}}

     页面加载以后查看页面的源代码。以下：

能够看到组件customizing-component-element的内容确实是被包裹在nav标签之中，若是在组件类中没有使用属性tagName指定包裹的HTML标签，默认是div，你能够把组件类中tagName属性删除以后再查看页面的HTML源码代码。

 

2，自定义包裹组件的HTML元素的类名

       默认状况下，Ember会自动为包裹组件的HTML元素增长一个以“ember”开头的类名，若是你须要增长自定义的CSS类，能够在组件类中使用className数组属性指定，能够一次性指定多个CSS类。好比下面的代码例子：

//  app/components/customizing-component-element.js
 
import Ember from 'ember';
 
export default Ember.Component.extend({
       // 使用tabName属性指定渲染以后HTML标签
       // 注意属性的值必须是标准的HTML标签名
       tagName: 'nav',
       classNames: ['primary', 'my-class-name']  //指定包裹元素的CSS类
});

 

       页面从新加载以后查看源代码，能够看到nav标签中多了两个CSS类，一个是primary，一个是my-class-name。

<nav id="ember411" class="ember-view primary my-class-name">
……
</nav>

 

       若是你想根据某个数据的值决定是否增长CSS类也是能够作到的，好比下面的代码，当urgent为true的时增长一个CSS类urgent，不然不增长这个类。要达到这个目的能够经过属性classNameBindings设置。

//  app/components/customizing-component-element.js
 
import Ember from 'ember';
 
export default Ember.Component.extend({
       // 使用tabName属性指定渲染以后HTML标签
       // 注意属性的值必须是标准的HTML标签名
       tagName: 'nav',
       classNames: ['primary', 'my-class-name'],  //指定包裹元素的CSS类
       classNameBindings: ['urgent'],
       urgent: true
});

       页面从新加载以后查看源代码，能够看到nav标签中多了一个CSS类urgent，若是属性urgent的值为false，CSS类urgent将不会渲染到nav标签上。

<nav id="ember411" class="ember-view primary my-class-name urgent">
……
</nav>

注意：classNameBindings指定的属性值必需要跟用于判断数据的属性名一致，好比这个例子中classNameBindings指定的属性值是urgent，用户判断是否增长类的属性也是urgent。若是这个属性只是驼峰式命名的那么渲染以后CSS类名将是以中划线“-”分隔，好比classNameBindings指定一个名为secondClassName，渲染后的CSS类为second-class-name。好比下面的演示代码：

//  app/components/customizing-component-element.js
 
import Ember from 'ember';
 
export default Ember.Component.extend({
       // 使用tabName属性指定渲染以后HTML标签
       // 注意属性的值必须是标准的HTML标签名
       tagName: 'nav',
       classNames: ['primary', 'my-class-name'],  //指定包裹元素的CSS类
       classNameBindings: ['urgent', 'secondClassName'],
       urgent: true,
       secondClassName: true
});

 

页面从新加载以后查看源代码，能够看到nav标签中多了一个CSS类second-class-name。

<nav id="ember411" class="ember-view primary my-class-name urgent second-class-name">
……
</nav>

 

       若是你不想渲染以后的CSS类名被修改成中划线分隔形式，你能够值classNameBindings属性中指定渲染以后的CSS类名。好比下面的代码：

//  app/components/customizing-component-element.js
 
import Ember from 'ember';
 
export default Ember.Component.extend({
       // 使用tabName属性指定渲染以后HTML标签
       // 注意属性的值必须是标准的HTML标签名
       tagName: 'nav',
       classNames: ['primary', 'my-class-name'],  //指定包裹元素的CSS类
       classNameBindings: ['urgent', 'secondClassName:scn'],  //指定secondClassName渲染以后的CSS类名为scn
       urgent: true,
       secondClassName: true
});

 

页面从新加载以后查看源代码，能够看到nav标签中原来CSS类为second-class-name的变成了scn。

<nav id="ember411" class="ember-view primary my-class-name urgent scn">
……
</nav>

 

       有没有感受Ember既灵活又强大！！Ember的设计理念是“约定优于配置”！因此不少的属性默认的设置都是咱们日常开发中最经常使用的格式。

       除了上述能够指定CSS类名以外，还能够在classNameBindings增长简单的逻辑。

//  app/components/customizing-component-element.js
 
import Ember from 'ember';
 
export default Ember.Component.extend({
       // 使用tabName属性指定渲染以后HTML标签
       // 注意属性的值必须是标准的HTML标签名
       tagName: 'nav',
       classNames: ['primary', 'my-class-name'],  //指定包裹元素的CSS类
       classNameBindings: ['urgent', 'secondClassName:scn', 'isEnabled:enabled:disabled'],
       urgent: true,
       secondClassName: true,
       isEnabled: true  //若是这个属性为true，类enabled将被渲染到nav标签上，若是属性值为false类disabled将被渲染到nav标签上，相似于三目运算
});

       正如代码的注释所说的，“isEnabled:enabled:disabled”能够理解为一个三目运算，会根据isEnabled的值渲染不一样的CSS类到nav上。

       下面的HTML代码是isEnabled为true的状况，对于isEnabled为false的状况请读者本身试试：

<nav id="ember411" class="ember-view primary my-class-name urgent scn enabled">
……
</nav>

 

注意：若是用于判断的属性值不是一个Boolean值而是一个字符串那么获得的结果与上面的结果是不同的，Ember会直接把这个字符串的值做为CSS类名渲染到包裹的标签上。好比下面的代码：

//  app/components/customizing-component-element.js
 
import Ember from 'ember';
 
export default Ember.Component.extend({
       // 使用tabName属性指定渲染以后HTML标签
       // 注意属性的值必须是标准的HTML标签名
       tagName: 'nav',
       classNames: ['primary', 'my-class-name'],  //指定包裹元素的CSS类
       classNameBindings: ['urgent', 'secondClassName:scn', 'isEnabled:enabled:disabled', 'stringValue'],
       urgent: true,
       secondClassName: true,
       isEnabled: true,  //若是这个属性为true，类enabled将被渲染到nav标签上，若是属性值为false类disabled将被渲染到nav标签上，相似于三目运算
       stringValue: 'renderedClassName'
});

       此时页面的HTML源码就有点不同了。'renderedClassName'做为CSS类名被渲染到了nav标签上。

<nav id="ember411" class="ember-view primary my-class-name urgent scn enabled renderedClassName">
……
</nav>

 

       对于这点须要特别注意。Ember对于Boolean值和其余值的判断结果是不同的。

 

3，自定义包裹组件的HTML元素的属性

       在前面两点介绍了包裹组件的HTML元素的标签名、CSS类名，在HTML标签上出来CSS类另一个最经常使用的就是属性，那么Ember一样提供了自定义包裹HTML元素的属性的方法。使用attributeBindings属性指定，这个属性的属性方式与classNameBindings基本一致。

为了与前面的例子区别开新建一个组件link-items，使用命令ember g component link-items建立。

<!--  app/templates/components/link-items.hbs  -->
 
这是个组件

在模板中调用组件。

<!--  app/templates/customizing-component-element.hbs  -->
 
{{customizing-component-element}}
<br><br>
 
{{link-items}}

 

下面设置组件类，指定包裹的HTML标签为a标签，并增长一个属性href。

//  app/components/link-items.js
 
import Ember from 'ember';
 
export default Ember.Component.extend({
       tagName: 'a',
       attributeBindings: ['href'],
       href: 'http://www.google.com.hk'
});

 

       页面从新加载以后获得以下结果：

比较简单，对于渲染以后的结果我就不过多解释了，请参考classNameBindings属性理解。

 

 

到此，有关于组件渲染以后包裹组件的HTML标签的相关设置介绍完毕。内容很少，classNameBindings和attributeBindings这两个属性的使用方式基本相同。

若有疑问欢迎给我留言或者直接查看官方教程。