HarmonyOS轻量JS开发框架与W3C标准差异分析-轻量web框架

HarmonyOS轻量JS应用开发框架(下文简称“框架”)，是HarmonyOS为开发者提供的一套开发JS应用的开发框架。开发框架采用类小程序的web开发方式，其实现大部分遵循W3C标准(主流web开发标准)，但由于设备条件限制(例如，ROM和RAM大小)，“框架”中部分组件和属性与W3C标准存在差异，需要开发者在开发过程中了解和掌握。

本文将会梳理当前“框架”已有的组件和属性与W3C标准相对应组件和属性的主要差异点，并配以示例说明，供开发者在开发过程中参考。

主要差异点包括：width和height属性、绝对定位和相对定位、文字显示、页面滑动和长按事件。

width和height属性

作为一个前端开发者，在开发网页或者应用的过程中，我们一般不会手动设置组件的高度和宽度，而是希望元素的大小根据窗口或者子元素自动调整，这就是自适应能力。

自适应能力使得布局更灵活，可适应不同设备、不同窗口和不同分辨率下的显示。

但是，“框架”当前提供的组件除text外，皆不支持内容高度和宽度的自适应能力，必须由开发者明确指定高度和宽度，否则组件不会显示。

以一段简单的代码为例：

<div style="background-color: red;"> 
    <div style="width: 100px;height: 100px;background-color: yellow;"></div> 
</div>

根组件div未设置高宽属性，子组件div设置了高宽属性，在“框架”和W3C标准中其运行效果图分别如图1和图2所示：

从图1和图2可以看出，“框架”中根组件必须设置高度和宽度，否则无法显示，即使根组件的子组件设置了高宽度属性，界面也无法显示。另外由于W3C标准的div组件是块状元素，如果没有设置宽度，会独占一行，所以在图2中，没有设置宽度，其显示范围为一整行。

“框架”中设置根组件的高度和宽度，则正常显示，效果如图3所示：

<div style="width:200px;height:200px;background-color: red;"> 
    <div style="width: 100px;height: 100px;background-color: yellow;"></div> 
</div>

针对text组件，不设置高宽属性的条件下，“框架”和W3C标准下web开发界面显示效果一致，如图4和图5所示：

<text> 
  Hello World! 
</text>

绝对定位和相对定位

如何实现绝对定位和相对定位?如果你常用html语言开发，你可能会首先想到设置position属性为absolute和relative，然后通过left和top设置距离即可实现绝对定位和相对定位的效果，其实现代码如下所示：

<html> 
  <head> 
    <style type="text/css"> 
      h2.left { 
        position: relative; 
        left: 30px; 
        top: 30px; 
      } 
      h2.right { 
        position: absolute; 
        left: 90px; 
        top: 160px; 
      } 
</style> 
  </head> 
  <body> 
    <h2>这是位于正常位置的标题</h2> 
    <h2 class="left">这个标题相对于其正常位置向右向下移动</h2> 
    <h2 class="right">这个标题相对于其页面左上角位置向右向下移动</h2> 
  </body> 
</html>

但是在“框架”中，我们查看HarmonyOS官网JS API文档后发现，position属性是不支持设置absolute和relative，那该如何实现绝对定位和相对定位这两种效果呢?

如果我们仔细阅读HarmonyOS官网文档，我们会发现“框架”提供了一个新组件stack，借助这个组件我们可以实现绝对定位的效果，示例代码如下所示，添加一个stack根组件(同时也作为父组件)，其子组件为div，然后设置其left和top的值为50px来实现绝对定位的效果，其效果如图6所示，子组件div相对于父组件stack向下、向右各偏移50px。

<stack style="width: 200px; height: 200px; background-color: red;"> 
  <div 
    style=" 
      left: 50px; 
      top: 50px; 
      width: 100px; 
      height: 100px; 
      background-color: yellow;" 
  > 
  </div> 
</stack>

另外，绝对定位存在一种特殊场景：如果是根组件，直接设置top和left属性即可实现绝对定位功能;非根组件，其父组件必须是stack，才能通过设置top和left属性来实现绝对定位功能。根组件绝对定位是相对于页面左上角做偏移，非根组件绝对定位是相对于父组件做偏移。

如下代码所示，根组件直接设置top和left属性实现绝对定位，由于此时根组件作为父组件不是stack，所以设置子组件的绝对定位无效，如图7中所示，子组件黄色div相对于父组件红色div未实现绝对定位的效果。

<div 
  style=" 
    width: 200px; 
    height: 200px; 
    background-color: red; 
    top: 50px; 
    left: 50px;" 
> 
  <div 
    style=" 
      left: 50px; 
      top: 50px; 
      width: 100px; 
      height: 100px; 
      background-color: yellow;" 
  > 
  </div> 
</div>

相对定位：由于设备硬件ROM和RAM大小限制，当前“框架”不支持W3C标准中的相对定位实现(position:relative)，只支持部分flex布局属性，与W3C标准相比差异较大，具体差异见表1所示。

表1：“框架”下flex布局可支持属性对比

在“框架”中实现flex布局，将需要flex布局的子组件用div容器包裹一下，并将div的display属性设置为flex即可。如下图所示，我们要实现三个div一行排列且居中显示的flex布局。

