全部产品
云市场
云游戏

组件模板和样式

更新时间:2019-09-09 14:07:25

与页面类似,自定义组件可以有自己的 axml 模板和 acss 样式。

axml

axml 是自定义组件必选部分。

  1. <!-- /components/index/index.axml -->
  2. <view onTap="onMyClick" id="c-{{$id}}"/>
  1. // /components/index/index.js
  2. Component({
  3. methods: {
  4. onMyClick(e) {
  5. console.log(this.is, this.$id);
  6. },
  7. },
  8. });
说明:与页面不同,用户自定义事件需要放到 methods 里面。

插槽 slot

通过在组件 js 中支持 props,自定义组件可以和外部调用者交互,接受外部调用者传来的数据,同时可以调用外部调用者传来的函数,通知外部调用者组件内部的变化。

但是这样还不够,自定义组件还不够灵活。除了数据的处理与通知,小程序提供的 slot 使得自定义组件的 axml 结构可以使用外部调用者传来的 axml 组装。外部调用者可以传递 axml 给自定义组件,自定义组件使用其组装出最终的组件 axml 结构。

默认插槽 default slot

代码示例

  1. <!-- /components/index/index.axml -->
  2. <view>
  3. <slot>
  4. <view>default slot & default value</view>
  5. </slot>
  6. <view>other</view>
  7. </view>

调用者不传递 axml

  1. // /pages/index/index.json
  2. {
  3. "usingComponents": {
  4. "my-component": "/components/index/index"
  5. }
  6. }
  1. <!-- /pages/index/index.axml -->
  2. <my-component />

页面输出

  1. default slot & default value
  2. other

调用者传递 axml

  1. <!-- /pages/index/index.axml -->
  2. <my-component>
  3. <view>header</view>
  4. <view>footer</view>
  5. </my-component>

页面输出

  1. header
  2. footer
  3. other

可以将 slot 理解为插槽,default slot 就是默认插槽,如果调用者在组件标签 <xx> 之间不传递 axml,则渲染的是默认插槽。而如果调用者在组件标签 <xx> 之间传递有 axml,则使用其替代默认插槽,进而组装出最终的 axml 以供渲染。

具名插槽 named slot

default slot 只能传递一份 axml。复杂的组件需要在不同位置渲染不同的 axml,即需要传递多个 axml。此时需要 named slot。使用具名插槽后,外部调用者可以在自定义组件标签的子标签中指定要将哪一部分的 axml 放入到自定义组件的哪个具名插槽中。而自定义组件标签的子标签中没有指定具名插槽的部分则会放入到默认插槽上。如果仅仅传递了具名插槽,则默认插槽不会被覆盖。

代码示例

  1. <!-- /components/index/index.axml -->
  2. <view>
  3. <slot>
  4. <view>default slot & default value</view>
  5. </slot>
  6. <slot name="header"/>
  7. <view>body</view>
  8. <slot name="footer"/>
  9. </view>

只传递具名插槽

  1. <!-- /pages/index/index.axml -->
  2. <my-component>
  3. <view slot="header">header</view>
  4. <view slot="footer">footer</view>
  5. </my-component>

页面输出

  1. default slot & default value
  2. header
  3. body
  4. footer

传递具名插槽与默认插槽

  1. <!-- /pages/index/index.axml -->
  2. <my-component>
  3. <view>this is to default slot</view>
  4. <view slot="header">header</view>
  5. <view slot="footer">footer</view>
  6. </my-component>

页面输出

  1. this is to default slot
  2. header
  3. body
  4. footer

作用域插槽 slot-scope

通过使用 named slot ,自定义组件的 axml 要么使用自定义组件的 axml,要么使用外部调用者(比如页面)的 axml。使用自定义组件的 axml,可以访问组件内部的数据,同时通过 props 属性,可以访问外部调用者的数据。

代码示例

  1. // /components/index/index.js
  2. Component({
  3. data: {
  4. x: 1,
  5. },
  6. props: {
  7. y: '',
  8. },
  9. });
  1. <!-- /components/index/index.axml -->
  2. <view>component data: {{x}}</view>
  3. <view>page data: {{y}}</view>
  1. // /pages/index/index.js
  2. Page({
  3. data: { y: 2 },
  4. });
  1. <!-- /pages/index/index.axml -->
  2. <my-component y="{{y}}" />

页面输出:

  1. component data: 1
  2. page data: 2

自定义组件通过 slot 使用外部调用者(比如页面)的 axml 时,却只能访问外部调用者的数据。

代码示例

  1. <!-- /components/index/index.axml -->
  2. <view>
  3. <slot>
  4. <view>default slot & default value</view>
  5. </slot>
  6. <view>body</view>
  7. </view>
  1. // /pages/index/index.js
  2. Page({
  3. data: { y: 2 },
  4. });
  1. <!-- /pages/index/index.axml -->
  2. <my-component>
  3. <view>page data: {{y}}</view>
  4. </my-component>

页面输出

  1. page data: 2
  2. body

slot scope 使得插槽内容可以访问到组件内部的数据。

代码示例

  1. // /components/index/index.js
  2. Component({
  3. data: {
  4. x: 1,
  5. },
  6. });
  1. <!-- /components/index/index.axml -->
  2. <view>
  3. <slot x="{{x}}">
  4. <view>default slot & default value</view>
  5. </slot>
  6. <view>body</view>
  7. </view>
  1. // /pages/index/index.js
  2. Page({
  3. data: { y: 2 },
  4. });
  1. <!-- /pages/index/index.axml -->
  2. <my-component>
  3. <view slot-scope="props">
  4. <view>component data: {{props.x}}</view>
  5. <view>page data: {{y}}</view>
  6. </view>
  7. </my-component>

页面输出

  1. component data: 1
  2. page data: 2
  3. body

如上所示,自定义组件通过定义 slot 属性的方式暴露组件内部数据,页面使用组件时,通过 slot-scope 申明为作用域插槽,属性值定义临时变量名 props,即可访问到组件内部数据。

acss

和页面一样,自定义组件也可以定义自己的 acss 样式。acss 会自动被引入使用组件的页面,不需要页面手动引入。详见 acss 语法