基于element-ui的页面内面包屑组件

lzlz000的个人主页

elment-ui提供了面包屑组件 el-breadcrumb 然而他要配合url跳转路由使用,在项目中需要用到页面内的面包屑,因此我写了一个组件 inner-breadcrumb

inner-breadcrumb 包装了 el-breadcrumb 显示效果基本相同,不同的是,不再跳转页面,而是提供一个v-model控制当前的path值,并且提供了动态参数显示的功能(样式只是因为我们的需求如此,这个可以很容易更改)
原版样式


本组件样式


属性

名称 说明 类型 默认值
v-model 绑定路径值 string/number 必填
path 面包屑全路径参数,详见下文 object 必填
showInRoot 是否在根页面显示该组件 boolean false
showBack 是否在右侧显示“返回上一级” boolean false
labelArgs 面包屑标签动态参数,详见下文 object -

<inner-breadcrumb
  v-model="innerPath"
  :path="{
    label: '一级页面',
    key: '1',
    children: [
      {
        key: '2A',
        label: '二级页面A'
      },
      {
        key: '2B',
        label: '二级页面B',
        children: [
          {
            key: '3',
            label: '三级页面'
          }
        ]
      }
    ]
}"/>

当 v-model绑定值为"3"时,页面为:


  • 控制页面的方式
<div v-if="innerPath=='1'">...</div>
<div v-else-if="innerPath=='2A'">...</div>
<div v-else-if="innerPath=='2B'">...</div>
<div v-else-if="innerPath=='3'">...</div>

以此类推,页面会按照树形结构自动生成当前位置的面包屑,你可以无限添加。

值得注意的是,当回到主页面时候,面包屑默认隐藏,因为绝大多数需求和常理都不需要在主页面显示孤零零的面包屑。当然可以通过添加参数 showInRoot 来显示它

属性path的设置

名称 说明 类型 默认值
label 页面标签显示的值 string/number 必填
key 标签的key string/number 必填
children 下一级路径的集合 array,其中每个元素都是一个节点,多叉树结构 -
disable 如果当前路径不允许被点击则加上 boolean false
  • 注意,开启“返回上一级”按钮,若上一级目录是disable,则会跳过,若所有上级目录均为disable,则无效,控制台会打印警告信息
{
    label: "一级页面", 
    key: "1",
    children: [
      {
        key: "2A",
        label: "二级页面A",
        disable: true
      },
      {
        key: "2B",
        label: "二级页面B",
        children: [
          {
            key: "3",
            label: "三级页面"
          }
        ]
      }
    ]
}

动态参数

动态参数通过属性 labelArgs 设置,适用于需要路径动态标签的情况

<inner-breadcrumb
  v-model="pathKey"
  :label-args ="{code: active.code}"
  :path="{
    label: '排课管理',
    key:'main',
    children:[{
      label: '教学班排课({code})',
      key:'arrange'
    },]
  }"/>

当切换到对应路径arrange时候,会显示:
[图片上传失败...(image-5f5ef0-1562071791110)]

源码如下:

<template>
  <!-- 页面内部使用的面包屑组件(URL不变,不适用router跳转) -->
  <div class="inner-breadcrumb" v-show="showInRoot || value!=root" style="height:24px;padding:0 3px 10px;">
    <el-breadcrumb class="breadcrumb" separator="/" style="float:left;">
      <el-breadcrumb-item v-for="(node, index) in pathArr" :key="index">
        <span v-if="node.disable && index<pathArr.length-1" class="disable" :class="{'last':index==pathArr.length-1}">{{parse(node.label)}}</span>
        <a v-else :class="{'last':index==pathArr.length-1}" href="javascript:;" @click="change(node.key,node.disable)">{{parse(node.label)}}</a>
      </el-breadcrumb-item>
    </el-breadcrumb>
    <el-button v-if="showBack&&pathArr.length>1" style="float:right;padding:0;" type="text" @click="back">返回上一级</el-button>
  </div>
