Работа с codepen

CodePen.io — это мощная облачная среда разработки и социальная платформа для фронтенд-разработчиков, которая работает полностью в браузере. Она позволяет писать, тестировать и демонстрировать код без необходимости устанавливать локальное окружение. Главная особенность сервиса — мгновенный визуальный отклик: результат написания HTML, CSS и JavaScript отображается в окне предпросмотра в реальном времени.

1. Как начать работать в codepen.io?

Для работы в CodePen нужен аккаунт: он позволяет сохранять проекты, чтобы они не пропадали после закрытия вкладки.
  1. Регистрация: на главной странице codepen.io нажать "Sign Up" и зарегистрироваться через e-mail либо через аккаунт GitHub, Google или Apple.
  2. Создание проекта: нажать кнопку "New Pen". Откроется редактор. Один проект в CodePen называется pen.
  3. Верхняя панель редактора: справа находятся три кнопки — сердечко (поставить проекту "лайк"), "Save" (сохранить проект) и "Controls" (меню управления редактором).
Меню "Controls"
  • Pen Settings — окно настроек. Настройки проекта: "Pen Details" (описание проекта), "Behavior & Processing" (поведение и обработка кода), "Code Indentation" (отступы), "Template". Настройки редактора: "Theme & Fonts" (тема и шрифты), "Features", "Layout" (расположение) и "Snippets" (сокращения для быстрого набора кода, см. вопрос 7).
  • Template — переключатель, который превращает проект в шаблон для создания новых проектов.
  • Editor Layout — расположение панелей. Верхний ряд: "Split" (редакторы и предпросмотр вместе), "Editors" (только редакторы), "Preview" (только результат). Нижний ряд: "Left", "Top", "Right" — положение редакторов и предпросмотра друг относительно друга. Границы между областями можно перетаскивать мышью.
  • Minimal UI — упрощённый интерфейс: скрывает боковую панель и нижнюю строку, оставляя больше места для кода.
  • Change Theme & Fonts — смена темы оформления и шрифта редактора.
  • Open Live Preview — открытие результата в отдельной вкладке. Функция помечена значком PRO и доступна только на платном тарифе.
  • Fork — создать собственную копию проекта, чтобы редактировать её независимо от оригинала.
  • Keyboard Shortcuts — список горячих клавиш.
  • Feedback — отправка отзыва разработчикам CodePen.
  • Delete — удаление проекта.
Боковая панель
Слева в редакторе находится узкая панель с иконками. Каждая иконка открывает отдельный раздел; открытым может быть только один раздел, но можно закрыть и все. Скрыть или показать боковую панель целиком можно сочетанием `Ctrl + U`.
  • Files — файловый менеджер проекта. Здесь отображаются файлы (по умолчанию `index.html`, `style.css` и `script.js`). Есть поиск по файлам, кнопка "Upload" для загрузки файла со своего компьютера и кнопки создания нового файла и папки. Счётчик "3/3 Files" показывает, сколько файлов уже создано и сколько разрешено тарифом: на бесплатном тарифе три файла, и все они заняты стандартными.
  • Blocks (иконка со слоями) — блоки: технологии, которые подключаются к проекту (препроцессоры, форматирование и т.д.), см. вопрос 5. Кнопка "Add Blocks" также есть внизу панели.
  • AI (иконка робота) — чат с ИИ-помощником: в поле внизу панели можно задать вопрос о своём проекте.
  • History (иконка часов) — история версий: каждое сохранение проекта запоминается, и к предыдущему состоянию можно вернуться.
  • Privacy & Collaboration (иконка человека с плюсом) — приватность проекта и приглашение других пользователей к совместной работе.
  • Details & Comments (иконка диалога) — описание проекта, теги и комментарии других пользователей.
  • Settings (шестерёнка внизу) — то же окно настроек, что и "Pen Settings" в меню "Controls".
Если описание в интернете или в видеоуроках не совпадает с тем, что вы видите на экране, возможно, там показан старый вариант редактора. Он по-прежнему доступен по адресу codepen.io/pen.

2. Как посмотреть ошибки кода?

Если в окне предпросмотра пусто или результат отличается от ожидаемого, причину нужно искать в консоли. Для этого есть два способа.
  1. Встроенная консоль CodePen. Консоль открывается в области предпросмотра: она делит область с результатом пополам, а размер можно менять, перетаскивая границу. В неё попадают сообщения от `console.log()`, `console.warn()` и `console.error()`, а также ошибки выполнения JavaScript с текстом и номером строки, например `Uncaught ReferenceError: x is not defined`. В консоли можно и вводить команды, они будут выполняться внутри проекта. Если не видите кнопку "Console", отключите "Minimal UI" в меню "Controls": в этом режиме нижняя строка скрыта.
  2. Инструменты разработчика браузера. Для более сложной отладки нажмите `F12` и используйте вкладки DevTools: "Console" (ошибки), "Elements" (проверка вёрстки и стилей), "Network" (не загрузились ли внешние файлы), "Sources" (точки останова). Результат проекта показывается внутри страницы редактора, поэтому его ошибки тоже появляются в консоли браузера.
Новый редактор перед показом результата выполняет сборку проекта (обрабатывает код блоками, см. вопрос 5), поэтому ошибки в таком коде (например, в Sass или TypeScript) могут возникнуть ещё на этапе сборки, до запуска. Типичные ситуации:
  • `Failed to load resource: 404` — неверная ссылка на внешний файл. Для файлов с GitHub проверьте, что используется raw-ссылка (см. вопрос 4).
  • `Uncaught SyntaxError` — опечатка в коде: незакрытая скобка, кавычка или запятая. В сообщении указана строка, на которой браузер обнаружил проблему.
  • `Cannot read properties of null` — скрипт обращается к элементу, которого нет на странице (опечатка в id или класс не совпадает).
  • `Mixed Content` — на странице с HTTPS подключается ресурс по HTTP. Ссылку нужно заменить на HTTPS-версию.

3. Как сохранить готовый проект на локальный компьютер?

В CodePen проект можно выгрузить в виде архива, который затем открывается без интернета (но если в проекте есть внешние файлы по ссылкам, как в вопросе 4, для их загрузки интернет всё равно понадобится).
  1. В правом верхнем углу редактора открыть меню кнопки "Share".
  2. Выбрать "Export .zip" — браузер скачает архив с проектом.
  3. Распаковать архив в любую папку.
  4. Открыть файл `index.html` двойным щелчком — проект запустится в браузере.
Для дальнейшей работы архив можно открыть в любом редакторе кода (например, VS Code) и загрузить на GitHub или на обычный хостинг.

4. Как использовать сторонние файлы?

У бесплатного тарифа есть существенное ограничение: нет встроенной загрузки файлов в проект.
Это ограничение касается:
  • изображений (спрайт-листы, иконки, текстуры, фоны)
  • шрифтов (`@font-face`)
  • аудиофайлов (`
  • JSON-файлов с данными (конфигурации, texture-атласы, локализация)
  • видео.
Решение одно и то же для всех этих случаев: файл нужно разместить во внешнем хранилище и подключать в проекте не как локальный путь, а как обычный URL — через url() в CSS или src в JS. Существует несколько способов получить такой URL.

Способ 1: GitHub + raw-ссылка Самый надёжный и рекомендуемый способ для учебных и pet-проектов — разместить файл в репозитории на GitHub и получить прямую ссылку на его содержимое.
  1. Создать репозиторий на GitHub.
  2. Загрузить файл: Add file → Upload files.
  3. Открыть загруженный файл в интерфейсе репозитория, нажать по файлу правой кнопкой мыши и выбрать "Открыть картинку в новой вкладке" (для картинок) или нажать на кнопку "Raw" (для файлов других форматов).
  4. Скопировать URL из адресной строки:
    https://raw.githubusercontent.com/username/repo-name/main/filename
  5. Использовать в JS:
    const spriteSheet = new Image(); 
    spriteSheet.src = 'https://raw.githubusercontent.com/username/repo-name/main/filename';
Важно не перепутать эту ссылку с обычной ссылкой на страницу файла в интерфейсе GitHub — вида github.com/username/repo/blob/main/filename. Это HTML-страница с превью файла внутри интерфейса GitHub, а не сам файл — браузер не сможет загрузить её как изображение, шрифт или аудио. Работает только адрес через домен raw.githubusercontent.com.
Тот же способ для файлов, отличных от изображений
Принцип одинаков для любого типа файла — меняется лишь то, куда подставляется ссылка:
// шрифт 
const font = new FontFace('MyFont', 'url(https://raw.githubusercontent.com/username/repo-name/main/font.woff2)'); 
font.load().then(loadedFont => document.fonts.add(loadedFont));
 
// JSON с данными
fetch('https://raw.githubusercontent.com/username/repo-name/main/atlas.json')
.then(response => response.json())
.then(atlas => console.log(atlas));
 
// аудио
const sound = new Audio('https://raw.githubusercontent.com/username/repo-name/main/jump.mp3');
Частая практическая проблема: если обновить файл на GitHub под тем же именем, браузер может продолжать показывать закэшированную старую версию. Решение — добавить в конец ссылки произвольный параметр, который заставит браузер считать это новым запросом:
spriteSheet.src = 'https://raw.githubusercontent.com/username/repo-name/main/filename?v=2'; 

Способ 2: Сторонние хостинги изображений
  • imgur.com, postimages.org — загрузить картинку, скопировать прямую ссылку, заканчивающуюся расширением файла.
Плюс — не нужен GitHub-аккаунт, быстро для разовой демонстрации. Минус — менее надёжно для долгосрочных проектов, некоторые сервисы удаляют неактивные файлы.
Стоит отметить: такие сервисы, как правило, предназначены именно для изображений. Для шрифтов, JSON и аудио они обычно не подходят — там уместнее способ 1 (GitHub) или специализированные хостинги под конкретный тип файла.

Способ 3: jsDelivr CDN поверх GitHub Тот же файл на GitHub можно раздавать через бесплатный CDN — быстрее и стабильнее прямой raw-ссылки:
spriteSheet.src = 'https://cdn.jsdelivr.net/gh/username/repo-name@main/filename';
Разница с прямой raw-ссылкой (способ 1) в том, что jsDelivr кэширует файлы на серверах по всему миру, поэтому загрузка происходит быстрее — особенно если проект открывают пользователи из разных стран. Для учебного проекта, который смотрит только сам студент и преподаватель, разница незаметна, но для чего-то более публичного (например, демо, которое планируется показывать широкой аудитории) стоит использовать именно этот вариант.
Способ работает для любых файлов, лежащих в репозитории — не только изображений.

Способ 4: Base64 Для очень маленьких файлов можно закодировать содержимое в строку Base64 (например, через base64-image.de для изображений или аналогичные сервисы для других форматов) и вставить прямо в код — без каких-либо внешних ссылок и хостинга:
spriteSheet.src = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...';
Но данный подход сильно раздувает исходник, и неприменим для больших файлов вроде полноразмерных спрайт-листов, аудиодорожек или шрифтов с большим набором символов.

5. Как подключить библиотеку, фреймворк или препроцессор?

В новом редакторе нет отдельных полей для внешних скриптов в настройках. Вместо этого есть три способа.

Способ 1: npm-пакет через import
Самый простой способ — подключить пакет прямо в JS-файле. CodePen сам заметит строку с import, создаст файл package.json со списком пакетов и подключит их через CDN esm.sh. Устанавливать ничего не нужно.
import { v4 } from "uuid";
console.log(v4());
Файл package.json появится в панели "Files", и его можно редактировать — например, чтобы закрепить конкретную версию пакета. Если нужна ссылка вручную, то же самое работает и с полным адресом:
import confetti from "https://esm.sh/canvas-confetti";
confetti();

Способ 2: ссылка на CDN в HTML
Библиотеку можно подключить обычным тегом в файле index.html, как на любом сайте:
<script src="https://cdn.jsdelivr.net/npm/gsap@3.12.5/dist/gsap.min.js"></script>
Тег нужно разместить раньше, чем ваш скрипт, который эту библиотеку использует. Ссылки на библиотеки удобно искать на сайтах cdnjs.com и jsdelivr.com. Версию лучше указывать явно (как @3.12.5 в примере), чтобы проект не сломался после выхода новой версии. Стили подключаются аналогично, тегом `<link rel="stylesheet" href="...">`.

Способ 3: блоки (Blocks)
Блоки — это технологии, которые CodePen добавляет в сборку проекта: препроцессоры (Sass), языки (TypeScript, JSX, Markdown), инструменты (Tailwind, Prettier) и так далее. Добавить блок можно кнопкой "Add Blocks" или на панели "Blocks" в боковой панели. Часто блоки подключаются автоматически по расширению файла: создав файл style.scss, script.ts, app.jsx или notes.md, вы получите нужную обработку без дополнительных настроек.

6. Как поделиться проектом?

Все действия находятся в меню кнопки "Share":
  • Copy URL — копирует ссылку на проект. Любой, у кого она есть, сможет посмотреть код и результат.
  • Copy Link with Layout — копирует ссылку, которая сохраняет текущее расположение панелей. Например, если включить режим "Preview", получатель увидит только результат — это аналог прежнего режима "Full Page".
  • Add to Collection и Add to Bookmarks — добавить проект в подборку или в закладки. "Show Bookmarks" показывает список закладок.
  • Embed — получить готовый HTML-код, который вставляется на ваш сайт, и проект отображается прямо на странице.
  • Export .zip — скачать проект архивом (см. вопрос 3).
  • Add Collaborators — пригласить других пользователей редактировать проект вместе с вами. Функция помечена значком PRO.
Чтобы ссылка сразу открывала панель с описанием и комментариями, добавьте к адресу проекта параметр `?panel=details`.
Приватность проекта и приглашения к совместной работе настраиваются в боковой панели "Privacy & Collaboration", при этом доступные возможности зависят от тарифа. Если проект публичный, его может увидеть любой, поэтому не размещайте в нём пароли, ключи API и другие личные данные.

7. Как ускорить работу в редакторе?

  • Emmet — сокращённая запись HTML и CSS: нужно набрать сокращение и нажать `Tab`. Например, `ul>li*3` превратится в список из трёх пунктов, а `div.card` — в `<div class="card"></div>`. Emmet включается и выключается в "Settings" → "Snippets" (переключатель "On/Off"). Там же можно добавить собственные сокращения: в левое поле вписывается короткое слово, в правое — код, в который оно должно раскрываться. Например, сокращение `bgred` может раскрываться в `background: red;`. Для HTML и CSS сокращения вводятся отдельно.
  • Настройки редактора находятся в "Settings" → "Editor Settings": "Theme & Fonts" (тема и шрифты), "Features" (дополнительные функции редактора), "Layout" (расположение панелей) и "Snippets" (сокращения). Отступы в коде настраиваются в "Pen Settings" → "Code Indentation".
  • Горячие клавиши. Полный список открывается через "Controls" → "Keyboard Shortcuts". Сочетание `Ctrl + U` скрывает и показывает боковую панель. Также в редакторе есть быстрый поиск по файлам, настройкам и командам, открывающийся горячей клавишей (её можно найти в том же списке).
  • Несколько файлов в одном окне. Любой файл можно открыть как вкладку редактора. Вкладки можно перетаскивать, объединяя несколько файлов в одну область редактирования.
  • Автоформатирование. Чтобы код выравнивался автоматически при сохранении, подключите блок Prettier (см. вопрос 5).
  • История версий. Каждое сохранение запоминается, поэтому ошибку можно откатить через панель History.

8. Какие ограничения у бесплатного тарифа и какие бывают проблемы?

Ограничения бесплатного тарифа:
  • количество файлов в проекте ограничено тарифом. На бесплатном тарифе это три файла (`index.html`, `style.css`, `script.js`), поэтому добавить в проект дополнительные файлы (изображения, шрифты, JSON) нельзя — используйте внешние ссылки (вопрос 4);
  • функции с пометкой PRO недоступны: например, "Open Live Preview" (результат в отдельной вкладке) и "Add Collaborators" (приглашение соавторов);
  • возможности приватности проекта зависят от тарифа;
  • для сложных проектов из многих файлов можно использовать другие онлайн-среды, например CodeSandbox или StackBlitz.
Частые проблемы:
  • Не загружается внешний файл или стиль: проверьте, что ссылка начинается с `https://`, ведёт именно на файл, а не на страницу с превью, и что сервис не блокируется (иногда мешают расширения-блокировщики рекламы).
  • Ошибка CORS при `fetch()`: браузер запрещает запросы к чужому сайту, если тот не разрешил их явно. Данные с raw.githubusercontent.com запросы разрешают, а многие другие серверы — нет.
  • Звук не воспроизводится: браузеры запрещают автоматическое включение звука, воспроизведение нужно запускать по клику или нажатию клавиши пользователя.
  • Результат не обновляется: проверьте консоль на наличие ошибок (вопрос 2) и параметры в "Pen Settings" → "Behavior & Processing", затем обновите страницу с очисткой кэша (`Ctrl + Shift + R`).