nutui/src/packages/__VUE/popover/doc.md

Popover 气泡弹出框

介绍

点击或在元素上悬停鼠标，弹出气泡卡片浮层。

安装

import { createApp } from 'vue';
// vue
import { Popover } from '@nutui/nutui';
// taro
import { Popover } from '@nutui/nutui-taro';

const app = createApp();
app.use(Popover);

代码实例

基本用法

Popover 支持明朗和暗黑两种风格，默认为明朗风格，将 theme 属性设置为 dark 可切换为暗黑风格。

:::demo

<template>
  <nut-popover v-model:visible="visible.lightTheme" :list="iconItemList">
    <template #reference>
      <nut-button type="primary" shape="square">明朗风格</nut-button>
    </template>
  </nut-popover>
</template>
<script>
import { reactive, ref } from 'vue';
export default {
  setup() {
    const visible = ref({
     lightTheme: false,
    });

    const iconItemList = reactive([
      {
        name: '选项一'
      },
      {
        name: '选项二'
      },
      {
        name: '选项三'
      }
    ]);

    return {
        visible,
        iconItemList,
      };
    }
}
</script>

:::

选项配置

在 list 数组中，可以通过 disabled 字段来禁用某个选项。

:::demo

<template>
  <nut-popover v-model:visible="visible.showIcon" theme="dark" :list="itemList">
    <template #reference>
      <nut-button type="primary" shape="square">展示图标</nut-button>
    </template>
  </nut-popover>

  <nut-popover v-model:visible="visible.disableAction" :list="itemListDisabled">
    <template #reference>
      <nut-button type="primary" shape="square">禁用选项</nut-button>
    </template>
  </nut-popover>
</template>

<script>
import { reactive, ref } from 'vue';
export default {
  setup() {
    const visible = ref({
      showIcon: false,
      disableAction: false,
    });

    const itemList = reactive([
      {
        name: '选项一',
        icon: 'my2'
      },
      {
        name: '选项二',
        icon: 'cart2'
      },
      {
        name: '选项三',
        icon: 'location2'
      }
    ]);

    const itemListDisabled = reactive([
      {
        name: '选项一',
        disabled: true
      },
      {
        name: '选项二',
        disabled: true
      },
      {
        name: '选项三'
      }
    ]);

    return {
        itemList,
        visible,
        itemListDisabled,
      };
    }
}
</script>

:::

自定义内容

在名为 content 插槽中自定义内容。

:::demo

<template>
  <nut-popover v-model:visible="visible.Customized">
    <template #reference>
      <nut-button type="primary" shape="square">自定义内容</nut-button>
    </template>

    <template #content>
      <div class="self-content">
        <div class="self-content-item" v-for="(item, index) in selfContent" :key="index">
          <nut-icon :name="item.name" size="15"></nut-icon>
        <div class="self-content-desc">{{ item.desc }}</div>
        </div>
      </div>
    </template>
  </nut-popover>
</template>


<script>
import { reactive, ref } from 'vue';
export default {
  setup() {
    const visible = ref({
      Customized: false,
    });
    const selfContent = reactive([
      {
        name: 'service',
        desc: '选项一'
      },
      {
        name: 'notice',
        desc: '选项二'
      },
      {
        name: 'location',
        desc: '选项三'
      },
      {
        name: 'category',
        desc: '选项四'
      },
      {
        name: 'scan2',
        desc: '选项五'
      },
      {
        name: 'message',
        desc: '选项六'
      }
    ]);

    return {
      visible,
      selfContent,
    };
  }
}
</script>

<style lang="scss">
.self-content {
  width: 195px;
  display: flex;
  flex-wrap: wrap;
  &-item {
    margin-top: 10px;
    margin-bottom: 10px;
    display: flex;
    justify-content: center;
    align-items: center;
    flex-direction: column;
  }
  &-desc {
    margin-top: 5px;
    width: 60px;
    font-size: 10px;
    text-align: center;
  }
}
</style>

:::

位置自定义

支持 bottom, top, left, right 四种弹出位置，默认值为 bottom。

:::demo

<template>
  <nut-popover v-model:visible="visible.topLocation" location="top" theme="dark" :list="iconItemList">
    <template #reference>
      <nut-button type="primary" shape="square">向上弹出</nut-button>
    </template>
  </nut-popover>

  <h2></h2>
  <nut-popover v-model:visible="visible.rightLocation" location="right" theme="dark" :list="iconItemList">
    <template #reference>
      <nut-button type="primary" shape="square">向右弹出</nut-button>
    </template>
  </nut-popover>
  <nut-popover v-model:visible="visible.leftLocation" location="left" theme="dark" :list="iconItemList">
    <template #reference>
    <nut-button type="primary" shape="square">向左弹出</nut-button>
    </template>
  </nut-popover>
</template>

<script lang="ts">
import { reactive, ref } from 'vue';
export default {
  setup() {
    const visible = ref({
      topLocation: false, 
      rightLocation: false, 
      leftLocation: false 
    });

    const iconItemList = reactive([
        {
          name: '选项一'
        },
        {
          name: '选项二'
        },
        {
          name: '选项三'
        }
      ]);

      return {
        iconItemList,
        visible,
      };
    }
};
</script>

:::

Prop

字段	说明	类型	默认值
list	选项列表	List[]	[]
visible	是否展示气泡弹出层	boolean	false
theme	主题风格，可选值为 dark	string	light
location	弹出位置，可选值为 top,left,right	string	bottom

List 数据结构

List 属性是一个由对象构成的数组，数组中的每个对象配置一列，对象可以包含以下值：

键名	说明	类型	默认值
name	选项文字	string	-
icon	nut-icon 图标名称	string	-
disabled	是否为禁用状态	boolean	false

Slots

名称	说明
content	自定义气泡组件菜单内容
reference	触发 Popover 显示的元素内容

Events

名称	说明
choose	点击选项时触发
open	打开菜单时触发
close	关闭菜单时触发