ant-design-vue 快速避坑指南(推薦)

更新時(shí)間：2020年01月21日 09:10:13 作者：劉家三胖

ant-design-vue是螞蟻金服 Ant Design 官方唯一推薦的Vue版UI組件庫，它其實(shí)是Ant Design的Vue實(shí)現(xiàn)，組件的風(fēng)格與Ant Design保持同步，組件的html結(jié)構(gòu)和css樣式也保持一致，很多朋友在使用過程中遇到很多問題，今天小編就給大家分享一篇教程幫助大家快速閉坑，一起看看吧

ant-design-vue是螞蟻金服 Ant Design 官方唯一推薦的Vue版UI組件庫，它其實(shí)是Ant Design的Vue實(shí)現(xiàn)，組件的風(fēng)格與Ant Design保持同步，組件的html結(jié)構(gòu)和css樣式也保持一致。用下來發(fā)現(xiàn)它的確稱得上為數(shù)不多的完整的VUE組件庫與開發(fā)方案集成項(xiàng)目。

本文主要目的是總結(jié)一些開發(fā)過程中比較耗時(shí)間去查找，文檔中沒有具體說明的常見問題，同時(shí)希望能給新上手此框架的同學(xué)提供一些參考作用。

1.Table對接后臺返回?cái)?shù)據(jù)

針對Table數(shù)據(jù)格式與后他接口返回?cái)?shù)據(jù)格式不一致問題，修改 `@/components/table/index.js` 132行起

主要修改pageNo,pageSize,totalCount,data這字段與后臺返回字段一致就OK了

result.then(r => {
 this.localPagination = Object.assign({}, this.localPagination, {
  current: r.pageNo, // 這里修改當(dāng)前分頁字段
  total: r.totalCount, // 這里修改總記錄數(shù)字段
  showSizeChanger: this.showSizeChanger,
  pageSize: (pagination && pagination.pageSize) ||
   this.localPagination.pageSize // 這里修改總記錄數(shù)當(dāng)前頁數(shù)字段
 })
  //r.data中的data修改為返回列表字段
 if (r.data.length == 0 && this.localPagination.current != 1) {
  this.localPagination.current--
  this.loadData()
  return
 }
 !r.totalCount && ['auto', false].includes(this.showPagination) && (this.localPagination = false)
 this.localDataSource = r.data // 返回結(jié)果中的數(shù)組數(shù)據(jù)
 this.localLoading = false
});

2.table操作欄參數(shù)問題

在table的dataSource中指定的每一個(gè)數(shù)據(jù)中，都必須包含有name為key的對象，而顯示出的數(shù)據(jù)就是相應(yīng)key對應(yīng)的數(shù)據(jù)，dataIndex就用來聲明列數(shù)據(jù)在數(shù)據(jù)項(xiàng)中對應(yīng)的key

然而在操作列中，我們一般需要傳入不知一項(xiàng)數(shù)據(jù),試了一下如下圖配置dataIndex，數(shù)據(jù)并不能正確傳入slot-scope中

