Java之父詹姆斯·高斯林（James Gosling）学鸿蒙（HarmonyOS），HarmonyOS（鸿蒙）——Image组件详述

￡神魔★判官ぃ 2022-09-15 12:27 150阅读 0赞

**本文已收录于专栏**

[❤️《鸿蒙开发》❤️][Link 1]

**欢迎各位关注、三连博主的文章及专栏，每周定期更新1-5篇基础文章，共勉！**

--------------------

##  ##

## 1、简介 ##

Image是用来显示图片的组件，我们在开发中使用的非常频繁！

## 2、属性表 ##

Image也是组件，它继承自：**ohos.agp.components.Component**

我们在使用Image组件的时候，只需要事先搞懂它的属性，使用起来就很方便了（官方指定的全部Image属性，都在这里）：

<table> 
 <tbody> 
 <tr> 
 <td> 属性名称 </td> 
 <td> 中文描述 </td> 
 <td> 取值 </td> 
 <td> 取值说明 </td> 
 <td> 使用案例 </td> 
 </tr> 
 <tr> 
 <td> clip_alignment </td> 
 <td> 图像裁剪对齐方式 </td> 
 <td> left </td> 
 <td> 表示按左对齐裁剪。 </td> 
 <td> ohos:clip_alignment="left" </td> 
 </tr> 
 <tr> 
 <td> right </td> 
 <td> 表示按右对齐裁剪。 </td> 
 <td> ohos:clip_alignment="right" </td> 
 </tr> 
 <tr> 
 <td> top </td> 
 <td> 表示按顶部对齐裁剪。 </td> 
 <td> ohos:clip_alignment="top" </td> 
 </tr> 
 <tr> 
 <td> bottom </td> 
 <td> 表示按底部对齐裁剪。 </td> 
 <td> ohos:clip_alignment="bottom" </td> 
 </tr> 
 <tr> 
 <td> center </td> 
 <td> 表示按居中对齐裁剪。 </td> 
 <td> ohos:clip_alignment="center" </td> 
 </tr> 
 <tr> 
 <td> image_src </td> 
 <td> 图像 </td> 
 <td> Element类型 </td> 
 <td> 可直接配置色值，也可引用color资源或引用media/graphic下的图片资源。 </td> 
 <td> ohos:image_src="#FFFFFFFF" ohos:image_src="$color:black" ohos:image_src="$media:warning" ohos:image_src="$graphic:graphic_src" </td> 
 </tr> 
 <tr> 
 <td> scale_mode </td> 
 <td> 图像缩放类型 </td> 
 <td> zoom_center </td> 
 <td> 表示原图按照比例缩放到与Image最窄边一致，并居中显示。 </td> 
 <td> ohos:scale_mode="center" </td> 
 </tr> 
 <tr> 
 <td> zoom_start </td> 
 <td> 表示原图按照比例缩放到与Image最窄边一致，并靠起始端显示。 </td> 
 </tr> 
 <tr> 
 <td> zoom_end </td> 
 <td> 表示原图按照比例缩放到与Image最窄边一致，并靠结束端显示。 </td> 
 </tr> 
 <tr> 
 <td> stretch </td> 
 <td> 表示将原图缩放到与Image大小一致。 </td> 
 </tr> 
 <tr> 
 <td> center </td> 
 <td> 表示不缩放，按Image大小显示原图中间部分。 </td> 
 </tr> 
 <tr> 
 <td> inside </td> 
 <td> 表示将原图按比例缩放到与Image相同或更小的尺寸，并居中显示。 </td> 
 </tr> 
 <tr> 
 <td> clip_center </td> 
 <td> 表示将原图按比例缩放到与Image相同或更大的尺寸，并居中显示。 </td> 
 </tr> 
 </tbody> 
</table>

## 3、使用 ##

### 3.1 上传资源 ###

在使用Image组件之前，需要知道HarmonyOS的应用程序结构中，图片资源的存放位置。 我们创建一个项目之后，打开项目的entry > src > main > resources > base > media目录，这个下面会有一张默认的icon.png图片。这里就是图片指定存放位置了。

![image.png][]

我们接下来使用Java之父（詹姆斯·高斯林 （James Gosling）），来做测试，保佑大家都成为Java之母，哈哈哈哈哈！！！

![下载.jpg][.jpg]

将图片放置到entry > src > main > resources > base > media即可！

![image.png][image.png 1]

### 3.2 代码中使用 ###

HarmonyOS的Java语义开发中，组件可以通过XML配置和Java代码直接构建，这里两种方式都演示一下。

3.2.1 XML创建Image

在src -> main -> resources -> base -> layout -> ability\_main.xml中实现如下代码：

<?xml version="1.0" encoding="utf-8"?>
 <DirectionalLayout
     xmlns:ohos="http://schemas.huawei.com/res/ohos"
     ohos:height="match_parent"
     ohos:width="match_parent"
     ohos:alignment="center"
     ohos:orientation="vertical">
 
 
     
     <Image
         ohos:id="$+id:imageComponent"
         ohos:height="200vp"
         ohos:width="200vp"
         ohos:image_src="$media:JamesGosling"
         />
 
 </DirectionalLayout>

启动应用程序看下效果，我们来瞅瞅Java之父（嗯嗯嗯，有点小呀！！）

![image.png][image.png 2]

3.2.2 Java代码创建Image

注释掉XML中配置的Image，我们改用Java代码实现。 在com.liziba.image.slice.MainAbilitySlice类的onStart方法中，创建Image代码如下：

package com.liziba.image.slice;
    
    import com.liziba.image.ResourceTable;
    import ohos.aafwk.ability.AbilitySlice;
    import ohos.aafwk.content.Intent;
    import ohos.agp.components.DirectionalLayout;
    import ohos.agp.components.Image;
    
    public class MainAbilitySlice extends AbilitySlice {
        @Override
        public void onStart(Intent intent) {
            super.onStart(intent);
    
            //创建一个Image组件
            Image image = new Image(getContext());
            image.setPixelMap(ResourceTable.Media_JamesGosling);
            image.setHeight(500);
            image.setWidth(500);
            image.setScaleMode(Image.ScaleMode.STRETCH);
    
    
            //创建一个布局
            DirectionalLayout layout = new DirectionalLayout(getContext());
            //Image组件添加到DirectionalLayout布局中
            layout.addComponent(image);
    
            super.setUIContent(layout);
        }
    
        @Override
        public void onActive() {
            super.onActive();
        }
    
        @Override
        public void onForeground(Intent intent) {
            super.onForeground(intent);
        }
    }

这里做了一个简单的缩放，将原图缩放到与Image大小一致，看下效果（嗯不错，长大了点，哈哈哈！！！）：

![image.png][image.png 3]

### 3.3 属性 ###

由于在实际开发中，XML配置UI的还是多一些，因为方便改动和统一管理，也更加灵活。所以属性这里，都用XML配置来演示啦！！！

3.3.1 透明度

**设置透明度为0.2，透明度设置的越小，图片越透明，原图透明度为1。**

> **ohos:alpha="0.2"**

![image.png][image.png 4]

3.3.2 缩放系数

当我们给定的图片大小和Image组件设置的大小不一致的时候，我们往往需要通过缩放来实现兼容。（但是为了图片不失真，最后还是少用缩放，图片大小不符合尽量找美工做一张新的图片。）

缩放系数可设置X轴和Y轴方向两个参数，其实就是宽、高

**如下是缩放x和y轴都配置0.5的效果**

> ohos:scale\_x="0.5"
> 
> **ohos:scale\_y="0.5"**

<Image
        ohos:id="$+id:imageComponent"
        ohos:height="200vp"
        ohos:width="200vp"
        ohos:image_src="$media:JamesGosling"
        ohos:scale_x="0.5"
        ohos:scale_y="0.5"
        />

![image.png][image.png 5]

**如下是配置为1的效果，默认为1，可以不配置：**

> ohos:scale\_x="1"
> 
> **ohos:scale\_y="1"**

<Image
        ohos:id="$+id:imageComponent"
        ohos:height="200vp"
        ohos:width="200vp"
        ohos:image_src="$media:JamesGosling"
        ohos:scale_x="1"
        ohos:scale_y="1"
        />

![image.png][image.png 6]

