미디어 라이브러리에서 이미지 대체텍스트를 고쳤는데 예전 글의 설명은 그대로일 수 있습니다. 같은 이미지 파일을 사용해도 본문에 저장된 alt와 첨부파일의 기본 alt는 서로 다른 위치에 있습니다. 이미지 파일을 다시 올리기 전에 어떤 값이 현재 페이지에 출력되는지 구분해야 합니다.
미디어의 기본값과 본문의 값을 나눕니다
WordPress 공식 이미지 블록 안내는 미디어 라이브러리의 대체텍스트가 다른 위치에 이미지를 넣을 때 기본값으로 사용된다고 설명합니다. 반면 블록 설정에서 편집한 값은 그 글이나 페이지의 해당 이미지에 적용됩니다. 따라서 라이브러리에서 한 번 바꾸면 모든 기존 본문까지 자동으로 교체된다고 가정해서는 안 됩니다.
WordPress 렌더링에서 확인한 범위
비민감 시험 이미지를 사용해 첨부파일의 기본 alt를 바꾼 뒤 두 경로를 비교했습니다. 하나는 이전 alt가 들어 있는 이미지 블록 문자열을 do_blocks로 렌더링한 결과이고, 다른 하나는 wp_get_attachment_image로 첨부파일 이미지를 새로 만든 결과입니다. 사이트의 WordPress 7.1 서버에서 이 두 출력의 alt를 읽어 확인했습니다. 블록 편집기의 모든 저장 조합을 시험한 것은 아닙니다.
| 출력 경로 | 확인한 alt | 이유 |
|---|---|---|
| 기존 블록 문자열 | 저장된 본문 설명 A | 본문 HTML 속성 유지 |
| 첨부파일로 새 이미지 출력 | 미디어 기본 설명 B | 현재 첨부파일 기본값 사용 |
이 결과는 오래된 본문이 반드시 캐시 때문에 남는 것은 아니라는 점을 보여줍니다. 본문에 저장된 alt 자체가 A이면 캐시를 지워도 A가 다시 만들어질 수 있습니다. 동적 테마·플러그인이 매번 첨부파일 메타를 읽는 경우에는 또 다른 결과가 나올 수 있어 실제 렌더링 경로를 확인해야 합니다.
실제 글을 수정하는 순서
- 문제가 보이는 공개 글 주소와 이미지 위치를 기록합니다.
- 글 편집기에서 그 이미지 블록을 선택하고 대체텍스트 값을 확인합니다.
- 그 글에서 이미지가 전달하는 의미에 맞게 수정한 뒤 저장합니다.
- 공개 글을 다시 열어 최종 HTML의 alt를 확인합니다.
- 다른 글에서도 같은 이미지를 썼다면 그 위치의 문맥에 맞는지 별도로 확인합니다.
미디어 라이브러리의 기본값을 수정하는 작업도 필요할 수 있습니다. 다만 기본값은 이후 삽입할 때 편리하게 쓰는 출발점이고, 이미 쓰인 모든 문맥에서 가장 좋은 설명이라는 뜻은 아닙니다. 같은 화면 캡처라도 한 글에서는 권한 스위치를, 다른 글에서는 오류 문구를 설명할 수 있습니다.
좋은 설명은 파일명이 아니라 목적을 말합니다
| 상황 | 부족한 설명 | 개선 방향 |
|---|---|---|
| 권한 설정 설명 | image-01.png | 어떤 앱의 어떤 권한 상태인지 |
| 변경 전후 비교 | 스크린샷 | 무엇이 전후에 달라졌는지 |
| 장식 이미지 | 키워드 나열 | 의미가 없는 장식인지 판단 |
이미지에 있는 긴 표나 모든 문장을 alt에 한꺼번에 넣으면 읽는 부담이 커집니다. 핵심 의미는 간결하게 설명하고 자세한 수치와 절차는 본문에서 제공하십시오. 장식용 이미지는 빈 alt가 적절할 수 있으며, 모든 이미지에 검색어를 채우는 방식이 접근성 개선은 아닙니다.
대표 이미지와 본문 이미지를 혼동하지 않습니다
대표 이미지는 테마가 첨부파일 정보로 출력할 수 있고 본문 이미지는 저장된 블록 HTML에서 나올 수 있습니다. 대표 이미지만 설명이 바뀌었다면 두 경로가 다르다는 신호일 수 있습니다. 어느 하나의 화면만 보고 전체 변경이 완료됐다고 판단하지 않습니다. 이미지 파일 자체를 지우거나 교체하면 다른 글까지 영향을 줄 수 있으므로 설명 수정과 파일 교체를 분리합니다.
변경 뒤 확인할 것
공개 응답에 올바른 alt가 있는지 확인한 다음에만 캐시와 브라우저 표시 차이를 살핍니다. 저장된 본문 값이 맞고 서버 응답도 맞는데 특정 방문자에게 예전 값이 남으면 그때 캐시 경로를 점검합니다. 이 실험의 요지는 미디어 기본값, 본문 저장값, 실제 공개 출력이라는 세 지점을 나누는 것입니다.
본문 위치 링크도 비슷하게 최종 출력의 속성을 확인해야 합니다. ID와 링크가 일치하는지 확인하는 실험에서 저장 화면과 공개 결과가 달라 보일 때 점검하는 방법을 이어서 볼 수 있습니다.