1# 使用JS语言开发(低代码方式) 2 3 4> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** 5> 该特性在**DevEco Studio V2.2 Beta1**及更高版本中支持。 6> 7> 为确保运行效果,本文以使用**DevEco Studio V3.0.0.900 Beta3**版本为例,点击[此处](https://developer.harmonyos.com/cn/develop/deveco-studio#download_beta_openharmony)获取下载链接。 8 9 10OpenHarmony低代码开发方式具有丰富的UI界面编辑功能,通过可视化界面开发方式快速构建布局,可有效降低开发者的上手成本并提升开发者构建UI界面的效率。 11 12 13使用低代码开发应用或服务有以下两种开发方式: 14 15 16- 直接创建一个支持低代码开发的新工程以进行开发。本文以此方式为例进行说明。 17 18- 在已有工程中,创建visual文件来进行开发。此种方式的操作可参考[创建visual文件支持低代码开发](#构建第二个页面)。 19 20 21## 创建新工程支持低代码开发 22 23> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** 24> 该功能在DevEco Studio 3.0 Beta2及更高版本中支持,且compileSdkVersion必须为7或以上。 25 261. 若首次打开**DevEco Studio**,请点击**Create Project**创建工程。如果已有一个工程,请点击**File** > **New** > **Create Project**。选择模板“**Empty Ability**”,点击**Next**进行下一步配置。 27 28 ![zh-cn_image_0000001268198893](figures/zh-cn_image_0000001268198893.png) 29 302. 进入配置工程界面,打开“**Enable Super Visual**”开关,**UI Syntax**选择“**JS**”,其他参数保持默认设置即可。 31 32 ![zh-cn_image_0000001223717294](figures/zh-cn_image_0000001223717294.png) 33 343. 点击**Finish**,工具会自动生成示例代码和相关资源,等待工程创建完成。 35 36 37## 低代码开发工程项目文件 38 39工程同步完成后,自动生成以下目录结构: 40 41![zh-cn_image_0000001223558810](figures/zh-cn_image_0000001223558810.png) 42 43- **entry > src > main > js > MainAbility > pages > index > index.js** :低代码页面的逻辑描述文件,定义了页面里所用到的所有的逻辑关系,比如数据、事件等,详情请参考[JS语法参考](../ui/js-framework-syntax-js.md)。如果创建了多个低代码页面,则pages目录下会生成多个页面文件夹及对应的js文件。 44 45 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** 46 > 使用低代码页面开发时,其关联js文件的同级目录中不能包含hml和css页面,例如上图中的 **js > MainAbility > pages > index** 目录下不能包含hml与css文件,否则会出现编译报错。 47 48- **entry > src > main > supervisual > MainAbility > pages > index > index.visual** :visual文件存储低代码页面的数据模型,双击该文件即可打开低代码页面,进行可视化开发设计。如果创建了多个低代码页面,则pages目录下会生成多个页面文件夹及对应的visual文件。 49 50 51## 构建第一个页面 52 53工程同步完成后,第一个页面已有一个容器、一段文本(Hello World)显示。为了更详细地了解低代码开发,我们将删除画布原有模板组件,从零开始完成页面的添加、设置。 54 55第一个页面内有一个容器、一段文本和一个按钮,通过Div、Text和Button组件来实现。 56 571. 删除画布原有模板组件。<a name= delete_origin_content></a> 58 打开index.visual文件,选中画布中的组件,单击鼠标右键,选择Delete删除画布原有模板组件。操作如下所示: 59 60 ![zh-cn_image_0000001216600980](figures/zh-cn_image_0000001216600980.gif) 61 622. 添加容器,设置Div容器的样式和属性。<a name = add_container></a> 63 选中UI Control中的Div组件,将其拖至画布。点击右侧属性样式栏中的样式图标![zh-cn_image_0000001260226691](figures/zh-cn_image_0000001260226691.png)(General),设置Div组件的高度Height为100%,使其占满屏幕;点击右侧属性样式栏中的样式图标![zh-cn_image_0000001215226858](figures/zh-cn_image_0000001215226858.png)(Flex),设置Div组件的FlexDirection样式为column,使Div的主轴垂直;设置Div组件的JustifyContent样式为center,使得其子组件在主轴上居中显示;设置Div组件的AlignItems样式为center,使得其子组件在交叉轴上居中显示。操作如下所示: 64 65 ![zh-cn_image_0000001216448880](figures/zh-cn_image_0000001216448880.gif) 66 673. 添加文本。 68 选中UI Control中的Text组件,将其拖至Div组件的中央区域。点击右侧属性样式栏中的属性图标![zh-cn_image_0000001215066868](figures/zh-cn_image_0000001215066868.png)(Properties),设置Text组件的Content属性为“Hello World”;点击右侧属性样式栏中的样式图标![zh-cn_image_0000001215386842](figures/zh-cn_image_0000001215386842.png)(Feature),设置组件的FontSize样式为60px,使得其文字放大;设置组件的TextAlign样式为center,使得组件文字居中显示。再选中画布上的Text组件,拖动放大。操作如下所示: 69 70 ![zh-cn_image_0000001216446670](figures/zh-cn_image_0000001216446670.gif) 71 724. 添加按钮。 73 选中UI Control中的Button组件,将其拖至Text组件下面。点击右侧属性样式栏中的属性图标![zh-cn_image_0000001260106745](figures/zh-cn_image_0000001260106745.png)(Properties),设置Button组件的Value属性为“Next”,点击右侧属性样式栏中的样式图标![zh-cn_image_0000001259866741](figures/zh-cn_image_0000001259866741.png)(Feature),设置组件的FontSize样式为40px,使得其文字放大;再选中画布上的Button组件,拖动放大。操作如下所示: 74 75 ![zh-cn_image_0000001260928361](figures/zh-cn_image_0000001260928361.gif) 76 775. 在编辑窗口右上角的侧边工具栏,点击Previewer,打开预览器。第一个页面效果如下图所示: 78 79 ![zh-cn_image_0000001216288558](figures/zh-cn_image_0000001216288558.png) 80 81 82## 构建第二个页面 83 841. 创建第二个页面。 85 在“**Project**”窗口,打开“**entry > src > main > js > MainAbility**”,右键点击“**pages**”文件夹,选择“**New > Visual**”,命名为“**second**”,单击“**Finish**”,即完成第二个页面的创建。可以看到文件目录结构如下: 86 87 ![zh-cn_image_0000001223882030](figures/zh-cn_image_0000001223882030.png) 88 892. [删除画布原有模板组件。](#delete_origin_content) 90 913. [添加容器,设置Div容器的样式和属性。](#add_container) 92 934. 添加文本。 94 选中Text组件,拖至Div组件的中央区域。点击右侧属性样式栏中的属性图标![zh-cn_image_0000001260227453](figures/zh-cn_image_0000001260227453.png)(Properties),设置Text组件的Content属性为“Hi there”;点击右侧属性样式栏中的样式图标![zh-cn_image_0000001260107497](figures/zh-cn_image_0000001260107497.png)(Feature),设置组件的FontSize样式为60px;设置组件的TextAlign样式为center。再选中画布上的Text组件,拖动放大。操作如下所示: 95 96 ![zh-cn_image_0000001216614132](figures/zh-cn_image_0000001216614132.gif) 97 985. 添加按钮。 99 选中UI Control中的Button组件,将其拖至Text组件下面。点击右侧属性样式栏中的属性图标![zh-cn_image_0000001215227618](figures/zh-cn_image_0000001215227618.png)(Properties),设置Button组件的Value属性为“Back”,点击右侧属性样式栏中的样式图标![zh-cn_image_0000001259987441](figures/zh-cn_image_0000001259987441.png)(Feature),设置组件的FontSize样式为40px,使得其文字放大;再选中画布上的Button组件,拖动放大。操作如下所示: 100 101 ![zh-cn_image_0000001261017331](figures/zh-cn_image_0000001261017331.gif) 102 103 104## 实现页面间的跳转 105 106页面间的导航可以通过[页面路由router](../ui/ui-js-building-ui-routes.md)来实现。页面路由router根据页面url找到目标页面,从而实现跳转。使用页面路由请导入router模块。 107 1081. 第一个页面跳转到第二个页面。 109 在第一个页面中,跳转按钮绑定onclick方法,点击按钮时跳转到第二页。需同时处理js文件及visual文件。 110 - “**index.js**”示例如下: 111 112 ```js 113 import router from '@ohos.router'; 114 115 export default { 116 onclick() { 117 router.push({ 118 url:'pages/second/second', // 指定要跳转的页面 119 }) 120 } 121 } 122 ``` 123 124 - “**index.visual**”: 打开index.visual,选中画布上的Button组件。点击右侧属性样式栏中的事件图标![zh-cn_image_0000001215388136](figures/zh-cn_image_0000001215388136.png)(Events),鼠标点击Click事件的输入框,选择onclick,如下所示: 125 126 ![zh-cn_image_0000001223722586](figures/zh-cn_image_0000001223722586.png) 127 1282. 第二个页面返回到第一个页面。 129 在第二个页面中,返回按钮绑定back方法,点击按钮时返回到第一页。 130 131 需同时处理js文件及visual文件。 132 133 - “**second.js**”示例如下: 134 135 ```js 136 import router from '@ohos.router'; 137 138 export default { 139 back() { 140 router.back() 141 } 142 } 143 ``` 144 - “**second.visual**”: 打开second.visual,选中画布上的Button组件。点击右侧属性样式栏中的事件图标![zh-cn_image_0000001215388262](figures/zh-cn_image_0000001215388262.png)(Events),鼠标点击Click事件的输入框,选择back,如下所示: 145 146 ![zh-cn_image_0000001268082945](figures/zh-cn_image_0000001268082945.png) 147 1483. 打开index.visual或index.js文件,点击预览器中的 ![zh-cn_image_0000001261979271](figures/zh-cn_image_0000001261979271.png) 按钮进行刷新。效果如下图所示: 149 150 ![zh-cn_image_0000001261142799](figures/zh-cn_image_0000001261142799.png) 151 152 153## 使用真机运行应用 154 1551. 将搭载OpenHarmony标准系统的开发板与电脑连接。 156 1572. 点击**File** > **Project Structure** > **Project** > **Signing Configs**界面勾选“**Automatically generate signing**”,等待自动签名完成即可,点击“**OK**”。如下图所示: 158 159 ![zh-cn_image_0000001268283201](figures/zh-cn_image_0000001268283201.png) 160 1613. 在编辑窗口右上角的工具栏,点击![zh-cn_image_0000001262207811](figures/zh-cn_image_0000001262207811.png)按钮运行。效果如下图所示: 162 163 ![zh-cn_image_0000001262127855](figures/zh-cn_image_0000001262127855.png) 164 165恭喜您已经使用JS语言开发(低代码方式)完成了第一个OpenHarmony应用,快来[探索更多的OpenHarmony功能](../application-dev-guide.md)吧。 166