3.4【HarmonyOS鸿蒙开发】组件Image

作者：韩茹

公司：程序咖（北京）科技有限公司

鸿蒙巴士专栏作家

Image是用来显示图片的组件。

一、支持的XML属性

Image的共有XML属性继承自：Component

Image的自有XML属性见下表：

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

二、创建Image

在“Project”窗口，打开“entry > src > main > resources > base > media”，添加一个图片至media文件夹下，以“chengxuka.jpg”为例。

WX20210608-134536@2x

既可以在XML中创建Image，也可以在代码中创建Image，两种方式如下：

在XML中创建Image

<Image
        ohos:height="match_content"
        ohos:width="match_content"
        ohos:layout_alignment="center"
        ohos:image_src="$media:chengxuka"/>

获取输入框的内容：在代码中创建Image

				//创建Image
        Image image = new Image(getContext());
        //设置要显示的图片
        image.setPixelMap(ResourceTable.Media_chengxuka);

这里注意，使用Image不要导错包，使用下面的这条导入：

import ohos.agp.components.Image;

效果：

WX20210608-135037@2x

三、设置Image

    1. 设置透明度
  <Image
          ohos:height="match_content"
          ohos:width="match_content"
          ohos:layout_alignment="center"
          ohos:top_margin="20vp"
          ohos:image_src="$media:chengxuka"
          ohos:alpha="0.5"
          />

设置透明度为0.5的效果和没有设置透明度的对比：

WX20210608-140359@2x

    1. 设置缩放系数
  <Image
          ohos:height="match_content"
          ohos:width="match_content"
          ohos:layout_alignment="center"
          ohos:top_margin="20vp"
          ohos:image_src="$media:chengxuka"
          ohos:scale_x="0.5"
          ohos:scale_y="0.5"
          />

效果

WX20210608-140537@2x

    1. 设置缩放方式

    当图片尺寸与Image尺寸不同时，可以根据不同的缩放方式来对图片进行缩放，如设置Image的宽高为150vp

  <?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:orientation="vertical">
  
  <!--    scale_mode，图片尺寸与Image尺寸不同时，可以根据不同的缩放方式来对图片进行缩放
              center，表示不缩放，按Image大小显示原图中间部分。
              zoom_center，表示原图按照比例缩放到与Image最窄边一致，并居中显示。
              stretch，表示将原图缩放到与Image大小一致。
              inside，表示将原图按比例缩放到与Image相同或更小的尺寸，并居中显示。
              clip_center，表示将原图按比例缩放到与Image相同或更大的尺寸，并居中显示。
  -->
  <!--    center，表示不缩放，按Image大小显示原图中间部分。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:scale_mode="center"
          />
  <!--    zoom_center，表示原图按照比例缩放到与Image最窄边一致，并居中显示。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:scale_mode="zoom_center"
          ohos:background_element="$graphic:background_image"
          />
  
  <!--    stretch，表示将原图缩放到与Image大小一致。图片可能会变形-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:scale_mode="stretch"
          ohos:background_element="$graphic:background_image"
          />
  <!--    inside，表示将原图按比例缩放到与Image相同或更小的尺寸，并居中显示。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:scale_mode="inside"
          ohos:background_element="$graphic:background_image"
          />
  <!--    clip_center，表示将原图按比例缩放到与Image相同或更大的尺寸，并居中显示。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:scale_mode="clip_center"
          ohos:background_element="$graphic:background_image"
          />
  
  </DirectionalLayout>

这里我们为了更好的看到效果，在图片上加了边框，设置背景资源如下background_image.xml：

<?xml version="1.0" encoding="UTF-8" ?>
<shape xmlns:ohos="http://schemas.huawei.com/res/ohos"
       ohos:shape="rectangle">

    <stroke
        ohos:color="#FF0000"
        ohos:width="6"/>
</shape>

效果：

WX20210608-143148@2x
    1. 设置裁剪对齐模式

    当Image尺寸小于图片尺寸时，可以对图片进行裁剪，仍以Image的宽高为150vp为例，小于图片尺寸。

  <?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:orientation="vertical">
  
  <!--    clip_alignment，图像裁剪对齐方式
              left    表示按左对齐裁剪。
              right   表示按右对齐裁剪。
              top     表示按顶部对齐裁剪。
              bottom  表示按底部对齐裁剪。
              center  表示按居中对齐裁剪。
  -->
  <!--    left    表示按左对齐裁剪。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:clip_alignment="left"
          />
  <!--    right   表示按右对齐裁剪。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:clip_alignment="right"
          />
  
  <!--    top     表示按顶部对齐裁剪。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:clip_alignment="top"
          />
  <!--    bottom  表示按底部对齐裁剪。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:clip_alignment="bottom"
          />
  <!--    center  表示按居中对齐裁剪。-->
      <Image
          ohos:height="150vp"
          ohos:width="150vp"
          ohos:image_src="$media:chengxuka"
          ohos:clip_alignment="center"
          />
  
  </DirectionalLayout>

效果如下：

WX20210608-143453@2x

四、写个例子-轮播图

我们做一个轮播图：设置两个按钮，上一张和下一张，点击下一张就显示下一张图片，点击上一张，就显示上一张图片。

imageyunxing1 
思路分析：
我们先将这些图片资源存储在一个数组里，然后设置一个下标变量index，用于表示当前Image组件要显示的图片，当点击上一张按钮的时候，我们将index减1。当点击下一张按钮的时候，我们将idnex加1。这里要注意index的边界值问题。

1、首先准备好一些图片，将它们粘贴到media目录下。

WX20210608-151115@2x

2、首先在layout目录下，新建一个布局文件：image_carousel.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:orientation="vertical">



    <Image
        ohos:id="$+id:image1"
        ohos:height="0"
        ohos:weight="1"
        ohos:width="300vp"
        ohos:layout_alignment="center"
        ohos:top_margin="30vp"
        ohos:bottom_margin="30vp"
        ohos:scale_mode="stretch"
        ohos:image_src="$media:img001"
        ohos:background_element="#33FF0000"/>

    <DependentLayout
        ohos:height="match_content"
        ohos:layout_alignment="center"
        ohos:bottom_margin="30vp"
        ohos:width="300vp">
        <Button
            ohos:id="$+id:btn1"
            ohos:height="match_content"
            ohos:width="match_content"
            ohos:align_parent_left="true"
            ohos:text_size="18fp"
            ohos:background_element="$graphic:background_button"
            ohos:text="上一张"
            ohos:left_padding="14vp"
            ohos:right_padding="14vp"
            ohos:top_padding="8vp"
            ohos:bottom_padding="8vp"

            />
        <Button
            ohos:id="$+id:btn2"
            ohos:height="match_content"
            ohos:width="match_content"
            ohos:text_size="18fp"
            ohos:align_parent_right="true"
            ohos:text="下一张"
            ohos:background_element="$graphic:background_button"
            ohos:left_padding="14vp"
            ohos:right_padding="14vp"
            ohos:top_padding="8vp"
            ohos:bottom_padding="8vp"
            />
    </DependentLayout>



</DirectionalLayout>

为了让两个按钮更加美观，我们设置一下按钮的背景样式，

然后我们在graphic目录下创建所需要的xml文件，

background_button.xml代码示例：

<?xml version="1.0" encoding="UTF-8" ?>
<shape xmlns:ohos="http://schemas.huawei.com/res/ohos"
       ohos:shape="rectangle">
    <solid
        ohos:color="#3387CEFA"/>
    <corners
        ohos:radius="18vp"/>
    <stroke
        ohos:color="#9987CEFA"
        ohos:width="6"/>
</shape>

3、Java中的代码

首先我们修改MainAbilitySlice中onStart()方法里，要加载显示的布局文件：

				//要加载显示的布局文件
        super.setUIContent(ResourceTable.Layout_image_carousel);

然后先设置图片的资源数组和index下标，这里要将它们声明为成员变量：

//1.将图片的id，存入数组中，int
    int[] images = {ResourceTable.Media_img001,ResourceTable.Media_img002,ResourceTable.Media_img003,ResourceTable.Media_img004,ResourceTable.Media_img005,ResourceTable.Media_img006,ResourceTable.Media_img007,ResourceTable.Media_img008,ResourceTable.Media_img009};
    //2.定义下标
    int index = 0;

最后获取图片控件，按钮控件，为按钮添加点击事件：

				//实现图片轮播
        /*
        题目思路：点击上一张，切换到上一个图片，点击下一张，切换到下一个图片。
        将图片存放在数组中，统一操作index数组的下标完成。
         */

        //3.获取控件对象
        Image image = (Image) findComponentById(ResourceTable.Id_image1);
        Button btn1 = (Button) findComponentById(ResourceTable.Id_btn1);
        Button btn2 = (Button) findComponentById(ResourceTable.Id_btn2);

        //4.为按钮添加点击事件
        btn1.setClickedListener(new Component.ClickedListener() {
            @Override
            public void onClick(Component component) {
                //上一张：点击按钮，index-1
                index--;
                if(index<0){
                    index = images.length-1;
                }
                if(index>images.length-1){
                    index= 0;
                }
                image.setPixelMap(images[index]);
            }
        });
        btn2.setClickedListener(new Component.ClickedListener() {
            @Override
            public void onClick(Component component) {
                //下一张：点击按钮，index+1
                index++;
                if(index<0){
                    index = images.length-1;
                }
                if(index>images.length-1){
                    index= 0;
                }
                image.setPixelMap(images[index]);
            }
        });

五、再写个例子

我们再来一个例子，和刚才差不多，点击按钮，来更改图片的透明度。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-oZeYbP80-1625189770080)(https://img.chengxuka.com/imageyunxing2.gif)]

1、首先准备好一张素材图片，复制到media目录下。

2、在layout目录下，新建一个布局文件：image_alpha.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">
    <Text
        ohos:height="match_content"
        ohos:width="match_content"
        ohos:text="增减透明度"
        ohos:text_size="18fp"
        ohos:text_alignment="center"
        />


    <Image
        ohos:id="$+id:image1"
        ohos:height="400vp"
        ohos:width="300vp"
        ohos:layout_alignment="center"
        ohos:top_margin="30vp"
        ohos:bottom_margin="30vp"
        ohos:scale_mode="stretch"
        ohos:image_src="$media:aa"
        ohos:background_element="#33FF0000"/>

    <DependentLayout
        ohos:height="match_content"
        ohos:layout_alignment="center"
        ohos:bottom_margin="30vp"
        ohos:width="300vp">
        <Button
            ohos:id="$+id:btn1"
            ohos:height="match_content"
            ohos:width="match_content"
            ohos:align_parent_left="true"
            ohos:text_size="18fp"
            ohos:background_element="$graphic:background_button"
            ohos:text="+"
            ohos:left_padding="14vp"
            ohos:right_padding="14vp"
            ohos:top_padding="8vp"
            ohos:bottom_padding="8vp"

            />
        <Button
            ohos:id="$+id:btn2"
            ohos:height="match_content"
            ohos:width="match_content"
            ohos:text_size="18fp"
            ohos:align_parent_right="true"
            ohos:text="-"
            ohos:background_element="$graphic:background_button"
            ohos:left_padding="14vp"
            ohos:right_padding="14vp"
            ohos:top_padding="8vp"
            ohos:bottom_padding="8vp"
            />
    </DependentLayout>



</DirectionalLayout>

这里我们为了页面好看，将按钮设置为圆形，在graphic目录下，添加按钮的背景文件，background_circle_button.xml，内容如下：

<?xml version="1.0" encoding="UTF-8" ?>
<shape xmlns:ohos="http://schemas.huawei.com/res/ohos"
       ohos:shape="oval">
    <solid
        ohos:color="#3387CEFA"/>
    <corners
        ohos:radius="18vp"/>
    <stroke
        ohos:color="#9987CEFA"
        ohos:width="6"/>
</shape>

3、如果你在刚刚轮播图例子的这个项目里来实现，那么我们在slice目录下，新建一个java文件，SecondAbilitySlice.java，示例代码如下：

package com.example.hanruimage.slice;

import com.example.hanruimage.ResourceTable;
import ohos.aafwk.ability.AbilitySlice;
import ohos.aafwk.content.Intent;
import ohos.agp.components.Button;
import ohos.agp.components.Component;
import ohos.agp.components.Image;

public class SecondAbilitySlice extends AbilitySlice{
    float alpha = 1.0f;//取值范围0-1之间。
    @Override
    protected void onStart(Intent intent) {
        super.onStart(intent);
        super.setUIContent(ResourceTable.Layout_image_alpha);
        //获取控件
        Image image = (Image) findComponentById(ResourceTable.Id_image1);
        Button btn1 = (Button) findComponentById(ResourceTable.Id_btn1);
        Button btn2 = (Button) findComponentById(ResourceTable.Id_btn2);

        //为按钮添加点击事件
        btn1.setClickedListener(new Component.ClickedListener() {
            @Override
            public void onClick(Component component) {
                alpha += 0.25;
                if(alpha>=1){
                    alpha = 1;
                }
                image.setAlpha(alpha);
            }
        });
        btn2.setClickedListener(new Component.ClickedListener() {
            @Override
            public void onClick(Component component) {
                alpha -= 0.25;
                if(alpha<=0){
                    alpha = 0;
                }
                image.setAlpha(alpha);
            }
        });
    }
}

那么我们就要修改程序的入口，程序的默认入口是显示MainAbilitySlice，修改MainAbility文件：

package com.example.hanruimage;

import com.example.hanruimage.slice.MainAbilitySlice;
import com.example.hanruimage.slice.SecondAbilitySlice;
import ohos.aafwk.ability.Ability;
import ohos.aafwk.content.Intent;

public class MainAbility extends Ability {
    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
//        super.setMainRoute(MainAbilitySlice.class.getName());
        super.setMainRoute(SecondAbilitySlice.class.getName());
    }
}

然后运行程序即可。

更多内容：

1、社区：鸿蒙巴士https://www.harmonybus.net/

2、公众号：HarmonyBus

3、技术交流QQ群：714518656

4、视频课：https://www.chengxuka.com

Logo
HarmonyOS开发者社区

讨论HarmonyOS开发技术，专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐

cover

2024 HarmonyOS极客马拉松

avatar HarmonyOS开发者社区
cover

鸿蒙OS初体验：从0到1的开发者之路·北京

avatar HarmonyOS开发者社区
cover

鸿蒙OS初体验：从0到1的开发者之路·深圳

avatar HarmonyOS开发者社区