В обычной галерее храните изображение, подпись и порядок в одной записи. Не собирайте сетку из отдельного массива фото и отдельного массива текстов по одинаковому индексу. При удалении одного файла индексы могут разойтись. Начните с трёх условных работ, у каждой собственный ID и подпись, и переставьте одну из них.

Для портфолио без последовательного просмотра достаточно сетки с подписями. Карусель добавляет состояние текущего слайда, управление и отдельную проверку клавиатуры. Если эти функции не решают задачу посетителя, их можно не вводить. Здесь контроль касается связи изображения с пояснением, а не открытия увеличенного окна.

Запись фотографии должна пережить перестановку

ПолеЗачем оно нужно
ID работыустойчивая связь при изменении порядка
Адрес фотоконкретный доступный ресурс
Подписьназвание или контекст работы
Альтернативный текстсмысл изображения для нужного контекста
Позицияявный порядок, а не случайная выдача

Сортировка по имени файла не заменяет редакционный порядок. work-10 может оказаться рядом с work-1 по неожиданному правилу, а переименование изменит выдачу. Задайте собственную позицию и дополнительный стабильный критерий для одинаковых позиций. При параллельном редактировании сравнивайте версию набора перед сохранением, чтобы один редактор не затёр перестановку другого.

Фото и подпись образуют один блок

<!-- Условная работа; файл должен существовать -->
<figure class="portfolio-item">
  <img src="/media/example-work.jpg"
       alt="Деревянная лестница с поворотом у окна"
       width="1200" height="800">
  <figcaption>Лестница в частном доме</figcaption>
</figure>

figure объединяет самостоятельное содержимое и необязательную подпись figcaption; MDN описывает их как одну единицу. Альтернативный текст и подпись решают разные задачи. Подпись может назвать проект, а alt — передать значимые детали изображения. Не копируйте длинное описание дважды автоматически и не заполняйте alt набором поисковых ключей.

Для декоративных изображений подход к alt отличается; выбор определяется ролью картинки на странице. Если фотография является ссылкой, посетителю должно быть понятно назначение перехода. При необходимости видимый текст ссылки объясняет действие лучше, чем скрытый список слов. Проверьте смысл блока без изображения и без цвета — связь с работой должна сохраняться.

Порядок на экране совпадает с порядком чтения

Не используйте визуальную перестановку CSS как единственный способ поменять редакционный порядок. Чтение и клавиатурные переходы следуют структуре документа, и такая сетка может выглядеть логично только мышью. Отсортируйте записи до вывода HTML. Колонки могут менять расположение, но соседство фото и подписи остаётся внутри собственного блока.

  • Удалить среднюю работу в тестовом наборе.
  • Поменять местами первую и последнюю.
  • Добавить работу с длинной подписью.
  • Заменить фото, сохранив ID работы.
  • Открыть сетку на узком экране и без загрузки одного файла.

Краткое имя файла не подтверждает, что подпись соответствует содержимому. При замене фото редактор должен просмотреть связанный текст. Сохраняйте исходный файл и прежние метаданные до приёмки новой версии. Если фото недоступно, подпись всё ещё должна относиться к той же записи, а не переезжать к следующему успешно загруженному изображению.

Приёмка проверяет каждую пару

Сверьте список ID и порядок с опубликованной страницей, затем посмотрите каждую пару «фото — подпись». Отдельно проверьте фактические размеры изображений и доступность файлов. Количество карточек не является доказательством правильных связей: сетка из пяти блоков способна содержать пять ошибочных подписей.

Для разработки галереи подготовьте небольшую таблицу работ с ID, адресами, подписями и нужным порядком. Условные данные держите на стенде. По такой таблице можно построить простую сетку и контроль перестановки; усложнять её до карусели или lightbox стоит только после появления конкретного сценария просмотра.

Проверенные источники