【Android】一文讲明Jetpack中的图片组件

Jetpack Compose中的常用图片组件有两个:Icon和Image。从命名上就不难看出这两个组件在内容呈现上就是负责图形和图片相关。

需要说明的是,Compose获取资源方式有四种:

  • 文本 -> stringResource(R.string.hello_world)

  • 颜色 -> colorResource(R.color.black)

  • 尺寸 -> dimensionResource(R.dimen.padding)

  • 图片 -> painterResource(R.drawable.head_icon)

而Icon和Image毫无疑问都是图片资源。

Icon

image.gif

Icon共有三种构造函数:

fun Icon(
    bitmap: ImageBitmap,
    contentDescription: String?,
    modifier: Modifier = Modifier,
    tint: Color = LocalContentColor.current.copy(alpha = LocalContentAlpha.current)
) 
fun Icon(
    imageVector: ImageVector,
    contentDescription: String?,
    modifier: Modifier = Modifier,
    tint: Color = LocalContentColor.current.copy(alpha = LocalContentAlpha.current)
)
fun Icon(
    painter: Painter,
    contentDescription: String?,
    modifier: Modifier = Modifier,
    tint: Color = LocalContentColor.current.copy(alpha = LocalContentAlpha.current)
) 

三种函数仅第一个参数类型不一致,但均是Icon的实际内容。其他三个参数,分别为:

· contentDescription: 内容含义描述,用于 无障碍服务(考虑到一些视觉障碍的人使用,所以有个这个属性,会使用TTS语音播放将contentDescription属性读出来,告知用户此按钮的作用) ,如果这个Icon可以被触发,就需要解释它的含义,如果仅仅是装饰性质,可以忽略掉。

· modifier: 修饰器。

· tint: 着色器,可以直接修改Icon实质内容的颜色。(跟View体系的一个道理)

另外三个有区别的参数即:

· ImageBitmap: 位图。

· Painter: 抽象类,表示可被绘制的内容,类似于Android中的 Drawable。

· ImageVector: 矢量图。

Compose内置了几十个常用的图标,Icons里面定了5种MaterialDesign类型风格Outlined、Filled、Sharp、TwoTone、Rounded,可以根据自己的需要选择不同的类型。

下例我们引用官方提供的矢量图资源来显示五种类型Icon:

Row {
    Icon(Icons.Outlined.CheckCircle, contentDescription = null, tint = Color.Red)
    Icon(Icons.Filled.CheckCircle, contentDescription = null, tint = Color.Black)
    Icon(Icons.Sharp.CheckCircle, contentDescription = null, tint = Color.Blue)
    Icon(Icons.TwoTone.CheckCircle, contentDescription = null, tint = Color.Green)
    Icon(Icons.Rounded.CheckCircle, contentDescription = null, tint = Color.Red)
} 

对应效果为:

image.gif

不难看出,这五种风格分别对应:

· Filled 默认类型,图形是内容填充风格。

· Outlined 轮廓型,只有描边,不做填充。

· Rounded 圆形,例如圆形启动图标。

· TwoTone 双调,不确定翻译doc是否写错,和Sharp完全一致。

· Sharp 例如直角图标。

这里需要提一下,代码中的图片资源文件是Compose内置的,除此之外默认常用的多达40+个,如果想用其他内置图标,可以在gradle中通过导入material-icons-extended依赖来使用:

dependencies {
    ···
    implementation "androidx.compose.material:material-icons-extended:$compose_version"
} 

但是全套图标会导致打包后的apk文件会过大,所以官方推荐使用导入图标文件的方法,详情可参考官方文档

Painter

我们拿Painter写个简单的Icon:

Icon(painter = painterResource(id = R.mipmap.ic_launcher), null) 

一运行,发现:

image.gif

居然报错了!赶紧看下原因:
image.gif

错误原因写得很清楚了,这里painter对象只只支持.png或.jpg格式图片,而原图片是.webp格式。

这回我们换个图片,如下:

Icon(painter = painterResource(id = R.mipmap.icon_text), null) 

运行发现:

image.gif

显示成黑色了,原图不是这样的啊。

这里需要说明的是,tint着色器默认模式是AmbientContentColor.current,我们要显示出原图色彩需要更换模式,设置tint的属性设置为Color.Unspecified

代码可以修改为:

Icon(painter = painterResource(id = R.mipmap.icon_text), null, tint = Color.Unspecified) 

对应的Icon也正常显示了:

image.gif

Image

按照惯例,我们先看引用Image控件需要的参数。

image.gif
image.gif

不难看出Image参数与Icon的基础参数几乎一致。使用方式事实上也一致,这里主要说下其他区别参数:

alignment:对齐方向

Image使用alignment的前提是设置了宽高。alignment对应的取值如下:

image.gif

看词义就能猜到具体位置,这里不做赘述。

contentScale:缩放设置

其效果类似View体系中的ImageView scaleType属性,具体缩放值在ContentScale中:

image.gif

其中这一项默认值为ContentScale.Fit。其余各参数解释如下:

· ContentScale.Crop: 裁剪;

· ContentScale.FillBounds: 拉伸图片宽高填满形状;

· ContentScale.FillHeight: 拉伸图片高度填满高度;

· ContentScale.FillWidth: 拉伸图片宽度填满宽度;

· ContentScale.Fit: 均匀缩放源(保持源的长宽比),以便源的两个维度(宽度和高度)都等于或小于目标的相应维度;

· ContentScale.Inside: 如果源大于目标,则缩放源以保持长宽比在目标边界内。 如果源在两个维度中都小于或等于目标,则此行为类似于None;

· ContentScale.None: 不缩放。

alpha透明度

数值范围为0f-1f之间,默认是1f,这没什么好讲的。

colorFilter:着色效果

将某种颜色应用到图片上,即使用颜色对图片进行混合加工,有如下三种设置方法:

· ColorFilter.tint(Color, BlendMode) :修改着色效果;

· ColorFilter.lighting(Color,AddColor) :在着色图片上添加AddColor颜色;

· ColorFilter.colorMatrix(colorMatrix) :修改着色矩阵。

一般来说,都是用在图片不变的基础上修改图片颜色。

Row {
    Image(modifier = Modifier
        .size(60.dp, 45.dp),
        painter = painterResource(id = R.drawable.icon_text),
        contentDescription = null,
        alpha = 1f,
        colorFilter = null
    )
    Image(modifier = Modifier
        .size(60.dp, 45.dp),
        painter = painterResource(id = R.drawable.icon_text),
        contentDescription = null,
        alpha = 1f,
        colorFilter = ColorFilter.tint(color = Color.Blue, BlendMode.SrcAtop)
    )
    Image(modifier = Modifier
        .size(60.dp, 45.dp),
        painter = painterResource(id = R.drawable.icon_text),
        contentDescription = null,
        alpha = 1f,
        colorFilter = ColorFilter.lighting(multiply = Color.Blue,add = Color.Black)
    )
} 

对应的效果为:

image.gif

colorMatrix涉及到色彩矩阵,使用场景也较少,这里不再赘述。

最后

如果想要成为架构师或想突破20~30K薪资范畴,那就不要局限在编码,业务,要会选型、扩展,提升编程思维。此外,良好的职业规划也很重要,学习的习惯很重要,但是最重要的还是要能持之以恒,任何不能坚持落实的计划都是空谈。

一、面试合集

image
二、源码解析合集

image
三、开源框架合集
在这里插入图片描述

私信获取籽料~

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,029评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,395评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,570评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,535评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,650评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,850评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,006评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,747评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,207评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,536评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,683评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,342评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,964评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,772评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,004评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,401评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,566评论 2 349

推荐阅读更多精彩内容