首页 > 其他分享 >HarmonyOS实战开发:@ohos.router (页面路由)

HarmonyOS实战开发:@ohos.router (页面路由)

时间:2024-05-29 17:58:47浏览次数:38  
标签:err 错误码 HarmonyOS ohos router message ArkUI 页面

本模块提供通过不同的url访问不同的页面,包括跳转到应用内的指定页面、同应用内的某个页面替换当前页面、返回上一页面或指定的页面等。

说明

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

  • 页面路由需要在页面渲染完成之后才能调用,在onInit和onReady生命周期中页面还处于渲染阶段,禁止调用页面路由方法。

  • 本模块功能依赖UI的执行上下文,不可在UI上下文不明确的地方使用,参见UIContext说明。

  • 从API version 10开始,可以通过使用UIContext中的getRouter方法获取当前UI上下文关联的Router对象。

  • 为了实现更好的转场效果,推荐使用Navigation组件模态转场

导入模块

import router from '@ohos.router'

router.pushUrl9+

pushUrl(options: RouterOptions): Promise<void>

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

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

参数:

参数名类型必填说明
选项路由器选项跳转页面描述信息。

返回值:

类型说明
承诺<无效>异常返回结果。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到 UI 执行上下文。
100002如果 URI 不存在。
100003如果页面推送过多。

示例:

import { BusinessError } from '@ohos.base';

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

