快捷導(dǎo)航

詳解Vue后臺(tái)管理系統(tǒng)開(kāi)發(fā)日?？偨Y(jié)(組件PageHeader)

更新時(shí)間：2019年11月01日 09:48:16 作者：jenemy

這篇文章主要介紹了詳解Vue后臺(tái)管理系統(tǒng)開(kāi)發(fā)日?？偨Y(jié)(組件PageHeader)，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

在后臺(tái)管理系統(tǒng)的日常開(kāi)發(fā)過(guò)程中發(fā)現(xiàn)對(duì)于同一個(gè)業(yè)務(wù)下面的版塊不同的開(kāi)發(fā)同事每次都會(huì)重復(fù)寫(xiě)頁(yè)面標(biāo)題的樣式，而且不同的頁(yè)面標(biāo)題還不太一樣。雖然有的頁(yè)面標(biāo)題欄承載的元素不一樣，但是也有通用的部分，經(jīng)過(guò)多個(gè)項(xiàng)目的迭代慢慢地總結(jié)與積累完善出了一個(gè)通用的頁(yè)面標(biāo)題組件<PageHeader/>。

下面是一個(gè)最常見(jiàn)的標(biāo)題設(shè)計(jì)原型：

下面是同事給出的封裝方案:

使用方式

<router-back class="router-back" text="詳情" />

組件封裝代碼片段

<template>
 <div>
  <a
   href="javascript:void(0)" rel="external nofollow" 
   :title="title"
   size="15px"
   class="font-icon arrow-left"
   @click="back"
   v-if="!disableRoute"
  ></a>
  <span
   v-show="text.length > 0 && !disableRoute"
   class="vertical-line"
  ></span>
  <span class="text">{{ text }}</span>
 </div>
</template>
<script>
export default {
 name: 'router-back',
 props: {
  text: {
   type: String,
   default: _ => ''
  },
  url: {
   type: [String, Number],
   default: _ => -1
  },
  title: {
   type: String,
   default: _ => '返回'
  },
  disableRoute: {
   type: Boolean,
   default: _ => false
  }
 },
 methods: {
  back () {
   if (typeof this.url === 'number') return this.$router.go(this.url)
   return this.$router.push(this.url)
  }
 }
}
</script>

無(wú)對(duì)比就沒(méi)有傷害，這個(gè)封裝只是爭(zhēng)對(duì)了單一的情況，并沒(méi)有任何擴(kuò)展性和靈性性，而且在組件方法名稱(chēng)和接收的屬性上有待考究。所以我果斷棄用這個(gè)組件，而選擇自己的解決方案，雖然也不是很完美，代碼質(zhì)量上相比也沒(méi)有什么大的改進(jìn)，但是自我認(rèn)為還是可以分享一下。

不多廢話，先看實(shí)際效果圖：

注意：截圖是在Chrome中縮小后截下的，并不是默認(rèn)大小。

整個(gè)組件是通過(guò)Vue組件JSX方式寫(xiě)法來(lái)實(shí)現(xiàn)的，我的代碼質(zhì)量一般，實(shí)現(xiàn)上不一定是最佳的，但是我有點(diǎn)納悶我一個(gè)同事總是說(shuō)我的多套了一些標(biāo)簽，說(shuō)：pageHeader還需要優(yōu)化，減少標(biāo)簽嵌套。下面是實(shí)現(xiàn)代碼：

import './pageHeader.scss'

