国家选择组件
一、ml-country-selector是什么?
"ml-country-selector基于typescript实现和rollup打包,是一款开箱即用的选择国家名称前端组件,支持自定义国家名称数据
二、使用步骤
1.引入库
代码如下(示例):
npm i ml-country-selector -S
注意如果是npm方式就需要这样引入
import {
mlCountrySelector } from 'ml-country-selector';
2.初始化使用
在需要的地方初始化使用,demo如下:
注意必须提供一个容器元素
代码如下(示例):
let instance = mlCountrySelector.initializationFn({
el: '#container',
// 初始化请求类型,建议true
isHttps: true,
// 唯一校验key 前往官网获取(http://luckycola.com.cn)
colaKey: 'nCkNqVE4HYldsw1697442858722W',
// 是否开启input动画伸缩功能 即“清除”按钮 强烈建议开启
animaInput: true,
// 自定义按钮文案,仅animaInput开启时候生效
inputOutBtnTxt: '取消',
// input没有搜到任何内容时 失去焦点立即重制所有状态
immediatelyReset: false,
// input搜索是否全局匹配
globalSearchWord: false,
// 是否支持拼音搜索,默认false(非全局匹配模式才生效)
supportEnSearch: false,
// 是否开启列表独立滚动,搜索区域固定
fixedAndScroll: true,
// 自定义滚动区域高度px fixedAndScroll=true有效
scrollviewHeight: null,
// 搜索数据源是否需要包含“推荐”部分数据
serachDataIncludeRecommend: false,
// 是否在选中国家后重置状态
selectCountryAfterReset: false,
// 当使用input搜索结果为0时候是否也显示国家列表现,如果不显示就会是空状态视图, 默认false不显示
searchEmptyShowCountryList: false,
// 搜索输入最大字符数 默认值20
searchInputMaxNum: 10,
// 是否开启连续匹配模式下的匹配独立样式 默认false 且globalSearchWord=false生效
searchWordAddStyle: true,
// 是否滚动出现侧边提示大气泡
scrollBodyBubble: true,
// 是否左侧列表区域字母吸顶(仅当fixedAndScroll=true时候有效)
leftTipTop: true,
// 侧边栏跟随监听偏移值 PX
leftActionSpan: 163,
// input类型 默认值text,如果useServerSeach=true时建议值search
inputType: 'text',
// 是否启用server搜索和推荐
useServerSeach