From 063a937116f3506247e50fbaa90c4a7f4f141153 Mon Sep 17 00:00:00 2001 From: tianyu Date: Thu, 28 Jul 2022 13:10:18 +0800 Subject: [PATCH] update abilityComponent Signed-off-by: tianyu --- .../ts-container-ability-component.md | 43 +++---------------- .../reference/arkui-ts/ts-container-column.md | 12 +++--- .../reference/arkui-ts/ts-container-flex.md | 16 +++---- .../reference/arkui-ts/ts-container-tabs.md | 28 ++++++------ 4 files changed, 35 insertions(+), 64 deletions(-) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-ability-component.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-ability-component.md index d6717d2d95..b0bfd71a88 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-ability-component.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-ability-component.md @@ -41,34 +41,20 @@ ohos.permission.INTEGRATED_INTERIOR_WINDOW ## 接口 -AbilityComponent(value: {want : Want, controller? : AbilityController}) +AbilityComponent(value: {want : Want}) - 参数 | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | | want | [Want](../../reference/apis/js-apis-application-Want.md) | 是 | - | 默认加载的Ability描述。 | - | controller | [AbilityController](#abilityController) | 否 | - | Ability控制器。 | ## 事件 | 名称 | 功能描述 | | -------- | -------- | -| onReady() => void | AbilityComponent环境启动完成时的回调，之后可使用AbilityComponent的方法。 | -| onDestroy() => void | AbilityComponent环境销毁时的回调。 | -| onAbilityCreated(name: string) => void | 加载Ability时触发，name为Ability名。 | -| onAbilityMoveToFont() => void | 当Ability移动到前台时触发。 | -| onAbilityWillRemove() => void | Ability移除之前触发。 | - -## AbilityController - -Ability控制器，提供AbilityComponent的控制接口。 - -| 名称 | 功能描述 | -| --------------------------------------- | ------------------------------------------------------------ | -| startAbility() => want | 在AbilityComponent内部加载Ability。
want：要加载的Ability描述信息。 | -| preformBackPress() => void | 在AbilityComponent内部执行返回操作。 | -| getStackCount() => void | 获取AbilityComponent内部任务栈中任务的个数。 | +| onConnect() => void | AbilityComponent环境启动完成时的回调，之后可使用AbilityComponent的方法。 | +| onDisconnect() => void | AbilityComponent环境销毁时的回调。 | ## 示例 @@ -78,7 +64,6 @@ Ability控制器，提供AbilityComponent的控制接口。 @Entry @Component struct MyComponent { - @State controller: AbilityController = new AbilityController() build() { Column() { @@ -87,26 +72,12 @@ struct MyComponent { bundleName: '', abilityName: '' }, - controller: this.controller - }) - .onReady(() => { - console.log('AbilityComponent ready'); }) - .onDestory(() => { - console.log('AbilityComponent destory'); - }) - Button("Start New") - .onClick(() => { - this.controller.startAbility({ - bundleName: '', - abilityName: '' - }); + .onConnect(() => { + console.log('AbilityComponent connect'); }) - Button("Back") - .onClick(() => { - if (this.controller.getStacjCount() > 1) { - this.controller.preformBackPress(); - } + .onDisconnect(() => { + console.log('AbilityComponent disconnect'); }) } } diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md index 4f83bc1fcc..e618bdb2db 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md @@ -23,9 +23,9 @@ Column(value:{space?: Length}) - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | - | space | Length | 否 | 0 | 纵向布局元素间距。 | + | space | Length | 否 | 0 | 纵向布局元素间距。 | ## 属性 @@ -33,13 +33,13 @@ Column(value:{space?: Length}) | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | | alignItems | HorizontalAlign | HorizontalAlign.Center | 设置子组件在水平方向上的对齐格式。 | -| justifyContent8+ | [FlexAlign](ts-container-flex.md) | FlexAlign.Start | 设置子组件在垂直方向上的对齐格式。 | +| justifyContent8+ | [FlexAlign](ts-container-flex.md) | FlexAlign.Start | 设置子组件在垂直方向上的对齐格式。 | - HorizontalAlign枚举说明 - | 名称 | 描述 | + | 名称 | 描述 | | -------- | -------- | - | Start | 按照语言方向起始端对齐。 | - | Center | 居中对齐，默认对齐方式。 | + | Start | 按照语言方向起始端对齐。 | + | Center | 居中对齐，默认对齐方式。 | | End | 按照语言方向末端对齐。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md index d837cc9327..a94e44d5c8 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md @@ -48,14 +48,14 @@ Flex(options?: { direction?: FlexDirection, wrap?: FlexWrap, justifyContent?: F | WrapReverse | Flex容器的元素反向多行/列排布，子项允许超出容器。 | - FlexAlign枚举说明 - | 名称 | 描述 | - | ------------ | ---------------------------------------- | - | Start | 元素在主轴方向首端对齐, 第一个元素与行首对齐，同时后续的元素与前一个对齐。 | - | Center | 元素在主轴方向中心对齐，第一个元素与行首的距离与最后一个元素与行尾距离相同。 | - | End | 元素在主轴方向尾部对齐,  最后一个元素与行尾对齐，其他元素与后一个对齐。 | - | SpaceBetween | Flex主轴方向均匀分配弹性元素，相邻元素之间距离相同。 第一个元素与行首对齐，最后一个元素与行尾对齐。 | - | SpaceAround | Flex主轴方向均匀分配弹性元素，相邻元素之间距离相同。 第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。 | - | SpaceEvenly | Flex主轴方向元素等间距布局， 相邻元素之间的间距、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。 | + | 名称 | 描述 | + | ------------ | ------------------------------------------------------------ | + | Start | 元素在主轴方向首端对齐，第一个元素与行首对齐，同时后续的元素与前一个对齐。 | + | Center | 元素在主轴方向中心对齐，第一个元素与行首的距离与最后一个元素与行尾距离相同。 | + | End | 元素在主轴方向尾部对齐，最后一个元素与行尾对齐，其他元素与后一个对齐。 | + | SpaceBetween | Flex主轴方向均匀分配弹性元素，相邻元素之间距离相同。第一个元素与行首对齐，最后一个元素与行尾对齐。 | + | SpaceAround | Flex主轴方向均匀分配弹性元素，相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。 | + | SpaceEvenly | Flex主轴方向元素等间距布局，相邻元素之间的间距、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md index 810c345c4c..ea24e62cf3 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md @@ -29,10 +29,10 @@ Tabs(value: {barPosition?: BarPosition, index?: number, controller?: [TabsContro | controller | [TabsController](#tabscontroller) | 否 | - | 设置Tabs控制器。 | - BarPosition枚举说明 - | 名称 | 描述 | + | 名称 | 描述 | | -------- | -------- | - | Start | vertical属性方法设置为true时，页签位于容器左侧；vertical属性方法设置为false时，页签位于容器顶部。 | - | End | vertical属性方法设置为true时，页签位于容器右侧；vertical属性方法设置为false时，页签位于容器底部。 | + | Start | vertical属性方法设置为true时，页签位于容器左侧；vertical属性方法设置为false时，页签位于容器顶部。 | + | End | vertical属性方法设置为true时，页签位于容器右侧；vertical属性方法设置为false时，页签位于容器底部。 | ## 属性 @@ -41,25 +41,25 @@ Tabs(value: {barPosition?: BarPosition, index?: number, controller?: [TabsContro | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| vertical | boolean | 是否为纵向Tab，默认为false。 | 是否为纵向Tab，默认为false。 | -| scrollable | boolean | 是否可以通过左右滑动进行页面切换，默认为true。 | 是否可以通过左右滑动进行页面切换，默认为true。 | -| barMode | BarMode | TabBar布局模式。 | TabBar布局模式。 | -| barWidth | number | TabBar的宽度值，不设置时使用系统主题中的默认值。 | TabBar的宽度值，不设置时使用系统主题中的默认值。 | -| barHeight | number | TabBar的高度值，不设置时使用系统主题中的默认值。 | TabBar的高度值，不设置时使用系统主题中的默认值。 | +| vertical | boolean | false | 是否为纵向Tab，默认为false。 | +| scrollable | boolean | true | 是否可以通过左右滑动进行页面切换，默认为true。 | +| barMode | BarMode | BarMode.Fixed | TabBar布局模式。 | +| barWidth | number | - | TabBar的宽度值，不设置时使用系统主题中的默认值。 | +| barHeight | number | - | TabBar的高度值，不设置时使用系统主题中的默认值。 | | animationDuration | number | 200 | TabContent滑动动画时长。 | - BarMode枚举说明 - | 名称 | 描述 | + | 名称 | 描述 | | -------- | -------- | - | Scrollable | TabBar使用实际布局宽度, 超过总长度后可滑动。 | - | Fixed | 所有TabBar平均分配宽度。 | + | Scrollable | TabBar使用实际布局宽度, 超过总长度后可滑动。 | + | Fixed | 所有TabBar平均分配宽度。 | ## 事件 -| 名称 | 功能描述 | +| 名称 | 功能描述 | | -------- | -------- | -| onChange(callback: (index: number) => void) | Tab页签切换后触发的事件。 | +| onChange(callback: (index: number) => void) | Tab页签切换后触发的事件。 | ## TabsController @@ -79,7 +79,7 @@ changeIndex(value: number): void 控制Tabs切换到指定页签。 - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | | value | number | 是 | - | 页签在Tabs里的索引值，索引值从0开始。 | -- GitLab