Grid 宫格导航

一、概述

定义

每个入口往往是独立的业务,用户进入一个入口后,只处理与此入口相关的内容,如果要跳转至其他入口,必须要先回到入口的总界面。

使用场景

  • 为其他独立业务提供入口

交互说明

  • 一般导航展示两行,超过两行时使用走马灯进行切换。

  • 在大屏,当一行展示不全时,使用左右切换展示。

二、小屏效果

Grid 宫格导航 - 图1

  1. <template>
  2. <div class="custom-grid-small-example">
  3. <se-grid :row="row" :col="col" @change="change">
  4. <se-grid-item v-for="item in 20" :key="item" label="标题文字"></se-grid-item>
  5. </se-grid>
  6. </div>
  7. </template>
  8. <script>
  9. export default {
  10. data() {
  11. return {
  12. row: 2,
  13. col: 5
  14. }
  15. },
  16. methods: {
  17. change(current) {
  18. console.log(`当前显示第${current}页`)
  19. }
  20. }
  21. }
  22. </script>
  23. <style>
  24. .custom-grid-small-example {
  25. width: 400px;
  26. margin: 0 auto;
  27. }
  28. </style>

三、大屏效果

Grid 宫格导航 - 图2

<template>
  <div class="custom-grid-small-example">
    <se-grid :row="row" :col="col" large>
      <se-grid-item v-for="item in 20" :key="item" :label="`标题文字` + item"></se-grid-item>
    </se-grid>
  </div>
</template>

<script>
  export default {
    data() {
      return {
        row: 1,
        col: 10
      }
    }
  }
</script>

四、 自定义 Grid-item 内容

Grid 宫格导航 - 图3

<template>
  <div class="custom-grid-small-example">
    <se-grid :row="row" :col="col" large>
      <se-grid-item v-for="(item, index) in 20" :key="index">
        <div class="se-grid-item__wrap">
          <div class="se-grid-item__img"></div>
          <span class="se-grid-item__label">导航{{index}}</span>
        </div>
      </se-grid-item>
    </se-grid>
  </div>
</template>

<script>
  export default {
    data() {
      return {
        row: 1,
        col: 10
      }
    }
  }
</script>

<style>
  .custom-grid-small-example .se-grid-item__img {
    border-radius: 0;
  }

  .custom-grid-small-example .se-grid-item {
    text-align: center;
  }

  .custom-grid-small-example .se-tag {
    margin-top: 20px;
  }
</style>

Grid Props

属性类型默认值必填说明
rownumber2每页显示几行
colnumber5每行显示几列
gutterstring列间距。可取 CSS 中有效的长度,比如 1px 1em 6%
largebooleanfalse样式按照大(小)屏展示

Grid Events

事件名称描述回调函数参数
change选中值发生变化时触发当前的 index

GridItem Props

属性类型默认值必填说明
iconstring(图片的 src)-选项的 icon
labelstring-选项的 label
tostring-选项的 path
replacebooleanfalse在使用 to 进行路由跳转时,启用 replace 将不会向 history 添加新记录