Vue后台管理系统开发日常总结__组件PageHeader

2019-06-12 admin

在后台管理系统的日常开发过程中发现对于同一个业务下面的版块不同的开发同事每次都会重复写页面标题的样式,而且不同的页面标题还不太一样。虽然有的页面标题栏承载的元素不一样,但是也有通用的部分,经过多个项目的迭代慢慢地总结与积累完善出了一个通用的页面标题组件<PageHeader/>

下面是一个最常见的标题设计原型:

clipboard.png

下面是同事给出的封装方案:

使用方式

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

组件封装代码片段

<template>
  <div>
    <a
      href="javascript:void(0)"
      :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>

无对比就没有伤害,这个封装只是争对了单一的情况,并没有任何扩展性和灵性性,而且在组件方法名称和接收的属性上有待考究。所以我果断弃用这个组件,而选择自己的解决方案,虽然也不是很完美,代码质量上相比也没有什么大的改进,但是自我认为还是可以分享一下。

不多废话,先看实际效果图:

clipboard.png

注意:截图是在Chrome中缩小后截下的,并不是默认大小。

整个组件是通过Vue组件JSX方式写法来实现的,我的代码质量一般,实现上不一定是最佳的,但是我有点纳闷我一个同事总是说我的多套了一些标签,说:pageHeader还需要优化,减少标签嵌套。下面是实现代码:

import './pageHeader.scss'

