更新记录
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
,可根据实际项目调整。