const PageHeader = {
 name: 'PageHeader',

 props: {
  // 標(biāo)題
  title: String,

  // 子標(biāo)題
  subTitle: String,

  // 返回路徑，不適用于帶選項(xiàng)卡標(biāo)題
  path: {
   type: [String, Number],
   default: -1
  },

  // 是否顯示回退按鈕
  withPath: {
   type: Boolean,
   default: false
  },

  // 子標(biāo)題顯示位置 'right' | 'bottom', 不適用于帶選項(xiàng)卡標(biāo)題
  position: {
   type: String,
   default: 'right'
  },

  // 帶選項(xiàng)卡標(biāo)題開(kāi)關(guān)
  withTab: {
   type: Boolean,
   default: false
  },

  // 選項(xiàng)卡是否引起路由改變
  isRoute: {
   type: Boolean,
   default: false
  },

  // 當(dāng)前激活選項(xiàng)卡
  activeTab: {
   type: String,
   default: ''
  },

  // 選項(xiàng)卡數(shù)據(jù)
  options: {
   type: Array,
   default() {
    return [
     {
      title: '',
      field: '',
      path: ''
     }
    ]
   }
  }
 },

 computed: {
  isBottom() {
   return this.position === 'bottom'
  },

  curTab: {
   get: function() {
    return this.activeTab
   },

   set: function(val) {
    if (this.activeTab !== val) {
     if (this.isRoute) {
      this.options.forEach(option => {
       if (option.field === tab) {
        this.$router.push(option.path)
        this.$emit('tabChange', val)
       }
      })
     } else {
      this.$emit('tabChange', val)
     }
    }
   }
  }
 },

 methods: {
  goBack() {
   typeof this.path === 'string'
    ? this.$router.push(this.path)
    : this.$router.go(this.path)
  }
 },

 render(h) {
  const Back = (
   <div class="page-header__back">
    <el-button
     type="text"
     class="page-header__action"
     icon="el-icon-back"
     onClick={this.goBack}
    />
    <span class="page-header__separator mx__m" />
   </div>
  )

  const Header = (
   <div class="page-header-wrap">
    <div class="page-header__main">
     {this.withPath && Back}

     <div class="page-header__title">
      {(this.title || this.$slots.title) && (
       <div
        class={`page-header-title__main ${this.isBottom ? '' : 'fl'}`}
       >
        {this.$slots.title ? this.$slots.title : this.title}
       </div>
      )}

      {(this.subTitle || this.$slots.subTitle) && (
       <div
        class={`page-header-title__sub ${
         this.isBottom ? 'lh__14' : 'fl ml__s'
        }`}
       >
        {this.$slots.subTitle ? this.$slots.subTitle : this.subTitle}
       </div>
      )}
     </div>
    </div>
    {this.$slots.action && (
     <div class={`page-header__aside ${this.isBottom ? 'lh__72' : ''}`}>
      {this.$slots.action}
     </div>
    )}
   </div>
  )

  const TabHeader = (
   <div class="page-header-wrap--tab">
    <div class="page-header-tab__main">
     <el-tabs v-model={this.curTab}>
      {this.options.map(option => (
       <el-tab-pane label={option.title} name={option.field} />
      ))}
     </el-tabs>
    </div>

    {this.$slots.extra && (
     <div class="page-header-tab__extra">{this.$slots.extra}</div>
    )}
   </div>
  )

  return (
   <div class={`page-header ${this.isBottom ? 'pt__20' : 'py__20'}`}>
    {this.withTab ? TabHeader : Header}
   </div>
  )
 }
}

export default PageHeader

上面的代碼在實(shí)現(xiàn)上之前沒(méi)見(jiàn)有考慮到通過(guò)this.$router.go(-1)回到上一個(gè)頁(yè)面，而是直接采用this.$router.push(path)，這種需要傳path的方式，后來(lái)看了最前面同事寫(xiě)的方案后借鑒過(guò)來(lái)，改進(jìn)了一下。這個(gè)代碼實(shí)現(xiàn)很簡(jiǎn)單沒(méi)有什么需要講的，下面是組件使用的實(shí)際例子，當(dāng)然如果能寫(xiě)個(gè)單元測(cè)試文件來(lái)測(cè)試組件更好，但是我Jest只停留在入門(mén)水平，平時(shí)也就寫(xiě)些最簡(jiǎn)單的assert，然后過(guò)代碼覆蓋率。

由于代碼在處理選項(xiàng)卡時(shí)，并沒(méi)有對(duì)額外的插槽extra作處理，所以在使用時(shí)需要在對(duì)應(yīng)的標(biāo)簽上模擬一下<el-tabs/>下面的線。這里直接使用了Css-in-js的一種實(shí)現(xiàn)styled-components的Vue版vue-styled-components，來(lái)實(shí)現(xiàn)在JSX中實(shí)現(xiàn)類(lèi)似.vue中樣式的scoped功能。但是并不建議用，因?yàn)閂ue版的沒(méi)有更新，使用的人也不多，不像React社區(qū)那么活躍。

import styled from 'vue-styled-components'
import PageHeader from '~/components/pageHeader'

const PageHeaderAction = styled.div`
 border-bottom: 2px solid #e4e7ed;
 padding-bottom: 6px;
`

