arkui_ace_engine/README_zh.md
2021-06-02 19:02:57 +08:00

5.1 KiB
Raw Blame History

JS UI框架组件

简介

JS UI框架是OpenHarmony UI开发框架提供基础类、容器类、画布类等UI组件和标准CSS动画能力支持类Web范式编程。

  • 类Web范式编程

    JS UI框架采用类HTML和CSS Web编程语言作为页面布局和页面样式的开发语言页面业务逻辑则支持ECMAScript规范的JavaScript语言。JS UI框架提供的类Web编程范式可以让开发者避免编写UI状态切换的代码视图配置信息更加直观。

图 1 JS UI框架架构

JS UI框架包括应用层Application、前端框架层Framework、引擎层Engine和平台适配层Porting Layer

  • Application

    应用层表示开发者使用JS UI框架开发的FA应用这里的FA应用特指JS FA应用。

  • Framework

    前端框架层主要完成前端页面解析以及提供MVVMModel-View-ViewModel开发模式、页面路由机制和自定义组件等能力。

  • Engine

    引擎层主要提供动画解析、DOMDocument Object Model树构建、布局计算、渲染命令构建与绘制、事件管理等能力。

  • Porting Layer

    适配层主要完成对平台层进行抽象,提供抽象接口,可以对接到系统平台。比如:事件对接、渲染管线对接和系统生命周期对接等。

目录

JS UI开发框架源代码在/foundation/ace/ace_engine下目录结构如下图所示

/foundation/ace/ace_engine
├── adapter                       # 平台适配目录
│   ├── common
│   └── ohos
├── frameworks                    # 框架代码
│   ├── base                      # 基础库
│   ├── bridge                    # 前后端组件对接层
│   └── core                      # 核心组件目录

使用场景

JS UI框架提供了丰富的、功能强大的UI组件、样式定义组件之间相互独立随取随用也可以在需求相同的地方重复使用。开发者还可以通过组件间合理的搭配定义满足业务需求的新组件减少开发量。

接口说明

表 1 组件介绍

组件类型

主要组件

基础组件

button、text、input、label、image、progress、rating、span、marquee、image-animator、divider、menu、chart、option、picker、picker-view、piece、qrcode、select、slider、switch、toolbar、toolbar-item、toggle

容器组件

div、list、list-item、list-item-group、stack、swiper、tabs、tab-bar、tab-content、refresh、dialog、badge、panel、popup、stepper、stepper-item

画布组件

canvas

栅格组件

grid-container、grid-row、grid-col

涉及仓

JS UI框架子系统

ace_ace_engine

ace_engine_lite

ace_napi