A requirement that almost every single application has is "I want to scale up an ImageView proportionally to fit its parent. How can I do that?" Like this:
Actually ImageView has already come with this capability. You can just simply setandroid:adjustViewBounds
to true
and that's all.
1
2
3
4
5
|
<
ImageView
android:layout_width
=
"match_parent"
android:layout_height
=
"wrap_content"
android:adjustViewBounds
=
"true"
android:src
=
"@mipmap/ic_launcher"
/>
|
Here is the result.
Everything looks fine? Actually not. If you switch your preview version to API Level 17 or below, you will see that ImageView doesn't scale up anymore.
It is not a bug but a correct behaviour that is officially noted in the documentation.
Note: If the application targets API level 17 or lower, adjustViewBounds will allow the drawable to shrink the view bounds, but not grow to fill available measured space in all cases. This is for compatibility with legacyMeasureSpec
andRelativeLayout
behavior.
It means that in API Level 17 and below, the maximum width and maximum height are bounded to the size of image defined in android:src
. As a result, it happens like picture above.
Have a small look at Market Share of Android Platform Versions. It appears that Android phone running API Level 17 and below takes almost 50% share.
It is not a good solution to set minSdkVersion to 18 just to avoid this problem.
It is far better to modify some ImageView's source code to give it an API Level 18+'s behavior and use it instead of a normal ImageView. Here it comes, a Custom ImageView that does the job !
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
import
android.content.Context;
import
android.graphics.drawable.Drawable;
import
android.util.AttributeSet;
import
android.view.ViewGroup;
import
android.view.ViewParent;
import
android.widget.ImageView;
/**
* Created by nuuneoi on 2/17/15 AD.
*/
public
class
AdjustableImageView
extends
ImageView {
boolean
mAdjustViewBounds;
public
AdjustableImageView(Context context) {
super
(context);
}
public
AdjustableImageView(Context context, AttributeSet attrs) {
super
(context, attrs);
}
public
AdjustableImageView(Context context, AttributeSet attrs,
int
defStyleAttr) {
super
(context, attrs, defStyleAttr);
}
@Override
public
void
setAdjustViewBounds(
boolean
adjustViewBounds) {
mAdjustViewBounds = adjustViewBounds;
super
.setAdjustViewBounds(adjustViewBounds);
}
@Override
protected
void
onMeasure(
int
widthMeasureSpec,
int
heightMeasureSpec) {
Drawable mDrawable = getDrawable();
if
(mDrawable ==
null
) {
super
.onMeasure(widthMeasureSpec, heightMeasureSpec);
return
;
}
if
(mAdjustViewBounds) {
int
mDrawableWidth = mDrawable.getIntrinsicWidth();
int
mDrawableHeight = mDrawable.getIntrinsicHeight();
int
heightSize = MeasureSpec.getSize(heightMeasureSpec);
int
widthSize = MeasureSpec.getSize(widthMeasureSpec);
int
heightMode = MeasureSpec.getMode(heightMeasureSpec);
int
widthMode = MeasureSpec.getMode(widthMeasureSpec);
if
(heightMode == MeasureSpec.EXACTLY && widthMode != MeasureSpec.EXACTLY) {
// Fixed Height & Adjustable Width
int
height = heightSize;
int
width = height * mDrawableWidth / mDrawableHeight;
if
(isInScrollingContainer())
setMeasuredDimension(width, height);
else
setMeasuredDimension(Math.min(width, widthSize), Math.min(height, heightSize));
}
else
if
(widthMode == MeasureSpec.EXACTLY && heightMode != MeasureSpec.EXACTLY) {
// Fixed Width & Adjustable Height
int
width = widthSize;
int
height = width * mDrawableHeight / mDrawableWidth;
if
(isInScrollingContainer())
setMeasuredDimension(width, height);
else
setMeasuredDimension(Math.min(width, widthSize), Math.min(height, heightSize));
}
else
{
super
.onMeasure(widthMeasureSpec, heightMeasureSpec);
}
}
else
{
super
.onMeasure(widthMeasureSpec, heightMeasureSpec);
}
}
private
boolean
isInScrollingContainer() {
ViewParent p = getParent();
while
(p !=
null
&& p
instanceof
ViewGroup) {
if
(((ViewGroup) p).shouldDelayChildPressedState()) {
return
true
;
}
p = p.getParent();
}
return
false
;
}
}
|
The way these codes work is straightforward. It would calculate the height proportionally in case the width is fixed and vice versa inside onMeasure
. In case this AdjustableImageView
object is placed inside non-scrollable container, width and height would be limited to the space left in parent. Otherwise, it would be scaled up without any restriction.
To use it, simply change ImageView
tocom.inthecheesefactory.thecheeselibrary.widget.AdjustableImageView
in the layout xml.
1
2
3
4
5
|
<
com.inthecheesefactory.thecheeselibrary.widget.AdjustableImageView
android:layout_width
=
"match_parent"
android:layout_height
=
"wrap_content"
android:adjustViewBounds
=
"true"
android:src
=
"@mipmap/ic_launcher"
/>
|
And it is now done !
Make it easy with AdjustableImageView Library
We know that it is such a boring task creating a file, copy the code, paste it, reformat, check if everything is right, blah blah blah.
Your life is now 10 times easier with the library dependency we prepared for you. It is now live on jcenter. Once you add the dependency to your project, AdjustableImageView
and AdjustableImageButton
will be ready to make your day. Source codes of this library are hosted on GitHub. Please feel free to have a look.
Here is the gradle dependency. Just simply add this line to yourbuild.gradle
1
2
3
|
dependencies {
compile 'com.inthecheesefactory.thecheeselibrary:adjustable-imageview:1.0.0'
}
|
AdjustableImageView
and AdjustableImageButton
are now ready to use inside com.inthecheesefactory.thecheeselibrary.widget.*
package.
Simply replace ImageView and ImageButton with those classes provided by the library.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
<
LinearLayout
xmlns:android
=
"http://schemas.android.com/apk/res/android"
xmlns:tools
=
"http://schemas.android.com/tools"
android:layout_width
=
"match_parent"
android:layout_height
=
"match_parent"
android:orientation
=
"vertical"
tools:context
=
".MainActivity"
>
<
ScrollView
android:layout_width
=
"match_parent"
android:layout_height
=
"match_parent"
android:fillViewport
=
"true"
>
<
LinearLayout
android:layout_width
=
"match_parent"
android:layout_height
=
"match_parent"
android:orientation
=
"vertical"
>
<
com.inthecheesefactory.thecheeselibrary.widget.AdjustableImageView
android:layout_width
=
"match_parent"
android:layout_height
=
"wrap_content"
android:adjustViewBounds
=
"true"
android:src
=
"@mipmap/ic_launcher"
/>
<
com.inthecheesefactory.thecheeselibrary.widget.AdjustableImageView
android:layout_width
=
"match_parent"
android:layout_height
=
"wrap_content"
android:adjustViewBounds
=
"true"
android:src
=
"@mipmap/ic_launcher"
/>
</
LinearLayout
>
</
ScrollView
>
</
LinearLayout
>
|
As a result, ImageView is now scaled up perfectly no matter which Android version the application is running on.
This is a good example why we should install multiple SDK Platforms in the machine and not just the latest one. Since if you want to let Android Studio preview your layout with specific Android version, you need to install SDK Platform for that version or it wouldn't be listed as a choice in preview pane. Per my suggestion, you should install every single SDK Platform from API Level 14 on. Loss some disk space but what that you get back is worthy.
![]() | Author: nuuneoi (Android GDE, CTO & CEO at The Cheese Factory)
A full-stack developer with more than 6 years experience on Android Application Development and more than 12 years in Mobile Application Development industry. Also has skill in Infrastucture, Service Side, Design, UI&UX, Hardware, Optimization, Cooking, Photographing, Blogging, Training, Public Speaking and do love to share things to people in the world!
|