From 27947864ace6dc3882ded57c6cd75846c4829b0c Mon Sep 17 00:00:00 2001 From: gaohui Date: Tue, 28 Sep 2021 14:51:16 +0800 Subject: [PATCH 1/4] modify readme Signed-off-by: gaohui --- UI/Animation/README_zh.md | 10 ++++ UI/CommonLayout/README_zh.md | 13 ----- UI/Components/README_zh.md | 5 -- UI/Dialog/README_zh.md | 3 -- UI/Image/README_zh.md | 3 -- UI/JsAnimation/README_zh.md | 5 -- UI/JsApp/README_zh.md | 7 --- UI/JsCallJava/README_zh.md | 5 -- UI/MultiModeInput/{README_en.md => README.md} | 6 +-- UI/MultiModeInput/README_zh.md | 6 +-- .../{README_en.md => README.md} | 0 UI/MultimodalEvent/README_zh.md | 6 +-- UI/Popup/README.md | 6 +-- UI/Popup/README_zh.md | 6 +-- UI/RefreshContainer/README.md | 6 +-- UI/RefreshContainer/README_zh.md | 6 +-- UI/Tabs/{Tabs_README.md => README.md} | 0 UI/Tabs/{Tabs_README_zh.md => README_zh.md} | 0 device/BatteryInfo/README_zh.md | 18 ++++++- device/Compass/README_zh.md | 17 +++++- device/Location/README_zh.md | 23 +++++--- device/Setting/README_zh.md | 14 ++++- media/Audio/README_zh.md | 20 +++++-- media/AudioPlayer/README_zh.md | 12 ++++- media/PixelMap/README_zh.md | 30 ++++++++--- media/VideoPlayer/README_zh.md | 22 +++++++- network/Bluetooth/README_zh.md | 18 ++++++- network/DistributedAbility/README_zh.md | 17 +++++- network/DistributedDevices/README_zh.md | 13 ++++- network/NFC/README_zh.md | 19 +++++-- network/NetworkManagement/README_zh.md | 26 ++++++++-- network/WLAN/README_zh.md | 52 +++++++++++++++++-- security/DataSecurity/README_zh.md | 15 +++++- security/FaceRecognition/README_zh.md | 16 +++++- security/Permission/README_zh.md | 20 ++++++- thread/EventHandler/README_zh.md | 18 ++++++- thread/TaskDispatcher/README_zh.md | 28 +++++++++- 37 files changed, 377 insertions(+), 114 deletions(-) delete mode 100644 UI/CommonLayout/README_zh.md delete mode 100644 UI/Components/README_zh.md delete mode 100644 UI/Dialog/README_zh.md delete mode 100644 UI/Image/README_zh.md delete mode 100644 UI/JsAnimation/README_zh.md delete mode 100644 UI/JsApp/README_zh.md delete mode 100644 UI/JsCallJava/README_zh.md rename UI/MultiModeInput/{README_en.md => README.md} (91%) rename UI/MultimodalEvent/{README_en.md => README.md} (100%) rename UI/Tabs/{Tabs_README.md => README.md} (100%) rename UI/Tabs/{Tabs_README_zh.md => README_zh.md} (100%) diff --git a/UI/Animation/README_zh.md b/UI/Animation/README_zh.md index a4e0bc2ec3..05ed3eefd3 100644 --- a/UI/Animation/README_zh.md +++ b/UI/Animation/README_zh.md @@ -1,5 +1,7 @@ # 动画 +### 简介 + - 动画是组件的基础特性之一，精心设计的动画使 UI 变化更直观，有助于改进应用程序的外观并改善用户体验。 1、帧动画是利用视觉暂留现象，将一系列静止的图片按序播放，给用户产生动画的效果。 @@ -7,3 +9,11 @@ 2、AnimatorValue 数值从0到1变化，本身与 Component 无关。开发者可以设置0到1变化过程的属性，例如：时长、变化曲线、重复次数等，并通过值的变化改变组件的属性，实现组件的动画效果。 3、AnimatorProperty 可以为 Component 设置某个属性或多个属性而实现动画效果。 + +### 使用说明 + +本示例展示了4种动画效果，包括图片动效，物体运动，物体变换以及多个物体移动。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/CommonLayout/README_zh.md b/UI/CommonLayout/README_zh.md deleted file mode 100644 index aa1d465746..0000000000 --- a/UI/CommonLayout/README_zh.md +++ /dev/null @@ -1,13 +0,0 @@ -# 常用布局 - -- DirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件（Component）按照水平或者垂直方向排布，能够方便地对齐布局内的组件。 - - 该布局和其他布局的组合，可以实现更加丰富的布局方式。 - - DirectionalLayout 的排列方向（orientation）分为水平（horizontal）或者垂直（vertical）方向。使用 orientation 设置布局内组件的排列方式，默认为垂直排列。 - - DependentLayout 是 Java UI 系统里的一种常见布局。 - - 与 DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。 - - DependentLayout 的排列方式是相对于其他同级组件或者父组件的位置进行布局。 diff --git a/UI/Components/README_zh.md b/UI/Components/README_zh.md deleted file mode 100644 index ab61f3322a..0000000000 --- a/UI/Components/README_zh.md +++ /dev/null @@ -1,5 +0,0 @@ -# Components - -- 本示例中文本 Text 是用来显示字符串的组件，在界面上显示为一块文本区域。 - - 按钮 Button 是一种常见的组件，点击可以触发对应的操作，通常由文本或图标组成，也可以由图标和文本共同组成。 diff --git a/UI/Dialog/README_zh.md b/UI/Dialog/README_zh.md deleted file mode 100644 index d4b673f5e2..0000000000 --- a/UI/Dialog/README_zh.md +++ /dev/null @@ -1,3 +0,0 @@ -# 对话框 - -- UI 提供了多种类型的 Dialog 组件，本示例主要演示了 CommonDialog ,ListDialog 以及自定义对话框的基本使用。 diff --git a/UI/Image/README_zh.md b/UI/Image/README_zh.md deleted file mode 100644 index d877751c2d..0000000000 --- a/UI/Image/README_zh.md +++ /dev/null @@ -1,3 +0,0 @@ -# 基本动画（JS） - -- 本示例演示了 JS FA 应用中，图片组件常见的几种动画，如：缩放，旋转，平移，渐变等。 diff --git a/UI/JsAnimation/README_zh.md b/UI/JsAnimation/README_zh.md deleted file mode 100644 index 68327cc17c..0000000000 --- a/UI/JsAnimation/README_zh.md +++ /dev/null @@ -1,5 +0,0 @@ -# 动效示例应用 - -- 该应用是一个体现组件动效基础能力的JS应用，包含组件的旋转、平移、显隐切换，以及组件阴影等功能，其中动效负载可调节。开发者可借鉴使用相关动效能力。适用于大型系统（参考内存≥1GiB）。 - 1. 使用了典型的div、stack、video、image、text、input、button组件。 - 2. 使用了旋转、显隐、平移等动画能力，以及阴影效果能力。 diff --git a/UI/JsApp/README_zh.md b/UI/JsApp/README_zh.md deleted file mode 100644 index 3617040536..0000000000 --- a/UI/JsApp/README_zh.md +++ /dev/null @@ -1,7 +0,0 @@ -# JsApp - -- 本示例适用于介绍如何开发一个 JS FA 应用。 - - 此应用相对于 Hello World 应用模板具备更复杂的页面布局、页面样式和页面逻辑。 - - 该页面可以通过将焦点移动到不同颜色的圆形来选择不同的食物图片，也可以进行添加到购物车操作。 diff --git a/UI/JsCallJava/README_zh.md b/UI/JsCallJava/README_zh.md deleted file mode 100644 index 354746a24d..0000000000 --- a/UI/JsCallJava/README_zh.md +++ /dev/null @@ -1,5 +0,0 @@ -# JsCallJava - -- JS UI 框架提供了 JS FA（Feature Ability）调用 Java PA（Particle Ability）的机制，该机制提供了一种通道来传递方法调用、数据返回以及订阅事件上报。 - - 本示例是以 JS 端调用 Java 端实时获取/监听电池电量为例来说明 JS FA（Feature Ability）调用 Java PA（Particle Ability）的机制。 diff --git a/UI/MultiModeInput/README_en.md b/UI/MultiModeInput/README.md similarity index 91% rename from UI/MultiModeInput/README_en.md rename to UI/MultiModeInput/README.md index 1217eb07fc..809a011070 100644 --- a/UI/MultiModeInput/README_en.md +++ b/UI/MultiModeInput/README.md @@ -1,10 +1,10 @@ # Multimodal Input -##### Introduction +### Introduction This sample app of multimodal input illustrates how to use APIs such as **KeyEventListener**, **TouchEventListener**, and **SpeechEventListener** to handle corresponding key, touch, and speech events. -##### Usage +### Usage The home page of the sample app contains the **touchEvent**, **keyEvent**, **mouseEvent**, and **speechEvent** buttons. The specific implementation is as follows: @@ -13,7 +13,7 @@ The home page of the sample app contains the **touchEvent**, **keyEvent**, ** 3. When you tap the **mouseEvent** button, you will be redirected to another page. If you tap the **mouse** button on that page by pressing the left key of the mouse, a popup dialog indicating a mouse click event will be displayed. 4. When you tap the **speechEvent** button, you will be redirected to another page. If you press the voice assistant button on the remote control of HUAWEI Vision, a popup dialog indicating a speech event will be displayed. -##### Constraints +### Constraints This sample can only be run on standard-system devices. diff --git a/UI/MultiModeInput/README_zh.md b/UI/MultiModeInput/README_zh.md index 84c77269ad..80c033f633 100644 --- a/UI/MultiModeInput/README_zh.md +++ b/UI/MultiModeInput/README_zh.md @@ -1,10 +1,10 @@ # 多模输入 -##### 简介 +### 简介 本示例通过实现相关接口KeyEventListener、TouchEventListener、SpeechEventListener等，对相应的事件进行处理，例如按键事件、触摸事件、语音事件等。 -##### 使用说明 +### 使用说明 本事例主页面包含触摸事件按钮、按键事件按钮、鼠标事件按钮、语音事件按钮； @@ -13,7 +13,7 @@ 3. 当点击鼠标事件按钮时，跳转到另一个页面，用鼠标左键点击当前页面上的按钮，页面上会弹出提示框显示鼠标事件； 4. 当点击语音事件按钮时，跳转到另一个页面，按智慧屏遥控器上的语音按钮，页面上会弹出提示框显示语音事件。 -##### 约束与限制 +### 约束与限制 本示例仅支持在标准系统上运行； diff --git a/UI/MultimodalEvent/README_en.md b/UI/MultimodalEvent/README.md similarity index 100% rename from UI/MultimodalEvent/README_en.md rename to UI/MultimodalEvent/README.md diff --git a/UI/MultimodalEvent/README_zh.md b/UI/MultimodalEvent/README_zh.md index c32713f7f9..573000bbdb 100644 --- a/UI/MultimodalEvent/README_zh.md +++ b/UI/MultimodalEvent/README_zh.md @@ -1,10 +1,10 @@ # 多模输入事件标准化 -##### 简介 +### 简介 本示例通过提供处理标准化事件的类MultimodalEventHandle对标准化基类StandardizedEventHandle衍生出来的其它标准化事件进行注册，然后对相应的事件进行处理，将不同输入设备的输入事件映射到标准化事件上。 -##### 使用说明 +### 使用说明 本示例主页面包含触摸类标准化事件按钮、按键类标准化事件按钮 、通用类标准化事件按钮、媒体类标准化事件按钮、系统类标准化事件按钮、通话类标准化事件按钮： @@ -15,7 +15,7 @@ 5. 当点击系统类标准化事件按钮时，跳转到另一个页面，执行返回操作，页面上会弹出提示框显示系统类标准化事件； 6. 当点击通话类标准化事件按钮时，跳转到另一个页面，插入耳机按拨打电话或挂断电话键，页面上会弹出提示框显示通话类标准化事件。 -##### 约束与限制 +### 约束与限制 本示例仅支持在标准系统上运行； diff --git a/UI/Popup/README.md b/UI/Popup/README.md index 48345c4495..3a52ec9957 100644 --- a/UI/Popup/README.md +++ b/UI/Popup/README.md @@ -1,14 +1,14 @@ # JavaScript Bubble -##### Introduction +### Introduction This sample shows JavaScript bubbles. After you click a bound component, a bubble with a message is displayed to provide you with guidance. You can define component attributes such as its position, style, and events to respond. -##### Usage +### Usage On the home screen of the sample app, touch the prompt button or the text box. A JavaScript bubble is displayed. The bubble disappears after you touch it. -##### Constraints +### Constraints This sample can only be run on standard-system devices. diff --git a/UI/Popup/README_zh.md b/UI/Popup/README_zh.md index be4d687f47..6c78c01108 100644 --- a/UI/Popup/README_zh.md +++ b/UI/Popup/README_zh.md @@ -1,14 +1,14 @@ # JS气泡 -##### 简介 +### 简介 本示例展示了JS气泡提示，在点击绑定的控件后会弹出相应的气泡来引导用户进行操作。开发者可自行定义该控件的位置、样式、响应事件等属性信息。 -##### 使用说明 +### 使用说明 进入应用主界面后，点击提示按钮或者文本框，JS气泡提示会出现，点击JS气泡提示后，气泡提示会消失。 -##### 约束与限制 +### 约束与限制 本示例仅支持在标准系统上运行。 diff --git a/UI/RefreshContainer/README.md b/UI/RefreshContainer/README.md index 89938b1c46..0e6da24f7a 100644 --- a/UI/RefreshContainer/README.md +++ b/UI/RefreshContainer/README.md @@ -1,14 +1,14 @@ # RefreshContainer -##### Introduction +### Introduction This sample shows the **** component in the JavaScript UI framework. You can use this component to refresh the content in child components and customize the conditions to trigger a refresh. -##### Usage +### Usage On the home screen of the sample app, a refresh icon is displayed when you swipe down the list. After the refresh is complete, two more items are displayed. -##### Constraints +### Constraints This sample can only be run on standard-system devices. diff --git a/UI/RefreshContainer/README_zh.md b/UI/RefreshContainer/README_zh.md index bd2fdff368..8d1288e9a7 100644 --- a/UI/RefreshContainer/README_zh.md +++ b/UI/RefreshContainer/README_zh.md @@ -1,14 +1,14 @@ # 下拉刷新容器 -##### 简介 +### 简介 本示例展示了JS UI框架中refresh组件的使用方法，refresh组件可以刷新子组件中的内容，并且可以自定义触发条件。 -##### 使用说明 +### 使用说明 进入应用后，下拉列表出现刷新图标，刷新结束后，新增两个ltem。 -##### 约束与限制 +### 约束与限制 本示例仅支持在标准系统上运行。 diff --git a/UI/Tabs/Tabs_README.md b/UI/Tabs/README.md similarity index 100% rename from UI/Tabs/Tabs_README.md rename to UI/Tabs/README.md diff --git a/UI/Tabs/Tabs_README_zh.md b/UI/Tabs/README_zh.md similarity index 100% rename from UI/Tabs/Tabs_README_zh.md rename to UI/Tabs/README_zh.md diff --git a/device/BatteryInfo/README_zh.md b/device/BatteryInfo/README_zh.md index 1c91766d4d..d70cbdfd7c 100644 --- a/device/BatteryInfo/README_zh.md +++ b/device/BatteryInfo/README_zh.md @@ -1,4 +1,18 @@ # 电池信息 -- 本示例演示了获取设备的电池信息，提供获取电池电量、健康状态、充电器类型、充电状态等能力。 -- Licensing +### 简介 + +电池信息提供了电池的各类参数信息，这些参数由系统提供，均为只读信息，不可修改。 + +本示例演示了获取设备的电池信息，提供获取电池电量、健康状态、充电器类型、充电状态等能力。 + +### 使用说明 + +1.点击“ Get Battery Level ”，可获取当前设备的电池状态信息，包括电池电量、是否充电、充电类型和电池状态。 + +2.点击“ Subscribe Battery Level ”，可订阅当前设备电池信息。 + +### 约束与限制 + +此设备仅支持在大型系统上运行。 + diff --git a/device/Compass/README_zh.md b/device/Compass/README_zh.md index 0916f7f64e..dd6f9003a4 100644 --- a/device/Compass/README_zh.md +++ b/device/Compass/README_zh.md @@ -1,7 +1,20 @@ # 指南针 -- 传感器是应用访问底层硬件传感器的一种设备抽象概念。开发者根据传感器提供的 Sensor API，可以查询设备上的传感器，订阅传感器的数据，并根据传感器数据定制相应的算法，开发各类应用。 +### 简介 + +传感器是应用访问底层硬件传感器的一种设备抽象概念。开发者根据传感器提供的 Sensor API，可以查询设备上的传感器，订阅传感器的数据，并根据传感器数据定制相应的算法，开发各类应用。 + +本示例通过实现一个简单的指南针，来演示传感器的常规使用方法（获取传感器并进行监听、取消监听等）。 + +### 使用说明 + +将设备水平放置，观察面板上的指针指向即可判断方向。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + + - 本示例通过实现一个简单的指南针，来演示传感器的常规使用方法（获取传感器并进行监听、取消监听等）。 diff --git a/device/Location/README_zh.md b/device/Location/README_zh.md index e52a4a0d3c..b550c50d93 100644 --- a/device/Location/README_zh.md +++ b/device/Location/README_zh.md @@ -1,13 +1,24 @@ # 位置 -- 开发者可以调用位置相关接口，获取设备实时位置，或者最近的历史位置。 +### 简介 - 对于位置敏感的应用业务，建议获取设备实时位置信息。 +地理位置模块支持调用位置相关接口，获取设备实时位置，或者最近的历史位置。 - 如果不需要设备实时位置信息，并且希望尽可能的节省耗电，开发者可以考虑获取最近的历史位置。 +对于位置敏感的应用业务，建议获取设备实时位置信息。 - 使用坐标描述一个位置，非常准确，但是并不直观，面向用户表达并不友好。 +如果不需要设备实时位置信息，并且希望尽可能的节省耗电，开发者可以考虑获取最近的历史位置。 - 系统向开发者提供了地理编码转化能力（将坐标转化为地理编码信息），以及逆地理编码转化能力（将地理描述转化为具体坐标）。 +系统向开发者提供了地理编码转化能力（将坐标转化为地理编码信息），以及逆地理编码转化能力（将地理描述转化为具体坐标）。 - 其中地理编码包含多个属性来描述位置，包括国家、行政区划、街道、门牌号、地址描述等等，这样的信息更便于用户理解。 +其中地理编码包含多个属性来描述位置，包括国家、行政区划、街道、门牌号、地址描述等等，这样的信息更便于用户理解。 + +### 使用说明 + +1. 点击“ Start Location ”获取起始位置信息，可显示当前位置经纬度、当地时间，地区、城市等信息。 +2. 点击“ Stop Location ”获取终止位置信息，更新以上信息。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + +本示例需获取相关位置权限。 diff --git a/device/Setting/README_zh.md b/device/Setting/README_zh.md index 25b07a0768..d5e25c6d3b 100644 --- a/device/Setting/README_zh.md +++ b/device/Setting/README_zh.md @@ -1,5 +1,15 @@ # 设置 -- TTS、Wireless、Network、Input、Sound、Display、Date、Call、General 九类定义了表征终端设备状态的相关字段，如屏幕亮度、日期格式、字体显示大小等，应用程序可以根据自身所拥有的权限对其进行增、删、改、查等操作，并进行相应的场景适配。 +### 简介 - 例如：TIME\_FORMAT——表示日期格式，应用程序可进行读写。 +系统设置数据项分为TTS（Text To Speech）、Wireless、Network、Input、Sound、Display、Date、Call、General九类。 + +应用程序可通过SystemSettings提供系统设置的相关接口来对系统各类设置项进行查询。 + +### 使用说明 + +应用显示设备WiFi状态、蓝牙状态与飞行模式状态，修改以上三种设置，应用显示内容改变。 + +### 约束与限制 + +本示例仅支持在标准系统上运行。 diff --git a/media/Audio/README_zh.md b/media/Audio/README_zh.md index 2f56244d94..dd21afa337 100644 --- a/media/Audio/README_zh.md +++ b/media/Audio/README_zh.md @@ -1,13 +1,23 @@ # 音频 -- 音频模块支持音频业务的开发，提供音频相关的功能，主要包括音频播放、音频采集、音量管理和短音播放等。 +### 简介 - 1、音频播放的主要工作是将音频数据转码为可听见的音频模拟信号并通过输出设备进行播放，同时对播放任务进行管理。 +音频模块支持音频业务的开发，提供音频相关的功能，主要包括音频播放、音频采集、音量管理和短音播放等。 - 2、音频采集的主要工作是通过输入设备将声音采集并转码为音频数据，同时对采集任务进行管理。 +1、音频播放的主要工作是将音频数据转码为可听见的音频模拟信号并通过输出设备进行播放，同时对播放任务进行管理。 - 3、音量管理的主要工作是音量调节，输入/输出设备管理，注册音频中断、音频采集中断的回调等。 +2、音频采集的主要工作是通过输入设备将声音采集并转码为音频数据，同时对采集任务进行管理。 - 4、短音播放主要负责管理音频资源的加载与播放、tone音的生成与播放以及系统音播放。 +3、音量管理的主要工作是音量调节，输入/输出设备管理，注册音频中断、音频采集中断的回调等。 +4、短音播放主要负责管理音频资源的加载与播放、tone音的生成与播放以及系统音播放。 +### 使用说明 + +1.点击“player”按钮，开始播放音频。 + +2.点击“Recorder”按钮，跳转界面，点击“Record”按钮准备录音 + +### 约束与限制 + +本示例仅支持在大型设备上运行。 diff --git a/media/AudioPlayer/README_zh.md b/media/AudioPlayer/README_zh.md index 951a24313a..f8f4492cd7 100644 --- a/media/AudioPlayer/README_zh.md +++ b/media/AudioPlayer/README_zh.md @@ -1,9 +1,17 @@ # 媒体会话 -- 音视频播放控制框架，主要包括浏览器（AVBrowser）、控制器（AVController）、浏览器服务（AVBrowserService）、会话（AVSession）四部分组成。这四部分构成了音视频播放控制框架的核心。 +### 简介 - 本示例展示了如何使用音视频播放控制框架实现音乐播放功能。主要功能包括了曲目播放、暂停、上一首、下一首、播放进度、跳转曲目列表等功能。曲目列表展示曲目名称，并选中播放曲目。 +音视频播放控制框架，主要包括浏览器（AVBrowser）、控制器（AVController）、浏览器服务（AVBrowserService）、会话（AVSession）四部分组成。这四部分构成了音视频播放控制框架的核心。 +本示例展示了如何使用音视频播放控制框架实现音乐播放功能。主要功能包括了曲目播放、暂停、上一首、下一首、播放进度、跳转曲目列表等功能。曲目列表展示曲目名称，并选中播放曲目。 +### 使用方法 +1.点击播放按钮，开始播放本地音乐；点击“>”切换下一首音乐；点击“<”切换上一首音乐。 +2.在线音乐播放，连网条件下，点击“TO PLAY ONLINE AUDIO”，跳转界面，点击“PLAY”开始播放音。 + +### 约束与限制 + +本示例仅支持在大型设备上运行。 diff --git a/media/PixelMap/README_zh.md b/media/PixelMap/README_zh.md index 48784d7b1b..01828502a6 100644 --- a/media/PixelMap/README_zh.md +++ b/media/PixelMap/README_zh.md @@ -1,13 +1,31 @@ # 图像 -- 图像模块支持图像业务的开发，常见功能如图像解码、图像编码、基本的位图操作、图像编辑等。 +### 简介 - 当然，也支持通过接口组合来实现更复杂的图像处理逻辑，详细如下： +图像模块支持图像业务的开发，常见功能如图像解码、图像编码、基本的位图操作、图像编辑等。 - \* 图像解码：图像解码就是将所支持格式的存档图片解码成统一的 PixelMap 图像，用于后续图像显示或其他处理，比如旋转、缩放、裁剪等。 +当然，也支持通过接口组合来实现更复杂的图像处理逻辑，详细如下： - 当前支持格式包括 JPEG、PNG、GIF、HEIF、WebP、BMP。 +\* 图像解码：图像解码就是将所支持格式的存档图片解码成统一的 PixelMap 图像，用于后续图像显示或其他处理，比如旋转、缩放、裁剪等。 - \* 图像编码：图像编码就是将 PixelMap 图像编码成不同存档格式图片，用于后续其他处理，比如保存、传输等。当前仅支持 JPEG 格式。 +当前支持格式包括 JPEG、PNG、GIF、HEIF、WebP、BMP。 - \* 位图操作：位图操作就是指对 PixelMap 图像进行相关的操作，比如创建、查询信息、读写像素数据等。 +\* 图像编码：图像编码就是将 PixelMap 图像编码成不同存档格式图片，用于后续其他处理，比如保存、传输等。当前仅支持 JPEG 格式。 + +\* 位图操作：位图操作就是指对 PixelMap 图像进行相关的操作，比如创建、查询信息、读写像素数据等。 + +### 使用说明 + +1.点击“Common Decode”，对图片进行常规解码 + +2.点击“ Region Decode”，对图片进行地区解码 + +3.点击“Encode”，对图片进行编码存储并显示存储路径 + +4.点击“PixelMap Edit"，对图片进行编辑，并展示编辑后的图片 + +5.点击”PixelMap Attribute“，对图片进行缩放 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/media/VideoPlayer/README_zh.md b/media/VideoPlayer/README_zh.md index 454a430bfb..868078ee9f 100644 --- a/media/VideoPlayer/README_zh.md +++ b/media/VideoPlayer/README_zh.md @@ -1,5 +1,23 @@ # 视频播放 -- 视频模块支持视频业务的开发和生态开放，开发者可以通过已开放的接口很容易地实现视频媒体的播放、操作和新功能开发。视频媒体的常见操作有视频编解码、视频合成、视频提取、视频播放以及视频录制等。 +### 简介 - 本示例主要演示了如何操作网络视频和本地 MP4，MOV，AVI 等格式的视频（设置视频资源、播放、暂停、释放资源等）。 +视频模块支持视频业务的开发和生态开放，开发者可以通过已开放的接口很容易地实现视频媒体的播放、操作和新功能开发。视频媒体的常见操作有视频编解码、视频合成、视频提取、视频播放以及视频录制等。 + +本示例主要演示了如何操作网络视频和本地 MP4，MOV，AVI 等格式的视频（设置视频资源、播放、暂停、释放资源等）。 + +### 使用说明 + +1.点击“Refresh List”，获取视频列表 + +2.点击视频名字，开始播放视频 + +3.点击“pause”，暂停视频播放 + +4.点击“play”，继续播放视频 + +5.点击“seek”，重新开始播放视频 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/Bluetooth/README_zh.md b/network/Bluetooth/README_zh.md index ba415a105e..bd33bd5bdf 100644 --- a/network/Bluetooth/README_zh.md +++ b/network/Bluetooth/README_zh.md @@ -1,5 +1,19 @@ # Bluetooth -- 传统蓝牙本机管理主要是针对蓝牙本机的基本操作，包括打开和关闭蓝牙、设置和获取本机蓝牙名称、 +### 简介 - 扫描和取消扫描周边蓝牙设备、获取本机蓝牙profile对其他设备的连接状态、获取本机蓝牙已配对的蓝牙设备列表。 +传统蓝牙本机管理主要是针对蓝牙本机的基本操作，包括打开和关闭蓝牙、设置和获取本机蓝牙名称、 + +扫描和取消扫描周边蓝牙设备、获取本机蓝牙profile对其他设备的连接状态、获取本机蓝牙已配对的蓝牙设备列表。 + +### 使用说明 + +1.打开蓝牙开关 + +2.点击“Start Discovery”，开始搜索蓝牙设备，并显示设备名称。 + +3.可选择蓝牙设备进行配对，输入配对码即可配对。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/DistributedAbility/README_zh.md b/network/DistributedAbility/README_zh.md index 1de5535472..21749be180 100644 --- a/network/DistributedAbility/README_zh.md +++ b/network/DistributedAbility/README_zh.md @@ -1,4 +1,19 @@ # 设备和服务的发现 & 连接 -- 本示例主要通过分布式能力，从而实现近场设备和服务的发现、连接。 +### 简介 +本示例主要通过分布式能力，从而实现近场设备和服务的发现、连接。 + +### 使用说明 + +1.点击“ScanRemoteAbility”,扫描远程能力，显示已发现的设备信息。 + +2.点击“RegisterChangeListener”,监听设备状态 + +3.点击“UnRegisterChangeListener”，取消设备监听 + +4.点击“DisconnectRemoteAbility”，断开远程能力 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/DistributedDevices/README_zh.md b/network/DistributedDevices/README_zh.md index ce60699e3a..453baeed10 100644 --- a/network/DistributedDevices/README_zh.md +++ b/network/DistributedDevices/README_zh.md @@ -1,3 +1,14 @@ # 分布式设备 -- 本示例主要通过监听当前分布式网络中远程设备的在线/离线状态案例来演示分布式设备的发现能力。 +### 简介 + +本示例主要通过监听当前分布式网络中远程设备的在线/离线状态案例来演示分布式设备的发现能力。 + +### 使用说明 + +在组网条件下 ，应用自动检测与之成功连接的设备，并显示设备名称和类型。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + diff --git a/network/NFC/README_zh.md b/network/NFC/README_zh.md index 432d21be7e..c2707f2221 100644 --- a/network/NFC/README_zh.md +++ b/network/NFC/README_zh.md @@ -1,10 +1,21 @@ # NFC -- NFC（Near Field Communication，近距离无线通信技术） 是一种非接触式识别和互联技术，让移动设备、消费类电子产品、PC和智能设备之间可以进行近距离无线通信。 +### 简介 - 应用或者其他模块可以通过接口完成以下功能： +NFC（Near Field Communication，近距离无线通信技术） 是一种非接触式识别和互联技术，让移动设备、消费类电子产品、PC和智能设备之间可以进行近距离无线通信。 - \* 查询本机是否支持NFC能力。 +应用或者其他模块可以通过接口完成以下功能： - \* 开启或者关闭本机NFC。 +\* 查询本机是否支持NFC能力。 +\* 开启或者关闭本机NFC。 + +### 使用说明 + +1.开启NFC，状态显示“NFC_ENABLED” + +2.关闭NFC，状态显示“NFC_DISABLED” + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/NetworkManagement/README_zh.md b/network/NetworkManagement/README_zh.md index 6eb86d77e3..5804ee57dc 100644 --- a/network/NetworkManagement/README_zh.md +++ b/network/NetworkManagement/README_zh.md @@ -1,9 +1,27 @@ # 网络管理 -- 网络管理模块主要提供以下功能： +### 简介 - 数据连接管理：网卡绑定，打开URL，数据链路参数查询。 +网络管理模块主要提供以下功能： - 数据网络管理：指定数据网络传输，获取数据网络状态变更，数据网络状态查询。 +数据连接管理：网卡绑定，打开URL，数据链路参数查询。 - 流量统计：获取蜂窝网络、所有网卡、指定应用或指定网卡的数据流量统计值。HTTP缓存：有效管理HTTP缓存，减少数据流量。 +数据网络管理：指定数据网络传输，获取数据网络状态变更，数据网络状态查询。 + +流量统计：获取蜂窝网络、所有网卡、指定应用或指定网卡的数据流量统计值。 + +HTTP缓存：有效管理HTTP缓存，减少数据流量。 + +### 使用说明 + +1.点击“Network Request”，跳转页面，点击“Start Request”，使用当前网络打开一个URL链接 + +2.点击“Socket Client”，跳转页面，输入服务器的IP地址，点击“Send Message"，使用当前网络进行Socket数据传输 + +3.点击“Socket Server”，跳转页面，点击“Start Server”，启动服务器 + +4.点击“HTTP Cache”，HTTP缓存的功能，点击“Start Request”，开始请求加载缓存内容 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/WLAN/README_zh.md b/network/WLAN/README_zh.md index 0d7b020e7b..cc89a37c22 100644 --- a/network/WLAN/README_zh.md +++ b/network/WLAN/README_zh.md @@ -1,11 +1,53 @@ # WLAN -- WLAN 服务系统为用户提供 WLAN 基础功能、P2P（peer-to-peer）功能和 WLAN 消息通知的相应服务，让应用可以通过 WLAN 和其他设备互联互通。 +### 简介 - 1、WLAN 基础功能可以获取WLAN状态，查询WLAN是否打开。发起扫描并获取扫描结果。获取连接态详细信息，包括连接信息、IP 信息等。 +WLAN 服务系统为用户提供 WLAN 基础功能、P2P（peer-to-peer）功能和 WLAN 消息通知的相应服务，让应用可以通过 WLAN 和其他设备互联互通。 - 2、不信任热点配置是指应用可以添加指定的热点，其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点，自动连接该热点。 +1、WLAN 基础功能可以获取WLAN状态，查询WLAN是否打开。发起扫描并获取扫描结果。获取连接态详细信息，包括连接信息、IP 信息等。 - 3、WLAN P2P 功能用于设备与设备之间的点对点数据传输。 +2、不信任热点配置是指应用可以添加指定的热点，其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点，自动连接该热点。 - 4、WLAN 消息通知（Notification）是系统内部或者与应用之间跨进程通讯的机制，注册者在注册消息通知后，一旦符合条件的消息被发出，注册者即可接收到该消息并获取消息中附带的信息。 +3、WLAN P2P 功能用于设备与设备之间的点对点数据传输。 + +4、WLAN 消息通知（Notification）是系统内部或者与应用之间跨进程通讯的机制，注册者在注册消息通知后，一旦符合条件的消息被发出，注册者即可接收到该消息并获取消息中附带的信息。 + +### 使用说明 + + 1.点击“Basic Features”，跳转页面，WLAN基础功能 + +​ a.点击“Scan”，扫描无线网络 + +​ b.点击“Get Connected Info”，获取连接状态信息 + +​ c.点击“Get Country Code”，获取设备国家码 + +​ d.点击“Get Support Feature”，获取设备是否支持指定的能力 + + 2.点击“Untrusted Config”，跳转页面，不信任热点配置 + +​ a.点击“Add Untrusted Wifi”，设置不信任热点配置 + +​ b.点击“Remove Untrusted Wifi”，删除不信任热点配置 + + 3.点击“P2P”，跳转页面，P2P功能 + +​ a.点击“Discover”，搜索附近可用的P2P设备 + +​ b.点击“Stop Discover”，停止搜索附近的P2P设备 + +​ c.点击“Create Group”，建立P2P群组 + +​ d.点击“Remove Group”，移除P2P群组 + +​ e.点击“Disconnect”，取消向指定设备发起的连接 + + 4.点击“Wlan Notification”，WLAN消息通知 + +​ a.点击“Register”，注册WLAN变化消息事件 + +​ b.点击“Unregister”，注销WLAN变化消息事件 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/security/DataSecurity/README_zh.md b/security/DataSecurity/README_zh.md index feea55eda3..de39086ec3 100644 --- a/security/DataSecurity/README_zh.md +++ b/security/DataSecurity/README_zh.md @@ -1,3 +1,16 @@ # 数据安全 -- 支持开发者调用安全加解密接口来达到安全防护作用。 \ No newline at end of file +### 简介 + +支持开发者调用安全加解密接口来达到安全防护作用。 + +### 使用说明 + +1.点击“Encrypt”，加密文本内容“Hello World!”，显示加密后的文本 + +2.点击“Decrypt”,对加密后的文本解密，显示解密后的文本内容 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + diff --git a/security/FaceRecognition/README_zh.md b/security/FaceRecognition/README_zh.md index 268953f55e..01689c18b9 100644 --- a/security/FaceRecognition/README_zh.md +++ b/security/FaceRecognition/README_zh.md @@ -1,3 +1,17 @@ # 人脸识别 -- 当前生物特征识别支持2D人脸识别、3D人脸识别，可应用于设备解锁、应用登录、支付等身份认证场景。 \ No newline at end of file +### 简介 + +当前生物特征识别支持2D人脸识别、3D人脸识别，可应用于设备解锁、应用登录、支付等身份认证场景。 + +### 使用说明 + +1.打开设置，进入生物识别和密码，选择人脸识别，开始录入人脸。 + +2.进入应用，点击“Start Face Unlock”，人脸对准摄像头进行生物识别。 + +3.点击“Cancel Authentication”，取消认证。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 \ No newline at end of file diff --git a/security/Permission/README_zh.md b/security/Permission/README_zh.md index be359ad2f9..433927db91 100644 --- a/security/Permission/README_zh.md +++ b/security/Permission/README_zh.md @@ -1,5 +1,21 @@ # 应用权限 -- 应用权限是程序访问操作某种对象的许可。权限在应用层面要求明确定义且经用户授权，以便系统化地规范各类应用程序的行为准则与权限许可。 +### 简介 - 本示例演示了照片/视频、位置、日历、麦克风的权限申请，并通过访问相关业务确认授权是否成功。 +应用权限是程序访问操作某种对象的许可。权限在应用层面要求明确定义且经用户授权，以便系统化地规范各类应用程序的行为准则与权限许可。 + +本示例演示了照片/视频、位置、日历、麦克风的权限申请，并通过访问相关业务确认授权是否成功。 + +### 使用说明 + +1.点击“Request Location permission”，位置请求许可弹框 + +2.点击“Request Microphone permission”，请求允许麦克风弹框 + +3.点击“Request Calendar permission”，日历请求许可弹框 + +4.点击“Request Storage permission”，请求存储权限弹框 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/thread/EventHandler/README_zh.md b/thread/EventHandler/README_zh.md index 7432287a50..78fa84c363 100644 --- a/thread/EventHandler/README_zh.md +++ b/thread/EventHandler/README_zh.md @@ -1,5 +1,19 @@ # 线程间通信 -- EventHandler 的主要功能是将 InnerEvent 事件或者 Runnable 任务投递到其他的线程进行处理; +### 简介 - EventRunner 的工作模式可以分为托管模式和手动模式。两种模式是在调用 EventRunner 的 create\(\) 方法时，通过选择不同的参数来实现的。 +EventHandler 的主要功能是将 InnerEvent 事件或者 Runnable 任务投递到其他的线程进行处理; + +EventRunner 的工作模式可以分为托管模式和手动模式。两种模式是在调用 EventRunner 的 create\(\) 方法时，通过选择不同的参数来实现的。 + +### 使用说明 + +1.点击“Send InnerEvent”，发送 InnerEvent事件 + +2.点击“Post Runnable Task”，发送Runnable 任务 + +3.点击“Send Event To OriginalThread”，发送事件到线程中 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/thread/TaskDispatcher/README_zh.md b/thread/TaskDispatcher/README_zh.md index 1ab3f73e60..60a383ae3f 100644 --- a/thread/TaskDispatcher/README_zh.md +++ b/thread/TaskDispatcher/README_zh.md @@ -1,5 +1,29 @@ # 线程管理 -- 如果应用的业务逻辑比较复杂，可能需要创建多个线程来执行多个任务。 +### 简介 - 这种情况下，代码复杂难以维护，任务与线程的交互也会更加繁杂，要解决此问题，开发者可以使 TaskDispatcher 来分发不同的任务。 +如果应用的业务逻辑比较复杂，可能需要创建多个线程来执行多个任务。 + +这种情况下，代码复杂难以维护，任务与线程的交互也会更加繁杂，要解决此问题，开发者可以使 TaskDispatcher 来分发不同的任务。 + +### 使用说明 + +1.点击“Sync Dispatch”，同步派发任务 + +2.点击“Async Dispatch”，异步分派任务 + +3.点击“Delay Dispatch”，异步延迟发送任务 + +4.点击“Dispatch Group”，任务组 + +5.点击“Revoke Task”，取消任务 + +6.点击“Sync Dispatch Barrier”，同步设置屏障任务 + +7.点击“Async Dispatch Barrier”，异步设置屏障任务 + +8.点击“Apply Dispatch”，执行多次任务 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 -- Gitee From 4e73764ca73c6f2f8fe3c42f5a56c19aaca4f3be Mon Sep 17 00:00:00 2001 From: gaohui Date: Tue, 28 Sep 2021 15:10:49 +0800 Subject: [PATCH 2/4] modify readme Signed-off-by: gaohui --- UI/Components/README_zh.md | 7 +++++++ UI/CustomComponent/{README_en.md => README.md} | 6 +++--- UI/CustomComponent/README_zh.md | 6 +++--- UI/Dialog/README_zh.md | 13 +++++++++++++ UI/Image/README_zh.md | 13 +++++++++++++ UI/JsAnimation/README_zh.md | 13 +++++++++++++ UI/JsApp/README_zh.md | 16 ++++++++++++++++ UI/JsCallJava/README_zh.md | 15 +++++++++++++++ 8 files changed, 83 insertions(+), 6 deletions(-) create mode 100644 UI/Components/README_zh.md rename UI/CustomComponent/{README_en.md => README.md} (81%) create mode 100644 UI/Dialog/README_zh.md create mode 100644 UI/Image/README_zh.md create mode 100644 UI/JsAnimation/README_zh.md create mode 100644 UI/JsApp/README_zh.md create mode 100644 UI/JsCallJava/README_zh.md diff --git a/UI/Components/README_zh.md b/UI/Components/README_zh.md new file mode 100644 index 0000000000..420ea25c32 --- /dev/null +++ b/UI/Components/README_zh.md @@ -0,0 +1,7 @@ +# JsComponents + +- 本示例适用于介绍如何使用組件开发一个用戶界面 。 + + 组件 Component 是构建页面的核心，每个组件通过对数据和方法的简单封装，实现独立的可视、可交互功能单元。 + + 组件之间相互独立，随取随用，也可以在需求相同的地方重复使用。 diff --git a/UI/CustomComponent/README_en.md b/UI/CustomComponent/README.md similarity index 81% rename from UI/CustomComponent/README_en.md rename to UI/CustomComponent/README.md index 86f46ecfc2..2d02cf5b0e 100644 --- a/UI/CustomComponent/README_en.md +++ b/UI/CustomComponent/README.md @@ -1,16 +1,16 @@ # CustomComponent -##### Introduction +### Introduction You can use the Java UI framework to customize components, add custom draw tasks, and define component attributes and event responses. This sample shows how to customize components. -##### Usage +### Usage On the application home screen, click the custom component **ColorChangingRing**. A yellow ring is displayed. You can click the ring to change its color. On the application home screen, click the custom component **RingProgressBar**. A round progress controller is displayed. You can click the controller to change the progress. -##### Constraints +### Constraints This sample can only be run on standard-system devices. diff --git a/UI/CustomComponent/README_zh.md b/UI/CustomComponent/README_zh.md index 857d5f24f9..40b2301e6d 100644 --- a/UI/CustomComponent/README_zh.md +++ b/UI/CustomComponent/README_zh.md @@ -1,16 +1,16 @@ # 自定义组件 -##### 简介 +### 简介 本示例展示了自定义组件的使用方法，在Java UI框架中提供了更加强大的能力，可以自定义组件，添加自定义绘制任务，并定义组件的属性和事件响应。 -##### 使用说明 +### 使用说明 进入应用主界面后，点击自定义组件：可变色圆环，跳转页面，出现黄色圆环，点击圆环改变其颜色； 点击自定义组件：环形进度条，跳转页面，出现环形进度控制器，点击环形可改变其进度。 -##### 约束和限制 +### 约束和限制 本示例支持在标准系统上运行。 diff --git a/UI/Dialog/README_zh.md b/UI/Dialog/README_zh.md new file mode 100644 index 0000000000..005135ed03 --- /dev/null +++ b/UI/Dialog/README_zh.md @@ -0,0 +1,13 @@ +# 对话框 + +### 简介 + +UI 提供了多种类型的 Dialog 组件，本示例主要演示了 CommonDialog ,ListDialog 以及自定义对话框的基本使用。 + +### 使用说明 + +点击不同的按钮展示不同的对话框，包括确认框，单选框，多选框以及输入框。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/Image/README_zh.md b/UI/Image/README_zh.md new file mode 100644 index 0000000000..6d9733486c --- /dev/null +++ b/UI/Image/README_zh.md @@ -0,0 +1,13 @@ +# 基本动画（JS） + +### 简介 + +本示例演示了 JS FA 应用中，图片组件常见的几种动画，如：缩放，旋转，平移，渐变等。 + +### 使用说明 + +从上往下依次点击按钮，图片会实现缩放、旋转、翻转的动画效果。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/JsAnimation/README_zh.md b/UI/JsAnimation/README_zh.md new file mode 100644 index 0000000000..45efd8be32 --- /dev/null +++ b/UI/JsAnimation/README_zh.md @@ -0,0 +1,13 @@ +# 动效示例应用 + +### 简介 + +该应用是一个体现组件动效基础能力的JS应用，包含组件的旋转、平移、显隐切换，以及组件阴影等功能，其中动效负载可调节。开发者可借鉴使用相关动效能力。 + +### 使用说明 + +本示例展示了一组动效包括阴影，旋转，平移等。 + +### 约束与限制 + +本示例仅支持在大型系统上运行，且参考内存 ≥ 1GiB。 diff --git a/UI/JsApp/README_zh.md b/UI/JsApp/README_zh.md new file mode 100644 index 0000000000..c9ad221b51 --- /dev/null +++ b/UI/JsApp/README_zh.md @@ -0,0 +1,16 @@ +# JsApp + +### 简介 + +本示例适用于介绍如何开发一个 JS FA 应用。 + +此应用相对于 Hello World 应用模板具备更复杂的页面布局、页面样式和页面逻辑。 + +### 使用说明 + +在应用页面可以通过将焦点移动到不同颜色的圆形来选择不同的食物图片，也可以进行添加到购物车操作。 + +### 约束与限制 + +本示例仅支持在标准系统上运行。 + diff --git a/UI/JsCallJava/README_zh.md b/UI/JsCallJava/README_zh.md new file mode 100644 index 0000000000..752d8159aa --- /dev/null +++ b/UI/JsCallJava/README_zh.md @@ -0,0 +1,15 @@ +# JsCallJava + +### 简介 + +JS UI 框架提供了 JS FA（Feature Ability）调用 Java PA（Particle Ability）的机制，该机制提供了一种通道来传递方法调用、数据返回以及订阅事件上报。 + +本示例是以 JS 端调用 Java 端实时获取/监听电池电量为例来说明 JS FA（Feature Ability）调用 Java PA（Particle Ability）的机制。 + +### 使用说明 + +应用主界面有3个按钮，点击对应按钮显示对应文本通知。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 -- Gitee From 4eee6e5ed9c1cf0d4e7283f3ce7b40ee1d29a266 Mon Sep 17 00:00:00 2001 From: gaohui Date: Tue, 28 Sep 2021 15:17:28 +0800 Subject: [PATCH 3/4] modify readme Signed-off-by: gaohui --- UI/CommonLayout/README_zh.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 UI/CommonLayout/README_zh.md diff --git a/UI/CommonLayout/README_zh.md b/UI/CommonLayout/README_zh.md new file mode 100644 index 0000000000..d088f18c63 --- /dev/null +++ b/UI/CommonLayout/README_zh.md @@ -0,0 +1,24 @@ +# 常用布局 + +### 简介 + +DirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件（Component）按照水平或者垂直方向排布，能够方便地对齐布局内的组件。 + +该布局和其他布局的组合，可以实现更加丰富的布局方式。 + +DirectionalLayout 的排列方向（orientation）分为水平（horizontal）或者垂直（vertical）方向。使用 orientation 设置布局内组件的排列方式，默认为垂直排列。 + +DependentLayout 是 Java UI 系统里的一种常见布局。 + +与 DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。 + +DependentLayout 的排列方式是相对于其他同级组件或者父组件的位置进行布局。 + +### 使用说明 + +本示例展示了DirectionalLayout 的排列方式与DependentLayout 的排列方式，分别点击对应的名字以显示对应的效果。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + -- Gitee From 40daf3bf91312c4908c2028703eb6126392cbb10 Mon Sep 17 00:00:00 2001 From: gaohui Date: Wed, 29 Sep 2021 09:18:29 +0800 Subject: [PATCH 4/4] modify readme Signed-off-by: gaohui --- UI/CommonLayout/README_zh.md | 10 ++-------- UI/Components/README_zh.md | 16 ++++++++++++---- 2 files changed, 14 insertions(+), 12 deletions(-) diff --git a/UI/CommonLayout/README_zh.md b/UI/CommonLayout/README_zh.md index d088f18c63..5fc6d20375 100644 --- a/UI/CommonLayout/README_zh.md +++ b/UI/CommonLayout/README_zh.md @@ -2,15 +2,9 @@ ### 简介 -DirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件（Component）按照水平或者垂直方向排布，能够方便地对齐布局内的组件。 +DirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件（Component）按照水平或者垂直方向排布，能够方便地对齐布局内的组件。该布局和其他布局的组合，可以实现更加丰富的布局方式。DirectionalLayout 的排列方向（orientation）分为水平（horizontal）或者垂直（vertical）方向。使用 orientation 设置布局内组件的排列方式，默认为垂直排列。 -该布局和其他布局的组合，可以实现更加丰富的布局方式。 - -DirectionalLayout 的排列方向（orientation）分为水平（horizontal）或者垂直（vertical）方向。使用 orientation 设置布局内组件的排列方式，默认为垂直排列。 - -DependentLayout 是 Java UI 系统里的一种常见布局。 - -与 DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。 +DependentLayout 是 Java UI 系统里的一种常见布局。与 DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。 DependentLayout 的排列方式是相对于其他同级组件或者父组件的位置进行布局。 diff --git a/UI/Components/README_zh.md b/UI/Components/README_zh.md index 420ea25c32..2f78efeca9 100644 --- a/UI/Components/README_zh.md +++ b/UI/Components/README_zh.md @@ -1,7 +1,15 @@ -# JsComponents +# Components -- 本示例适用于介绍如何使用組件开发一个用戶界面 。 +### 简介 - 组件 Component 是构建页面的核心，每个组件通过对数据和方法的简单封装，实现独立的可视、可交互功能单元。 +文本 Text 是用来显示字符串的组件，在界面上显示为一块文本区域。 - 组件之间相互独立，随取随用，也可以在需求相同的地方重复使用。 +按钮 Button 是一种常见的组件，点击可以触发对应的操作，通常由文本或图标组成，也可以由图标和文本共同组成。 + +### 使用说明 + +点击Start Text 与 Start Button按钮显示对应的文本样式或者按钮样式，再点击文本展示对应的测试组件布局。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 -- Gitee