HarmonyOS開發(fā)實(shí)例：【圖片編輯應(yīng)用】

介紹

通過動(dòng)態(tài)設(shè)置元素樣式的方式，實(shí)現(xiàn)幾種常見的圖片操作，包括裁剪、旋轉(zhuǎn)、縮放和鏡像。效果如圖所示：

相關(guān)概念

• [image組件]：圖片組件，用來渲染展示圖片。
• [div組件]：基礎(chǔ)容器組件，用作頁(yè)面結(jié)構(gòu)的根節(jié)點(diǎn)或?qū)?nèi)容進(jìn)行分組。
• [text組件]：文本組件，用于呈現(xiàn)一段信息。
• [setstyle]：動(dòng)態(tài)設(shè)置組件樣式的方法。

環(huán)境搭建

軟件要求

• [DevEco Studio]版本：DevEco Studio 3.1 Release及以上版本。
• OpenHarmony SDK版本：API version 9及以上版本。

硬件要求

• 開發(fā)板類型：[潤(rùn)和RK3568開發(fā)板]。
• OpenHarmony系統(tǒng)：3.2 Release及以上版本。

環(huán)境搭建

完成本篇Codelab我們首先要完成開發(fā)環(huán)境的搭建，本示例以RK3568開發(fā)板為例，參照以下步驟進(jìn)行：

1. [獲取OpenHarmony系統(tǒng)版本]：標(biāo)準(zhǔn)系統(tǒng)解決方案（二進(jìn)制）。以3.2 Release版本為例：
   
2. 搭建燒錄環(huán)境。
   1. [完成DevEco Device Tool的安裝]
   2. [完成RK3568開發(fā)板的燒錄]
3. 搭建開發(fā)環(huán)境。
   1. 開始前請(qǐng)參考[工具準(zhǔn)備]，完成DevEco Studio的安裝和開發(fā)環(huán)境配置。
   2. 開發(fā)環(huán)境配置完成后，請(qǐng)參考[使用工程向?qū)創(chuàng)建工程（模板選擇“Empty Ability”）。
   3. 工程創(chuàng)建完成后，選擇使用[真機(jī)進(jìn)行調(diào)測(cè)]。
   4. 鴻蒙開發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

代碼結(jié)構(gòu)解讀

本篇Codelab只對(duì)核心代碼進(jìn)行講解，對(duì)于完整代碼，我們會(huì)在gitee中提供。

HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿

├──entry/src/main/js	              // 代碼區(qū)
│  └──MainAbility
│     ├──common
│     │  ├──constants
│     │  │  └──commonConstants.js     // 公共數(shù)據(jù)常量
│     │  └──images
│     ├──i18n		                  // 中英文	
│     │  ├──en-US.json			
│     │  └──zh-CN.json			
│     └──pages
│        └──index
│           ├──index.css              // 首頁(yè)樣式文件	
│           ├──index.hml              // 首頁(yè)布局文件
│           └──index.js               // 首頁(yè)腳本文件
└──entry/src/main/resources           // 應(yīng)用資源目錄

構(gòu)建界面

本示例主界面由上至下分為三部分：頂部標(biāo)題欄、中間圖片區(qū)域、底部操作欄。

標(biāo)題欄中的元素呈水平分布，包含“返回”圖標(biāo)、“編輯”標(biāo)題和“保存”圖標(biāo)。div容器內(nèi)元素默認(rèn)為水平分布，開發(fā)者將對(duì)應(yīng)元素置于div容器組件中即可?！胺祷亍眻D標(biāo)和“編輯”標(biāo)題置于同一個(gè)子div容器中，組成一個(gè)新元素，與“保存”圖標(biāo)分別置于父div容器的水平兩側(cè)。

< !-- index.hml -- >
< !-- 頂部標(biāo)題欄 -- >
< div class="title-container" >
    < div >
        < image src="/common/images/ic_back.png" class="image-back" >< /image >
        < text class="title-text" >{{ $t('strings.edit') }}< /text >
    < /div >
    < image src="/common/images/ic_save.png" class="image-save" >< /image >
< /div >

/* index.css */
.title-container {
    justify-content: space-between;
    width: 100%;
    padding-top: 13vp;
    padding-left: 26vp;
    padding-bottom: 15vp;
    padding-right: 24vp;
}

圖片區(qū)域用于展示被編輯的圖片，使用div容器組件限定區(qū)域范圍。再通過設(shè)置樣式，使范圍內(nèi)的圖片居中展示。圖片組件image設(shè)置object-fit屬性為contain，確保圖片保持寬高比縮放，并在區(qū)域內(nèi)完整展示。

