cfc/cfc-frontend/components/address-picker.vue

<template>
  <view class="address-picker">
    <!-- 显示当前选中的地址（show-trigger=false 时由页面自己绘制入口行） -->
    <view v-if="showTrigger" class="current-address" @click="open">
      <text class="address-text">{{ currentAddress || '请选择地址' }}</text>
      <text class="address-arrow">›</text>
    </view>

    <!-- 地址选择面板 -->
    <view class="picker-mask" v-if="showPicker" @click="closePicker">
      <view class="picker-panel" @click.stop>
        <!-- 面板头部 -->
        <view class="picker-header">
          <text class="picker-btn" @click="closePicker">取消</text>
          <text class="picker-title">选择地区</text>
          <text class="picker-btn picker-confirm" @click="confirmAddress">确定</text>
        </view>

        <!-- 面包屑导航 -->
        <view class="picker-breadcrumb">
          <text
            :class="['crumb', currentLevel === 0 ? 'crumb-active' : '']"
            @click="jumpToLevel(0)"
          >{{ tempProvince || '省份' }}</text>
          <text v-if="tempProvince" class="crumb-arrow">›</text>
          <text
            :class="['crumb', currentLevel === 1 ? 'crumb-active' : '']"
            @click="jumpToLevel(1)"
          >{{ tempCity || '城市' }}</text>
          <text v-if="tempCity" class="crumb-arrow">›</text>
          <text
            :class="['crumb', currentLevel === 2 ? 'crumb-active' : '']"
            @click="jumpToLevel(2)"
          >{{ tempDistrict || '区县' }}</text>
          <block v-if="effectiveLevels >= 4">
            <text v-if="tempDistrict" class="crumb-arrow">›</text>
            <text
              :class="['crumb', currentLevel === 3 ? 'crumb-active' : '']"
              @click="jumpToLevel(3)"
            >{{ tempStreet || '街道' }}</text>
          </block>
        </view>

        <!-- 选择列表 -->
        <scroll-view class="picker-list" scroll-y>
          <view
            v-for="(item, idx) in currentItems"
            :key="idx"
            :class="['picker-item', isSelected(item) ? 'picker-item-selected' : '']"
            @click="selectItem(item)"
          >
            <text class="item-text">{{ getItemName(item) }}</text>
            <text v-if="isSelected(item)" class="item-check">✓</text>
          </view>
          <view v-if="loading" class="picker-loading">
            <text>加载中...</text>
          </view>
        </scroll-view>
      </view>
    </view>
  </view>
</template>

<script>
import { getProvinces, getStreetChildren, getStreetPath } from '@/utils/api.js'

