微信小程序自定义组件

简介:

wxs

一种类似于js的小程序脚本语言。
注意;

  1. wxs 文件不依赖于运行时的库。
  2. wxs 与js是另外一门语言。
  3. wxs于js的运行时完全隔离的,不能调用js中的函数,不能调用小程序提供的api
  4. 不能进行回调

总结一下

总结一下当前的内容
wxs类似于一门脚本语言,使用的是导出的方式来进行和wxml进行连接,类似于node.js
wxml为页面显示的文件,类似于网页中的html文件
json为配置文件,可以进行对页面内容的配置。
wxss为css配置文件,可以进行css的配置。
js 为进行处理回调,以及页面数据绑定的文件

自定义组件

使用自定义组件,将页面的功能抽象成为组件,在不同的页面中重复使用,将复杂的页面抽象成为多个模块。即达到高内聚,低耦合的目标。

总诉

创建自定义组件

一个组件由json,wxml,wxss,js四个文件组成,要编写一个自定义组件,需要在json中自定义组件声明,声明这一组文件为自定义组件。

json文件如下

{
  "usingComponents": {
    "component": "/component/component"
  }
}

即上方中设置该文件夹为组件文件夹

命名有点不规范,应该命名为components

Component({
  properties: {
    // 这里定义了innerText属性,属性值可以在组件使用时指定
    innerText: {
      type: String,
      value: '默认文字',
    }
  },
  data: {
    // 这里是一些组件内部数据
    someData: {}
  },
  methods: {
    // 这里是一个自定义方法
    customMethod: function () { }
  }
})

使用component函数进行设置

ps 这里需要重要component为大写。必须写为Component 否则会无法显示,一个小坑,不是驼峰命名法,╮(╯▽╰)╭

设置组件的内容

<view class="inner">
  {{innerText}}
</view>
<slot></slot>

设置组件的css

.inner {
  color: red
}

通过设置页面的json数据,进行对组件的引用

{
  "usingComponents": {
    "component": "/component/component"
  }
}

设置component组件引用component文件夹下单component组件内容
对组件进行引用

<view>
  <component inner-text="Some text"></component>
</view>

设置文字内容为some text,
如果

<view>
  <component></component>
</view>

设置的话,将会设置为默认的。

组件模板和样式

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

组件模板

组件模板的写法和页面模板相同,组件模板和组件数据组合生成节点树。将被插入到组件的引用位置上。
组件模板中提供slot,用于承载组件引用时的子节点,即组件引用的时候,其内部的子节点,将会插入到slot节点内部
组件的wxml文件如下

<view class="inner">
<slot></slot>
  {{innerText}}
  这是内部节点
</view>

page的wxml文件如下

<view>
  <component>
    <view>这是内部节点</view>
  </component>
</view>

编译后即可生成

模板和数据绑定

使用数据绑定,向子组件的属性动态的传递数据
即,向模板传递数据
设置模板的wxml

<view>
  <component propA="hello" propB="world">
    <view>这是内部节点</view>
  </component>
</view>

设置模板的js文件

Component({
  properties: {
    // 这里定义了innerText属性,属性值可以在组件使用时指定
    propA: {
      type: String,
      value: '1'
    },
    propB: {
      type: String,
      value: '2'
    }
  },
  data: {
    // 这里是一些组件内部数据
    someData: {}
  },
  methods: {
    // 这里是一个自定义方法
    customMethod: function () { }
  }
})

设置page的wxml文件

<view>
  <component propA="hello" propB="world">
    <view>这是内部节点</view>
  </component>
</view>

完成对组件的使用。

设置组件的slot

slot为子节点的承载点。
在Component函数中设置options对象的multipleSlots属性为true,确保支持多slot的支持

  options: {
    multipleSlots: true  // 在组件中支持多slot子节点的支持
  }

对于多个slot使用name来进行区分
定义wxml文件如下

<!-- 这是自定义组件的内部WXML结构 -->
<view class="inner">
<slot name="before"></slot>
  {{propA}}
  {{propB}}
  这是内部节点
<slot name="after"></slot>
</view>

接着定义page的wxml文件

<view>
  <component propA="hello" propB="world">
    <view slot="after">这是after</view>
    <view slot="before">这是before</view>
  </component>
</view>

完成,至此完成多个节点的slot的插入

组件样式

组件对应于wxss文件的样式,只对组件内部的wxml节点生效。
注意

  1. 组件只能使用class
  2. 组件避免使用后代选择器

:host选择器

使用host选择器,可以设置组件的默认样式

:host {
  color: yellow;
}

即上方设置该页面的全部的host值为yellow

外部样式

