微信小程式開發初次體驗-小程式開發-PHP中文網

元件實例

this.selectComponent('.classSelector')

引入

Taro

Taro中引入Vant Weapp，不能直接透過第三方NPM套件的形式直接呼叫。

需要進行以下幾個步驟：

在github上找到Vant-weapp下載檔案包，將對應的dist目錄複製到項目/src/components/vant-weapp目錄下。
在Pages對應檔案的config.usingComponents中，設定每個頁面所需的元件。 (無法在app.js中進行所謂的全域註冊元件。)

  config = {
    navigationBarTitleText: '首页',
    usingComponents: {
      "van-button": "../../components/vant-weapp/button/index",
      "van-popup": "../../components/vant-weapp/popup/index"
    }
  }

登入後複製

在使用Vant-weapp元件後，taro建置會自動將對應的元件複製一份到dist/components下，而Vant-weapp的元件也依賴工具庫/src/components/vant-weapp/wxs，工具庫taro不會自動複製到dist。所以，我們需要修改/config/index.js檔案中的config.copy.patterns，讓其在編譯時，自動複製到dist對應目錄下。

  copy: {
    patterns: [
      {
        from: 'src/components/vant-weapp/wxs/',
        to: 'dist/components/vant-weapp/wxs/'
      }
    ],
    options: {
    }
  },

登入後複製

由於Vant-weapp的樣式使用的單位是px，所以會被taro編譯成rpx，以便對各個設配進行適配。可以透過修改/config/index.js檔案中的config.weapp.module.pxtransform.selectorBlackList不讓其單位轉換。

pxtransform: {
  enable: true,
  config: {

  },
  selectorBlackList: [
    /^.van-.*?$/,  // 这里是vant-weapp中className的匹配模式
  ]
},

登入後複製

ec-canvas

#ec-canvas是 ECharts 的微信小程式版本。

iconfont

下載到本機，什麼都不要改，放到指定位置。

該資源不會自動拷貝到dist/資料夾下，所以需要透過修改設定檔拷貝。

  copy: {
    patterns: [
      ...
      {
        from: 'src/assets/fonts/',
        to: 'dist/assets/fonts/'
      },
      ...
    ],
    options: {
    }
  }

登入後複製

然後，在app.js入口檔案中，import './assets/fonts/iconfont.css'。

自訂元件

元件向外傳參考

this.triggerEvent(
  'eventType',
  {
    key: value, //这里定义的键值对，在父组件中，通过args.detail.key获取；
  },
  {
    bubbles: true, //事件属性:是否冒泡；
    capturePhase: true, //事件属性： 是否可捕获；
  }
)

登入後複製

插槽slot

用法同Vue。

注意：元件內部對slot定義的樣式，不起作用。只能在呼叫元件的位置，對傳入slot內的結構進行樣式定義。

開發障礙

`Taro`中自訂tabBar

##切換Tab時(

app.jsx中config.tabBar.custom = true)，需要在對應Tab頁componentDidShow生命週期中：

if (typeof this.$scope.getTabBar === 'function' && this.$scope.getTabBar()) {
  this.$scope.getTabBar().setData({
    selected: 1
  })
}

登入後複製

#注意是

this.$scope.getTabBar。

Canvas所造成的層級覆寫問題

#canvas是由客戶端建立的原生元件，而原生元件的層級則是最高的，所以頁面中的其他元件無論設定z-index 為多少，都無法蓋在原生元件上。

所以，如果

canvas和遮罩互動同時存在時，canvas會在遮罩的上層。

解決方案：

canvas外包覆一層結構，透過條件(遮罩的開關)來設定canvas容器的hidden屬性。
透過
cover-view、cover-image#自訂元件，cover-view透過定位，提升層級，可防止被canvas覆蓋。
- 結構上，cover-view一定要在canvas後邊；
- flex和order來調整展示順序。
- 最外層cover-view才支援#position: fixed。

typeof

#wx:if語句中，不能使用typeof運算符，{{}}中不能使用typeof運算符，只能在wxs中使用。

data初始化賦值

不知道data什麼時機初始化，但，初始化

data的時候，不能使用this指向目前元件實例（這是this === void 0），也就是說，data初始化只能給一個常數。

需要

properties或methods來初始化data的時候，只能在生命週期attached中透過this.setData更新data的值。

而且，如果data.fn = this.methodName，methodName中如果调用了this引用，这时this指向的是data，所以需要使用data.fn = this.methodName.bind(this)。

vant-weapp库中的popup样式设置

popup内容的大小不是由内容撑起来的，需要通过popup组件的custom-class定义一个类名，设置width、height来定义内容的尺寸。

vant-tree-select事件触发

在Taro中的代码风格类React，而vant-weapp库中的代码风格为wxml和wxs风格。React绑定事件是驼峰式，wxml绑定事件是使用-连字符分隔。

这就造成了Taro使用vant-tree-select组件时，onClickNav和onClickItem不会被vant-tree-select识别，事件无法触发。

