Trước đây khi sử dụng ImageView để hiển thị hình ảnh thì nó đơn giản chỉ hiển thị với hình chữ nhật. Để hiển thị hình dạng khác mà không tốn thời gian ta thường nhờ đến sự cứu cánh của các thư viện, điển hình như CircleImageView của hdodenhof.
Và rồi cuối cùng thì Android cũng đã giới thiệu ShapeableImageView trong Material Design
ShapeableImageView
ShapeableImageView
kế thừa từ AppCompatImageView
, nghĩa là nó có tất cả các function được cung cấp như trong AppCompatImageView
XML Attributes mới
- strokeColor: màu đường viền của ImageView
- strokeWidth: độ rộng đường viền của ImageView
- cornerFamily: xác định corner của hình với giá trị là cut hoặc rounded tương ứng với loại cắt góc hay bo góc
- cornerSize: xác định kích thước của corner, có thể sử dụng bằng giá trị phần trăm hoặc dp
Sử dụng
Thêm marerial design vào Gradle
implementation ‘com.google.android.material:material:1.2.0’
Circle ImageView
Circle ImageView thường được sử dụng nhiều cho avatar của user.
Đầu tiên, ta tạo style.
<style name="circle">
<item name="cornerSize">50%</item>
</style>
Như ở trên, ta không thêm attribute cornerFamily vì giá trị mặc định của nó chính là rounded.
Sau đó gán style vào attribute app:shapeApperanceOverlay
ở trong file layout
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/circle"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:scaleType="centerCrop"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:shapeAppearanceOverlay="@style/circle"
app:srcCompat="@drawable/doge" />
Circle ImageView Border
Ta dùng style như Circle Image trên và thêm thuộc tính strokeColor và strokeWidth để thêm border.
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/circle_border"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:padding="5dp"
android:scaleType="centerCrop"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:shapeAppearanceOverlay="@style/circle"
app:srcCompat="@drawable/doge"
app:strokeColor="@color/black"
app:strokeWidth="5dp" />
Rounded Corner Image
Với loại hình bo góc ta cũng có thể thực hiện bằng cách lồng ImageView vào CardView vì CardView có hỗ trợ bo góc, tuy nhiên nó có thể làm giảm hiệu suất khi render layout. Vì vậy dùng ShapeableImageView thay thế là cách tốt hơn
Thêm style
<style name="rounded_corner">
<item name="cornerSize">20dp</item>
</style>
Sử dụng style trong layout
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/rounded_corner"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:scaleType="centerCrop"
app:layout_constraintStart_toStartOf="parent"
app:shapeAppearanceOverlay="@style/rounded_corner"
app:srcCompat="@drawable/doge" />
Rounded Corner Image Border
Tương tự, ta thêm thuộc tính strokeWidth và strokeColor
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/rounded_corner_with_border"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:padding="5dp"
android:scaleType="centerCrop"
app:layout_constraintEnd_toEndOf="parent"
app:shapeAppearanceOverlay="@style/rounded_corner"
app:srcCompat="@drawable/doge"
app:strokeColor="@color/black"
app:strokeWidth="5dp" />
Cut Corner Image
Đến đây thì ta phải thêm attribute cornerFamily
với giá trị là cut
Tạo style
<style name="cut_corner">
<item name="cornerSize">20dp</item>
<item name="cornerFamily">cut</item>
</style>
Thêm vào layout
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/cut_corner"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:scaleType="centerCrop"
app:layout_constraintStart_toStartOf="parent"
app:shapeAppearanceOverlay="@style/cut_corner"
app:srcCompat="@drawable/doge" />
Cut Corner Image Border
Tương tự
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/cut_corner_border"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:padding="5dp"
android:scaleType="centerCrop"
app:layout_constraintEnd_toEndOf="parent"
app:shapeAppearanceOverlay="@style/cut_corner"
app:srcCompat="@drawable/doge"
app:strokeColor="@color/black"
app:strokeWidth="5dp" />
Specific Rounded Corner
Thêm style
<style name="specific_rounded_corner">
<item name="cornerSizeTopLeft">50dp</item>
<item name="cornerSizeBottomRight">50dp</item>
<item name="cornerFamilyTopLeft">rounded</item>
<item name="cornerFamilyBottomRight">rounded</item>
</style>
Thêm vào layout
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/specific_rounded_corner"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:scaleType="centerCrop"
app:layout_constraintStart_toStartOf="parent"
app:shapeAppearanceOverlay="@style/specific_rounded_corner"
app:srcCompat="@drawable/doge" />
Specific Rounded Corner Border
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/specific_rounded_border_corner"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:padding="5dp"
android:scaleType="centerCrop"
app:layout_constraintEnd_toEndOf="parent"
app:shapeAppearanceOverlay="@style/specific_rounded_corner"
app:srcCompat="@drawable/doge"
app:strokeColor="@color/black"
app:strokeWidth="5dp" />
Specific Cut Corner
Thêm style
<style name="specific_cut_corner">
<item name="cornerSizeTopLeft">50dp</item>
<item name="cornerSizeBottomRight">50dp</item>
<item name="cornerFamilyTopLeft">cut</item>
<item name="cornerFamilyBottomRight">cut</item>
</style>
Thêm vào layout
<com.gogle.android.material.imageview.ShapeableImageView
android:id="@+id/specific_cut_corner"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:scaleType="centerCrop"
app:shapeAppearanceOverlay="@style/specific_cut_corner"
app:srcCompat="@drawable/doge" />
Specific Cut Corner Border
Tương tự
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/specific_cut_border_corner"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:padding="5dp"
android:scaleType="centerCrop"
app:layout_constraintEnd_toEndOf="parent"
app:shapeAppearanceOverlay="@style/specific_cut_corner"
app:srcCompat="@drawable/doge"
app:strokeColor="@color/black"
app:strokeWidth="5dp" />
ImageView Rounded and Cut Corners
Một số design sẽ có cả sự kết hợp giữa bo góc và căn góc.
Thêm style
<style name="specific_mix_corner">
<item name="cornerSize">50dp</item>
<item name="cornerFamilyTopLeft">cut</item>
<item name="cornerFamilyBottomRight">cut</item>
<item name="cornerFamilyBottomLeft">rounded</item>
<item name="cornerFamilyTopRight">rounded</item>
</style>
Thêm vào layout
<com.google.android.material.imageview.ShapeableImageView
android:id="@+id/specific_mix_corner"
android:layout_width="100dp"
android:layout_height="100dp"
android:layout_margin="10dp"
android:scaleType="centerCrop"
app:shapeAppearanceOverlay="@style/specific_mix_corner"
app:srcCompat="@drawable/doge" />
Programmatically với Kotlin
Nếu muốn set qua code thì ShapeableImageView
cung cấp một số hàm mà ta có thể sử dụng.
Ví dụ ta muốn set Top Right Corner bo góc với size là 14dp:
topCornerImage.setShapeAppearanceModel(topCornerImage.getShapeAppearanceModel()
.toBuilder()
.setTopRightCorner(CornerFamily.ROUNDED,14dp)
.build());
Nguồn tham khảo
https://amahmoud91.medium.com/deep-dive-into-shapeableimageview-in-android-1ba7f9a5969e