普通样式和外部样式尽量避免同时使用,因为这样会造成两个类的优先级为未定义的
设置externalClasses 为class的样式。
commpont文件如下
js

Component({
  properties: {
    // 这里定义了innerText属性,属性值可以在组件使用时指定
    propA: {
      type: String,
      value: '1'
    },
    propB: {
      type: String,
      value: '2'
    }
  },
  options: {
    multipleSlots: true  // 在组件中支持多slot子节点的支持
  },
  externalClasses: ['my-class'] // 设置允许外部样式的my-class的使用
})

wxml

<!-- 这是自定义组件的内部WXML结构 -->
<view>
<slot name="before"></slot>
  {{propA}}
  {{propB}}
  这是内部节点
<slot name="after"></slot>
</view>

wxss

:host {
  color: red
}

page如下
wxml如下

<view>
  <component propA="hello" propB="world" class="my-class">
    <view slot="after">这是after</view>
    <view slot="before">这是before</view>
  </component>
</view>

wxss如下

.my-class {
  color:yellow
}

显示为黄色,因为默认的权重低于外部样式表

全局样式

设置addGlobalClass为true即可,当设置addGlobalClass的时候,其组件定义的css无效,只有外部的class影响,除此之外都不影响

目录
相关文章
|
1月前
|
小程序 JavaScript
【微信小程序】之轮播图、swiper、swiper-item、banner组件使用
【微信小程序】之轮播图、swiper、swiper-item、banner组件使用
【微信小程序】之轮播图、swiper、swiper-item、banner组件使用
|
2月前
|
存储 小程序 JavaScript
【微信小程序】-- 表单组件 - picker 实现日期选择器(五十三)
【微信小程序】-- 表单组件 - picker 实现日期选择器(五十三)
|
1月前
|
小程序 JavaScript
【微信小程序】之顶部选项卡自定义tabs(不用mp-tabs扩展组件,太难用了)
【微信小程序】之顶部选项卡自定义tabs(不用mp-tabs扩展组件,太难用了)
|
1月前
|
小程序 JavaScript
【微信小程序】之自定义三宫格一行展示row-grid(简单数据看板)
【微信小程序】之自定义三宫格一行展示row-grid(简单数据看板)
|
1月前
|
小程序 程序员
【uniapp微信小程序】自定义导航栏:非首页展示的实现方式(极为快捷方式)
【uniapp微信小程序】自定义导航栏:非首页展示的实现方式(极为快捷方式)
21 0
|
1月前
|
小程序 JavaScript
【微信小程序】之自定义四宫格(不用mp-grids扩展组件实现,这个组件太难用了)
【微信小程序】之自定义四宫格(不用mp-grids扩展组件实现,这个组件太难用了)
|
2月前
|
JSON 资源调度 小程序
一个强大的小程序富文本组件mp-html
一个强大的小程序富文本组件mp-html
35 0
|
1月前
|
小程序 前端开发 API
微信小程序全栈开发中的异常处理与日志记录
【4月更文挑战第12天】本文探讨了微信小程序全栈开发中的异常处理和日志记录,强调其对确保应用稳定性和用户体验的重要性。异常处理涵盖前端(网络、页面跳转、用户输入、逻辑异常)和后端(数据库、API、业务逻辑)方面;日志记录则关注关键操作和异常情况的追踪。实践中,前端可利用try-catch处理异常,后端借助日志框架记录异常,同时采用集中式日志管理工具提升分析效率。开发者应注意安全性、性能和团队协作,以优化异常处理与日志记录流程。
|
1月前
|
小程序 安全 数据安全/隐私保护
微信小程序全栈开发中的身份认证与授权机制
【4月更文挑战第12天】本文探讨了微信小程序全栈开发中的身份认证与授权机制。身份认证包括手机号验证、微信登录和第三方登录,而授权机制涉及角色权限控制、ACL和OAuth 2.0。实践中,开发者可利用微信登录获取用户信息,集成第三方登录,以及实施角色和ACL进行权限控制。注意点包括安全性、用户体验和合规性,以保障小程序的安全运行和良好体验。通过这些方法,开发者能有效掌握小程序全栈开发技术。
|
1月前
|
小程序 前端开发 JavaScript
微信小程序全栈开发中的PWA技术应用
【4月更文挑战第12天】本文探讨了微信小程序全栈开发中PWA技术的应用,PWA结合Web的开放性和原生应用的性能,提供离线访问、后台运行、桌面图标和原生体验。开发者可利用Service Worker实现离线访问,Worker处理后台运行,Web App Manifest添加桌面图标,CSS和JavaScript提升原生体验。实践中需注意兼容性、性能优化和用户体验。PWA技术能提升小程序的性能和用户体验,助力开发者打造优质小程序。

热门文章

最新文章