Một ảnh đại diện từ API có thể mất hiệu lực hoặc tải thất bại khi thiết bị đổi mạng. Nếu màn hình chỉ để vùng trắng, người dùng khó biết ảnh đang tải hay đã lỗi. Image có onError để bạn chuyển sang một fallback phù hợp với thiết kế.
Giữ trạng thái theo nguồn ảnh
Ví dụ dùng một component con cho mỗi URI bằng key. Khi URI đổi, component được tạo lại nên trạng thái lỗi của ảnh cũ không theo sang ảnh mới. Phần hiển thị luôn giữ vùng 72 nhân 72 để bố cục không nhảy khi chuyển fallback.
import React, {useState} from 'react';
import {Image, Text, View} from 'react-native';
function AvatarSource({uri}) {
const [failed, setFailed] = useState(false);
if (!uri || failed) {
return (
<View style={{width: 72, height: 72, justifyContent: 'center'}}>
<Text>Chưa có ảnh</Text>
</View>
);
}
return (
<Image
source={{uri}}
style={{width: 72, height: 72, borderRadius: 36}}
accessibilityLabel="Ảnh đại diện"
onError={() => setFailed(true)}
/>
);
}
export default function Avatar({uri}) {
return <AvatarSource key={uri || 'empty'} uri={uri} />;
}
Kiểm tra chuyển nguồn sau lỗi
Thử URI hợp lệ, URI thất bại có chủ đích trong môi trường test và giá trị rỗng. Sau khi fallback hiện, đổi sang URI hợp lệ khác và kiểm tra ảnh mới được tải. Nếu chỉ reset lỗi bằng effect ở cùng component, cần chú ý callback muộn từ request cũ. Thiết kế component theo key làm vòng đời theo nguồn rõ hơn trong ví dụ này.
Khi dùng trong danh sách, giữ key của hàng theo ID bản ghi. key bên trong Avatar dùng cho vòng đời nguồn ảnh, không thay thế khóa định danh của hàng. Kiểm tra trường hợp API cập nhật ảnh của đúng người dùng mà danh sách vẫn giữ các state khác.
Chọn trải nghiệm thử lại
Ví dụ chỉ báo thiếu ảnh. Nếu sản phẩm cần nút thử lại cho cùng URI, thêm thao tác tạo lượt tải mới theo thiết kế của app và giới hạn số lần thử tự động. Tránh gọi lặp vô hạn trong onError vì có thể tạo lưu lượng mà không giúp người dùng.
Lỗi tải ảnh có thể đến từ mạng, URL, quyền truy cập hoặc định dạng. Ghi thông tin chẩn đoán cần thiết nhưng tránh log URL có token. Fallback nên có nhãn phù hợp cho trình đọc màn hình và không lặp thông báo gây ồn.
Đoạn JSX đã được đối chiếu tài liệu Image, chưa chạy trên thiết bị trong lượt viết. Khi tích hợp, thử cả iOS và Android với cache, offline và cập nhật URI để xác nhận trạng thái lỗi được quản lý đúng.

