萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 實現阿里巴巴風格城市選擇器:二級聯動、鍵盤導航、虛擬列表與無障礙完整組件化

需求分析

  • 省份/城市二級聯動(支援直轄市無二級)
  • 鍵盤完整操作(Tab、方向鍵、Enter、Esc)
  • 虛擬列表渲染(支援 300+ 城市不卡頓)
  • 無障礙:ARIA 屬性、螢幕閱讀器友好
  • 響應式:行動裝置底部彈出、桌面下拉
  • 零依賴、TypeScript 就緒、可主題化

資料結構


const cityData = [
  {code: '110000', name: '北京', children: []},
  {code: '310000', name: '上海', children: []},
  {code: '440000', name: '廣東', children: [
    {code: '440100', name: '廣州'},
    {code: '440300', name: '深圳'},
    {code: '440400', name: '珠海'}
  ]},
  // ... 所有省市區資料
];

核心組件架構


class CityPicker {
  constructor(triggerEl, options = {}) {
    this.trigger = triggerEl;
    this.data = options.data || cityData;
    this.value = options.value || null; // {province, city}
    this.onChange = options.onChange;
    this.isMobile = window.innerWidth < 768;
    this.render();
    this.bindEvents();
  }
  
  render() {
    // 建立下拉面板 DOM,掛載 document.body(避免 overflow 截斷)
    // 結構:省份列表 + 城市列表(或單列表)
    // 使用虛擬滾動:僅渲染可視區 + 緩衝區項目
  }
  
  // 虛擬列表核心邏輯
  renderVirtualList(container, items, itemHeight, renderItem) {
    const scrollTop = container.scrollTop;
    const visibleCount = Math.ceil(container.clientHeight / itemHeight);
    const start = Math.max(0, Math.floor(scrollTop / itemHeight) - 5);
    const end = Math.min(items.length, start + visibleCount + 10);
    
    container.style.paddingTop = `${start * itemHeight}px`;
    container.style.paddingBottom = `${(items.length - end) * itemHeight}px`;
    
    const fragment = document.createDocumentFragment();
    for (let i = start; i < end; i++) {
      fragment.appendChild(renderItem(items[i], i));
    }
    container.innerHTML = '';
    container.appendChild(fragment);
  }
}

鍵盤導航實現


handleKeydown(e) {
  const focused = this.panel.querySelector('[data-focused]');
  switch (e.key) {
    case 'ArrowDown':
      e.preventDefault();
      this.focusNext(focused);
      break;
    case 'ArrowUp':
      e.preventDefault();
      this.focusPrev(focused);
      break;
    case 'Enter':
      e.preventDefault();
      focused?.click();
      break;
    case 'Escape':
      this.close();
      this.trigger.focus();
      break;
    case 'Tab':
      if (!this.isMobile) this.close(); // 桌面端 Tab 關閉
      break;
  }
}

無障礙屬性


// 觸發按鈕


// 面板
北京
廣州

狀態管理與事件流


selectProvince(province) {
  this.value = {province, city: null};
  this.renderCityList(province.children);
  this.updateTriggerText();
  if (province.children.length === 0) this.confirm(); // 直轄市直接確認
}

selectCity(city) {
  this.value = {...this.value, city};
  this.confirm();
}

confirm() {
  this.close();
  this.onChange?.(this.value);
  this.trigger.focus();
}

樣式隔離:CSS Modules / Shadow DOM


// Shadow DOM 方案(完全隔離)
this.shadow = this.trigger.attachShadow({mode: 'open'});
this.shadow.adoptedStyleSheets = [cityPickerStylesheet]; // 建構式樣式表
this.shadow.appendChild(this.panel);

效能優化清單

  1. 虛擬列表:只渲染可視區 +- 5 項
  2. 事件委派:面板單一監聽器處理 click/keydown
  3. 防抖搜尋:輸入框過濾城市時 200ms 防抖
  4. 資料預載:IntersectionObserver 預載入熱門城市
  5. CSS `contain: layout paint` 限制重排範圍

現代框架整合

Vue 3 組合式 API


const useCityPicker = (props, emit) => {
  const panelRef = ref(null);
  const provinceList = computed(() => props.data);
  const cityList = computed(() => props.value?.province?.children || []);
  // ... 虛擬列表、鍵盤導航、ARIA 邏輯
  return {panelRef, provinceList, cityList, selectProvince, selectCity};
};

React Hook


const useCityPicker = (data, onChange) => {
  const [province, setProvince] = useState(null);
  const [city, setCity] = useState(null);
  const [open, setOpen] = useState(false);
  // ... 邏輯
  return {province, city, open, setOpen, setProvince, setCity};
};

總結

城市選擇器是典型的「看似簡單、實則複雜」UI 組件。優秀實現需兼顧:資料結構設計、虛擬列表效能、鍵盤/無障礙完整支援、響應式佈局、框架無關核心邏輯、樣式隔離。建議採用成熟庫(如 Vant Area、El-Cascader、Antd Cascader)或參考其源碼自建,避免重複造輪子並踩坑。

copyright © 萬盛學電腦網 all rights reserved