try {
  router.pushUrl({
    url: 'pages/routerpage2',
    params: new routerParams('message' ,[123,456,789])
  })
} catch (err) {
  console.error(`pushUrl failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

router.pushUrl9+

pushUrl(options: RouterOptions, callback: AsyncCallback<void>): void

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

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

参数:

参数名类型必填说明
选项路由器选项跳转页面描述信息。
回调AsyncCallback<void>异常响应回调。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到 UI 执行上下文。
100002如果 URI 不存在。
100003如果页面推送过多。

示例:

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

router.pushUrl({
  url: 'pages/routerpage2',
  params: new routerParams('message' ,[123,456,789])
}, (err) => {
  if (err) {
    console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('pushUrl success');
})

router.pushUrl9+

pushUrl(options: RouterOptions, mode: RouterMode): Promise<void>

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

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

参数:

参数名类型必填说明
选项路由器选项跳转页面描述信息。
模式路由器模式跳转页面使用的模式。

返回值:

类型说明
承诺<无效>异常返回结果。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到 UI 执行上下文。
100002如果 URI 不存在。
100003如果页面推送过多。

示例:

import { BusinessError } from '@ohos.base';

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

try {
  router.pushUrl({
    url: 'pages/routerpage2',
    params: new routerParams('message' ,[123,456,789])
  }, router.RouterMode.Standard)
} catch (err) {
  console.error(`pushUrl failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

router.pushUrl9+

pushUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback<void>): void

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

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

参数:

参数名类型必填说明
optionsRouterOptions跳转页面描述信息。
modeRouterMode跳转页面使用的模式。
callbackAsyncCallback<void>异常响应回调。

错误码:

以下错误码的详细介绍请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001if UI execution context not found.
100002if the uri is not exist.
100003if the pages are pushed too much.

示例:

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

router.pushUrl({
  url: 'pages/routerpage2',
  params: new routerParams('message' ,[123,456,789])
}, router.RouterMode.Standard, (err) => {
  if (err) {
    console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('pushUrl success');
})

router.replaceUrl9+

replaceUrl(options: RouterOptions): Promise<void>

用应用内的某个页面替换当前页面,并销毁被替换的页面。不支持设置页面转场动效,如需设置,推荐使用Navigation组件

系统能力:系统功能.ArkUI.ArkUI.Lite

参数:

参数名类型必填说明
选项路由器选项替换页面描述信息。

返回值:

类型说明
承诺<无效>异常返回结果。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到UI执行上下文,则仅投入标准系统。
200002如果 URI 不存在。

示例:

import { BusinessError } from '@ohos.base';

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

try {
  router.replaceUrl({
    url: 'pages/detail',
    params: new routerParams('message')
  })
} catch (err) {
  console.error(`replaceUrl failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

router.replaceUrl9+

replaceUrl(options: RouterOptions, callback: AsyncCallback<void>): void

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

系统能力:系统功能.ArkUI.ArkUI.Lite

参数:

参数名类型必填说明
选项路由器选项替换页面描述信息。
回调AsyncCallback<void>异常响应回调。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到UI执行上下文,则仅投入标准系统。
200002如果 URI 不存在。

示例:

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

router.replaceUrl({
  url: 'pages/detail',
  params: new routerParams('message')
}, (err) => {
  if (err) {
    console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('replaceUrl success');
})

router.replaceUrl9+

replaceUrl(options: RouterOptions, mode: RouterMode): Promise<void>

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

系统能力:系统功能.ArkUI.ArkUI.Lite

参数:

参数名类型必填说明
选项路由器选项替换页面描述信息。
模式路由器模式跳转页面使用的模式。

返回值:

类型说明
承诺<无效>异常返回结果。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001if can not get the delegate, only throw in standard system.
200002如果 URI 不存在。

示例:

import { BusinessError } from '@ohos.base';

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

try {
  router.replaceUrl({
    url: 'pages/detail',
    params: new routerParams('message')
  }, router.RouterMode.Standard)
} catch (err) {
  console.error(`replaceUrl failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

router.replaceUrl9+

replaceUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback<void>): void

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

系统能力:系统功能.ArkUI.ArkUI.Lite

参数:

参数名类型必填说明
选项路由器选项替换页面描述信息。
模式路由器模式跳转页面使用的模式。
回调AsyncCallback<void>异常响应回调。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到UI执行上下文,则仅投入标准系统。
200002如果 URI 不存在。

示例:

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

router.replaceUrl({
  url: 'pages/detail',
  params: new routerParams('message')
}, router.RouterMode.Standard, (err) => {
  if (err) {
    console.error(`replaceUrl failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('replaceUrl success');
});

router.pushNamedRoute10+

pushNamedRoute(options: NamedRouterOptions): Promise<void>

跳转到指定的命名路由页面。

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

参数:

参数名类型必填说明
选项NamedRouterOptions跳转页面描述信息。

返回值:

类型说明
承诺<无效>异常返回结果。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到 UI 执行上下文。
100003如果页面推送过多。
100004如果命名路由不存在。

示例:

import { BusinessError } from '@ohos.base';

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

try {
  router.pushNamedRoute({
    name: 'myPage',
    params: new routerParams('message' ,[123,456,789])
  })
} catch (err) {
  console.error(`pushNamedRoute failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

详细示例请参考:UI开发-页面路由

router.pushNamedRoute10+

pushNamedRoute(options: NamedRouterOptions, callback: AsyncCallback<void>): void

跳转到指定的命名路由页面。

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

参数:

参数名类型必填说明
optionsNamedRouterOptions跳转页面描述信息。
callbackAsyncCallback<void>异常响应回调。

错误码:

以下错误码的详细介绍请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001if UI execution context not found.
100003if the pages are pushed too much.
100004if the named route is not exist.

示例:

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

router.pushNamedRoute({
  name: 'myPage',
  params: new routerParams('message' ,[123,456,789])
}, (err) => {
  if (err) {
    console.error(`pushNamedRoute failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('pushNamedRoute success');
})

router.pushNamedRoute10+

pushNamedRoute(options: NamedRouterOptions, mode: RouterMode): Promise<void>

跳转到指定的命名路由页面。

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

参数:

参数名类型必填说明
optionsNamedRouterOptions跳转页面描述信息。
modeRouterMode跳转页面使用的模式。

返回值:

类型说明
Promise<void>异常返回结果。

错误码:

以下错误码的详细介绍请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001if UI execution context not found.
100003if the pages are pushed too much.
100004if the named route is not exist.

示例:

import { BusinessError } from '@ohos.base';

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

try {
  router.pushNamedRoute({
    name: 'myPage',
    params: new routerParams('message' ,[123,456,789])
  }, router.RouterMode.Standard)
} catch (err) {
  console.error(`pushNamedRoute failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

router.pushNamedRoute10+

pushNamedRoute(options: NamedRouterOptions, mode: RouterMode, callback: AsyncCallback<void>): void

跳转到指定的命名路由页面。

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

参数:

参数名类型必填说明
选项NamedRouterOptions跳转页面描述信息。
模式路由器模式跳转页面使用的模式。
回调AsyncCallback<void>异常响应回调。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到 UI 执行上下文。
100003如果页面推送过多。
100004如果命名路由不存在。

示例:

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

router.pushNamedRoute({
  name: 'myPage',
  params: new routerParams('message' ,[123,456,789])
}, router.RouterMode.Standard, (err) => {
  if (err) {
    console.error(`pushNamedRoute failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('pushNamedRoute success');
})

router.replaceNamedRoute10+

replaceNamedRoute(options: NamedRouterOptions): Promise<void>

用指定的命名路由页面替换当前页面,并销毁被替换的页面。

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

参数:

参数名类型必填说明
选项NamedRouterOptions替换页面描述信息。

返回值:

类型说明
承诺<无效>异常返回结果。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到UI执行上下文,则仅投入标准系统。
100004如果命名路由不存在。

示例:

import { BusinessError } from '@ohos.base';

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

try {
  router.replaceNamedRoute({
    name: 'myPage',
    params: new routerParams('message')
  })
} catch (err) {
  console.error(`replaceNamedRoute failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

router.replaceNamedRoute10+

replaceNamedRoute(options: NamedRouterOptions, callback: AsyncCallback<void>): void

用指定的命名路由页面替换当前页面,并销毁被替换的页面。

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

参数:

参数名类型必填说明
选项NamedRouterOptions替换页面描述信息。
回调AsyncCallback<void>异常响应回调。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到UI执行上下文,则仅投入标准系统。
100004如果命名路由不存在。

示例:

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

router.replaceNamedRoute({
  name: 'myPage',
  params: new routerParams('message')
}, (err) => {
  if (err) {
    console.error(`replaceNamedRoute failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('replaceNamedRoute success');
})

router.replaceNamedRoute10+

replaceNamedRoute(options: NamedRouterOptions, mode: RouterMode): Promise<void>

用指定的命名路由页面替换当前页面,并销毁被替换的页面。

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

参数:

参数名类型必填说明
选项NamedRouterOptions替换页面描述信息。
模式路由器模式跳转页面使用的模式。

返回值:

类型说明
Promise<void>异常返回结果。

错误码:

以下错误码的详细介绍请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001if can not get the delegate, only throw in standard system.
100004if the named route is not exist.

示例:

import { BusinessError } from '@ohos.base';

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

try {
  router.replaceNamedRoute({
    name: 'myPage',
    params: new routerParams('message')
  }, router.RouterMode.Standard)
} catch (err) {
  console.error(`replaceNamedRoute failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

router.replaceNamedRoute10+

replaceNamedRoute(options: NamedRouterOptions, mode: RouterMode, callback: AsyncCallback<void>): void

用指定的命名路由页面替换当前页面,并销毁被替换的页面。

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

参数:

参数名类型必填说明
选项NamedRouterOptions替换页面描述信息。
模式路由器模式跳转页面使用的模式。
回调AsyncCallback<void>异常响应回调。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到UI执行上下文,则仅投入标准系统。
100004如果命名路由不存在。

示例:

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

router.replaceNamedRoute({
  name: 'myPage',
  params: new routerParams('message')
}, router.RouterMode.Standard, (err) => {
  if (err) {
    console.error(`replaceNamedRoute failed, code is ${err.code}, message is ${err.message}`);
    return;
  }
  console.info('replaceNamedRoute success');
});

router.back

back(options?: RouterOptions ): void

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

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

参数:

参数名类型必填说明
选项路由器选项返回页面描述信息,其中参数url指路由跳转时会返回到指定url的界面,如果页面栈上没有url页面,则不响应该情况。如果url未设置,则返回上一页,页面不会重新构建,页面栈里面的page不会回收,出栈后会被回收。

示例:

router.back({url:'pages/detail'});    

router.clear

clear(): void

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

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

示例:

router.clear();    

router.getLength

getLength(): string

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

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

返回值:

类型说明
字符串页面数量,页面栈支持最大数值是32。

示例:

let size = router.getLength();        
console.log('pages stack size = ' + size);    

router.getState

getState(): RouterState

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

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

返回值:

类型说明
RouterState页面状态信息。

示例:

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

RouterState

页面状态信息。

系统能力:SystemCapability.ArkUI.ArkUI.Full。

名称类型必填说明
指数表示当前页面在页面栈中的索引。从栈底到栈顶,index从1开始递增。
名字字符串表示当前页面的名称,即对应文件名。
路径字符串表示当前页面的路径。

router.showAlertBeforeBackPage9+

showAlertBeforeBackPage(options: EnableAlertOptions): void

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

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

参数:

参数名类型必填说明
选项EnableAlertOptions文本弹窗信息描述。

错误码:

以下错误码的详细介绍,请参见ohos.router(页面路由)错误码。

错误码ID错误信息
100001如果未找到 UI 执行上下文。

示例:

import { BusinessError } from '@ohos.base';

try {
  router.showAlertBeforeBackPage({
    message: 'Message Info'
  });
} catch(err) {
  console.error(`showAlertBeforeBackPage failed, code is ${(err as BusinessError).code}, message is ${(err as BusinessError).message}`);
}

EnableAlertOptions

页面返回询问对话框选项。

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

名称类型必填说明
消息字符串询问对话框内容。

router.hideAlertBeforeBackPage9+

hideAlertBeforeBackPage(): void

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

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

示例:

router.hideAlertBeforeBackPage();    

router.getParams

getParams(): Object

获取发起跳转的页面往当前页传入的参数。

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

返回值:

类型说明
object发起跳转的页面往当前页传入的参数。

示例:

router.getParams();

路由器选项

路由跳转选项。

系统能力: SystemCapability.ArkUI.ArkUI.Lite。

名称类型必填说明
url字符串表示目标页面的url,可以用以下两种格式:
- 页面绝对路径,由配置文件中pages列表提供,例如:
  - pages/index/index
  - pages/detail/detail
- 特殊值,如果url的值是"/",则跳转到首页。
paramsobject表示路由跳转时要同时传递到目标页面的数据,切换到其他页面时,当前接收的数据失效。跳转到目标页面后,使用router.getParams()获取传递的参数,此外,在类web范式中,参数也可以在页面中直接使用,如this.keyValue(keyValue为跳转时params参数中的key值),如果目标页面中已有该字段,则其值会被传入的字段值覆盖。
说明:
params参数不能传递方法和系统接口返回的对象(例如,媒体接口定义和返回的PixelMap对象)。建议开发者提取系统接口返回的对象中需要被传递的基础类型属性,自行构造object类型对象进行传递。

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

RouterMode9+

路由跳转模式。

系统能力:SystemCapability.ArkUI.ArkUI.Full。

名称说明
Standard多实例模式,也是默认情况下的跳转模式。
目标页面会被添加到页面栈顶,无论栈中是否存在相同url的页面。
说明: 不使用路由跳转模式时,则按照默认的多实例模式进行跳转。
Single单实例模式。
如果目标页面的url已经存在于页面栈中,则会将离栈顶最近的同url页面移动到栈顶,该页面成为新建页。
如果目标页面的url在页面栈中不存在同url页面,则按照默认的多实例模式进行跳转。

NamedRouterOptions10+

命名路由跳转选项。

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

名称类型必填说明
名字字符串表示目标命名路由页面的name。
paramsobject表示路由跳转时要同时传递到目标页面的数据。跳转到目标页面后,使用router.getParams()获取传递的参数,此外,在类web范式中,参数也可以在页面中直接使用,如this.keyValue(keyValue为跳转时params参数中的key值),如果目标页面中已有该字段,则其值会被传入的字段值覆盖。

完整示例

基于JS扩展的类Web开发范式

以下代码仅适用于javascript文件,不适用于ArkTS文件

// 在当前页面中
export default {
  pushPage() {
    router.push({
      url: 'pages/detail/detail',
      params: {
        data1: 'message'
      }
    });
  }
}
// 在detail页面中
export default {
  onInit() {
    console.info('showData1:' + router.getParams()['data1']);
  }
}

基于TS扩展的声明式开发范式

// 通过router.pushUrl跳转至目标页携带params参数
import router from '@ohos.router'
import { BusinessError } from '@ohos.base'

// 定义传递参数的类
class innerParams {
  array:number[]

  constructor(tuple:number[]) {
    this.array = tuple
  }
}

class routerParams {
  text:string
  data:innerParams

  constructor(str:string, tuple:number[]) {
    this.text = str
    this.data = new innerParams(tuple)
  }
}

@Entry
@Component
struct Index {
  async routePage() {
    let options:router.RouterOptions = {
      url: 'pages/second',
      params: new routerParams('这是第一页的值' ,[12, 45, 78])
    }
    try {
      await router.pushUrl(options)
    } catch (err) {
      console.info(` fail callback, code: ${(err as BusinessError).code}, msg: ${(err as BusinessError).message}`)
    }
  }

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Text('这是第一页')
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
      Button() {
        Text('next page')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({ top: 20 })
      .backgroundColor('#ccc')
      .onClick(() => {
        this.routePage()
      })
    }
    .width('100%')
    .height('100%')
  }
}
// 在second页面中接收传递过来的参数
import router from '@ohos.router'

class innerParams {
  array:number[]

  constructor(tuple:number[]) {
    this.array = tuple
  }
}

class routerParams {
  text:string
  data:innerParams

  constructor(str:string, tuple:number[]) {
    this.text = str
    this.data = new innerParams(tuple)
  }
}

@Entry
@Component
struct Second {
  private content: string = "这是第二页"
  @State text: string = (router.getParams() as routerParams).text
  @State data: object = (router.getParams() as routerParams).data
  @State secondData: string = ''

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Text(`${this.content}`)
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
      Text(this.text)
        .fontSize(30)
        .onClick(() => {
          this.secondData = (this.data['array'][1]).toString()
        })
        .margin({ top: 20 })
      Text(`第一页传来的数值:${this.secondData}`)
        .fontSize(20)
        .margin({ top: 20 })
        .backgroundColor('red')
    }
    .width('100%')
    .height('100%')
  }
}

router.push(deprecated)

push(options: RouterOptions): void

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

从API version9开始不再维护,建议使用pushUrl9+

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

参数:

参数名类型必填说明
选项路由器选项跳转页面描述信息。

示例:

class innerParams {
  data3:number[]

  constructor(tuple:number[]) {
    this.data3 = tuple
  }
}

class routerParams {
  data1:string
  data2:innerParams

  constructor(str:string, tuple:number[]) {
    this.data1 = str
    this.data2 = new innerParams(tuple)
  }
}

router.push({
  url: 'pages/routerpage2',
  params: new routerParams('message' ,[123,456,789])
});

router.replace(deprecated)

replace(options: RouterOptions): void

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

从API version9开始不再维护,建议使用replaceUrl9+

系统能力:系统功能.ArkUI.ArkUI.Lite

参数:

参数名类型必填说明
选项路由器选项替换页面描述信息。

示例:

class routerParams {
  data1:string

  constructor(str:string) {
    this.data1 = str
  }
}

router.replace({
  url: 'pages/detail',
  params: new routerParams('message')
});

router.enableAlertBeforeBackPage(deprecated)

enableAlertBeforeBackPage(options: EnableAlertOptions): void

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

从API version9开始不再维护,建议使用showAlertBeforeBackPage9+

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

参数:

参数名类型必填说明
选项EnableAlertOptions文本弹窗信息描述。

示例:

router.enableAlertBeforeBackPage({
  message: 'Message Info'
});

router.disableAlertBeforeBackPage(deprecated)

disableAlertBeforeBackPage(): void

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

从API version9开始不再维护,建议使用hideAlertBeforeBackPage9+

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

示例:

router.disableAlertBeforeBackPage();

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。 

这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!

获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙(HarmonyOS NEXT)最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。

标签:err,错误码,HarmonyOS,ohos,router,message,ArkUI,页面
From: https://blog.csdn.net/2401_84194030/article/details/139297706

相关文章

  • HarmonyOS实战开发:@ohos.promptAction (弹窗)
    创建并显示文本提示框、对话框和操作菜单。说明:本模块首批接口从APIversion9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。该模块不支持在UIAbility的文件声明处使用,即不能在UIAbility的生命周期中调用,需要在创建组件实例后使用。本模块功能依赖UI的......
  • HarmonyOS SDK助力中国建设银行探索金融领域创新场景
    今年年初,中国建设银行(以下简称建行)手机银行首批适配HarmonyOSNEXT,并高效实现其应用的核心功能迁移。同时,建行手机银行在HarmonyOSSDK的加持下,充分发挥鸿蒙原生应用在原生智能方面的优势,让用户尽享更高效便捷的线上金融服务。HarmonyOSSDK场景化控件助力建行高效开发自建行加......
  • 鸿蒙HarmonyOS实战-Web组件(前端函数和应用侧函数相互调用)
    ......
  • 干货收藏!Calico的BGP RouteReflector策略实践
    本文分享自华为云社区《CalicoBGPRouteReflector策略实践》,作者:可以交个朋友。一背景容器网络组件Calico支持多种后端模式,有Overlay的IPIP、Vxlan模式,也有Underlay纯路由的BGP模式。相比于Overlay网络模型,Underlay网络具有更高的数据面转发性能。同时在纯路由模式下,也有两种......
  • 【HarmonyOS】JSON格式化解析Map数据
    将数组转换成Map对象,然后调用letstr=JSON.stringify(newMap),将Map转换成字符串,转换出来的结果是{}Api11以上Object.fromEntries不可用【解决方案】exportclassJsonUtil{//json字符串转为mapstaticjsonParseMap(jsonStr:string){letjsonObj:Record<......
  • 【HarmonyOS Next】游戏对接鸿蒙系统
    一、开发环境要求Unityversions:需要更新到Unity2022LTS然后使用最新团结引擎:https://unity.cn/tuanjie/releasesDevEcoStudioBuildVersion:4.1.3.600及以上版本TargetAPI:11orlaterhvigor版本:4.1.1hvigor-ohos-plugin版本:4.1.1hvigor-ohos-arkui-x-......
  • 鸿蒙HarmonyOS实战-Web组件(基本使用和属性)
    ......
  • 4 React Router
    一环境搭建npxcreate-react-appreact-router-pronpmireact-router-dom普通版: 抽象后: 二路由导航2.1两种方式 2.2参数传递路径传参和拼接传参数,路径的时候注意再路由处配置参数名2.3嵌套路由实现步骤:1、使用children属性配置路由嵌套关系,两种路由模式......
  • 鸿蒙HarmonyOS实战-Stage模型(线程模型)
    ......
  • HarmonyOS NEXT星河版ArkTS 语法 学习笔记
    基础练习:console.log("你好,","11111")//let变量名:类型=值lettitle:string='奥利奥水果'letprice:number=21.8letisSelect:Boolean=trueconsole.log(title,price,isSelect)//变量的改变值title='燕麦水果捞'console.log('......