在“框架”中我们可以这样实现：添加一个div父组件，其子组件按行居中排列，分别设置justify-content和align-items两个属性值为center(div组件的主轴方向默认值是row，如果想实现纵向排列需要设置flex-direction: column)即可实现图8中的效果，详细代码如下所示：

//index.hml 
 
<div class="container"> 
  <div class="box box--red"></div> 
  <div class="box box--green"></div> 
  <div class="box box--blue"></div> 
</div> 
 
//index.css 
 
.container { 
  display: flex; 
  justify-content: center; 
  align-items: center; 
  width: 100%; 
  height: 100%; 
} 
.box { 
  width: 30%; 
  height: 60%; 
} 
.box--red { 
  background-color: #f00; 
} 
.box--green { 
  background-color: #0f0; 
} 
.box--blue { 
  background-color: #00f; 
}

W3C标准下的web开发代码如下所示，和“框架”下web开发代码实现基本一致。

<!DOCTYPE html> 
<html lang="en"> 
<head> 
  <meta charset="UTF-8"> 
  <meta http-equiv="X-UA-Compatible" content="IE=edge"> 
  <meta name="viewport" content="width=device-width, initial-scale=1.0"> 
  <title>Flex Layout</title> 
  <style> 
    .container { 
      align-items: center; 
      background-color: #000; 
      display: flex; 
      height: 454px; 
      justify-content: center; 
      width: 454px; 
    } 
    .title { 
      text-align: center; 
    } 
    .box { 
      height: 60%; 
      width: 30%; 
    } 
    .box--red { 
      background-color: #f00; 
    } 
    .box--green { 
      background-color: #0f0; 
    } 
    .box--blue { 
      background-color: #00f; 
    } 
</style> 
</head> 
<body> 
  <div class="container"> 
    <div class="box box--red"></div> 
    <div class="box box--green"></div> 
    <div class="box box--blue"></div> 
  </div> 
</body> 
</html>

文字显示

在前端开发中，遵循W3C标准开发者可以使用多种标签来实现文字显示。如段落“<p> </p>”、标题“<h1> </h1>”，甚至部分标签中直接放入文字也可以显示，如“<div>标题</div>”。

但是基于“框架”开发的应用想要显示文字，必须将文字内容放在text组件中，或者设置input组件的value值，才可以正常显示。

如下代码所示，在div组件中直接添加文字“Hello world”，可以看到W3C标准下web开发界面显示出文字(如图9所示)，“框架”下web开发界面则无法显示文字(如图10所示)。

<div style="width: 200px; height: 200px; background-color: red;"> 
  Hello World! 
</div>

HarmonyOS轻量JS开发框架与W3C标准差异分析-鸿蒙HarmonyOS技术社区

“框架”下正确使用方式是将要显示的文字放在text组件中，或者设置input组件的value值才能正常显示文字。另外，对于智能穿戴设备，只支持30和38两种字号的字体，字体只支持HYQiHei-65S;如果对其他大小的字体有需求，暂时只能通过贴图的方式去实现开发者所需的效果。

text组件显示文字的代码如下：

<text style="width: 200px; height: 200px; text-align: center;"> 
  hello world 
</text>

input组件显示文字的代码如下，通过设置value属性显示文字：

<input style="width: 200px; height: 50px; text-align: center;" value="hello world"> 
</input>

页面滑动和长按事件

“框架”原生支持页面滑动(swipe)和长按(longpress)事件，其中swipe支持“上下左右”四个方向的滑动，开发者通过事件返回值即可获取滑动方向。

如下代码所示，我们添加一个div组件和一个text组件，text组件用来显示屏幕上面的滑动方向，事件回调函数swipeAction返回相应的属性值，根据回调函数返回值中的direction属性，我们可以获取滑动方向，并在text组件中显示。

// index.hml 
<div style=" 
    width: 200px; 
    height: 200px; 
    align-items: center; 
    justify-content: center; 
    border-width: 2px; 
    border-color: red;" 
  onswipe="swipeAction" 
> 
  <text style="width: 100px; height: 50px; text-align: center;">{{title}}</text> 
</div> 
// index.js 
export default { 
  data: { 
      title: '' 
  }, 
  swipeAction(e){ 
      switch(e.direction) { 
          case 'left': 
              this.title = '左滑'; 
              break; 
          case 'right': 
              this.title = '右滑'; 
              break; 
          case 'up': 
              this.title = '上滑'; 
              break; 
          case 'down': 
              this.title = '下滑'; 
              break; 
          default: 
          break; 
      } 
  } 
}

HarmonyOSè½»é‡JSå¼€å‘æ¡†æž¶ä¸ŽW3Cæ ‡å‡†å·®å¼‚åˆ†æž-é¸¿è’™HarmonyOSæŠ€æœ¯ç¤¾åŒº

除了上面关键差异点外，“框架”和W3C标准间还会存在一些组件名称(和等)、属性名称等细节信息差异，建议各位开发者在开发过程中多多参考HarmonyOS官网开发文档。

● HarmonyOS官网开发文档

https://device.harmonyos.com/cn/docs/develop/apiref/js-framework-file-0000000000611396

HarmonyOS轻量JS应用开发框架还在不断演进和完善的过程中，本文主要描述的是当前HarmonyOS轻量JS应用开发框架和主流web开发的W3C标准关键差异点，希望可以帮助到各位开发者上手HarmonyOS开发。

想了解更多内容，请访问：

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com