columns: [
  ...
  {
      title: '操作',
      dataIndex: 'id,text',
      key: 'id',
      scopedSlots: { customRender: 'operation' }
  }

多嘗試后發(fā)現(xiàn)，其實(shí)只要不配置dataIndex就好了。。。slot-scope自定義一個(gè)字段，自然就拿到了整行數(shù)據(jù)

3.table分頁組件展示條數(shù)

:pagination="{showTotal: total => `共${total}條`}"

4.神奇的最后一個(gè)標(biāo)簽隱藏問題

使用可編輯tags過程中值得注意的問題，一般刪除某個(gè)tag不止是從DOM中刪除這個(gè)tag，而是需要調(diào)接口修改數(shù)據(jù)，那么這時(shí)候如果選擇用修改完的數(shù)據(jù)動(dòng)態(tài)渲染tag列表，并且理所當(dāng)然地認(rèn)為動(dòng)態(tài)綁定數(shù)據(jù)就不需要關(guān)心數(shù)據(jù)手動(dòng)處理，問題就出現(xiàn)了：

假如一共有5個(gè)tag，現(xiàn)在刪除第一個(gè)tag，并調(diào)用接口返回新數(shù)據(jù)，注意tags默認(rèn)的刪除操作也不是從DOM中刪除這個(gè)tag，而是將這個(gè)tag設(shè)置為```display:none```!這就導(dǎo)致了一個(gè)很神奇的問題，此時(shí)新返回的tags數(shù)組長度已經(jīng) -1，而它仍然認(rèn)為當(dāng)前列表的第一個(gè)Tag是隱藏的，最后呈現(xiàn)的效果就是只剩3個(gè)Tag，此時(shí)再接著刪除第一個(gè)tag（其實(shí)是第二個(gè)），那么就只剩1個(gè)tag了。。

<a-tag
 v-for="(tag, index) in Tags"
  :key="tag.id"
  :closable="tagCloseable"
  :afterClose="() => handleTagStatus(0,tag)"
  >{{ tag.name }}
</a-tag>

這個(gè)問題貌似沒什么好的辦法，只能放棄綁定動(dòng)態(tài)數(shù)據(jù)，判斷接口調(diào)用成功后，再用文檔中的手動(dòng)操作增減數(shù)據(jù)的辦法：

this.Tags = this.Tags.filter(tag => tag.id !== removeTag.id)

5.表單的各種常規(guī)操作

單獨(dú)觸發(fā)某個(gè)字段的校驗(yàn):

this.form.validateFields(['name'], { force: true })

清除某個(gè)字段的值：

this.form.resetFields(`name`,'')

設(shè)置表單初始值：

this.form.resetFields(`name`,'')

注意：不初始化的值用undefined而非‘',否則下拉框會(huì)不顯示placeholder！

自定義文件上傳的action函數(shù)：

<a-upload :customRequest="upLoad"></a-upload>

upLoad (info) {
  let file = info.file;
  let param = new FormData(); //創(chuàng)建form對象
  param.append('file',file);//通過append向form對象添加數(shù)據(jù)
  console.log(param.get('file')); //FormData私有類對象訪問不到，可以通過get判斷值是否傳進(jìn)去
  let config = {
    headers:{'Content-Type':'multipart/form-data'}
  }; 
  this.$http.post(url, param, config).then(res => {
    ...
  })
},

6.接口跨域攜帶cookie問題

做單點(diǎn)登錄時(shí)需要在請求頭中攜帶cookie，遇到了很坑人的問題，實(shí)際原因是對mock.js的實(shí)現(xiàn)不夠了解。

還是在`@/src/utils/request.js`，這里創(chuàng)建了axios實(shí)例供全局調(diào)用，根據(jù)axios文檔，**在創(chuàng)建** axios 實(shí)例時(shí)添加：`withCredentials: true`

const service = axios.create({
  baseURL: `${process.env.VUE_APP_BASEURL}/backend`,
  withCredentials: true,
 timeout: 6000 
})

結(jié)果發(fā)現(xiàn)接口請求仍然不帶cookie，無奈試了一下用fetch請求`fetch(url, { credentials: 'include', mode: 'cors' })`，發(fā)現(xiàn)可以攜帶cookie，百思不得其解，兩者都是基于promise實(shí)現(xiàn)的，但是fetch在寫法和攔截請求響應(yīng)等方面都比較麻煩，全部替換成fetch也不太現(xiàn)實(shí)。最后才發(fā)現(xiàn)，是mock.js沒有注釋（`main.js`中注釋掉就好了），原來mock.js是通過攔截XHR請求來實(shí)現(xiàn)的接口模擬，Axios本質(zhì)上也是對原生XHR的封裝，只不過它是Promise的實(shí)現(xiàn)版本，所以它當(dāng)然被攔截了，而fetch脫離了XHR，這也是fetch請求能正常攜帶cookie的原因，這里還沒有全部梳理清楚，打算在后一篇中詳細(xì)介紹一下

7.單點(diǎn)登錄的實(shí)現(xiàn)

全局的路由鉤子在`permission.js`中，一般單點(diǎn)登錄、權(quán)限驗(yàn)證都是在這里處理，這里也不例外。沒什么特別的，需要注意的一點(diǎn)就是，不要忘記對頁面其他接口的統(tǒng)一無權(quán)限處理，和403請求的響應(yīng)處理。同時(shí)畫個(gè)流程圖會(huì)更快一些,這里就記錄一下吧：

流程圖：

路由鉤子

路由鉤子的處理:

router.beforeEach((to, from, next) => {
 // 對403無權(quán)限的處理
 if (to.path === '/403') {
  next()
 } else {
  if (roles) {//已登陸
   next()
  } else {
      //獲取用戶信息，GetUserInfo邏輯如下：
      //status=403 && reject(res)，返回包含status；
      //status=1005 && reject(res.data)返回重定向的URL；
      //status=1000 && resolve()
   store
    .dispatch('GetUserInfo') 
    .then(res => {
     next()
    })
    .catch((e) => {
     if (e.status) {
      next({ path: '/403' })
     } else {
            //拼接URL跳去登陸頁，登陸成功會(huì)重定向回當(dāng)前頁（login_redirect）
      const url = e.substring(0, e.lastIndexOf('redirect')) + 'redirect=' + login_redirect
      window.location.href = url
     }
    })
  }
 }
})

`@/ src/utils/request.js`中接口返回的統(tǒng)一處理:

service.interceptors.response.use((response) => {
  if (response.data.status === 1005){
      //... 同上跳去登陸頁
  }else{
    //為返回?cái)?shù)據(jù)做統(tǒng)一處理
    return response.data
  }
}, err)

7.引入eCharts

1）npm install

2) components下新建barChart.vue ,import echarts from 'echarts'，正常操作...