const PageHeader = {
  name: 'PageHeader',

  props: {
    // 标题
    title: String,

    // 子标题
    subTitle: String,

    // 返回路径,不适用于带选项卡标题
    path: {
      type: [String, Number],
      default: -1
    },

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

    // 子标题显示位置 'right' | 'bottom', 不适用于带选项卡标题
    position: {
      type: String,
      default: 'right'
    },

    // 带选项卡标题开关
    withTab: {
      type: Boolean,
      default: false
    },

    // 选项卡是否引起路由改变
    isRoute: {
      type: Boolean,
      default: false
    },

    // 当前激活选项卡
    activeTab: {
      type: String,
      default: ''
    },

    // 选项卡数据
    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

上面的代码在实现上之前没见有考虑到通过this.$router.go(-1)回到上一个页面,而是直接采用this.$router.push(path),这种需要传path的方式,后来看了最前面同事写的方案后借鉴过来,改进了一下。这个代码实现很简单没有什么需要讲的,下面是组件使用的实际例子,当然如果能写个单元测试文件来测试组件更好,但是我Jest只停留在入门水平,平时也就写些最简单的assert,然后过代码覆盖率。

由于代码在处理选项卡时,并没有对额外的插槽extra作处理,所以在使用时需要在对应的标签上模拟一下<el-tabs/>下面的线。这里直接使用了Css-in-js的一种实现styled-components的Vue版vue-styled-components,来实现在JSX中实现类似.vue中样式的scoped功能。但是并不建议用,因为Vue版的没有更新,使用的人也不多,不像React社区那么活跃。

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: '我的任务',
          field: '01'
        },
        {
          title: '我的流程',
          field: '02'
        },
        {
          title: '店铺任务',
          field: '03'
        },
        {
          title: '店铺流程',
          field: '04'
        }
      ]
    }
  },

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

  render(h) {
    return (
      <div>
        <el-row>
          <PageHeader title="标题"/>
        </el-row>
        <el-row>
          <PageHeader title="标题 + 默认回退" withPath={true}/>
          <PageHeader title="标题 + 指定回退路径" withPath={true} path="/4/dashboard"/>
        </el-row>
        <el-row>
          <PageHeader title="标题 + 右边描述" subTitle="我是页面标题描述文字,默认显示在标题右边"/>
          <PageHeader title="标题 + 下边描述" subTitle="我是页面标题描述文字,指定显示在标题下边" position="bottom"/>
          <PageHeader
            title="标题 + 回退 + 右边描述"
            withPath={true}
            subTitle="我是页面标题描述文字,默认显示在标题右边"
          />
          <PageHeader
            title="标题 + 回退 + 下边描述"
            withPath={true}
            subTitle="我是页面标题描述文字,指定显示在标题下边"
            position="bottom"
          />
        </el-row>
        <el-row>
          <PageHeader>
            <template slot="title">
              标题插槽示例
              <i class="el-icon-milk-tea"/>
              <strike style="color: #ff8e00">Yah!</strike>
            </template>
          </PageHeader>
          <PageHeader title="标题描述插槽示例">
            <template slot="subTitle">
              我是页面标题描述文字
              <i class="el-icon-milk-tea"/>
              <strike style="color: #ff8e00">Yah!</strike>
            </template>
          </PageHeader>
          <PageHeader title="标题栏右则附加操作按钮示例">
            <template slot="action">
              <el-button type="primary">保存</el-button>
            </template>
          </PageHeader>
          <PageHeader title="标题栏右则附加操作按钮示例2" subTitle="我是页面标题描述文字">
            <template slot="action">
              <el-button class="btn-link" type="text">页面跳转锚点</el-button>
            </template>
          </PageHeader>
          <PageHeader
            withPath={true}
            title="标题栏右则附加操作按钮示例3"
            subTitle="我是页面标题描述文字"
            position="bottom">
            <template slot="action">
              <el-button type="primary">保存</el-button>
            </template>
          </PageHeader>
        </el-row>
        <el-row>
          <h3>Tab选项卡标题示例</h3>
          <div>选项卡功能比较单一,只支持Element-ui默认的水平显示</div>
          <PageHeader
            withTab={true}
            activeTab={this.tabActive}
            options={this.tabOptions}
            onTabChange={this.onTabChange}
          />
        </el-row>
        <el-row>
          <h3>选项卡 + 标题右边附加操作按钮</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()方法中传了个h参考是因为我们的脚手架是公司架构师自己Webpack搞的,如果是用@vue/cli生成的项目是不需要这个参数的。

最后:写这个的目的是为了在工作中有所积累,写了几年业务系统,发现并没有留下什么,以文章的方式记录是一种不错的方式,希望能养成好习惯,坚持写作,在写的时候思考提升自我。

[转载]原文链接:https://segmentfault.com/a/1190000019457192

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处。

转载请注明:文章转载自 JavaScript中文网 [https://www.javascriptcn.com]

本文地址:https://www.javascriptcn.com/read-67144.html

文章标题:Vue后台管理系统开发日常总结__组件PageHeader

相关文章
JavaScript 事件流、事件处理程序及事件对象总结
JS与HTML之间的交互通过事件实现。事件就是文档或浏览器窗口中发生的一些特定的交互瞬间。可以使用监听器(或处理程序)来预定事件,以便事件发生时执行相应的代码。这种在传统软件工程中被称为观察员模式,支持页面的行为与页面的外观之间的松散耦合。...
2017-04-05
梳理前端开发使用eslint-prettier检查和格式化代码
问题痛点 在团队的项目开发过程中,代码维护所占的时间比重往往大于新功能的开发。因此编写符合团队编码规范的代码是至关重要的,这样做不仅可以很大程度地避免基本语法错误,也保证了代码的可读性。 对于代码版本管理系统(svn 和 git或者其他)...
2018-05-07
Web前端开发与iOS终端开发的异同
毕业之前一直在做前端开发,毕业后就转成做iOS开发,这两者有很多挺有意思的对比,尝试写下我能想到的它们的一些相同点和不同点。 语言 前端和终端作为面向用户端的程序,有个共同特点:需要依赖用户机器的运行环境,所以开发语言基本上是没有选择的,...
2016-01-13
HTML5游戏2015年的开发趋势
在互联网行业中,一个行业从零到成熟,开发者生态也是对应的,我们今年看到很多大公司,包括像微软和Google,也参与到了HTML5 开发者生态的建设当中。关于HTML5移动游戏的开发和盈利生态的走向又该去往何处?下面我们来试着讨论一下。 《围...
2015-11-12
vue.js实现请求数据的方法示例
vue2.0示例代码如下: var vm = new Vue({ el:&quot;#list&quot;, data:{ gridData: &quot;&quot;, }, ...
2017-03-20
vue-awesome-swiper的使用以及API整理
一、先说一个看关于vue-awesome-swiper的一个坑 vue项目的package.json中显示的&lt;span style=“color: orange;”&gt;“vue-awesome-swiper”: “^2.5.4”&...
2018-04-26
三步搞定vue在vscode的环境配置问题
1. vscode基础开发插件 vscode-icons 图标美化 Debugger for Chrome 调试 Beautify 代码格式化 Prettier 代码格式化 ESLint 代码规范 JavaScript (ES6) cod...
2017-12-25
Html5 是否适合移动应用开发
HTML5最近这几年声誉鹊起,而基于HTML5技术的产品也风生水起。感觉现在你的产品要是不和HTML5沾点边,都不好意思和客户打招呼!移动应用开发中,HTML5更是不可或缺的角色,市面上不少移动应用中间件产品都号称支持HTML5,例如APP...
2015-11-12
vuejs通过filterBy、orderBy实现搜索筛选、降序排序数据
直接贴代码了: 先上输入前的样子: &lt;style&gt; #example{margin:100px auto;width:600px;} .show{margin:10px;} #searchText{display: block...
2017-03-17
最细致的vue.js基础语法 值得收藏!
介绍 前段时间接触到一个库叫做Vue.js, 个人感觉很棒,所以整理了一篇博文做个介绍。 Vue读音/vju:/,和view类似。是一个数据驱动的web界面库。Vue.js只聚焦于视图层,可以很容易的和其他库整合。代码压缩后只有24kb。 ...
2017-03-21
回到顶部