@system.router (页面路由)

通过不同的uri访问不同的页面。

说明：

• 从API Version 8 开始，该接口不再维护，推荐使用新接口@ohos.router。

• 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import router from '@system.router';

router.push

push(options: RouterOptions): void

跳转到应用内的指定页面。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

示例：

// 在当前页面中
export default {
  pushPage() {
    router.push({
      uri: 'pages/routerpage2/routerpage2',
      params: {
        data1: 'message',
        data2: {
          data3: [123, 456, 789]
        }
      }
    });
  }
}

// 在routerpage2页面中
export default {
  data: {
    data1: 'default',
    data2: {
      data3: [1, 2, 3]
    }
  },
  onInit() {
    console.info('showData1:' + this.data1);
    console.info('showData3:' + this.data2.data3);
  }
}

说明： 页面路由栈支持的最大Page数量为32。

router.replace

replace(options: RouterOptions): void

用应用内的某个页面替换当前页面，并销毁被替换的页面。

系统能力： SystemCapability.ArkUI.ArkUI.Lite

参数：

示例：

// 在当前页面中
export default {
  replacePage() {
    router.replace({
      uri: 'pages/detail/detail',
      params: {
        data1: 'message'
      }
    });
  }
}

// 在detail页面中
export default {
  data: {
    data1: 'default'
  },
  onInit() {
    console.info('showData1:' + this.data1)
  }
}

router.back

back(options?: BackRouterOptions): void

返回上一页面或指定的页面。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

示例：

// index页面
export default {    
  indexPushPage() {        
    router.push({            
      uri: 'pages/detail/detail'      
    });        
  }
}

// detail页面
export default {    
  detailPushPage() {        
    router.push({            
      uri: 'pages/mall/mall'
    });    
  }
}

// mall页面通过back，将返回detail页面
export default {    
  mallBackPage() {        
    router.back();    
  }
}

// detail页面通过back，将返回index页面
export default {    
  defaultBack() {        
    router.back();    
  }
}

// 通过back，返回到detail页面
export default {    
  backToDetail() {        
    router.back({uri:'pages/detail/detail'});    
  }
}

说明： 示例中的uri字段是页面路由，由配置文件中的pages列表指定。

router.getParams⁷⁺

getParams(): ParamsInterface

获取当前页面的参数信息。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

router.clear

clear(): void

清空页面栈中的所有历史页面，仅保留当前页面作为栈顶页面。

系统能力： SystemCapability.ArkUI.ArkUI.Full

示例：

export default {    
  clearPage() {        
    router.clear();    
  }
}

router.getLength

getLength(): string

获取当前在页面栈内的页面数量。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

示例：

export default {     
  getLength() {        
    let size = router.getLength();        
    console.log('pages stack size = ' + size);    
  }
}

router.getState

getState(): RouterState

获取当前页面的状态信息。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

示例：

export default {     
  getState() {        
    let page = router.getState();
    console.log('current index = ' + page.index);
    console.log('current name = ' + page.name);
    console.log('current path = ' + page.path);
  }
}

router.enableAlertBeforeBackPage⁶⁺

enableAlertBeforeBackPage(options: EnableAlertBeforeBackPageOptions): void

开启页面返回询问对话框。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

示例：

export default {    
  enableAlertBeforeBackPage() {        
    router.enableAlertBeforeBackPage({            
      message: 'Message Info',            
      success: function() {                
        console.log('success');            
      },            
      cancel: function() {                
        console.log('cancel');            
      }   
    });    
  }
}

router.disableAlertBeforeBackPage⁶⁺

disableAlertBeforeBackPage(options?: DisableAlertBeforeBackPageOptions): void

禁用页面返回询问对话框。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

示例：

export default {    
  disableAlertBeforeBackPage() {        
    router.disableAlertBeforeBackPage({            
      success: function() {                
        console.log('success');            
      },            
      cancel: function() {                
        console.log('cancel');            
      } 
    });    
  }
}

RouterOptions

定义路由器的选项。

系统能力： 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Lite

BackRouterOptions

定义路由器返回的选项。

系统能力： 以下各项对应的系统能力有所不同，详见下表。

RouterState

定义路由器的状态。

系统能力： 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full

EnableAlertBeforeBackPageOptions⁶⁺

定义EnableAlertBeforeBackPage选项。

系统能力： 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full

DisableAlertBeforeBackPageOptions⁶⁺

定义DisableAlertBeforeBackPage参数选项。

系统能力： 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full

ParamsInterface