3) resize觸發(fā)圖表自適應(yīng)

echart有resizeAPI，一般是在圖表組件如barChart.vue里面手動(dòng)監(jiān)聽窗口resize

mounted() {
  window.addEventListener("resize", () => {
    this.chart.resize(); 
  });
},

后面借鑒element-admin，利用mixins實(shí)現(xiàn)了更完善的統(tǒng)一處理方法：

1）定義一個(gè)mixin:resize.js

import { debounce } from '@/utils'//防抖函數(shù)
export default {
 data() {
  return {
   $_sidebarElm: null
  }
 },
 mounted() {
  this.__resizeHandler = debounce(() => {
   if (this.chart) {
    this.chart.resize()
   }
  }, 100)
  window.addEventListener('resize', this.__resizeHandler)

  this.$_sidebarElm = document.getElementsByClassName('sidebar-container')[0]
  this.$_sidebarElm && this.$_sidebarElm.addEventListener('transitionend', this.$_sidebarResizeHandler)
 },
 beforeDestroy() {
  window.removeEventListener('resize', this.__resizeHandler)

  this.$_sidebarElm && this.$_sidebarElm.removeEventListener('transitionend', this.$_sidebarResizeHandler)
 },
 methods: {
  $_sidebarResizeHandler(e) {
   if (e.propertyName === 'width') {
    this.__resizeHandler()
   }
  }
 }
}

2）@/components/_utils/util.js中添加防抖函數(shù)

export const debounce = (func, wait, immediate) => {
 let timeout, args, context, timestamp, result
 const later = function() {
  // 據(jù)上一次觸發(fā)時(shí)間間隔
  const last = +new Date() - timestamp
  // 上次被包裝函數(shù)被調(diào)用時(shí)間間隔 last 小于設(shè)定時(shí)間間隔 wait
  if (last < wait && last > 0) {
   timeout = setTimeout(later, wait - last)
  } else {
   timeout = null
   // 如果設(shè)定為immediate===true，因?yàn)殚_始邊界已經(jīng)調(diào)用過了此處無需調(diào)用
   if (!immediate) {
    result = func.apply(context, args)
    if (!timeout) context = args = null
   }
  }
 }
 return function(...args) {
  context = this
  timestamp = +new Date()
  const callNow = immediate && !timeout
  // 如果延時(shí)不存在，重新設(shè)定延時(shí)
  if (!timeout) timeout = setTimeout(later, wait)
  if (callNow) {
   result = func.apply(context, args)
   context = args = null
  }
  return result
 }
}

3）resize監(jiān)聽方法混入圖表組件即可

mixins: [resize]

總結(jié)

以上所述是小編給大家介紹的ant-design-vue 快速避坑指南，希望對大家有所幫助，如果大家有任何疑問請給我留言，小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持！
如果你覺得本文對你有幫助，歡迎轉(zhuǎn)載，煩請注明出處，謝謝！

您可能感興趣的文章: