Handle avatar load errors with placeholder#387
Open
nOw-Ay wants to merge 1 commit intomatrix-org:mainfrom
Open
Handle avatar load errors with placeholder#387nOw-Ay wants to merge 1 commit intomatrix-org:mainfrom
nOw-Ay wants to merge 1 commit intomatrix-org:mainfrom
Conversation
Signed-off-by: nOw-Ay <noe@gabb.fr>
bugprone
reviewed
Jan 20, 2026
bugprone
left a comment
There was a problem hiding this comment.
Thanks for working on this! The graceful fallback approach is definitely the right direction.
I noticed a potential issue with the current implementation:
Concern: TemplateBuilder scope in onerror callback
onerror: function(event) {
const avatarContainer = event.target.parentNode;
if (avatarContainer) {
avatarContainer.replaceChild(
t.div({className: "defaultAvatar"}), // <- t captured via closure
event.target
);
}
}The t (TemplateBuilder) is captured via closure, but when onerror fires asynchronously, it's unclear if t.div() will behave correctly outside its original render context. Additionally, using replaceChild directly manipulates the DOM, which could conflict with TemplateView's binding system if avatarUrl ever changes.
Suggested alternative
A safer approach might be to hide the broken image and append a fallback, rather than replacing the node:
const avatar = t.map(vm => vm.avatarUrl, (avatarUrl, t) => {
if (avatarUrl) {
const img = t.img({className: "avatar", src: avatarUrl});
img.addEventListener('error', function() {
this.style.display = 'none';
if (!this.parentNode.querySelector('.defaultAvatar')) {
const fallback = document.createElement('div');
fallback.className = 'defaultAvatar';
this.parentNode.appendChild(fallback);
}
});
return img;
} else {
return t.div({className: "defaultAvatar"});
}
});This avoids:
- Relying on
tin async callback scope - Replacing nodes that TemplateView might track
- Potential issues if the binding re-evaluates
Have you tested the current implementation with the actual authenticated media scenario? Curious if it works as expected.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR updates matrix.to to use the default avatar placeholder when media authentication is not supported.
Currently, matrix.to attempts to load user avatars from authenticated media endpoints it cannot access. As a result, it displays broken or unreachable images, which negatively affects the user experience (see #351)
Changes:
onerrorhandler to the avatar image inLoadedPreviewView(src/preview/PreviewView.js) so that if the image fails to load, it is replaced with a default avatar element.This ensures the UI remains clean and consistent, even when avatar images are unavailable.