小程序 组件 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;

}

上一篇:如果正确读取SQL Server中的扩展事件?


下一篇:小程序组件化框架 WePY 在性能调优上做出的探究