跳到主要内容

区划选择

场景介绍​

本章节将介绍如何集成区划选择控件。该控件不支持在智能表设备中调用。

区划选择控件可加载全球或指定国家的区划信息，支持以树状结构化选择，支持功能：

  • 支持查看选中区划的下级区划。
  • 支持推荐热门区划。
  • 支持子窗拉起区划控件，适合宽屏设备使用。

图1 选择国家

图2 选择省市

图3 搜索地区

图4 子窗拉起区划控件

约束与限制​

使用该功能需满足以下条件：

  • 仅支持手机、平板和2in1设备。

接口说明​

区划选择控件功能主要由sceneMap命名空间下的selectDistrict方法提供，更多接口及使用方法请参见接口文档。

接口名描述
DistrictSelectOptions区划选择页面初始选项。
selectDistrict(context: common.Context, options: DistrictSelectOptions): Promise<DistrictSelectResult>调出区划选择页面。
DistrictSelectResult区划选择结果。

开发步骤​

  1. 导入相关模块。

    import { sceneMap } from '@kit.MapKit';
    import { BusinessError } from '@kit.BasicServicesKit';

  2. 创建区划选择请求参数，调用selectDistrict方法拉起区划选择页。

    let districtSelectOptions: sceneMap.DistrictSelectOptions = {
      countryCode: "CN",
      // 使用子窗拉起方式
      subWindowEnabled: true
    };
    // 拉起区划选择页
    sceneMap.selectDistrict(this.getUIContext().getHostContext(), districtSelectOptions).then((data) => {
      console.info("SelectDistrict", "Succeeded in selecting district.");
    }).catch((err: BusinessError) => {
      console.error("SelectDistrict", `Failed to select district, code: ${err.code}, message: ${err.message}`);
    });