ant-design-vue 快速避坑指南

ant-design-vue是螞蟻金服 Ant Design 官方唯一推薦的Vue版UI組件庫，它其實是Ant Design的Vue實現，組件的風格與Ant Design保持同步，組件的html結構和css樣式也保持一致。 用下來發現它的確稱得上為數不多的完整的VUE組件庫與開發方案集成項目。

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

 

1.Table對接后台返回數據

針對Table數據格式與后他接口返回數據格式不一致問題，修改 `@/components/table/index.js` 132行起

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

result.then(r => {
  this.localPagination = Object.assign({}, this.localPagination, {
    current: r.pageNo,  // 這里修改當前分頁字段
    total: r.totalCount, // 這里修改總記錄數字段
    showSizeChanger: this.showSizeChanger,
    pageSize: (pagination && pagination.pageSize) ||
      this.localPagination.pageSize // 這里修改總記錄數當前頁數字段
  })
    //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 // 返回結果中的數組數據
  this.localLoading = false
});

2.table操作欄參數問題

在table的dataSource中指定的每一個數據中，都必須包含有name為key的對象，而顯示出的數據就是相應key對應的數據，dataIndex就用來聲明列數據在數據項中對應的key

然而在操作列中，我們一般需要傳入不知一項數據,試了一下如下圖配置dataIndex，數據並不能正確傳入slot-scope中

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

多嘗試后發現，其實只要不配置dataIndex就好了。。。slot-scope自定義一個字段，自然就拿到了整行數據

3.table分頁組件展示條數

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

4.神奇的最后一個標簽隱藏問題

使用可編輯tags過程中值得注意的問題，一般刪除某個tag不止是從DOM中刪除這個tag，而是需要調接口修改數據，那么這時候如果選擇用修改完的數據動態渲染tag列表，並且理所當然地認為動態綁定數據就不需要關心數據手動處理，問題就出現了：

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

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

這個問題貌似沒什么好的辦法，只能放棄綁定動態數據，判斷接口調用成功后，再用文檔中的手動操作增減數據的辦法：

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

5.表單的各種常規操作

單獨觸發某個字段的校驗:

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

清除某個字段的值：

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

設置表單初始值：

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

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

 

自定義文件上傳的action函數：

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

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

6.接口跨域攜帶cookie問題

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

還是在`@/src/utils/request.js`，這里創建了axios實例供全局調用，根據axios文檔，**在創建** axios 實例時添加：`withCredentials: true`

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

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

7.單點登錄的實現

全局的路由鈎子在`permission.js`中，一般單點登錄、權限驗證都是在這里處理，這里也不例外。沒什么特別的，需要注意的一點就是，不要忘記對頁面其他接口的統一無權限處理，和403請求的響應處理。同時畫個流程圖會更快一些,這里就記錄一下吧：

流程圖：

路由鈎子的處理:

router.beforeEach((to, from, next) => {
  // 對403無權限的處理
  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跳去登陸頁，登陸成功會重定向回當前頁（login_redirect）
            const url = e.substring(0, e.lastIndexOf('redirect')) + 'redirect=' + login_redirect
            window.location.href = url
          }
        })
    }
  }
})

`@/ src/utils/request.js`中接口返回的統一處理:

service.interceptors.response.use((response) => {
    if (response.data.status === 1005){
            //... 同上跳去登陸頁
    }else{
        //為返回數據做統一處理
        return response.data
    }
}, err) 

7.引入eCharts

1）npm install

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

3) resize觸發圖表自適應

echart有resizeAPI，一般是在圖表組件如barChart.vue里面手動監聽窗口resize

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

后面借鑒element-admin， 利用mixins實現了更完善的統一處理方法：

1）定義一個mixin:resize.js

import { debounce } from '@/utils'//防抖函數
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中添加防抖函數

export const debounce = (func, wait, immediate) => {
  let timeout, args, context, timestamp, result

  const later = function() {
    // 據上一次觸發時間間隔
    const last = +new Date() - timestamp

    // 上次被包裝函數被調用時間間隔 last 小於設定時間間隔 wait
    if (last < wait && last > 0) {
      timeout = setTimeout(later, wait - last)
    } else {
      timeout = null
      // 如果設定為immediate===true，因為開始邊界已經調用過了此處無需調用
      if (!immediate) {
        result = func.apply(context, args)
        if (!timeout) context = args = null
      }
    }
  }

  return function(...args) {
    context = this
    timestamp = +new Date()
    const callNow = immediate && !timeout
    // 如果延時不存在，重新設定延時
    if (!timeout) timeout = setTimeout(later, wait)
    if (callNow) {
      result = func.apply(context, args)
      context = args = null
    }

    return result
  }
}

3）resize監聽方法混入圖表組件即可

mixins: [resize]