Back to Design Systems for Developers
React
Chapters
  • イントロダクション
  • 設計
  • 構築
  • レビュー
  • テスト
  • ドキュメント
  • 配布
  • ワークフロー
  • 結論

デザインシステムのためのワークフロー

フロントエンド開発者のためのデザインシステムワークフローの概要
このコミュニティの翻訳は、最新の Storybook バージョンに対応していません。英語ガイドの最新の変更を適用して、この日本語ガイドの更新にご協力ください。 Pull requests を大歓迎します。.

いかにフロントエンドのツール群を使いこなすかは、デザインと開発チームが実現しうる究極の価値に大きく影響します。上手くいくと、UI コンポーネントを開発し再利用することが円滑になるはずです。

本章は AvatarList という新しいコンポーネントの導入によるワークフローの 5 つのステップを紹介します。

Design system workflow

ビルド

AvatarList は複数のアバターを表示するコンポーネントです。他のデザインシステムのコンポーネントのように、AvatarList は数多くのプロジェクトで貼り付けられるところから始まりました。それがデザインシステムへ導入するには十分な理由です。当デモのため、コンポーネントが他のプロジェクトで開発され完成コードがすでにあるとしましょう。

AvatarList

最初に、この作業を追跡する新しいブランチを作成してください。

Copy
git checkout -b create-avatar-list-component

あなたの PC に AvatarList コンポーネントとストーリーをダウンロードして /src ディレクトリに配置します:

Storybook with AvatarList component

💡 Storybook は *.stories.js で終わるファイルを自動的に検知して設定し UI 上に表示します。

いいですね!では AvatarList に支えられる各 UI の状態と関連付けましょう。見たところ、AvatarListsmallloading のような Avatar プロパティをいくつかサポートしているのは明らかです。

Copy
src/AvatarList.stories.js
export const SmallSize = Template.bind({});
SmallSize.args = {
  users: Short.args.users,
  size: 'small',
};

export const Loading = Template.bind({});
Loading.args = {
  loading: true,
};

Storybook with more AvatarList stories

プロパティがリストなら、多数のアバターを表示するべきです。多数と少数のリストアイテムを表示するストーリーを追加しましょう。

Copy
src/AvatarList.stories.js
export const Ellipsized = Template.bind({});
Ellipsized.args = {
  users: [
    ...Short.args.users,
    {
      id: '3',
      name: 'Zoltan Olah',
      avatarUrl: 'https://avatars0.githubusercontent.com/u/81672',
    },
    {
      id: '4',
      name: 'Tim Hingston',
      avatarUrl: 'https://avatars3.githubusercontent.com/u/1831709',
    },
  ],
};

export const BigUserCount = Template.bind({});
BigUserCount.args = {
  users: Ellipsized.args.users,
  userCount: 100,
};

export const Empty = Template.bind({});
Empty.args = {
  users: [],
};

進んだものを保存してコミットします。

Copy
git commit -am "Added AvatarList and stories"

ドキュメント

Storybook Docs のおかげで、最小限の労力でカスタマイズ可能なドキュメンテーションが手に入ります。他の人が Storybook Docs タブを参照して AvatarList の使い方を学ぶことを助けます。

Storybook docs with minimal AvatarList info

最小限の価値あるドキュメント! AvatarList に使い方の補足的な背景を提供してもう少し親近感を加えましょう。

Copy
src/AvatarList.js
/**
 * A list of Avatars, ellipsized to at most 3. Supports passing only a subset of the total user count.
 */
