@@ -42,7 +42,7 @@ Web APIの設計については、別途公開している[Web API設計ガイ
4242
4343# ガイドラインの特徴
4444
45- 本ガイドラインは、基本的に ** 業務アプリケーションの開発を想定 ** して作成しています 。これらのアプリケーションは、大規模なtoC向けサービスとは異なる、以下のような特性を持ちます。
45+ 本ガイドラインは、基本的に業務アプリケーションの開発を想定して作成しています 。これらのアプリケーションは、大規模なtoC向けサービスとは異なる、以下のような特性を持ちます。
4646
4747- 権限管理が細かく所属部署や役職で表示内容が細かく変わる
4848- 複雑なデータ入力フォームや多機能なテーブル表示など状態管理やUI制御が複雑
@@ -62,12 +62,12 @@ Web APIの設計については、別途公開している[Web API設計ガイ
6262
6363# 一部コンテンツの抜粋
6464
65- ガイドラインは ** かなりのボリューム ** (A4のPDFで100ページ越え…!)となっています。
65+ ガイドラインはかなりのボリューム (A4のPDFで100ページ越え…!)となっています。
6666ここでは、皆さんにとくに見ていただきたいコンテンツをいくつかピックアップしてご紹介します!
6767
6868## ホスティング方式
6969
70- レンダリング方式として、** CSR** (Client Side Rendering)と ** SSR ** (Server Side Rendering)の特徴を比較しています。
70+ レンダリング方式として、CSR(Client Side Rendering)とSSR (Server Side Rendering)の特徴を比較しています。
7171
7272その上で、以下のように使い分けることを推奨しています。
7373
@@ -94,7 +94,7 @@ Web APIの設計については、別途公開している[Web API設計ガイ
9494- ** ハイブリッドアプローチ:** 既存ライブラリを拡張したり、Radix UIなどヘッドレスUIライブラリに独自デザインを組み合わせて開発
9595- ** フルスクラッチ:** 完全に社内で共通コンポーネントを開発
9696
97- それぞれのPros/Consや適用ケースを示し ** 「まず既存ライブラリの活用を第一に検討することを推奨」** としています。
97+ それぞれのPros/Consや適用ケースを示し 「まず既存ライブラリの活用を第一に検討することを推奨」 としています。
9898
9999また、コンポーネント設計でよく発生するアンチパターンの具体例も挙げ、それらに対する解決策も併せて提示しています。
100100
@@ -104,14 +104,14 @@ Web APIの設計については、別途公開している[Web API設計ガイ
104104
105105## バリデーション設計
106106
107- バリデーションは、ユーザーによる誤入力を防ぎ適切なメッセージで自己修正を促すことで、** ユーザー体験(UX)を向上させるために不可欠 ** です 。
107+ バリデーションは、ユーザーによる誤入力を防ぎ適切なメッセージで自己修正を促すことで、ユーザー体験(UX)を向上させるために不可欠です 。
108108
109- ** フロントエンドのバリデーションは、ユーザーへの即時フィードバックを通じたUX向上を主目的 ** とします 。一方で、** システムのデータ整合性維持やセキュリティ対策(XSSなど)は、サーバーサイドでのバリデーションが必須 ** です 。
109+ フロントエンドのバリデーションは、ユーザーへの即時フィードバックを通じたUX向上を主目的とします 。一方で、システムのデータ整合性維持やセキュリティ対策(XSSなど)は、サーバーサイドでのバリデーションが必須です 。
110110
111111バリデーションの実施タイミングには複数の選択肢があり、それぞれUXへの影響と実装コストが異なります。
112112UX要件・リリース速度・開発工数を総合的に考慮し、最適なバランスの実装を選択する必要があります。
113113
114- また、アクセシビリティも重要な考慮点です。` disabled ` なボタンはスクリーンリーダーやキーボード操作でのアクセスに問題を生じさせるため、** 非活性化することは推奨されません** 。ボタンを活性化したままエラーメッセージで問題を指摘するなど、アクセシブルな状態を保つよう設計しましょう。
114+ また、アクセシビリティも重要な考慮点です。` disabled ` なボタンはスクリーンリーダーやキーボード操作でのアクセスに問題を生じさせるため、非活性化することは推奨されません。ボタンを活性化したままエラーメッセージで問題を指摘するなど、アクセシブルな状態を保つよう設計しましょう。
115115
116116## 状態管理の設計
117117
@@ -136,9 +136,9 @@ React、Vue.jsなどのモダンフレームワークでは、アプリケーシ
136136
137137これらの認証方式について、それぞれのメリット・デメリットを比較しています。
138138
139- ** フロントエンドにおける認可制御は** 、ユーザーが権限のない操作を誤って行なわないよう、行動を制限するなど、** UX向上を目的 ** とします 。
139+ フロントエンドにおける認可制御は、ユーザーが権限のない操作を誤って行なわないよう、行動を制限するなど、UX向上を目的とします 。
140140
141- 複雑性を抑えるために、画面内におけるコンポーネントの ** 認可制御が可能な限り最小限になるような画面単位で設計することを推奨 ** します 。
141+ 複雑性を抑えるために、画面内におけるコンポーネントの認可制御が可能な限り最小限になるような画面単位で設計することを推奨します 。
142142
143143## ブラウザ対応戦略
144144
@@ -148,17 +148,17 @@ React、Vue.jsなどのモダンフレームワークでは、アプリケーシ
148148- ** Newly Available:** 総合的判断で採用(Experimentalでなければ基本OK)
149149- ** Limited availability:** 本番環境での採用は見送り推奨
150150
151- また、サポートするブラウザに関しては、構築するシステムの要件を考慮したうえで、** ミニマムに絞ることを推奨 ** します 。
151+ また、サポートするブラウザに関しては、構築するシステムの要件を考慮したうえで、ミニマムに絞ることを推奨します 。
152152
153153## テスト方針
154154
155- 品質の高いWebアプリケーションを継続的に提供するため、適切なテスト戦略の策定が重要です。本ガイドラインでは、フロントエンド開発と相性が良いとされる ** 「テストトロフィー」の考えに基づき、テスト設計の方針を示して ** います 。
155+ 品質の高いWebアプリケーションを継続的に提供するため、適切なテスト戦略の策定が重要です。本ガイドラインでは、フロントエンド開発と相性が良いとされる 「テストトロフィー」の考えに基づき、テスト設計の方針を示しています 。
156156
157157テストピラミッド(高速なユニットテストを土台とする従来の考え方)に対して、テストトロフィーはコンポーネント/インテグレーションテスト(ユーザー視点での動作検証)をより重視します。ユニットテストは実装の詳細に依存し脆く、E2Eテストはコストが高いため、過度に依存しないバランスの取れたアプローチを推奨しています。
158158
159159# まとめ
160160
161- [ Webフロントエンド設計ガイドライン] ( https://future-architect.github.io/arch-guidelines/documents/forWebFrontend/web_frontend_guidelines.html ) は、現代の複雑化したフロントエンド開発における設計判断を支援し、知見共有を促進することを目的として作成しました。単なる技術Tips集ではなく、** ビジネス要件と技術選択のバランスを重視し、開発チームの状況に応じた実践的な指針を提供 ** しています 。
161+ [ Webフロントエンド設計ガイドライン] ( https://future-architect.github.io/arch-guidelines/documents/forWebFrontend/web_frontend_guidelines.html ) は、現代の複雑化したフロントエンド開発における設計判断を支援し、知見共有を促進することを目的として作成しました。単なる技術Tips集ではなく、ビジネス要件と技術選択のバランスを重視し、開発チームの状況に応じた実践的な指針を提供しています 。
162162
163163ぜひ一度ガイドラインをご覧いただき、皆さまのプロジェクトにお役立てください。
164164
0 commit comments