介绍

组合了选择器、弹出框组件，实现了便捷快速的选择功能。

引入

import PickerPopout from 'sard-uniapp/components/picker-popout/picker-popout.vue'

代码演示

基础使用

使用 v-model 双向绑定当前值，使用 v-model:visible 控制弹出框显隐。

vue lang="ts"

<template>
  <sar-picker-popout
    v-model="value"
    v-model:visible="visible"
    title="请选择"
    :columns="columns"
    @change="onChange"
  />

  <sar-list card>
    <sar-list-item>
      <sar-button @click="visible = true">
        {{ value ? value : '请选择' }}
      </sar-button>
    </sar-list-item>
    <sar-list-item
      title="设置为: 天津市"
      arrow
      hover
      @click="value = '天津市'"
    />
    <sar-list-item title="清空" arrow hover @click="value = undefined" />
  </sar-list>
</template>

<script setup lang="ts">
import { ref } from 'vue'

const columns = ['北京市', '天津市', '河北省', '山东省']

const visible = ref(false)
const value = ref<string | undefined>()

const onChange = (value: any) => {
  console.log('change', value)
}
</script>

vue lang="js"

<template>
  <sar-picker-popout
    v-model="value"
    v-model:visible="visible"
    title="请选择"
    :columns="columns"
    @change="onChange"
  />

  <sar-list card>
    <sar-list-item>
      <sar-button @click="visible = true">
        {{ value ? value : '请选择' }}
      </sar-button>
    </sar-list-item>
    <sar-list-item
      title="设置为: 天津市"
      arrow
      hover
      @click="value = '天津市'"
    />
    <sar-list-item title="清空" arrow hover @click="value = undefined" />
  </sar-list>
</template>

<script setup lang="js">
import { ref } from "vue";
const columns = ["\u5317\u4EAC\u5E02", "\u5929\u6D25\u5E02", "\u6CB3\u5317\u7701", "\u5C71\u4E1C\u7701"];
const visible = ref(false);
const value = ref();
const onChange = (value2) => {
  console.log("change", value2);
};
</script>

级联选择

vue lang="ts"

<template>
  <sar-picker-popout
    v-model="value"
    v-model:visible="visible"
    title="请选择"
    :columns="regionData"
    :option-keys="{ label: 'name', value: 'code' }"
  />

  <sar-list card>
    <sar-list-item>
      <sar-button @click="visible = true">
        {{ value ? value : '请选择' }}
      </sar-button>
    </sar-list-item>
    <sar-list-item
      title="当前值："
      :value="JSON.stringify(value) ?? 'undefined'"
    />
    <sar-list-item
      title="设置为: 广东省/广州市/白云区"
      arrow
      hover
      @click="value = [440000, 440100, 440111]"
    />
    <sar-list-item title="清空" arrow hover @click="value = undefined" />
  </sar-list>
</template>

<script setup lang="ts">
import { ref } from 'vue'
import { getRegionData } from 'region-data'

const regionData = getRegionData()

const visible = ref(false)

const value = ref<number[] | undefined>([150000, 150500, 150522])
</script>

vue lang="js"

<template>
  <sar-picker-popout
    v-model="value"
    v-model:visible="visible"
    title="请选择"
    :columns="regionData"
    :option-keys="{ label: 'name', value: 'code' }"
  />

  <sar-list card>
    <sar-list-item>
      <sar-button @click="visible = true">
        {{ value ? value : '请选择' }}
      </sar-button>
    </sar-list-item>
    <sar-list-item
      title="当前值："
      :value="JSON.stringify(value) ?? 'undefined'"
    />
    <sar-list-item
      title="设置为: 广东省/广州市/白云区"
      arrow
      hover
      @click="value = [440000, 440100, 440111]"
    />
    <sar-list-item title="清空" arrow hover @click="value = undefined" />
  </sar-list>
</template>

<script setup lang="js">
import { ref } from "vue";
import { getRegionData } from "region-data";
const regionData = getRegionData();
const visible = ref(false);
const value = ref([15e4, 150500, 150522]);
</script>

API

PickerPopoutProps

继承 PickerProps 并有以下额外属性：

属性	描述	类型	默认值
popout-class	弹窗框根元素类名	string	-
popout-style	弹窗框根元素样式	StyleValue	-
visible (v-model)	是否显示弹出框	boolean	-
title	弹出框标题	string	-
validate-event	是否触发表单验证	boolean	true
resettable 1.23.3+	关闭弹出框后，是否可复位弹出框值	boolean	false

PickerPopoutSlots

继承 PickerSlots

PickerPopoutEmits

事件	描述	类型
update:model-value	选择器输入组件值改变时触发	(value: any) => void
change	选择器输入组件值改变时触发	(value: any) => void
update:visible	弹出框显隐时触发	(visible: boolean) => void
confirm 1.22.1+	点击确定按钮时触发	() => void
visible-hook 1.22.1+	入场/退场动画状态改变时触发	(name: TransitionHookName) => void
before-enter 1.22.1+	入场动画开始前触发	() => void
enter 1.22.1+	入场动画开始时触发	() => void
after-enter 1.22.1+	入场动画结束时触发	() => void
enter-cancelled 1.22.1+	入场动画取消时触发	() => void
before-leave 1.22.1+	退场动画开始前触发	() => void
leave 1.22.1+	退场动画开始时触发	() => void
after-leave 1.22.1+	退场动画结束时触发	() => void
leave-cancelled 1.22.1+	退场动画取消时触发	() => void