Skip to content

Commit 3dcac9d

Browse files
authored
Update 20250911a_Webフロントエンド設計ガイドラインを公開しました_at_10:00.md
1 parent 82a06e6 commit 3dcac9d

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

source/_posts/2025/20250911a_Webフロントエンド設計ガイドラインを公開しました_at_10:00.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -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への影響と実装コストが異なります。
112112
UX要件・リリース速度・開発工数を総合的に考慮し、最適なバランスの実装を選択する必要があります。
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

Comments
 (0)