const UiPageHeader = {
 name: 'UiPageHeader',
 components: {
  PageHeader
 },

 data() {
  return {
   tabActive: '01',
   tabOptions: [
    {
     title: '我的任務(wù)',
     field: '01'
    },
    {
     title: '我的流程',
     field: '02'
    },
    {
     title: '店鋪任務(wù)',
     field: '03'
    },
    {
     title: '店鋪流程',
     field: '04'
    }
   ]
  }
 },

 methods: {
  onTabChange(tab) {
   console.log(tab)
  }
 },

 render(h) {
  return (
   <div>
    <el-row>
     <PageHeader title="標(biāo)題"/>
    </el-row>
    <el-row>
     <PageHeader title="標(biāo)題 + 默認(rèn)回退" withPath={true}/>
     <PageHeader title="標(biāo)題 + 指定回退路徑" withPath={true} path="/4/dashboard"/>
    </el-row>
    <el-row>
     <PageHeader title="標(biāo)題 + 右邊描述" subTitle="我是頁(yè)面標(biāo)題描述文字，默認(rèn)顯示在標(biāo)題右邊"/>
     <PageHeader title="標(biāo)題 + 下邊描述" subTitle="我是頁(yè)面標(biāo)題描述文字，指定顯示在標(biāo)題下邊" position="bottom"/>
     <PageHeader
      title="標(biāo)題 + 回退 + 右邊描述"
      withPath={true}
      subTitle="我是頁(yè)面標(biāo)題描述文字，默認(rèn)顯示在標(biāo)題右邊"
     />
     <PageHeader
      title="標(biāo)題 + 回退 + 下邊描述"
      withPath={true}
      subTitle="我是頁(yè)面標(biāo)題描述文字，指定顯示在標(biāo)題下邊"
      position="bottom"
     />
    </el-row>
    <el-row>
     <PageHeader>
      <template slot="title">
       標(biāo)題插槽示例
       <i class="el-icon-milk-tea"/>
       <strike style="color: #ff8e00">Yah!</strike>
      </template>
     </PageHeader>
     <PageHeader title="標(biāo)題描述插槽示例">
      <template slot="subTitle">
       我是頁(yè)面標(biāo)題描述文字
       <i class="el-icon-milk-tea"/>
       <strike style="color: #ff8e00">Yah!</strike>
      </template>
     </PageHeader>
     <PageHeader title="標(biāo)題欄右則附加操作按鈕示例">
      <template slot="action">
       <el-button type="primary">保存</el-button>
      </template>
     </PageHeader>
     <PageHeader title="標(biāo)題欄右則附加操作按鈕示例2" subTitle="我是頁(yè)面標(biāo)題描述文字">
      <template slot="action">
       <el-button class="btn-link" type="text">頁(yè)面跳轉(zhuǎn)錨點(diǎn)</el-button>
      </template>
     </PageHeader>
     <PageHeader
      withPath={true}
      title="標(biāo)題欄右則附加操作按鈕示例3"
      subTitle="我是頁(yè)面標(biāo)題描述文字"
      position="bottom">
      <template slot="action">
       <el-button type="primary">保存</el-button>
      </template>
     </PageHeader>
    </el-row>
    <el-row>
     <h3>Tab選項(xiàng)卡標(biāo)題示例</h3>
     <div>選項(xiàng)卡功能比較單一，只支持Element-ui默認(rèn)的水平顯示</div>
     <PageHeader
      withTab={true}
      activeTab={this.tabActive}
      options={this.tabOptions}
      onTabChange={this.onTabChange}
     />
    </el-row>
    <el-row>
     <h3>選項(xiàng)卡 + 標(biāo)題右邊附加操作按鈕</h3>
     <PageHeader
      withTab={true}
      activeTab={this.tabActive}
      options={this.tabOptions}
      onTabChange={this.onTabChange}
     >
      <template slot="extra">
       <PageHeaderAction>
        <el-button
         type="primary"
         size="small"
         icon="el-icon-plus"
         onClick={this.onCreate}
        >
         新建
        </el-button>
       </PageHeaderAction>
      </template>
     </PageHeader>
    </el-row>
   </div>
  )
 }
}

export default UiPageHeader

注意：在上面的代碼中render()方法中傳了個(gè)h參考是因?yàn)槲覀兊哪_手架是公司架構(gòu)師自己Webpack搞的，如果是用@vue/cli生成的項(xiàng)目是不需要這個(gè)參數(shù)的。

最后：寫(xiě)這個(gè)的目的是為了在工作中有所積累，寫(xiě)了幾年業(yè)務(wù)系統(tǒng)，發(fā)現(xiàn)并沒(méi)有留下什么，以文章的方式記錄是一種不錯(cuò)的方式，希望能養(yǎng)成好習(xí)慣，堅(jiān)持寫(xiě)作，在寫(xiě)的時(shí)候思考提升自我。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: