basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Проверяем подачу до публикации: шесть проверок в браузере

    Шесть проверок занимают минут десять и ловят большую часть того, что портит страницу: план по заголовкам, пятна при размытии, телефон на 360 px, тёмная тема и масштаб 200%, контраст и тест пяти секунд. Всё делается в DevTools Chrome или Edge, без расширений.

    1. Читаем одни заголовки и первые фразы

      В консоли DevTools (F12, вкладка Console) — план страницы по заголовкам:

      [...document.querySelectorAll('main h1, main h2, main h3')]
        .map((h) => (h.tagName === 'H3' ? '    ' : '') + h.textContent.trim())
        .join('\n')

      Должен получиться план, по которому понятно, что где лежит. «Описание, Установка, Прочее» — заголовки переписываем («Заголовок говорит, что внутри»). Первые фразы абзацев:

      [...document.querySelectorAll('main p')]
        .map((p) => p.textContent.trim().split(/(?<=[.!?])\s/)[0])
        .join('\n\n')

      Если по первым фразам пересказывается суть — ответы стоят в начале. Если там вступления и связки вместо дела — ответы спрятаны глубже («Ответ первым»).

    2. Размываем страницу

      document.body.style.filter = 'blur(3px)'

      Текст не читается, остаются пятна. Хорошо, если видно три уровня: крупные заголовки, серое поле текста, мелкие подписи («Три уровня важности»). Плохо, если первым бросается в глаза баннер, плашка или значок, а не главное. Видно и выравнивание: края блоков, которые должны стоять на одной линии, и разные отступы у одинаковых блоков. Возвращаем как было — document.body.style.filter = ''.

    3. Смотрим на ширине 360 px

      Ctrl + Shift + M — режим устройства, ширина 360, высота 800. Смотрим:

      • абзац не длиннее экрана, заголовок не рвётся по слову в строке;
      • таблица прокручивается внутри себя или помещается;
      • поля у края — от 16 px, ничего не прилипает к краю.

      Ездит ли страница вбок, покажет консоль: document.documentElement.scrollWidth - innerWidth. Ноль или меньше — не ездит: innerWidth считает и полосу прокрутки, поэтому на компьютере выходит, например, -15. Больше нуля — ищем, кто шире экрана:

      [...document.querySelectorAll('body *')]
        .filter((el) => el.getBoundingClientRect().right > innerWidth + 1)
        .map((el) => el.tagName + '.' + el.className)

      В список попадут и строки внутри блоков кода и таблиц со своей прокруткой — их пропускаем, ищем блок верхнего уровня.

    4. Включаем тёмную тему и масштаб 200%

      Ctrl + Shift + P, команда Show Rendering; в открывшейся панели Emulate CSS media feature prefers-color-scheme ставим dark. Смотрим картинки, схемы и тени: белые прямоугольники и пропавшие рамки видно сразу.

      Возвращаем light, выключаем режим устройства и увеличиваем до 200% (Ctrl + + пять раз от 100%). Текст переносится, не обрезан, страница не прокручивается вбок — WCAG 1.4.4 и 1.4.10 выполнены.

    5. Проверяем контраст

      Вкладка Lighthouse в DevTools, в категориях оставляем только Accessibility, жмём Analyze page load. В отчёте пункт Background and foreground colors do not have a sufficient contrast ratio перечисляет элементы ниже порога. Пункта нет — контраст текста проходит 4,5:1 и 3:1 для крупного. Отдельный элемент — пипеткой в «Стилях», строка Contrast ratio («Контраст текста»).

      Отчёт смотрит страницу в одной теме; в другой проверяем пипеткой основной текст и подписи.

    6. Показываем первый экран на пять секунд

      Показываем человеку, который страницу не видел, первый экран на 5 с и закрываем. Спрашиваем: о чём страница и что на ней можно сделать. Ответил своими словами то, что мы хотели сказать, — первый экран работает («Один экран — один смысл»). Назвал баннер, картинку или «что-то про настройки» — главное на первом экране не главное на вид.

      Нет человека рядом — тот же вопрос себе через день: за день текст забывается достаточно, чтобы увидеть его со стороны.

    Как проверить

    Проверка проверок — та же страница через неделю: вопросы, которые о ней задали, должны отвечаться заголовками из шага 1. Вопрос, ответ на который есть, но его не нашли, — первый кандидат на правку («Сканируемый текст»).

    Если не работает

    Заголовков в списке из консоли нет, хотя на странице они видны

    Причина
    Заголовки свёрстаны как div с крупным шрифтом. Глаз их видит, а поиск, экранный диктор и оглавление — нет.
    Делаем
    Заголовкам — теги h2 и h3; размер задаём стилями, а не выбором тега.

    На телефоне страница ездит вбок

    Причина
    Что-то шире экрана: таблица, блок кода без прокрутки, картинка с width в пикселях.
    Делаем
    Ищем виновника в консоли (шаг 3); у таблиц и кода — своя прокрутка overflow-x: auto, у картинок — max-width: 100%.

    В тёмной теме часть картинок — белые прямоугольники

    Причина
    Схемы и скриншоты с белым фоном, сохранённые под светлую тему.
    Делаем
    Схемы — SVG с цветами из переменных темы или прозрачным фоном; скриншоты — в рамке, чтобы белое поле читалось как картинка.