export default {
  name: 'AddressPicker',
  props: {
    value: {
      type: Number,
      default: null
    },
    // 联动层级：3=省/市/区县（收货地址等，详细地址另行输入）；4=省/市/区县/街道（默认）
    levels: {
      type: Number,
      default: 4
    },
    // 是否渲染组件自带的入口行；页面已有自己的表单行时传 false，通过 ref.open() 打开
    showTrigger: {
      type: Boolean,
      default: true
    },
    // 编辑回显用：{ province, city, district } 名称，打开面板时按名称回选
    initial: {
      type: Object,
      default: null
    }
  },
  data() {
    return {
      showPicker: false,
      currentLevel: 0, // 0=省份, 1=城市, 2=区县, 3=街道
      loading: false,
      // 数据列表
      provinces: [],
      cities: [],
      districts: [],
      streets: [],
      // 临时选中项
      tempProvince: null,
      tempCity: null,
      tempDistrict: null,
      tempStreet: null,
      // 完整地址文本
      currentAddress: ''
    }
  },
  computed: {
    // 支持 3 级（省市区）与 4 级（省市区街道），外部传入越界值时兜底
    effectiveLevels() {
      var n = Number(this.levels) || 4
      return Math.min(4, Math.max(3, n))
    },
    currentItems() {
      if (this.currentLevel === 0) return this.provinces
      if (this.currentLevel === 1) return this.cities
      if (this.currentLevel === 2) return this.districts
      if (this.currentLevel === 3) return this.streets
      return []
    }
  },
  watch: {
    value: {
      immediate: true,
      handler(newVal) {
        if (newVal) {
          this.loadAddressById(newVal)
        }
      }
    }
  },
  methods: {
    async loadProvinces() {
      this.loading = true
      try {
        const res = await getProvinces()
        this.provinces = res.data || []
      } catch (e) {
        console.error('加载省份失败', e)
      } finally {
        this.loading = false
      }
    },

    async loadCities(provinceId) {
      this.loading = true
      try {
        const res = await getStreetChildren(provinceId)
        this.cities = res.data || []
      } catch (e) {
        console.error('加载城市失败', e)
      } finally {
        this.loading = false
      }
    },

    async loadDistricts(cityId) {
      this.loading = true
      try {
        const res = await getStreetChildren(cityId)
        this.districts = res.data || []
      } catch (e) {
        console.error('加载区县失败', e)
      } finally {
        this.loading = false
      }
    },

    async loadStreets(districtId) {
      this.loading = true
      try {
        const res = await getStreetChildren(districtId)
        this.streets = res.data || []
      } catch (e) {
        console.error('加载街道失败', e)
      } finally {
        this.loading = false
      }
    },

    async loadAddressById(streetId) {
      try {
        // 必须用「完整路径」接口：/api/streets/{id}/path 返回 [省, 市, 区县, 街道]
        const res = await getStreetPath(streetId)
        const path = res.data || []

        if (path.length >= 3) {
          this.tempProvince = path[0]
          this.tempCity = path[1]
          this.tempDistrict = path[2]
          this.tempStreet = path[3] || null
          this.updateAddressText()
        }

        // 加载下级选项
        if (this.tempProvince) await this.loadCities(this.tempProvince.id)
        if (this.tempCity) await this.loadDistricts(this.tempCity.id)
        if (this.tempDistrict && this.effectiveLevels >= 4) await this.loadStreets(this.tempDistrict.id)
      } catch (e) {
        console.error('加载地址路径失败', e)
      }
    },

    // 对外入口：页面可用 ref.open() 打开面板（配合 show-trigger=false）
    async open() {
      this.showPicker = true
      if (this.provinces.length === 0) {
        await this.loadProvinces()
      }
      // 编辑回显：按传入的名称逐级回选
      if (this.initial && !this.tempProvince) {
        await this.applyInitial()
      }
    },

    // 兼容旧调用名
    openPicker() {
      return this.open()
    },

    async applyInitial() {
      var init = this.initial || {}
      if (!init.province) return

      var p = this.provinces.find((x) => this.getItemName(x) === init.province)
      if (!p) return
      this.tempProvince = p
      this.currentLevel = 1
      await this.loadCities(p.id)

      if (!init.city) return
      var c = this.cities.find((x) => this.getItemName(x) === init.city)
      if (!c) return
      this.tempCity = c
      this.currentLevel = 2
      await this.loadDistricts(c.id)

      if (!init.district) return
      var d = this.districts.find((x) => this.getItemName(x) === init.district)
      if (!d) return
      this.tempDistrict = d

      // 三级模式：停在区县列表，当前区县保持高亮，不再加载街道
      if (this.effectiveLevels <= 3) {
        this.currentLevel = 2
        return
      }
      this.currentLevel = 3
      await this.loadStreets(d.id)
    },

    closePicker() {
      this.showPicker = false
    },

    jumpToLevel(level) {
      if (level < this.currentLevel) {
        this.currentLevel = level
      }
    },

    selectItem(item) {
      if (this.currentLevel === 0) {
        this.tempProvince = item
        this.tempCity = null
        this.tempDistrict = null
        this.tempStreet = null
        this.cities = []
        this.districts = []
        this.streets = []
        this.currentLevel = 1
        this.loadCities(item.id)
      } else if (this.currentLevel === 1) {
        this.tempCity = item
        this.tempDistrict = null
        this.tempStreet = null
        this.districts = []
        this.streets = []
        this.currentLevel = 2
        this.loadDistricts(item.id)
      } else if (this.currentLevel === 2) {
        this.tempDistrict = item
        this.tempStreet = null
        this.streets = []
        if (this.effectiveLevels <= 3) {
          // 三级模式：选完区县即完成
          this.confirmAddress()
        } else {
          this.currentLevel = 3
          this.loadStreets(item.id)
        }
      } else if (this.currentLevel === 3) {
        this.tempStreet = item
        this.confirmAddress()
      }
    },

    confirmAddress() {
      // 三级模式必须选完整省/市/区县，避免只选省就确定把已存地区清空
      if (this.effectiveLevels <= 3) {
        if (!this.tempProvince || !this.tempCity || !this.tempDistrict) {
          uni.showToast({ title: '请选择省/市/区县', icon: 'none' })
          return
        }
      }
      this.updateAddressText()
      this.emitChange()
      this.closePicker()
    },

    updateAddressText() {
      var parts = []
      if (this.tempProvince) parts.push(this.tempProvince.province || this.tempProvince.name)
      if (this.tempCity) parts.push(this.tempCity.city || this.tempCity.name)
      if (this.tempDistrict) parts.push(this.tempDistrict.district || this.tempDistrict.name)
      if (this.effectiveLevels >= 4 && this.tempStreet) {
        parts.push(this.tempStreet.street || this.tempStreet.name)
      }
      this.currentAddress = parts.join('')
    },

    emitChange() {
      var hasStreet = this.effectiveLevels >= 4 && !!this.tempStreet
      const streetId = hasStreet ? this.tempStreet.id : null
      const addressData = {
        streetId: streetId,
        province: this.tempProvince ? this.tempProvince.province : null,
        city: this.tempCity ? this.tempCity.city : null,
        district: this.tempDistrict ? this.tempDistrict.district : null,
        street: hasStreet ? this.tempStreet.street : null,
        fullName: this.currentAddress
      }

      this.$emit('input', streetId)
      this.$emit('change', addressData)
    },

    getItemName(item) {
      if (!item) return ''
      return item.province || item.city || item.district || item.street || item.name || ''
    },

    isSelected(item) {
      var name = this.getItemName(item)
      if (this.currentLevel === 0) return this.tempProvince && this.getItemName(this.tempProvince) === name
      if (this.currentLevel === 1) return this.tempCity && this.getItemName(this.tempCity) === name
      if (this.currentLevel === 2) return this.tempDistrict && this.getItemName(this.tempDistrict) === name
      if (this.currentLevel === 3) return this.tempStreet && this.getItemName(this.tempStreet) === name
      return false
    },

    reset() {
      this.tempProvince = null
      this.tempCity = null
      this.tempDistrict = null
      this.tempStreet = null
      this.currentAddress = ''
      this.provinces = []
      this.cities = []
      this.districts = []
      this.streets = []
      this.currentLevel = 0
      this.emitChange()
    }
  }
}
</script>