</template>
<script>
/**
 * 页面内部使用的面包屑组件(URL不变,不适用router跳转)
 */
export default {
  name: "InnerBreadcrumb",
  props: {
    value: {
      type: String,
    },
    path: {
      type: Object,
      required: true,
      // 形如:
      default: {
        label: "一级页面",
        key: "1",
        children: [
          {
            key: "2A",
            label: "二级页面A"
          },
          {
            key: "2B",
            label: "二级页面B",
            disable: true,
            children: [
              {
                key: "3",
                label: "三级页面"
              }
            ]
          }
        ]
      }
    },
    showBack:{ // 是否显示返回上一级
      type: Boolean,
      default: false
    },
    showInRoot: { // 是否在根目录显示
      type: Boolean,
      default: false
    },
    labelArgs:{ // 用于回显的参数 例如在 label 中使用 '设置:{info}',在 labelArgs传入{info:'用户信息'} 即可
      type: Object,
      default: {}
    }
  },
  data() {
    return {
      pathMap: null,
      root: null,
      pathArr: []
    };
  },
  watch: {
    value(val) {
      this.buildPath(val);
    }
  },
  methods: {
    init() {
      let path = this.path;
      this.root = path.key;
      let pathMap = {};
      // 遍历path树,给每个节点加上父节点的key,parentKey空则是根节点
      let traverse = (node, parentKey) => {
        node.parentKey = parentKey;
        pathMap[node.key] = node;
        if (node.children && node.children.length) {
          for (let i = 0; i < node.children.length; i++) {
            const child = node.children[i];
            traverse(child, node.key);
          }
        }
      };
      traverse(path);
      this.pathMap = pathMap;
    },
    buildPath(key) {
      if(!key)
        return;
      // 建立路径数组
      let node = this.pathMap[key];
      if (!node) {
        // console.warn("InnerBreadcrumb 找不到key:" + key);
        return;
      }
      let arr = [];
      while (node) {
        arr.push(node);
        node = this.pathMap[node.parentKey];
      }
      arr.reverse();
      this.pathArr = arr;
    },
    parse(label){
      const reg = /\{[^\}]+\}/g;
      let labelCopy = label; // 复制一份
      let match;
      /* match的值
        0: "{abc}"
        groups: undefined
        index: 3
        input: "123{abc},{b}"
      */
      while((match = reg.exec(label))!=null){
        let key = match[0].substr(1,match[0].length-2);
        let value = this.labelArgs[key];
        if (value){
          // console.warn('InnerBreadcrumb 找不到参数:', key);
          labelCopy = labelCopy.replace(match[0],value);
        }
      }
      return labelCopy;
    },
    change(key, disable) {
      if (disable) return;
      // console.log(key);
      this.$emit("input", key);
    },
    back(){
      if(this.pathArr && this.pathArr.length>1){
        for (let i = this.pathArr.length-2; i >=0; i--) {
          const node = this.pathArr[i];
          if (!node.disable){
            this.change(node.key);
            return;
          }
        }
      }
      console.warn('InnerBreadcrumb 没有非disalbe的上级路径');
    }
  },
  created() {},
  mounted() {
    this.init();
    this.buildPath(this.value);
  }
};
</script>
<style lang="scss">
.inner-breadcrumb {
  .breadcrumb{
    span {
      font-weight: normal;
      color: #aaa;
    }
    a {
      font-weight: normal;
      color: #aaa;
    }
    a:hover{
      color: #409EFF;
    }
    .last{
      font-weight: bold!important;
      cursor: default!important;
    }
    .disable{
      cursor: default!important;
    }
  }
  
}
</style>
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,254评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,875评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,682评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,896评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,015评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,152评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,208评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,962评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,388评论 1 304
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,700评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,867评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,551评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,186评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,901评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,142评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,689评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,757评论 2 351

推荐阅读更多精彩内容