解决方案：对vant-tree-select进行二次封装，事件原始触发通过this.$triggerEvent传出驼峰式的事件类型，在Taro中调用。

目前vant-weapp0.5.20中，vant-tree-select不支持单选。

props获取不到

驼峰式命名的事件无法触发[微信小程序]

注意@tarojs/cli的版本，如最初用的1.2.0版本就获取不到自定义组件传的参数，升级到最新版1.3.15就可以了。

注意@tarojs/cli的版本，如最初用的1.2.0版本无法触发驼峰式命名的事件，升级到最新版1.3.15，使用onClick-nav形式绑定事件就可以了。

`Taro`编译器无法自动将用到组件的`.wxs`文件移动到`/dist`相应目录下

手动移动。

在`微信开发者工具`中运行`Taro`代码，如果有`async/await`，则regenerator is not defined。

将微信开发者工具--> 右上角详情--> 本地设置里的配置全部关掉，如ES6转ES5...。

定制echarts，引入报错

echarts.js不需要再次编译，配置中新增编译时忽略echarts.js。

weapp: {
    ...
    compile: {
      exclude: ['src/echarts-for-weixin/ec-canvas/echarts.js']
    }
}

登入後複製

getState()获取Store存储的数据

可以在(dispatch, getState) => {中使用。

真机调试正常，预览/体验版空白（只有tabbar）

将"本地设置"--> "上传时进行代码保护"取消勾选。

`Taro`中`className=''`单引号赋值不起作用。

className的值使用双引号包裹。

`Taro`自定义组件内部使用`iconfont`，不显示图标

参照外部样式类、全局样式类。
或者，组件单独引入iconfont.css也可以。

获取路由参数

this.$router.params

`iconfont`字符串渲染

如果将字体做变量使用，通用情况下无法正常显示。

需要将icon: ['', '']改写成icon: ['\ue61e', '\ue62d']。
<rich-text nodes={}></rich-text>

使用Taro/微信小程序同步接口，仍异步返回结果

如使用Taro.getStorageSync('key')获取缓存数据，结果仍是异步返回。同步接口需要结合await使用，才是真正的同步。

分包

包大小限制

包超过2048KB，无法上传

分包操作

主包不需要特殊处理。
- navigateTab导航的页面必须在主包中。
分包
- 分包在subPackages配置。

    pages: [
      'pages/login/login',
      'pages/index/index',
      'pages/manage/manage',
      'pages/schedule/schedule',
      'pages/inpidual/inpidual'
    ],
    'subPackages': [
      {
         'root': 'pages-main',
         name: 'main',
          'pages': [
            'acs/acs',
            'acs-setting/acs-setting',
            'setting-details/setting-details',
            'current-energy/current-energy',
            'history-energy/history-energy',
            'electricity/electricity',
            'runtime/runtime',
            'daily-usage/daily-usage',
            'onshift-record/onshift-record',
            'schedule-details/schedule-details'
        ]
      },
    ],

登入後複製

伪动态绑定事件

// index.wxml
<input
    wx:if="{{metas.type == &#39;text&#39; || metas.type == &#39;number&#39; || metas.type == &#39;idcard&#39; || metas.type == &#39;digit&#39;}}"
    name="{{metas.name}}"
    type="{{metas.type}}"
    value="{{value}}"
    placeholder="{{metas.attrs.placeholder}}"
    bindchange="{{changeValidate}}"
    bindinput="{{inputValidate}}"
    bindblur="{{blurValidate}}"
/>

登入後複製

// index.js

Component({
    data: {
        changeValidate: '',
        inputValidate: '',
        blurValidate: '',
        eventType: 'input',
        rules: '',
        value: '',
        isRequired: false,
        validateState: '', //['validating', 'success', 'error']
        validateMessage: ''
    },
    observers: {
        rules(newV) {
            console.log('------=======')
            this.setData({
                [`${this.data.eventType}Validate`]: 'onBlurValidate'
            })
        }
    },
    methods: {
        onBlurValidate (e) {
            this.onValidate(e, rule)
        },
        onValidate (e, rule) {

        }
    }
})

登入後複製

获取组件实例

refFormItem =  (node, idx) => {
    if(this.formItem) {
        !this.formItem.includes(node) &&    this.formItem.push(node)
    } else {
        this.formItem = [node]
    }
}
...
clearValidate  () {
    console.log(this.formItem)
    this.formItem.forEach(item => {
        item.clearValidate()
    })
}
...
render  () {
    const { fieldMetas } = this.props;
    return (
        <Form  className="form"  onSubmit={this.submitForm.bind(this)}>

        {

            fieldMetas.map((meta, idx) => {

                return (
                    <form-item  ref\={this.refFormItem} onValidate={this.gatherValidate.bind(this)} taroKey={meta.name} metas={meta} initialValue={this.findValue.call(this, meta.name)}>
                    </form-item>
                )
            })
        }
            <Button  form-type="submit">按钮</Button>
            <Button  onClick={this.clearValidate}>按钮</Button>
        </Form>
    )
}

登入後複製