Работа с codepen
CodePen.io — это мощная облачная среда разработки и социальная платформа для фронтенд-разработчиков, которая работает полностью в браузере. Она позволяет писать, тестировать и демонстрировать код без необходимости устанавливать локальное окружение. Главная особенность сервиса — мгновенный визуальный отклик: результат написания HTML, CSS и JavaScript отображается в окне предпросмотра в реальном времени.
1. Как начать работать в codepen.io?
Для работы в CodePen нужен аккаунт: он позволяет сохранять проекты, чтобы они не пропадали после закрытия вкладки.
Слева в редакторе находится узкая панель с иконками. Каждая иконка открывает отдельный раздел; открытым может быть только один раздел, но можно закрыть и все. Скрыть или показать боковую панель целиком можно сочетанием `Ctrl + U`.
- Регистрация: на главной странице codepen.io нажать "Sign Up" и зарегистрироваться через e-mail либо через аккаунт GitHub, Google или Apple.
- Создание проекта: нажать кнопку "New Pen". Откроется редактор. Один проект в CodePen называется pen.
- Верхняя панель редактора: справа находятся три кнопки — сердечко (поставить проекту "лайк"), "Save" (сохранить проект) и "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".
2. Как посмотреть ошибки кода?
Если в окне предпросмотра пусто или результат отличается от ожидаемого, причину нужно искать в консоли. Для этого есть два способа.
- Встроенная консоль CodePen. Консоль открывается в области предпросмотра: она делит область с результатом пополам, а размер можно менять, перетаскивая границу. В неё попадают сообщения от `console.log()`, `console.warn()` и `console.error()`, а также ошибки выполнения JavaScript с текстом и номером строки, например `Uncaught ReferenceError: x is not defined`. В консоли можно и вводить команды, они будут выполняться внутри проекта. Если не видите кнопку "Console", отключите "Minimal UI" в меню "Controls": в этом режиме нижняя строка скрыта.
- Инструменты разработчика браузера. Для более сложной отладки нажмите `F12` и используйте вкладки DevTools: "Console" (ошибки), "Elements" (проверка вёрстки и стилей), "Network" (не загрузились ли внешние файлы), "Sources" (точки останова). Результат проекта показывается внутри страницы редактора, поэтому его ошибки тоже появляются в консоли браузера.
- `Failed to load resource: 404` — неверная ссылка на внешний файл. Для файлов с GitHub проверьте, что используется raw-ссылка (см. вопрос 4).
- `Uncaught SyntaxError` — опечатка в коде: незакрытая скобка, кавычка или запятая. В сообщении указана строка, на которой браузер обнаружил проблему.
- `Cannot read properties of null` — скрипт обращается к элементу, которого нет на странице (опечатка в id или класс не совпадает).
- `Mixed Content` — на странице с HTTPS подключается ресурс по HTTP. Ссылку нужно заменить на HTTPS-версию.
3. Как сохранить готовый проект на локальный компьютер?
В CodePen проект можно выгрузить в виде архива, который затем открывается без интернета (но если в проекте есть внешние файлы по ссылкам, как в вопросе 4, для их загрузки интернет всё равно понадобится).
- В правом верхнем углу редактора открыть меню кнопки "Share".
- Выбрать "Export .zip" — браузер скачает архив с проектом.
- Распаковать архив в любую папку.
- Открыть файл `index.html` двойным щелчком — проект запустится в браузере.
4. Как использовать сторонние файлы?
У бесплатного тарифа есть существенное ограничение: нет встроенной загрузки файлов в проект.
Это ограничение касается:
Способ 1: GitHub + raw-ссылка Самый надёжный и рекомендуемый способ для учебных и pet-проектов — разместить файл в репозитории на GitHub и получить прямую ссылку на его содержимое.
Тот же способ для файлов, отличных от изображений
Принцип одинаков для любого типа файла — меняется лишь то, куда подставляется ссылка:
Частая практическая проблема: если обновить файл на GitHub под тем же именем, браузер может продолжать показывать закэшированную старую версию. Решение — добавить в конец ссылки произвольный параметр, который заставит браузер считать это новым запросом:
Способ 2: Сторонние хостинги изображений
Стоит отметить: такие сервисы, как правило, предназначены именно для изображений. Для шрифтов, JSON и аудио они обычно не подходят — там уместнее способ 1 (GitHub) или специализированные хостинги под конкретный тип файла.
Способ 3: jsDelivr CDN поверх GitHub Тот же файл на GitHub можно раздавать через бесплатный CDN — быстрее и стабильнее прямой raw-ссылки:
Разница с прямой raw-ссылкой (способ 1) в том, что jsDelivr кэширует файлы на серверах по всему миру, поэтому загрузка происходит быстрее — особенно если проект открывают пользователи из разных стран. Для учебного проекта, который смотрит только сам студент и преподаватель, разница незаметна, но для чего-то более публичного (например, демо, которое планируется показывать широкой аудитории) стоит использовать именно этот вариант.
Способ работает для любых файлов, лежащих в репозитории — не только изображений.
Способ 4: Base64 Для очень маленьких файлов можно закодировать содержимое в строку Base64 (например, через base64-image.de для изображений или аналогичные сервисы для других форматов) и вставить прямо в код — без каких-либо внешних ссылок и хостинга:
Но данный подход сильно раздувает исходник, и неприменим для больших файлов вроде полноразмерных спрайт-листов, аудиодорожек или шрифтов с большим набором символов.
Это ограничение касается:
- изображений (спрайт-листы, иконки, текстуры, фоны)
- шрифтов (`@font-face`)
- аудиофайлов (`
- JSON-файлов с данными (конфигурации, texture-атласы, локализация)
- видео.
Способ 1: GitHub + raw-ссылка Самый надёжный и рекомендуемый способ для учебных и pet-проектов — разместить файл в репозитории на GitHub и получить прямую ссылку на его содержимое.
- Создать репозиторий на GitHub.
- Загрузить файл: Add file → Upload files.
- Открыть загруженный файл в интерфейсе репозитория, нажать по файлу правой кнопкой мыши и выбрать "Открыть картинку в новой вкладке" (для картинок) или нажать на кнопку "Raw" (для файлов других форматов).
- Скопировать URL из адресной строки:
https://raw.githubusercontent.com/username/repo-name/main/filename
- Использовать в JS:
const spriteSheet = new Image(); spriteSheet.src = 'https://raw.githubusercontent.com/username/repo-name/main/filename';
Тот же способ для файлов, отличных от изображений
Принцип одинаков для любого типа файла — меняется лишь то, куда подставляется ссылка:
// шрифт 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');
spriteSheet.src = 'https://raw.githubusercontent.com/username/repo-name/main/filename?v=2';
Способ 2: Сторонние хостинги изображений
- imgur.com, postimages.org — загрузить картинку, скопировать прямую ссылку, заканчивающуюся расширением файла.
Стоит отметить: такие сервисы, как правило, предназначены именно для изображений. Для шрифтов, JSON и аудио они обычно не подходят — там уместнее способ 1 (GitHub) или специализированные хостинги под конкретный тип файла.
Способ 3: jsDelivr CDN поверх GitHub Тот же файл на GitHub можно раздавать через бесплатный CDN — быстрее и стабильнее прямой raw-ссылки:
spriteSheet.src = 'https://cdn.jsdelivr.net/gh/username/repo-name@main/filename';
Способ работает для любых файлов, лежащих в репозитории — не только изображений.
Способ 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. Устанавливать ничего не нужно.
Файл package.json появится в панели "Files", и его можно редактировать — например, чтобы закрепить конкретную версию пакета. Если нужна ссылка вручную, то же самое работает и с полным адресом:
Способ 2: ссылка на CDN в HTML
Библиотеку можно подключить обычным тегом в файле index.html, как на любом сайте:
Тег нужно разместить раньше, чем ваш скрипт, который эту библиотеку использует. Ссылки на библиотеки удобно искать на сайтах 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, вы получите нужную обработку без дополнительных настроек.
Способ 1: npm-пакет через import
Самый простой способ — подключить пакет прямо в JS-файле. CodePen сам заметит строку с import, создаст файл package.json со списком пакетов и подключит их через CDN esm.sh. Устанавливать ничего не нужно.
import { v4 } from "uuid"; console.log(v4());
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>
Способ 3: блоки (Blocks)
Блоки — это технологии, которые CodePen добавляет в сборку проекта: препроцессоры (Sass), языки (TypeScript, JSX, Markdown), инструменты (Tailwind, Prettier) и так далее. Добавить блок можно кнопкой "Add Blocks" или на панели "Blocks" в боковой панели. Часто блоки подключаются автоматически по расширению файла: создав файл style.scss, script.ts, app.jsx или notes.md, вы получите нужную обработку без дополнительных настроек.
6. Как поделиться проектом?
Все действия находятся в меню кнопки "Share":
Приватность проекта и приглашения к совместной работе настраиваются в боковой панели "Privacy & Collaboration", при этом доступные возможности зависят от тарифа. Если проект публичный, его может увидеть любой, поэтому не размещайте в нём пароли, ключи API и другие личные данные.
- 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.
Приватность проекта и приглашения к совместной работе настраиваются в боковой панели "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`).