**能不能配置为比1大的数呢？当然是可以的，这样会更加配置的缩放参数，进行放大。** 比如配置一个2试试：

> ohos:scale\_x="2"
> 
> **ohos:scale\_y="2"**

<Image
        ohos:id="$+id:imageComponent"
        ohos:height="200vp"
        ohos:width="200vp"
        ohos:image_src="$media:JamesGosling"
        ohos:scale_x="2"
        ohos:scale_y="2"
        />

![image.png][image.png 7]

3.3.3 裁剪

如果给定的图片太大了，超过了我们的Image设置的大小，那该怎么办呢？ 这个时候我们可以使用裁剪，裁剪有下面这些参数，只演示一个吧！

<table> 
 <thead> 
 <tr> 
 <th>属性名称</th> 
 <th>中文描述</th> 
 <th>取值</th> 
 <th>取值说明</th> 
 <th>使用案例</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>clip_alignment</td> 
 <td>图像裁剪对齐方式</td> 
 <td>left</td> 
 <td>表示按左对齐裁剪。</td> 
 <td>ohos:clip_alignment="left"</td> 
 </tr> 
 <tr> 
 <td></td> 
 <td></td> 
 <td>right</td> 
 <td>表示按右对齐裁剪。</td> 
 <td>ohos:clip_alignment="right"</td> 
 </tr> 
 <tr> 
 <td></td> 
 <td></td> 
 <td>top</td> 
 <td>表示按顶部对齐裁剪。</td> 
 <td>ohos:clip_alignment="top"</td> 
 </tr> 
 <tr> 
 <td></td> 
 <td></td> 
 <td>bottom</td> 
 <td>表示按底部对齐裁剪。</td> 
 <td>ohos:clip_alignment="bottom"</td> 
 </tr> 
 <tr> 
 <td></td> 
 <td></td> 
 <td>center</td> 
 <td>表示按居中对齐裁剪。</td> 
 <td>ohos:clip_alignment="center"</td> 
 </tr> 
 </tbody> 
</table>

我们先将Image组件设置小一点，这样我们能看出裁剪的效果，这里我们采取按左对齐裁剪：

<Image
        ohos:id="$+id:imageComponent"
        ohos:height="50vp"
        ohos:width="50vp"
        ohos:image_src="$media:JamesGosling"
        ohos:clip_alignment="left"
        />

![image.png][image.png 8]

3.3.4 缩放

当图片和Image组件的大小不同的时候，我们可以通过缩放的形式来自行适配。 比如我们此时设置的Image组件大小宽高均为200vp，但是图片的肯定没得这么大，所以我们可以考虑放大图片，让图片放大到Image组件的大小即可。

我们采用stretch，将原图缩放到与Image大小一致。

> **ohos:scale\_mode="stretch"**

<Image
        ohos:id="$+id:imageComponent"
        ohos:height="200vp"
        ohos:width="200vp"
        ohos:image_src="$media:JamesGosling"
        ohos:scale_mode="stretch"
        />

![image.png][image.png 9]

Image组件非常简单，多试试就会了！！！

[Link 1]: https://blog.csdn.net/qq_41125219/category_11227374.html
[image.png]: /images/20220828/d1b45327541f4b029542c8bff9ea4196.png
[.jpg]: /images/20220828/96f238a1fe364755b08e211b3da5a214.png
[image.png 1]: /images/20220828/36b3e874d9854a508e1b49905c0a4196.png
[image.png 2]: /images/20220828/1f40e5751bb34beb88330d355081192f.png
[image.png 3]: /images/20220828/611d578b1340485e97967735cb362e9e.png
[image.png 4]: /images/20220828/3b8ba1f5269343ebb4a3774410771843.png
[image.png 5]: /images/20220828/9d618bd722f345ecae10508930b57e5a.png
[image.png 6]: /images/20220828/d6210b3edfcf4ba58f765b21044c992f.png
[image.png 7]: /images/20220828/b3bd7b67b9014d819998c00087f6fbf8.png
[image.png 8]: /images/20220828/8ea0e7534d804565bb89b1035812644a.png
[image.png 9]: /images/20220828/e466735a95ed4c2f984872f1a2eb384b.png