Сара пот
В последнее время я хотел пробовать новые вещи и проверить новые технологии или узоры в моих компонентах реагирования. Мне нужно было место, где я мог проверить эти вещи, не запускав новое приложение каждый раз.
Недавно я начал использовать Read DesealBook на работе, чтобы создать новую систему дизайна для будущих проектов. Я также использовал его для прототипа нескольких версий нового авторского инструмента контента, на нашей команде работает. Вмещает этот инструмент вместе с моим желанием создавать компоненты и играть с новыми вещами в низких ставках, казалось прекрасным. Несколько примеров этих новых «вещей» являются контекст React, Slitejs и реагированные крюки.
Это также может быть использовано в качестве портфеля и отличный способ продемонстрировать вашу работу. Поскольку сюжетная книга может быть развернута в качестве собственного приложения, вы можете разместить веб-страницу, в которой у вас есть различные проекты и компоненты, которые вы можете отображать для потенциальных работодателей или клиентов. После развертывания, это так же легко, как отправка им ссылку на ваш рассказчик!
Этот пост будет сосредоточен на создании сюжетной книги для среды Ract React, и я буду целью публиковать в будущем о том, что я создаю внутри этого!
SOOO … Что такое историй?
Взятые прямо с веб-сайта Складской книги, потому что я не мог сказать это лучше себя:
Это означает … Я могу создавать и отображать/взаимодействовать с компонентами независимо от фактического запуска приложения RACT! И поскольку этот проект не будет сосредоточен на производительности или сухости от одного приложения, у меня могут иметь несколько прототипов и версий компонентов, чтобы я мог их совершенствовать, позволить заинтересованным сторонам одобрить и т. Д. Прежде чем принести их в приложение, для которого они были предназначен для. Я также могу использовать его, чтобы просто практиковать создание компонентов и тестирование того, как использовать новые технологии, которые я упоминал ранее.
Давайте сейчас построим здания!
Создать базу Реагировать приложение
npx create-react-app my-playground
Вы можете убедиться, что ваше приложение было успешно создано, запуская Запуск пряжи . Новое окно должно появиться в вашем браузере к localhost: 3000 Это похоже на картину выше. После подтверждения вы можете остановить его, нажав ⌘ + C.
Добавить сюжет книгу
Во-первых, из командной строки в вашем проекте вам нужно будет добавить сюжетную книжку со следующей командой:
npx -p @storybook/cli sb init
Затем вы можете запустить сюжету с использованием:
yarn storybook
Теперь вы должны быть введены и запущены, увидев экран в вашем браузере, как приведен ниже:
Если вы посмотрите в папке проекта, вы заметите, что некоторые файлы были добавлены, а другие обновлены:
./Storybook. Папка является домом для того, где вы настроите много настроек для вашей сборной. Есть все виды дополнительных дополнений, которые вы можете подать заявку на ваш проект, чтобы добавить больше функций. config.js Файл, как правило, где вы будете применять дополнения, а также рассказать Designbook, где найти свои истории. Настройка по умолчанию следующее:
import { configure } from '@storybook/react';
function loadStories() {
require('../src/stories');
}
configure(loadStories, module);Это рассказывает истории посмотреть в Находятся/SRC/Stories Папка для историй, которые вы написали. Прямо сейчас STEALUBOOK отправился и добавил несколько историй по умолчанию для вас. Вы можете взглянуть на тех, кто понял, как написать истории. Вы в конечном итоге просто делаете свои компоненты в своих собственных функциях, и вы можете пройти им любые реквизиты.
Как вы можете видеть в примере, он дает вам ниже, вы можете создавать несколько версий одного и того же компонента, просто рендеринг его с разными реквизитами.
Тем не менее, вы можете себе представить, когда вы начнете создавать больше компонентов, этот файл может стать очень большим, и вы не хотите, чтобы их писать в конфигурации каждый файл с историями в нем, что вы хотите сделать … вместо этого, удобный способ сделать это, чтобы назвать любой файл в вашем SRC папка с Stories.js И чтобы сюжетную книжку динамически находить все файлы с именем Stories.js в конце, внутри вашего SRC Папка вы бы поместили в ваш файл конфигурации:
import { configure } from '@storybook/react'
function loadStories() {
const req = require.context('../src', true, /\.stories\.js$/)
req.keys().forEach(filename => req(filename))
}
configure(loadStories, module)Это позволяет для гораздо более чистой файловой структуры, и вы можете организовать свои истории проектом или даже по компоненту в вашей папке SRC.
Создайте свои мини-проекты
Давайте построим небольшой компонент в качестве примера, чтобы показать, как вы можете расширить быстрый пример проекта, чтобы начать обучение API контекста Rection. В моем фоне SRC Папка Я собираюсь создать папку ContextProject, в которой я собираюсь добавить файл, где я определим свой компонент, а затем другой, где я определим историю:
Теперь, когда я проверю свою историю книгу, я увижу, что у меня есть параметр меню для моего проекта API контекста, а ниже, что я могу нажать, чтобы увидеть мой домашний компонент, который я создал:
И теперь я могу начать строить мой контекст и другие компоненты в этой папке в Src. . Я смогу воспроизводить и отображать компоненты, которые я строит, позволяя мне быстро увидеть мои изменения и не нужно беспокоиться о запуске нового приложения RACT APP каждый раз, когда я хочу просто проверить определенную функцию или новую идею.
Это также позволяет много гибкости при попытке быстрого прототипа новой идеей. У вас уже есть среда вверх и запущена и могут иметь свои любимые библиотеки, такие как созданные компоненты, уже установленные или предоставляются предварительно определенные темы, которые могут быть легко импортированы в новые проекты. Вы также можете предварительно определить некоторые базовые компоненты, такие как в стиле заголовки, Divs, кнопки и т. Д., Вы можете поделиться между проектами, чтобы сделать разработку еще более быстрее.
Надеюсь, что это поможет и останется настроенными для будущих постов о моих любимых дополнениях и деталях в тестовых проектах, которые я строю в моем рассказе.
Счастливое кодирование!
Использованная литература:
Статью книги: UI Компонентная мастерская для разработчиков Frontend STEALBOOK – это инструмент с открытым исходным кодом для разработки компонентов пользовательского интерфейса в изоляции для реагирования, Vue и угловых. Это делает … storybook.js.org
Мой github repo:
Sarahwast/My-Playground Способствуйте разработку Sarahswast/My-Playground, создав счет на Github. github.com
Оригинал: “https://www.freecodecamp.org/news/how-to-build-a-react-development-playground-using-storybook-667ef9808e9f/”