< !-- index.hml -- >
< !-- 圖片區(qū)域 -- >
< div class="image-container" >
    < image id="picture" src="/common/images/ic_meals.png" class="picture" >< /image >
< /div >

/* index.css */
.image-container {
    justify-content: center;
    width: 100%;
    height: 68%;
    flex-direction: column;
    align-items: center;
}

.picture {
    object-fit: contain;
}

操作欄包含裁剪、旋轉(zhuǎn)、縮放和鏡像四種常見操作按鈕。他們的布局和數(shù)據(jù)結(jié)構(gòu)相同，可采用for循環(huán)的方式進(jìn)行渲染。每個(gè)按鈕的圖標(biāo)和文字都是垂直分布，也是通過設(shè)置對(duì)應(yīng)樣式達(dá)到效果。

< !-- index.hml -- >
< !-- 操作欄 -- >
< div >
    < div class="button-container" for="item in buttonList" on:click="pictureManipulation({{ item.buttonType }})" >
        < image src="{{ item.src }}" class="button-icon" >
        < /image >
        < text class="operation-text" >{{ item.description }}< /text >
    < /div >
< /div >

/* index.css */
.button-icon {
    width: 27vp;
    height: 27vp;
    margin-left: 24vp;
    margin-right: 24vp;
    margin-top: 52vp;
    margin-bottom: 6vp;
}

.operation-text {
    font-size: 12fp;
    color: #182431;
}

.button-container {
    justify-content: center;
    flex-direction: column;
    align-items: center;
    width: 100%;
}

編輯圖片

使用指定元素的setStyle(name: string, value: string)方法，可以動(dòng)態(tài)設(shè)置該元素樣式。當(dāng)前示例正是基于此方式，實(shí)現(xiàn)了對(duì)圖片裁剪、旋轉(zhuǎn)、縮放以及鏡像操作。

• 裁剪操作：使用clip-path樣式，設(shè)置組件的裁剪區(qū)域，只顯示區(qū)域內(nèi)的部分，實(shí)現(xiàn)對(duì)圖片的裁剪操作。
• 旋轉(zhuǎn)操作：使用transform動(dòng)畫樣式，設(shè)置組件的旋轉(zhuǎn)動(dòng)畫屬性，實(shí)現(xiàn)對(duì)圖片的旋轉(zhuǎn)操作。
• 縮放操作：動(dòng)態(tài)等比例設(shè)置組件寬、高屬性，實(shí)現(xiàn)對(duì)圖片的縮放操作。
• 鏡像操作：使用transform動(dòng)畫樣式，設(shè)置組件的Y軸方向旋轉(zhuǎn)動(dòng)畫屬性，實(shí)現(xiàn)對(duì)圖片的旋轉(zhuǎn)操作。

// index.js
pictureManipulation(buttonType) {
  if (this.isCropped || this.isRotated || this.isZoomed || this.isMirror) {
    this.$element('picture').setStyle('clipPath', 'inset(0, 0, 0, 0');
    this.$element('picture').setStyle('transform', 'rotate(0)');
    this.$element('picture').setStyle('height', this.imageHeight);
    this.$element('picture').setStyle('width', this.imageWidth);
    this.$element('picture').setStyle('transform', 'rotateY(0)');
    this.degrees = 0;
    this.rotateY = 0;
    this.isCropped = false;
    this.isRotated = false;
    this.isZoomed = false;
    this.isMirror = false;
  } else {
    switch (buttonType) {
      case CommonConstants.OperationType.CROP:
        this.$element('picture')
          .setStyle('clipPath', 'inset(0, 0, ' + (this.imageHeight / CommonConstants.SPLIT_IN_HALF) + ', 0');
        this.isCropped = true;
        break;
      case CommonConstants.OperationType.ROTATE:
        this.degrees = this.degrees + CommonConstants.ROTATE_DEGREE;
        this.$element('picture').setStyle('transform', 'rotate(' + this.degrees + ')');
        this.isRotated = true;
        break;
      case CommonConstants.OperationType.ZOOM:
        this.$element('picture').setStyle('height', this.imageHeight / CommonConstants.SPLIT_IN_HALF);
        this.$element('picture').setStyle('width', this.imageWidth / CommonConstants.SPLIT_IN_HALF);
        this.isZoomed = true;
        break;
      case CommonConstants.OperationType.MIRROR:
        this.rotateY = this.rotateY + CommonConstants.ROTATE_Y;
        this.$element('picture').setStyle('transform', 'rotateY(' + this.rotateY + ')');
        this.isMirror = true;
        break;
      default:
        hilog.info(0x0000, 'ImageOperation', '%{public}s', 'Operation type is wrong!');
        break;
    }
  }
}

審核編輯 黃宇