diff --git a/en/teaset.md b/en/teaset.md index a9d5027531aef104790c45c09e0fde3ca9885701..76a8168f32c7d5450bdc109217e4e3eeeb53486f 100644 --- a/en/teaset.md +++ b/en/teaset.md @@ -1,18 +1,16 @@ -Template Version: v0.2.2 +Template Version: v0.3.0

teaset

-

- - Supported platforms - - - License - -

-> [!TIP] [GitHub Repository](https://github.com/react-native-oh-library/teaset) +This project is based on [teaset@0.7.5](https://github.com/rilyu/teaset). + +Please go to the Releases release address of the third-party library to view the supporting version information: [@react-native-ohos/teaset Releases](https://github.com/react-native-oh-library/teaset/releases). For older versions that are not published to npm, install the tgz package by referring to the [Installation Guide](/en/tgz-usage-en.md). + +| Version | Releases info | Support RN version | +| ------------------------- | ------------------------------------------------- | -------------------------- | +| 0.7.6 | [@react-native-ohos/teaset Releases](https://github.com/react-native-oh-library/teaset/releases) | 0.72/0.77 | ## Installation and Usage @@ -26,14 +24,14 @@ Run the following command in your project directory: npm install @react-native-ohos/teaset # 0.72 -npm @react-navigation/native-stack@6.9.26 -npm @react-navigation/native@^6.1.7 -npm @react-native-oh-tpl/react-native-screens +npm install @react-navigation/native-stack@6.9.26 +npm install @react-navigation/native@^6.1.7 +npm install @react-native-oh-tpl/react-native-screens # 0.77 -npm @react-navigation/native-stack@7.2.0 -npm @react-navigation/native@7.1.17 -npm @react-native-ohos/react-native-screens +npm install @react-navigation/native-stack@7.2.0 +npm install @react-navigation/native@7.1.17 +npm install @react-native-ohos/react-native-screens ``` @@ -112,7 +110,7 @@ Theme provides global styling configuration to unify the application's visual de | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | | set | Configure the theme palette. Accepts a complete theme object or partial overrides. | function | yes | iOS/Android | yes | -| themes | Retrieve all built-in theme palettes (default, black, violet). | object | - | iOS/Android | yes | +| themes | Retrieve all built-in theme palettes (default, black, violet). | object | yes | iOS/Android | yes | **Theme Properties:** @@ -275,11 +273,11 @@ NavigationBar renders a top navigation bar. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Title | Title component for the navigation bar. | class | - | iOS/Android | yes | -| Button | Button component for the navigation bar. | class | - | iOS/Android | yes | -| LinkButton | Link-style button component. | class | - | iOS/Android | yes | -| IconButton | Icon button component. | class | - | iOS/Android | yes | -| BackButton | Back button component. | class | - | iOS/Android | yes | +| Title | Title component for the navigation bar. | class | no | iOS/Android | yes | +| Button | Button component for the navigation bar. | class | no | iOS/Android | yes | +| LinkButton | Link-style button component. | class | no | iOS/Android | yes | +| IconButton | Icon button component. | class | no | iOS/Android | yes | +| BackButton | Back button component. | class | no | iOS/Android | yes | **NavigationBar.Title** @@ -289,6 +287,35 @@ NavigationBar renders a top navigation bar. | numberOfLines | Number of lines. | number | no | iOS/Android | yes | | allowFontScaling | Allow system font scaling. | bool | no | iOS | yes | +The **allowFontScaling** property depends on the application’s configuration.For the detailed configuration method, refer to [How to configure whether the in-app font size follows the system setting](https://developer.huawei.com/consumer/cn/doc/architecture-guides/common-v1_26-ts_20-0000002298448781) or follow the steps below: + +- 1.Create a new configuration file: AppScope/resources/base/profile/configuration.json +``` +{ + "configuration": { + // nonFollowSystem: does not follow system changes; followSystem: follows system changes + "fontSizeScale": "followSystem", + "fontSizeMaxScale": "3.2" + } +} + +``` +- 2.Reference this configuration in AppScope/app.json5 +``` +{ + "app": { + "bundleName": "com.example.temp_demo", + "vendor": "example", + "versionCode": 1000000, + "versionName": "1.0.0", + "icon": "$media:app_icon", + "label": "$string:app_name", + // Reference here + "configuration": "$profile:configuration" + }, +} +``` + **NavigationBar.Button** | Name | Description | Type | Required | Platform | HarmonyOS Support | @@ -338,7 +365,7 @@ ListRow displays list items, commonly used on settings screens. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| SwipeActionButton | Swipe action button component. | class | - | iOS/Android | yes | +| SwipeActionButton | Swipe action button component. | class | no | iOS/Android | yes | **ListRow.SwipeActionButton** @@ -370,8 +397,8 @@ Carousel provides an image slideshow. | automaticallyAdjustContentInsets | Auto-adjust content insets. | bool | no | iOS/Android | yes | | scrollEventThrottle | Scroll event throttle interval. | number | no | iOS/Android | yes | | onChange | Page change handler. | function | no | iOS/Android | yes | -| scrollToPage | Scroll to a specific page. | function | - | iOS/Android | yes | -| scrollToNextPage | Scroll to the next page. | function | - | iOS/Android | yes | +| scrollToPage | Scroll to a specific page. | function | no | iOS/Android | yes | +| scrollToNextPage | Scroll to the next page. | function | no | iOS/Android | yes | **Carousel.Control Component:** @@ -399,8 +426,8 @@ SegmentedBar renders a segmented toolbar. | indicatorType | Indicator type (none, boxWidth, itemWidth, customWidth). | string | no | iOS/Android | yes | | indicatorPosition | Indicator position (top, bottom). | string | no | iOS/Android | yes | | indicatorLineColor | Indicator line color. | string | no | iOS/Android | yes | -| indicatorLineWidth | Indicator line width. | number | no | iOS/Android | yes | -| indicatorWidth | Custom indicator width. | number | no | iOS/Android | yes | +| indicatorLineWidth | Indicator line height. | number | no | iOS/Android | yes | +| indicatorWidth | indicator width. | number | no | iOS/Android | yes | | indicatorPositionPadding | Indicator position padding. | number | no | iOS/Android | yes | | animated | Enable animation. | bool | no | iOS/Android | yes | | autoScroll | Auto-scroll to center. | bool | no | iOS/Android | yes | @@ -411,7 +438,7 @@ SegmentedBar renders a segmented toolbar. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item | SegmentedBar item component. | class | - | iOS/Android | yes | +| Item | SegmentedBar item component. | class | no | iOS/Android | yes | **SegmentedBar.Item Properties:** @@ -435,8 +462,8 @@ SegmentedView is a segmented container. | justifyItem | Item width distribution (fixed, scrollable). | string | no | iOS/Android | yes | | indicatorType | Indicator type (none, boxWidth, itemWidth). | string | no | iOS/Android | yes | | indicatorPosition | Indicator position (top, bottom). | string | no | iOS/Android | yes | -| indicatorLineColor | Indicator color. | string | no | iOS/Android | yes | -| indicatorLineWidth | Indicator width. | number | no | iOS/Android | yes | +| indicatorLineColor | Indicator line color. | string | no | iOS/Android | yes | +| indicatorLineWidth | Indicator line height. | number | no | iOS/Android | yes | | indicatorPositionPadding | Indicator position padding. | number | no | iOS/Android | yes | | animated | Enable animation. | bool | no | iOS/Android | yes | | autoScroll | Enable auto-scroll. | bool | no | iOS/Android | yes | @@ -447,7 +474,7 @@ SegmentedView is a segmented container. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Sheet | SegmentedView sheet component. | class | - | iOS/Android | yes | +| Sheet | SegmentedView sheet component. | class | no | iOS/Android | yes | **SegmentedView.Sheet Properties:** @@ -473,8 +500,8 @@ TabView provides bottom tab navigation. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Sheet | TabView sheet component. | class | - | iOS/Android | yes | -| Button | TabView button component. | class | - | iOS/Android | yes | +| Sheet | TabView sheet component. | class | no | iOS/Android | yes | +| Button | TabView button component. | class | no | iOS/Android | yes | **TabView.Sheet Properties:** @@ -569,10 +596,10 @@ Overlay displays floating layers. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| View | Overlay view component. | class | - | iOS/Android | yes | -| PullView | Overlay with pull effect. | class | - | iOS/Android | yes | -| PopView | Overlay with pop effect. | class | - | iOS/Android | yes | -| PopoverView | Overlay with popover effect. | class | - | iOS/Android | yes | +| View | Overlay view component. | class | yes | iOS/Android | yes | +| PullView | Overlay with pull effect. | class | no | iOS/Android | yes | +| PopView | Overlay with pop effect. | class | no | iOS/Android | yes | +| PopoverView | Overlay with popover effect. | class | no | iOS/Android | yes | **Overlay.View** @@ -646,7 +673,7 @@ Toast shows lightweight notifications. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -|ToastView| Toast content display component | class | - | iOS/Android | yes | +|ToastView| Toast content display component | class | yes | iOS/Android | yes | | defaultDuration | Default toast duration. | string | no | iOS/Android | yes | | defaultPosition | Default toast position. | string | no | iOS/Android | yes | | messageDefaultDuration | Default duration for the message function. | string | no | iOS/Android | yes | @@ -668,7 +695,7 @@ ActionSheet shows a bottom action sheet. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | Show the action sheet. | function | - | iOS/Android | yes | +| show | Show the action sheet. | function | yes | iOS/Android | yes | **Static Properties:** @@ -728,7 +755,7 @@ ActionPopover displays an action menu in a bubble. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item | Action popover item component. | class | no | iOS/Android | yes | +| Item | Action popover item component. | class | yes | iOS/Android | yes | **ActionPopover.ActionPopoverView.Item Properties:** @@ -746,13 +773,13 @@ PullPicker shows a bottom pull-up selector. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | Show the picker. | function | - | iOS/Android | yes | +| show | Show the picker. | function | yes | iOS/Android | yes | **Static Properties:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| PullPickerView | Content component for the pull picker. | class | - | iOS/Android | yes | +| PullPickerView | Content component for the pull picker. | class | yes | iOS/Android | yes | **PullPicker.PullPickerView** @@ -768,7 +795,7 @@ PullPicker shows a bottom pull-up selector. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item | Pull picker item component. | class | - | iOS/Android | yes | +| Item | Pull picker item component. | class | no | iOS/Android | yes | **PullPicker.PullPickerView.Item Properties** @@ -784,13 +811,13 @@ PopoverPicker displays a bubble selector. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | Show the picker. | function | - | iOS/Android | yes | +| show | Show the picker. | function | yes | iOS/Android | yes | **Static Properties:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| PopoverPickerView | Content component for the popover picker. | class | - | iOS/Android | yes | +| PopoverPickerView | Content component for the popover picker. | class | yes | iOS/Android | yes | **PopoverPicker.PopoverPickerView Properties** @@ -809,7 +836,7 @@ PopoverPicker displays a bubble selector. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item | Popover picker item component. | class | - | iOS/Android | yes | +| Item | Popover picker item component. | class | no | iOS/Android | yes | **PopoverPicker.PopoverPickerView.Item Properties** @@ -826,13 +853,13 @@ Menu displays a popup menu. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | Show the menu. | function | - | iOS/Android | yes | +| show | Show the menu. | function | yes | iOS/Android | yes | **Static Properties:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| MenuView | Content component for the menu. | class | - | iOS/Android | yes | +| MenuView | Content component for the menu. | class | no | iOS/Android | yes | **Menu.MenuView Properties:** @@ -848,7 +875,7 @@ Menu displays a popup menu. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item | Menu item component. | class | - | iOS/Android | yes | +| Item | Menu item component. | class | no | iOS/Android | yes | **Menu.MenuView.Item Properties:** @@ -865,13 +892,13 @@ Drawer provides a side drawer. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| open | Open the drawer. | function | - | iOS/Android | yes | +| open | Open the drawer. | function | yes | iOS/Android | yes | **Static Properties:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| DrawerView | Content component for the drawer. | class | - | iOS/Android | yes | +| DrawerView | Content component for the drawer. | class | no | iOS/Android | yes | **Drawer.DrawerView Properties** @@ -885,14 +912,14 @@ ModalIndicator displays a modal loading indicator. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | Show the indicator. | function | - | iOS/Android | yes | -| hide | Hide the indicator. | function | - | iOS/Android | yes | +| show | Show the indicator. | function | yes | iOS/Android | yes | +| hide | Hide the indicator. | function | yes | iOS/Android | yes | **Static Properties:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| IndicatorView | Content component for the modal indicator. | class | - | iOS/Android | yes | +| IndicatorView | Content component for the modal indicator. | class | no | iOS/Android | yes | **ModalIndicator.IndicatorView Parameters:** @@ -911,13 +938,13 @@ TeaNavigator is the root navigator component. | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| rootView | Root component. | element | - | iOS/Android | yes | +| rootView | Root component. | element | yes | iOS/Android | yes | **Context:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| navigator | Return the navigator component. | function | - | iOS/Android | yes | +| navigator | Return the navigator component. | function | yes | iOS/Android | yes | ### 31. BasePage @@ -929,13 +956,28 @@ BasePage is the base page component. | autoKeyboardInsets | Auto-adjust for keyboard. | bool | no | iOS/Android | yes | | keyboardTopInsets | Keyboard top inset. | number | no | iOS/Android | yes | +For the **autoKeyboardInsets** property, **the soft keyboard on HarmonyOS automatically avoids input fields by default**. If you want to disable the system’s default soft keyboard avoidance behavior, refer to [Soft Keyboard Layout Adaptation](https://developer.huawei.com/consumer/en/doc/best-practices/bpta-keyboard-layout-adapt#section15829951124116) or follow the steps below: + +- Add the following configuration in harmony/entry/src/main/ets/pages/Index.ets: +```diff +... ++ import { KeyboardAvoidMode } from '@kit.ArkUI'; +... + + aboutToAppear() { + ... ++ this.getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.NONE); + ... + } +``` + **Variables:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| navigator | Navigator object. | object | - | iOS/Android | yes | -| didMount | Whether the page mounted. | bool | - | iOS/Android | yes | -| isFocused | Whether the page is focused. | bool | - | iOS/Android | yes | +| navigator | Navigator object. | object | yes | iOS/Android | yes | +| didMount | Whether the page mounted. | bool | yes | iOS/Android | yes | +| isFocused | Whether the page is focused. | bool | yes | iOS/Android | yes | **Lifecycle Methods:** diff --git a/zh-cn/teaset.md b/zh-cn/teaset.md index 7a14605afad49ab7c2c5bdada36ffa9de485454d..591e85cddeef1e5734612dd0f20243c35e436df0 100644 --- a/zh-cn/teaset.md +++ b/zh-cn/teaset.md @@ -1,18 +1,16 @@ -> 模板版本:v0.2.2 +> 模板版本:v0.3.0

teaset

-

- - Supported platforms - - - License - -

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/teaset) +本项目基于 [teaset@0.7.5](https://github.com/rilyu/teaset) 开发。 + +请到三方库的 Releases 发布地址查看配套的版本信息:[@react-native-ohos/teaset Releases](https://github.com/react-native-oh-library/teaset/releases)。对于未发布到npm的旧版本,请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ------------------------- | ------------------------------------------------- | -------------------------- | +| 0.7.6 | [@react-native-ohos/teaset Releases](https://github.com/react-native-oh-library/teaset/releases) | 0.72/0.77 | ## 安装与使用 @@ -26,14 +24,14 @@ npm install @react-native-ohos/teaset # 0.72 -npm @react-navigation/native-stack@6.9.26 -npm @react-navigation/native@6.1.7 -npm @react-native-oh-tpl/react-native-screens +npm install @react-navigation/native-stack@6.9.26 +npm install @react-navigation/native@6.1.7 +npm install @react-native-oh-tpl/react-native-screens # 0.77 -npm @react-navigation/native-stack@7.2.0 -npm @react-navigation/native@7.1.17 -npm @react-native-ohos/react-native-screens +npm install @react-navigation/native-stack@7.2.0 +npm install @react-navigation/native@7.1.17 +npm install @react-native-ohos/react-native-screens ``` @@ -112,7 +110,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | | set | 设置主题配色方案,支持完整主题对象或部分属性修改 | function | yes | iOS/Android | yes | -| themes | 获取所有内置主题配色方案(default、black、violet) | object | - | iOS/Android | yes | +| themes | 获取所有内置主题配色方案(default、black、violet) | object | yes | iOS/Android | yes | **主题属性:** @@ -275,11 +273,11 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Title | 导航条标题组件 | class | - | iOS/Android | yes | -| Button | 导航条按钮组件 | class | - | iOS/Android | yes | -| LinkButton| 导航条链接按钮组件 | class | - | iOS/Android | yes | -| IconButton | 导航条图标按钮组件 | class | - | iOS/Android | yes | -| BackButton | 导航条返回按钮组件 | class | - | iOS/Android | yes | +| Title | 导航条标题组件 | class | no | iOS/Android | yes | +| Button | 导航条按钮组件 | class | no | iOS/Android | yes | +| LinkButton| 导航条链接按钮组件 | class | no | iOS/Android | yes | +| IconButton | 导航条图标按钮组件 | class | no | iOS/Android | yes | +| BackButton | 导航条返回按钮组件 | class | no | iOS/Android | yes | **NavigationBar.Title** @@ -289,6 +287,35 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | numberOfLines | 显示行数 | number | no | iOS/Android | yes | | allowFontScaling| 是否允许系统自动缩放字体大小 | bool | no | iOS | yes | +**allowFontScaling** 属性依赖应用配置,具体配置方案参考[如何设置应用内字体是否跟随系统变化](https://developer.huawei.com/consumer/cn/doc/architecture-guides/common-v1_26-ts_20-0000002298448781) 或者以下步骤: + +- 1.新建配置文件“AppScope/resources/base/profile/configuration.json” +``` +{ + "configuration": { + // nonFollowSystem不跟随系统变化;followSystem跟随系统变化 + "fontSizeScale": "followSystem", + "fontSizeMaxScale": "3.2" + } +} + +``` +- 2.在“AppScope/app.json5”文件中引用该配置 +``` +{ + "app": { + "bundleName": "com.example.temp_demo", + "vendor": "example", + "versionCode": 1000000, + "versionName": "1.0.0", + "icon": "$media:app_icon", + "label": "$string:app_name", + // 在此处引用 + "configuration": "$profile:configuration" + }, +} +``` + **NavigationBar.Button** | Name | Description | Type | Required | Platform | HarmonyOS Support | @@ -338,7 +365,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| SwipeActionButton | 滑动按钮组件 | class | - | iOS/Android | yes | +| SwipeActionButton | 滑动按钮组件 | class | no | iOS/Android | yes | **ListRow.SwipeActionButton** @@ -348,7 +375,6 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | title | 标题 | string/number/element | no | iOS/Android | yes | | titleStyle | 标题样式 | style | no | iOS/Android | yes | - ### 13. Carousel - 走马灯 图片轮播组件。 @@ -371,8 +397,8 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | automaticallyAdjustContentInsets | 自动调整内容内边距 | bool | no | iOS/Android | yes | | scrollEventThrottle | 滚动事件的触发频率| number | no | iOS/Android | yes | | onChange | 页面改变事件 | function | no | iOS/Android | yes | -| scrollToPage | 滚动到指定页面 | function | - | iOS/Android | yes | -| scrollToNextPage | 滚动到下一页 | function | - | iOS/Android | yes | +| scrollToPage | 滚动到指定页面 | function | no | iOS/Android | yes | +| scrollToNextPage | 滚动到下一页 | function | no | iOS/Android | yes | **Carousel.Control 组件:** @@ -400,7 +426,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | indicatorType | 指示器类型 (none, boxWidth, itemWidth, customWidth) | string | no | iOS/Android | yes | | indicatorPosition | 指示器位置 (top, bottom) | string | no | iOS/Android | yes | | indicatorLineColor | 指示器线条颜色 | string | no | iOS/Android | yes | -| indicatorLineWidth | 指示器线条宽度 | number | no | iOS/Android | yes | +| indicatorLineWidth | 指示器线条高度 | number | no | iOS/Android | yes | | indicatorWidth | 自定义指示器宽度 | number | no | iOS/Android | yes | | indicatorPositionPadding | 指示器位置内边距 | number | no | iOS/Android | yes | | animated | 是否启用动画 | bool | no | iOS/Android | yes | @@ -412,7 +438,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item | 分段工具条组件 Item 组件 | class | - | iOS/Android | yes | +| Item | 分段工具条组件 Item 组件 | class | no | iOS/Android | yes | **SegmentedBar.Item 属性:** @@ -436,8 +462,8 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | justifyItem | Item 宽度分配 (fixed, scrollable) | string | no | iOS/Android | yes | | indicatorType | 指示器类型 (none, boxWidth, itemWidth) | string | no | iOS/Android | yes | | indicatorPosition | 指示器位置 (top, bottom) | string | no | iOS/Android | yes | -| indicatorLineColor | 指示器颜色 | string | no | iOS/Android | yes | -| indicatorLineWidth | 指示器宽度 | number | no | iOS/Android | yes | +| indicatorLineColor | 指示器线条颜色 | string | no | iOS/Android | yes | +| indicatorLineWidth | 指示器线条高度 | number | no | iOS/Android | yes | | indicatorPositionPadding | 指示器位置内边距 | number | no | iOS/Android | yes | | animated | 是否启用动画 | bool | no | iOS/Android | yes | | autoScroll | 自动滚动 | bool | no | iOS/Android | yes | @@ -448,8 +474,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Sheet | 分段器 Sheet 组件 | class | - | iOS/Android | yes | - +| Sheet | 分段器 Sheet 组件 | class | no | iOS/Android | yes | **SegmentedView.Sheet 属性:** @@ -475,9 +500,8 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Sheet | 标签页 Sheet 组件 | class | - | iOS/Android | yes | -| Button | 标签页按钮组件 | class | - | iOS/Android | yes | - +| Sheet | 标签页 Sheet 组件 | class | no | iOS/Android | yes | +| Button | 标签页按钮组件 | class | no | iOS/Android | yes | **TabView.Sheet 属性:** @@ -572,10 +596,10 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| View | 浮层组件 | class | - | iOS/Android | yes | -| PullView | 拖拉效果浮层组件 | class | - | iOS/Android | yes | -| PopView | 弹出效果浮层组件 | class | - | iOS/Android | yes | -| PopoverView | 气泡效果浮层组件 | class | - | iOS/Android | yes | +| View | 浮层组件 | class | yes | iOS/Android | yes | +| PullView | 拖拉效果浮层组件 | class | no | iOS/Android | yes | +| PopView | 弹出效果浮层组件 | class | no | iOS/Android | yes | +| PopoverView | 气泡效果浮层组件 | class | no | iOS/Android | yes | **Overlay.View - 浮层** @@ -628,7 +652,6 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | paddingCorner | 圆角内边距 | number | no | iOS/Android | yes | | overlayOpacity | 气泡不透明度 | number | no | iOS/Android | yes | - ### 22. Toast - 轻提示 提示框 @@ -650,7 +673,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -|ToastView| Toast 内容显示组件 | class | - | iOS/Android | yes | +|ToastView| Toast 内容显示组件 | class | yes | iOS/Android | yes | | defaultDuration | 轻提示框显示时长 | string | no | iOS/Android | yes | | defaultPosition | 轻提示框显示位置 | string | no | iOS/Android | yes | | messageDefaultDuration | message 函数的 duration 参数默认值 | string | no | iOS/Android | yes | @@ -672,7 +695,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | 显示操作选单 | function | - | iOS/Android | yes | +| show | 显示操作选单 | function | yes | iOS/Android | yes | **静态属性:** @@ -687,7 +710,6 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | items | 操作项数组 | array | yes | iOS/Android | yes | | cancelItem | 取消按钮 | object | no | iOS/Android | yes | - **ActionSheet.ActionSheetView 静态属性:** | Name | Description | Type | Required | Platform | HarmonyOS Support | @@ -709,11 +731,13 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 气泡式操作菜单 **静态方法:** + | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | | show | 显示操作气泡 | function | yes | iOS/Android | yes | **静态属性:** + | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | | ActionPopoverView | ActionPopover 内容显示组件 | class | yes | iOS/Android | yes | @@ -731,7 +755,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item | ActionPopover 操作项显示组件 | class | no | iOS/Android | yes | +| Item | ActionPopover 操作项显示组件 | class | yes | iOS/Android | yes | **ActionPopover.ActionPopoverView.Item属性:** @@ -749,13 +773,13 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | 显示选择器 | function | - | iOS/Android | yes | +| show | 显示选择器 | function | yes | iOS/Android | yes | **静态属性:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| PullPickerView | PullPicker 内容显示组件 | class | - | iOS/Android | yes | +| PullPickerView | PullPicker 内容显示组件 | class | yes | iOS/Android | yes | **PullPicker.PullPickerView** @@ -771,7 +795,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| item | PullPicker 可选项显示组件 | class | - | iOS/Android | yes | +| item | PullPicker 可选项显示组件 | class | no | iOS/Android | yes | **PullPicker.PullPickerView.Item属性** @@ -787,13 +811,13 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | 显示选择器 | function | - | iOS/Android | yes | +| show | 显示选择器 | function | yes | iOS/Android | yes | **静态属性:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| PopoverPickerView | PopoverPicker 内容显示组件 | class | - | iOS/Android | yes | +| PopoverPickerView | PopoverPicker 内容显示组件 | class | yes | iOS/Android | yes | **PopoverPicker.PopoverPickerView属性** @@ -809,9 +833,10 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | onSelected | 选中事件 | function | no | iOS/Android | yes | **PopoverPicker.PopoverPickerView静态属性** + | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item | PopoverPicker 可选项显示组件 | class | - | iOS/Android | yes | +| Item | PopoverPicker 可选项显示组件 | class | no | iOS/Android | yes | **PopoverPicker.PopoverPickerView.Item属性** @@ -828,13 +853,13 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | 显示菜单 | function | - | iOS/Android | yes | +| show | 显示菜单 | function | yes | iOS/Android | yes | **静态属性:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| MenuView | Menu 内容显示组件 | class | - | iOS/Android | yes | +| MenuView | Menu 内容显示组件 | class | no | iOS/Android | yes | **Menu.MenuView属性:** @@ -850,7 +875,7 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| Item| Menu 菜单项显示组件 | class | - | iOS/Android | yes | +| Item| Menu 菜单项显示组件 | class | no | iOS/Android | yes | **Menu.MenuView.Item属性:** @@ -867,13 +892,13 @@ Theme 为全局主题配置,用于统一应用的视觉风格。 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| open | 打开抽屉 | function | - | iOS/Android | yes | +| open | 打开抽屉 | function | yes | iOS/Android | yes | **静态属性:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| DrawerView | Drawer 内容显示组件 | class | - | iOS/Android | yes | +| DrawerView | Drawer 内容显示组件 | class | no | iOS/Android | yes | **Drawer.DrawerView属性** @@ -887,14 +912,14 @@ Drawer.DrawerView 组件继承 Overlay.PullView 组件的全部属性和事件 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| show | 显示指示器 | function | - | iOS/Android | yes | -| hide | 隐藏指示器 | function | - | iOS/Android | yes | +| show | 显示指示器 | function | yes | iOS/Android | yes | +| hide | 隐藏指示器 | function | yes | iOS/Android | yes | **静态属性:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| IndicatorView | ModalIndicator 内容显示组件 | class | - | iOS/Android | yes | +| IndicatorView | ModalIndicator 内容显示组件 | class | no | iOS/Android | yes | **ModalIndicator.IndicatorView参数:** @@ -913,13 +938,13 @@ Drawer.DrawerView 组件继承 Overlay.PullView 组件的全部属性和事件 | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| rootView | 根组件 | element | - | iOS/Android | yes | +| rootView | 根组件 | element | yes | iOS/Android | yes | **上下文:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| navigator | 返回 navigator 组件 | function | - | iOS/Android | yes | +| navigator | 返回 navigator 组件 | function | yes | iOS/Android | yes | ### 31. BasePage - 基础页面 @@ -931,13 +956,28 @@ Drawer.DrawerView 组件继承 Overlay.PullView 组件的全部属性和事件 | autoKeyboardInsets | 自动键盘占位 | bool | no | iOS/Android | yes | | keyboardTopInsets | 键盘顶部偏移 | number | no | iOS/Android | yes | +对于 **autoKeyboardInsets** 属性,**HarmonyOS的软键盘默认避让输入框**,如果需要关闭系统默认的软键盘避让可以参考[软键盘布局适配](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-keyboard-layout-adapt#section19987195213425)或者以下步骤: + +- 在“harmony/entry/src/main/ets/pages/Index.ets”中添加以下配置 +```diff +... ++ import { KeyboardAvoidMode } from '@kit.ArkUI'; +... + + aboutToAppear() { + ... ++ this.getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.NONE); + ... + } +``` + **变量:** | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| navigator | 导航器对象 | object | - | iOS/Android | yes | -| didMount | 是否已挂载 | bool | - | iOS/Android | yes | -| isFocused | 是否已聚焦 | bool | - | iOS/Android | yes | +| navigator | 导航器对象 | object | yes | iOS/Android | yes | +| didMount | 是否已挂载 | bool | yes | iOS/Android | yes | +| isFocused | 是否已聚焦 | bool | yes | iOS/Android | yes | **生命周期方法:**