移动端JS实现按首字母快速检索城市列表

作者:青柠时间:2026-10-22 05:37:03浏览:472

本文介绍如何使用JavaScript和better-scroll插件在移动端实现类似通讯录的城市列表按首字母快速检索功能。通过加载城市数据,利用CSS定位右侧字母导航,并绑定touch事件监听用户滑动,实现高效的城市定位与滚动体验。

移动端城市列表按首字母检索实现

常见的手机通讯录或微信通讯录中,联系人信息通常按字母顺序排列,用户点击右侧字母即可快速定位到对应首字母的联系人。本文将介绍如何实现类似效果的城市列表检索功能,让用户能迅速定位到目标城市。

移动端城市列表按首字母检索实现 查看演示 下载源码 准备

查看演示 下载源码

准备工作

准备

首先,我们需要获取全国城市数据。这些数据来源于网络,作者已将其格式化为JSON格式,用户可以直接使用。

此外,我们需要引入一个名为better-scroll的滚动插件。该插件能够处理超长页面的原生滚动条,优化滚动效果。

HTML结构准备

接下来,准备HTML结构。


<div class="city"> 
 <div class="city-wrapper city-wrapper-hook"> 
 <div class="scroller-hook"> 
 <div class="cities cities-hook"></div> 
 </div> 
 <div class="shortcut shortcut-hook"></div> 
 </div> 
</div> 

.cities类用于装载城市数据列表;.shortcut类用于装载首字母列表,需使用CSS将其定位在右侧。

JavaScript代码实现

Javascript

在编写JS代码之前,先加载城市数据city.js和better-scroll插件。


<script src="js/bscroll.min.js"> </script> 
<script src="js/city.js"> </script>

开始编写JS代码,首先定义所需变量:


var cityWrapper = document.querySelector('.city-wrapper-hook'); 
var cityScroller = document.querySelector('.scroller-hook'); 
var cities = document.querySelector('.cities-hook'); 
var shortcut = document.querySelector('.shortcut-hook'); 
var scroll; 
var shortcutList = []; 
var anchorMap = {};

函数initCities()循环遍历city.js中的城市数据,提取城市名称、首字母和id信息,并一次性添加到数据列表中。随后调用BScroll插件方法。


function initCities() { 
 var y = 0; 
 var titleHeight = 28; 
 var itemHeight = 44; 
 var lists = ''; 
 var en = '<ul>'; 
 cityData.forEach(function (group) { 
 var name = group.name; 
 lists += '<div class="title">'+name+'</div>'; 
 lists += '<ul>'; 
 group.cities.forEach(function(g) { 
 lists += '<li class="item" data-name="'+ g.name +'" data-id="'+ g.cityid +'"><span class="border-1px name">'+ g.name +'</span></li>'; 
 }); 
 lists += '</ul>'; 
 var name = group.name.substr(0, 1); 
 en += '<li data-anchor="'+name+'" class="item">'+name+'</li>'; 
 var len = group.cities.length; 
 anchorMap[name] = y; 
 y -= titleHeight + len * itemHeight; 
 }); 
 en += '</ul>'; 
 cities.innerHTML = lists; 
 shortcut.innerHTML = en; 
 shortcut.style.top = (cityWrapper.clientHeight - shortcut.clientHeight) / 2 + 'px'; 
 scroll = new window.BScroll(cityWrapper, { 
 probeType: 3 //1 会截流,只有在滚动结束的时候派发一个 scroll 事件。2在手指 move 的时候也会实时派发 scroll 事件,不会截流。 3除了手指 move 的时候派发scroll事件,在 swipe(手指迅速滑动一小段距离)的情况下,列表会有一个长距离的滚动动画,这个滚动的动画过程中也会实时派发滚动事件 
 }); 
 scroll.scrollTo(0, 0); 
}

然后,函数bindEvent()绑定事件,监听右侧首字母的touchstart和touchmove事件。


function bindEvent() { 
 var touch = {}; 
 var firstTouch; 
 shortcut.addEventListener('touchstart', function (e) { 
 var anchor = e.target.getAttribute('data-anchor'); 
 firstTouch = e.touches[0]; 
 touch.y1 = firstTouch.pageY; 
 touch.anchor = anchor; 
 scrollTo(anchor); 
 }); 
 shortcut.addEventListener('touchmove', function (e) { 
 firstTouch = e.touches[0]; 
 touch.y2 = firstTouch.pageY; 
 var anchorHeight = 16; 
 var delta = (touch.y2 - touch.y1) / anchorHeight | 0; 
 var anchor = shortcutList[shortcutList.indexOf(touch.anchor) + delta]; 
 scrollTo(anchor); 
 e.preventDefault(); 
 e.stopPropagation(); 
 }); 
 function scrollTo(anchor) { 
 var maxScrollY = cityWrapper.clientHeight - cityScroller.clientHeight; 
 var y = Math.min(0, Math.max(maxScrollY, anchorMap[anchor])); 
 if (typeof y !== 'undefined') { 
 scroll.scrollTo(0, y); 
 } 
 } 
}

最后,调用并执行这两个函数。


initCities(); 
bindEvent();

现在,使用手机或平板访问即可看到效果。如果需要实现通讯录效果,只需将联系人数据格式化为city.js中对应的JSON格式即可。

以上所述是小编给大家介绍的JS实现移动端按首字母检索城市列表,希望对大家有所帮助。如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对本站网站的支持!

作者最新文章