Vue3弹性布局（Flex）

效果如下图：在线预览

APIs

参数	说明	类型	默认值	必传
width	区域总宽度	string \| number	'auto'	false
vertical	`flex` 主轴的方向是否垂直，`vertical` 使用 `flex-direction: column`	boolean	false	false
wrap	设置元素单行显示还是多行显示；参考 `flex-wrap`	'nowrap' \| 'wrap' \| 'wrap-reverse'	'nowrap'	false
justify	设置元素在主轴方向上的对齐方式；参考 `justify-content`	string	'normal'	false
align	设置元素在交叉轴方向上的对齐方式；参考 `align-items`	string	'normal'	false
gap	设置网格之间的间隙，数组时表示: [水平间距, 垂直间距]	number \| number[] \| 'small' \| 'middle' \| 'large'	undefined	false

创建弹性布局组件Flex.vue

ts 复制代码

<script setup lang="ts">
import { computed } from 'vue'
interface Props {
  width?: string|number // 区域宽度
  vertical?: boolean // flex 主轴的方向是否垂直，vertical 使用 flex-direction: column
  wrap?: 'nowrap'|'wrap'|'wrap-reverse' // 设置元素单行显示还是多行显示；参考 flex-wrap
  justify?: string // 设置元素在主轴方向上的对齐方式；参考 justify-content
  align?: string // 设置元素在交叉轴方向上的对齐方式；参考 align-items
  gap?: number|number[]|'small'|'middle'|'large' // 设置网格之间的间隙，数组时表示: [水平间距, 垂直间距]
}
const props = withDefaults(defineProps<Props>(), {
  width: 'auto',
  vertical: false,
  wrap: 'nowrap',
  justify: 'normal',
  align: 'normal',
  gap: undefined
})
const flexWidth = computed(() => {
  if (typeof props.width === 'number') {
    return props.width + 'px'
  }
  return props.width
})
const gapValue = computed(() => {
  if (props.gap === undefined) {
    return 0
  }
  if (typeof props.gap === 'number') {
    return props.gap + 'px'
  }
  if (Array.isArray(props.gap)) {
    return props.gap[1] + 'px ' + props.gap[0] + 'px '
  }
  if (['small', 'middle', 'large'].includes(props.gap)) {
    const gapMap = {
      small: '8px',
      middle: '16px',
      large: '24px'
    }
    return gapMap[props.gap]
  }
})
</script>
<template>
  <div
    class="m-flex"
    :class="{'flex-vertical': vertical}"
    :style="`
      width: ${flexWidth};
      gap: ${gapValue};
      margin-bottom: -${Array.isArray(props.gap) && wrap ? props.gap[1] : 0}px;
      --wrap: ${wrap};
      --justify: ${justify};
      --align: ${align};
    `">
    <slot></slot>
  </div>
</template>
<style lang="less" scoped>
.m-flex {
  display: flex;
  flex-wrap: var(--wrap);
  justify-content: var(--justify);
  align-items: var(--align);
  font-size: 14px;
  color: rgba(0, 0, 0, .88);
  transition: all .3s;
}
.flex-vertical {
  flex-direction: column;
}
</style>

在要使用的页面引入

ts 复制代码

<script setup lang="ts">
import Flex from 'Flex.vue'
import { ref } from 'vue'
const directionOptions = ref([
        {
          label: 'horizontal',
          value: 'horizontal'
        },
        {
          label: 'vertical',
          value: 'vertical',
        }
      ])
const direction = ref('horizontal')
const baseStyle = {
  width: '25%',
  height: '54px'
}
const justifyOptions = ref([
        {
          label: 'flex-start',
          value: 'flex-start'
        },
        {
          label: 'center',
          value: 'center'
        },
        {
          label: 'flex-end',
          value: 'flex-end'
        },
        {
          label: 'space-between',
          value: 'space-between'
        },
        {
          label: 'space-around',
          value: 'space-around'
        },
        {
          label: 'space-evenly',
          value: 'space-evenly'
        }
      ])
const alignOptions = ref([
        {
          label: 'flex-start',
          value: 'flex-start'
        },
        {
          label: 'center',
          value: 'center'
        },
        {
          label: 'flex-end',
          value: 'flex-end'
        }
      ])
const justify = ref(justifyOptions.value[0].value)
const alignItems = ref(alignOptions.value[0].value)
const boxStyle = {
  width: '100%',
  height: '120px',
  borderRadius: '6px',
  border: '1px solid #40a9ff'
}
const gapOptions = ref([
        {
          label: 'Small',
          value: 'small'
        },
        {
          label: 'Middle',
          value: 'middle',
        },
        {
          label: 'Large',
          value: 'large'
        },
        {
          label: 'Customize',
          value: 'customize'
        }
      ])
const gapSize = ref('small')
const customGapSize = ref(8)
</script>
<template>
  <div>
    <h1>Flex 弹性布局</h1>
    <h2 class="mt30 mb10">基本使用</h2>
    <Flex gap="middle" vertical>
      <Radio :options="directionOptions" v-model:value="direction" />
      <Flex :vertical="direction === 'vertical'">
        <div
          v-for="n in 4" :key="n"
          :style="{ ...baseStyle, background: `${n % 2 ? '#1677ffbf' : '#1677ff'}` }"
        />
      </Flex>
    </Flex>
    <h2 class="mt30 mb10">对齐方式</h2>
    <Flex gap="middle" align="start" vertical>
      <p>Select justify :</p>
      <Radio v-model:value="justify" button :options="justifyOptions" />
      <p>Select align :</p>
      <Radio v-model:value="alignItems" button :options="alignOptions" />
      <Flex :style="{ ...boxStyle }" :justify="justify" :align="alignItems">
        <Button type="primary">Primary</Button>
        <Button type="primary">Primary</Button>
        <Button type="primary">Primary</Button>
        <Button type="primary">Primary</Button>
      </Flex>
    </Flex>
    <h2 class="mt30 mb10">设置间隙</h2>
    <Flex gap="middle" vertical>
      <Radio :options="gapOptions" v-model:value="gapSize" />
      <template v-if="gapSize === 'customize'">
        <Slider v-model:value="customGapSize" />
      </template>
      <Flex :gap="gapSize !== 'customize' ? gapSize : customGapSize">
        <Button type="primary">Primary</Button>
        <Button>Default</Button>
        <Button type="dashed">Dashed</Button>
        <Button type="link">Link</Button>
      </Flex>
    </Flex>
    <h2 class="mt30 mb10">自动换行</h2>
    <Flex wrap="wrap" :width="600" :gap="[8, 16]">
      <Button v-for="n in new Array(16)" :key="n" type="primary">Button</Button>
    </Flex>
  </div>
</template>