<stylescoped lang="scss">
.address-picker {
  width: 100%;
}

.current-address {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 24rpx 20rpx;
  background: $facade-fill-page;
  border-radius: 12rpx;
  border: 2rpx solid $facade-hairline-2;
}

.address-text {
  font-size: 28rpx;
  color: $facade-text-strong;
  flex: 1;
}

.address-arrow {
  font-size: 32rpx;
  color: $facade-text-muted;
  margin-left: 10rpx;
}

/* 面板遮罩 */
.picker-mask {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  background: rgba(0, 0, 0, 0.5);
  z-index: 999;
  display: flex;
  align-items: flex-end;
}

.picker-panel {
  width: 100%;
  background: $app-surface;
  border-radius: 24rpx 24rpx 0 0;
  max-height: 70vh;
  display: flex;
  flex-direction: column;
}

/* 面板头部 */
.picker-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 30rpx 30rpx 20rpx;
  border-bottom: 1px solid $facade-hairline-2;
}

.picker-btn {
  font-size: 28rpx;
  color: $facade-text-body;
  padding: 10rpx 20rpx;
}

.picker-confirm {
  color: $brand-primary;
  font-weight: bold;
}

.picker-title {
  font-size: 32rpx;
  font-weight: bold;
  color: $facade-text-strong;
}

/* 面包屑导航 */
.picker-breadcrumb {
  display: flex;
  align-items: center;
  padding: 20rpx 30rpx;
  background: $facade-fill-ghost;
  border-bottom: 1px solid $facade-hairline-2;
  flex-wrap: wrap;
}

.crumb {
  font-size: 26rpx;
  color: $facade-text-body;
  padding: 8rpx 16rpx;
  background: $facade-hairline-2;
  border-radius: 20rpx;
}

.crumb-active {
  background: $brand-primary;
  color: $app-surface;
}

.crumb-arrow {
  font-size: 28rpx;
  color: $facade-text-muted;
  margin: 0 8rpx;
}

/* 选择列表 */
.picker-list {
  flex: 1;
  min-height: 300rpx;
  max-height: 500rpx;
  padding: 20rpx 0;
}

.picker-item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 28rpx 40rpx;
  border-bottom: 1px solid $facade-fill-2;
}

.item-text {
  font-size: 30rpx;
  color: $facade-text-strong;
}

.item-check {
  font-size: 32rpx;
  color: $brand-primary;
  font-weight: bold;
}

.picker-item-selected .item-text {
  color: $brand-primary;
  font-weight: bold;
}

.picker-loading {
  padding: 40rpx;
  text-align: center;
  color: $facade-text-muted;
  font-size: 28rpx;
}
</style>