export function AvatarList({ loading, users, userCount, size, ...props }) {

サポートされるプロパティについていくつか補足的な詳細を書き散らします。

Copy
src/AvatarList.js
AvatarList.propTypes = {
  /**
   * Are we loading avatar data from the network?
   */
  loading: PropTypes.bool,
  /**
   * A (sub)-list of the users whose avatars we have data for. Note: only 3 will be displayed.
   */
  users: PropTypes.arrayOf(
    PropTypes.shape({
      id: PropTypes.string.isRequired,
      name: PropTypes.string,
      avatarUrl: PropTypes.string,
    })
  ),
  /**
   * The total number of users, if a subset is passed to `users`.
   */
  userCount: PropTypes.number,
  /**
   * AvatarList comes in four sizes. In most cases, you’ll be fine with `medium`.
   */
  size: PropTypes.oneOf(Object.keys(sizes)),
};

パイを食べるくらい簡単ですね!今のところ、この詳細の水準で十分です—後で MDX を使っていつでもカスタマイズできます。

Storybook docs with full AvatarList info

ドキュメンテーションは面倒である必要はありません。自動化されたツールを使い、すぐにライティングに取りかかるために単調な作業を省きました。

変更をコミットし GitHub へプッシュします。

Copy
git commit -am "Improved AvatarList docs"

プルリクエストを作成する

AvatarList ブランチを GitHub へプッシュしてプルリクエストを作成しましょう:

Copy
git push -u origin create-avatar-list-component

それから GitHub へ移動してプルリクエストをオープンします。

PR created in PR for AvatarList

レビュー

この時点で、AvatarList はデザインシステムに取り込む候補です。ステークホルダーは機能性と見た目が期待通りなのか確かめるためにコンポーネントをレビューしなければなりません。

デザインシステムの Storybook はレビューをごく簡単にするそれぞれのプルリクエストを自動的に発行します。PR チェックまでスクロールしデプロイされた Storybook へのリンクを探してください。

PR check for deployed PR

発行された Storybook で AvatarListを探してください。ローカルの Storybook と同じように見えるはずです。

AvatarList in Storybook online

発行された Storybook はチームにとって共通の参照ポイントです。より早くフィードバックを得るために他のステークホルダーに AvatarList へのリンクをシェアしましょう。コードを読むことに取り掛かったり開発環境をセットアップしたりする必要がないのでチームはあなたを気に入るでしょう。

Looks good, ship it!

多くのチームと合意に至るのはしばしば無駄な活動のように感じます。みんな開発環境を持たないで有効期限切れのコードを参照したり複数のツールをまたがりフィードバックを撒き散らします。オンラインで Storybook のレビューは URL を共有するだけの簡単なものになります。

テスト

私たちのテストパッケージはコミットのたびに裏で動いています。AvatarList はシンプルなプレゼンテーショナルコンポーネントのため、単体テストは必要ありません。しかし PR チェックを見れば、ビジュアルテストツールである Chromatic がすでにレビューが必要な変更を検知しています。

Chromatic changes on the GitHub PR check

AvatarList は新しいため、まだビジュアルテストはありません。ストーリーそれぞれにテスト基準を追加する必要があります。ビジュアルテストの範囲を広げるために Chromatic で “new stories” を受け入れます。

Chromatic changes to the AvatarList stories

受け入れが完了すると、 Chromatic でビルドが通るでしょう。

Chromatic changes to the AvatarList stories accepted

それから順次、GitHub で PR チェックが更新されます。

Chromatic changes accepted on the GitHub PR check

テストが首尾よく更新されました。今後、リグレッションがデザインシステムへ忍び込むのは難しいでしょう。

配布

デザインシステムに AvatarList を加えるプルリクエストをオープンしました。ストーリーを書いて、テストを通し、ドキュメンテーションがあります。ようやく、Auto と npm を用いてデザインシステムのパッケージを更新する準備が整いました。

プルリクエストに minor ラベルを追加しましょう。これはマージの際 Auto にパッケージのマイナーバージョンの更新を伝えます。

GitHub PR with labels

さてプルリクエストをマージして、npm 上であなたのパッケージへ移動し、パッケージが更新されるまで数分待ちましょう。

Package published on npm

上手くいきました!デザインシステムのパッケージが Github の快適さにより更新されました。コマンドラインを触ったり npm に手間取る必要は一切ありません。AvatarList を使い始めるためにサンプルアプリで learnstorybook-design-system の依存関係を更新しましょう。

旅の始まり

Design Systems for Developers はあなた自身の開発が有利なスタートを切れるようプロのフロントエンドチームに使われるエンド・ツー・エンドのワークフローに焦点を当てました。デザインシステムの成長にともない、チームの求めに応じるためこれらのツールを追加、再編成、拡張してゆきましょう。

第 9 章は完成したサンプルコード、参考資料、開発者からのよくある質問で締めくくります。

Keep your code in sync with this chapter. View 9d13d12 on GitHub.
Is this free guide helping you? Tweet to give kudos and help other devs find it.
Next Chapter
結論
デザインシステムの成長が時間を節約し生産性を向上させる
✍️ Edit on GitHub – PRs welcome!
Join the community
6,616 developers and counting
WhyWhy StorybookComponent-driven UI
Open source software
Storybook

Maintained by
Chromatic
Special thanks to Netlify and CircleCI