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

    }

 

posted @ 2019-01-14 15:27  柠檬先生  阅读(3099)  评论(0编辑  收藏  举报