更新记录

1.0.5(2025-06-12) 下载此版本

flx

1.0.4(2025-06-12) 下载此版本

flx

1.0.3(2025-06-12) 下载此版本

flx

查看更多

平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
-

其他

多语言 暗黑模式 宽屏模式
× ×

aure-country-picker 国际区号选择组件

组件参数说明

基本用法

<template>
  <aure-country-picker
    v-model="selectedDialCode"
    :title="'选择国家/地区'"
    :height="'70%'"
    :width="'60vw'"
    :duration="350"
    :position="'bottom'"
    :round="true"
    :radius="'24rpx'"
    :mask-closable="true"
  ></aure-country-picker>
</template>
<script setup>
import { ref } from 'vue'
const selectedDialCode = ref('86')  // 默认中国区号
</script>

Props 参数

参数名 类型 默认值 说明 可选值/示例
v-model String/Number undefined 当前选中的区号(只支持区号,不是国家 code),用作 v-model 双向绑定 '86', '1'
title String '选择国家/地区' 弹窗顶部标题文字 '选择国家/地区'
height String '80%' 弹窗高度,仅 position=bottom/top 有效 '70%', '480rpx'
width String '80%' 弹窗宽度,仅 position=left/right 有效 '60vw', '500rpx'
duration Number 300 弹窗动画时长(ms) 200, 400
position String 'bottom' 弹窗出现方向 'bottom', 'top', 'left', 'right'
round Boolean true 弹窗是否带圆角 true, false
radius String '24rpx' 圆角半径,带单位 '16rpx', '20px'
maskClosable Boolean true 点击遮罩是否允许关闭弹窗 true, false
countryList Array 内置国家数据 自定义数据源,数组结构同 /country-data.js,一般无需设置 []

事件

事件名 说明 参数
v-model 选中区号发生变化时触发 区号字符串(如 '86''1'
change 选中国家对象变化时触发 完整国家对象 { code, name, localName, dial_code }

数据源结构

每条数据结构如下(一般不用自定义):

{
  name: "China",
  localName: "中国",
  dial_code: "86",
  code: "CN"
}

内置所有国际主流国家/地区,无需自定义,特殊需要时可传 :country-list="自定义数据"

插槽

暂无自定义插槽(如需扩展可按实际需求自行 PR)。

典型用法场景

  • 手机号输入注册登录,选择区号
  • 绑定海外手机号
  • 表单注册/认证场景的国际化

Tips:

  • 组件自动根据 v-model 选中区号(如 '1'),如果一个区号有多个国家,则会优先匹配表中的第一个(如加拿大/美国等,二次选择时会精确到 code)。
  • 搜索支持中文、英文、区号、ISO 国家码。
  • 国旗图片路径默认 /static/flags/xx.png,可根据实际项目调整。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问