小程序 组件 Component

一.组件模板和样式

类似于页面，自定义组件拥有自己的 wxml 和模板 wxss 样式。

1.组件模板

组件的写法和页面的写法相同，组件模板与组件数据结合后生成的数节点，

将被插入到组件的引用位置。在组件模板中提供一个<slot> 节点，用于承载组件

引用时候提供的子节点。

例如：

<view class="wrapper">

<view>这里是组件的内部节点</view>

<slot></slot>

</view>

引用在页面的.json 文件中配置。

"usingComponents": {

"v-component": "/components/cs/cs"

}

"v-component" :为自定义的模板名字，页面引用的时候用，

"/components/cs/cs"  引用组件的路径

页面中引用 如下：

<v-component>

<view>这里是插入到组件slot中的内容</view>

</v-component>

2.组件中的模板数据绑定

与普通的模板数据绑定相同，动态像子组件传递数据。

例如：

<v-component  prop-a="{{dataA}}" prop-b="{{dataB}}">

<view>这里是插入到组件slot中的内容</view>

</v-component>

组件接收到页面传递过来的数据，页面可以通过setData 来改变绑定的绑定字段。

（目前只能传递JSON数据）

3.组件的wxml 的slot

默认情况下，一个组件的wxml 中只能有一个slot,需要使用多个slot 时，可以在组件js

声明启用。

Component({

options:{

multipleSlots: true // 在组件定义的选项中启用多slot 支持

}，

properties:{},

methods:{}

})

此时在组件就可以启用多个slot,以不同的name 来区分。

例如：

<view class="wrapper">

<slot name=“head”></slot>

<view>这里是组件的内部节点</view>

<slot name="footer"></slot>

</view>

在使用的时候

<v-component >

<view slot="head">slot中的头部内容</view>

<view slot="footer">slot中的底部内容</view>

</v-component>

4.组件样式

组件对应wxss 文件的样式，只对组件wxml 内的节点生效。编写组件样式时注意：

(1) 组件和引用的页面，不能使用id选择器，(#a),属性选择器（[a]）和标签名属性

选择器，请改用class 选择器。

(2) 组件和引用组件的页面中使用后代选择器(.a .b) 在极端情况下会有非预期的表现。

(3)子元素选择器(.a>.b) 只能用于view 组件与其子节点之间，用于其他组件可以能导致

非预期的情况。

(4)继承样式，如font , color 会从外部组件继承到组件内。

(5)除继承样式外，app.wxss 中的样式，组件所在页面中的样式对自定义样式无效。

（6）组件可以指定节点的默认样式 :host{color:yellow;}

5.外部样式

组件接收外部传入的样式类，可以在Component 中用externalClasses 定义若干个外部样式

类，这个特性可以用实现类似于，view 组件的 hover-class属性，页面可以提供一个样式类

赋予 view 的hover-class 这个一样式类写在页面中，而非， view 组件的实现中。

例如：

/* 组件 custom-component.js */

Component({

externalClasses:['my-class']

})

<!-- 组件 custom-component.wxml -->

<v-component class="my-class" >

这段文本的颜色由外部组建的 class 觉得

</v-component>

组件的使用或者可以指定这个样式类对应的class, 就像使用普通属性样式一样

页面的WXML

<v-component  my-class="red-text"></v-component>

.red-text{

color:red;

}

6.使用组件接收全局样式

默认情况下，自定义组件的样式只受到wxss 的影响

(1) app.wxss 中使用了标签名选择器，影响到页面和全部组件，

(2) 在自定义的组件中激活了 addGlobalClass 选项，这样使自定义

组件能被app.wxss 或页面的wxss 中的所有样式。

要激活 addGlobalClass 选项，只需在Component 构造中将 options.addGlobalClass

字段为true (当激活了 addGlobalClass 选项后，存在外部样式污染样式组件的风险)

/* 组件 custom-component.js */ Component({ options: {     addGlobalClass: true,   }   })

/* 组件 custom-component.wxml  */

<text class="red-text">

这段文字颜色由 `app.wxss`和页面`wxss` 中的样式定义来规定

</text>

/*app.wxxs*/

.red-text{

color:red;

}