メインコンテンツへスキップ
見出し画像

日本語サイトの英語版作成の補足:コード解説(新人エンジニア向け)


    前の記事の続きです。
    こちらでは、HTML、CSS、JavaScriptのコード部分を一行ずつ丁寧に解説します。各コードの意図や技術的背景についても詳しく説明します。
    各コードの意図や技術的背景についても詳しくシェアします!

    1. HTML基本構造と解説

    <!DOCTYPE html>
    <!-- HTML5の宣言 - モダンブラウザに対してHTML5文書であることを通知します -->
    
    <html lang="en">
    <!-- ドキュメントのルート要素。lang属性で言語を英語に指定します -->
    <!-- 検索エンジンや支援技術に英語コンテンツであることを伝え、適切な処理をさせます -->
    
    <head>
        <!-- ヘッド部分:メタデータやリソースリンクなどを含む領域 -->
    
        <meta charset="UTF-8">
        <!-- 文字エンコーディングをUTF-8に設定。多言語対応に必須の設定です -->
        <!-- 日本語も英語も含めたほとんどの言語をサポートできます -->
    
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <!-- モバイル対応のためのビューポート設定。レスポンシブデザインの基本です -->
        <!-- width=device-width:デバイスの幅に合わせる、initial-scale=1.0:初期ズームレベル -->
    
        <title>Your Website Title in English</title>
        <!-- ページのタイトル。ブラウザのタブやブックマークに表示されます -->
        <!-- SEOの重要要素なので、キーワードを含めた明確なタイトルにします -->
    
        <link rel="alternate" hreflang="ja" href="https://example.com/ja/">
        <!-- 代替言語版へのリンク(日本語版)。SEOとユーザービリティのために重要です -->
        <!-- 検索エンジンがユーザーの言語に適した版を表示するのに役立ちます -->
    
        <link rel="alternate" hreflang="en" href="https://example.com/en/">
        <!-- 代替言語版へのリンク(英語版)。自己参照も含めるのが推奨されています -->
        <!-- このページが英語版であることを明示します -->
    
        <link rel="stylesheet" href="styles.css">
        <!-- CSSファイルの読み込み。スタイルを別ファイルにすることで管理が容易になります -->
    </head>
    
    <body>
        <!-- ボディ部分:実際にユーザーに表示されるコンテンツの領域 -->
    
        <header>
            <!-- ヘッダー要素:サイトのトップ部分。ロゴやナビゲーションを含むことが多い -->
    
            <div class="logo">
                <!-- ロゴを包含するdiv要素。スタイリングのためのコンテナとして機能 -->
                <a href="/en/">
                    <!-- ホームページへのリンク。英語版のルートを指定 -->
                    <img src="logo.png" alt="Company Name Logo" width="200" height="60">
                    <!-- ロゴ画像。alt属性は必ず英語で適切な説明を入れます -->
                    <!-- width/heightの指定はCLS(Cumulative Layout Shift)対策として有効 -->
                </a>
            </div>
    
            <nav class="language-switcher">
                <!-- 言語切り替えナビゲーション。ユーザーが言語を選択できるように -->
                <ul>
                    <!-- 順序なしリスト。言語選択肢を並べるのに適しています -->
                    <li><a href="/ja/" lang="ja">日本語</a></li>
                    <!-- 日本語版へのリンク。lang属性で一部の言語を指定 -->
                    <!-- 日本語テキストには lang="ja" を指定し、スクリーンリーダーが正しく読み上げるようにします -->
                    <li><a href="/en/" class="active">English</a></li>
                    <!-- 英語版へのリンク。現在のページなのでactive classを追加 -->
                </ul>
            </nav>
    
            <nav class="main-nav">
                <!-- メインナビゲーション。サイト内の主要なセクションへのリンクを提供 -->
                <ul>
                    <li><a href="/en/about/">About Us</a></li>
                    <!-- 会社概要ページへのリンク。英語版のURLパスを指定 -->
                    <li><a href="/en/services/">Services</a></li>
                    <!-- サービス紹介ページへのリンク -->
                    <li><a href="/en/contact/">Contact</a></li>
                    <!-- お問い合わせページへのリンク -->
                </ul>
            </nav>
        </header>
    
        <main>
            <!-- メイン要素:ページの主要コンテンツを含む。SEO的にも重要 -->
    
            <section class="hero">
                <!-- ヒーローセクション:ページ上部の目立つ領域 -->
                <h1>Welcome to Our Website</h1>
                <!-- H1見出し:ページの主題を表す。SEOで最も重要な要素の一つ -->
                <!-- 1ページに1つのH1が望ましい -->
                <p>This is the English version of our website. We provide excellent services to our global customers.</p>
                <!-- 紹介文。英語は日本語より横幅を取るためレイアウト崩れに注意 -->
            </section>
    
            <section class="content-section">
                <!-- コンテンツセクション:ページの主要な情報を含む領域 -->
                <h2>Our Services</h2>
                <!-- H2見出し:セクションの見出し。情報の階層構造を作る -->
                <div class="service-grid">
                    <!-- サービス項目をグリッドレイアウトで表示するためのコンテナ -->
                    <div class="service-item">
                        <!-- 個別のサービス項目のコンテナ -->
                        <h3>Service 1</h3>
                        <!-- H3見出し:サブセクションの見出し -->
                        <p>Description of service 1 in English.</p>
                        <!-- サービスの説明文 -->
                    </div>
                    <!-- 他のサービス項目も同様の構造で続く... -->
                </div>
            </section>
        </main>
    
        <footer>
            <!-- フッター要素:ページ下部の補足情報やサイトマップなどを含む -->
            <div class="footer-content">
                <!-- フッターの内容をラップするコンテナ -->
                <div class="footer-nav">
                    <!-- フッター内のナビゲーション -->
                    <h4>Site Map</h4>
                    <!-- H4見出し:小見出し。サイトマップのタイトル -->
                    <ul>
                        <!-- サイトマップのリンクリスト -->
                        <li><a href="/en/about/">About Us</a></li>
                        <li><a href="/en/services/">Services</a></li>
                        <li><a href="/en/contact/">Contact</a></li>
                    </ul>
                </div>
    
                <p class="copyright">&copy; <script>document.write(new Date().getFullYear())</script> Company Name. All Rights Reserved.</p>
                <!-- 著作権表示。JavaScriptで現在の年を自動挿入します -->
                <!-- これにより、毎年手動で更新する必要がなくなります -->
            </div>
        </footer>
    </body>
    </html>
    

    2. CSSスタイルの解説

    * {
        box-sizing: border-box;
        /* すべての要素にbox-sizingプロパティを適用。paddingとborderを幅と高さに含める */
        /* これによりレイアウト計算が容易になり、要素のサイズ予測が簡単になります */
        margin: 0;
        /* すべての要素のマージンをゼロにリセット。ブラウザ間の一貫性を確保 */
        padding: 0;
        /* すべての要素のパディングをゼロにリセット */
    }
    
    body {
        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen,
        Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
        /* システムフォントスタックを指定。各OSで最適なフォントが選択される */
        /* 英語に適したフォントを優先順位付けで指定。WebフォントのダウンロードなしでOS標準フォントを使用 */
        line-height: 1.6;
        /* 行の高さを設定。英文は日本語より行間を広めに取るのが読みやすい(1.6倍が一般的) */
        color: #333 ;
        /* テキストの基本色を暗めのグレーに設定。純黒より目に優しい */
        background-color: #fff ;
        /* 背景色を白に設定 */
        font-size: 16px;
        /* 基本フォントサイズを16pxに設定。モバイルデバイスでも読みやすいサイズ */
    }
    
    .container {
        width: 100%;
        /* コンテナの幅を親要素の100%に設定 */
        max-width: 1200px;
        /* コンテナの最大幅を1200pxに制限。大画面でも読みやすさを確保 */
        margin: 0 auto;
        /* 上下のマージンを0、左右を自動で中央揃え */
        padding: 0 20px;
        /* 左右に20pxのパディングを追加。コンテンツが画面端に接しないようにする */
    }
    
    header {
        display: flex;
        /* フレックスボックスレイアウトを適用。子要素を横並びにする */
        flex-wrap: wrap;
        /* コンテナ幅を超えた場合に折り返しを許可。モバイル対応に重要 */
        justify-content: space-between;
        /* 子要素間のスペースを均等に配分し、両端に寄せる */
        align-items: center;
        /* 子要素を垂直方向の中央に配置 */
        padding: 20px 0;
        /* ヘッダーの上下に20pxのパディングを追加 */
    }
    
    .logo img {
        display: block;
        /* 画像をブロック要素として表示。余分な隙間を防ぐ */
        max-width: 100%;
        /* 画像の最大幅を親要素の100%に制限。レスポンシブ対応 */
        height: auto;
        /* 高さを自動調整して縦横比を維持 */
    }
    
    .language-switcher ul {
        display: flex;
        /* 言語切り替えリンクを横並びにする */
        list-style: none;
        /* リストマーカー(・など)を非表示にする */
    }
    
    .language-switcher li {
        margin-right: 15px;
        /* 各言語リンク間に右側のマージンを設定 */
    }
    
    .language-switcher a {
        text-decoration: none;
        /* リンクの下線を削除 */
        padding: 5px 10px;
        /* リンク内部の余白を設定。クリック領域を拡大 */
        border-radius: 3px;
        /* 角を丸くして見た目を柔らかく */
        transition: background-color 0.3s;
        /* 背景色の変化をアニメーション化。0.3秒かけて滑らかに変化 */
    }
    
    .language-switcher a.active {
        background-color: #eee ;
        /* 現在選択されている言語の背景色を薄いグレーに設定 */
        font-weight: bold;
        /* 現在選択されている言語のテキストを太字に設定 */
    }
    
    .main-nav ul {
        display: flex;
        /* メインナビゲーションのリンクを横並びにする */
        list-style: none;
        /* リストマーカーを非表示 */
        flex-wrap: wrap;
        /* 画面幅が狭い場合に折り返し表示 */
    }
    
    .main-nav li {
        margin-right: 20px;
        /* ナビゲーション項目間の右側のマージン */
    }
    
    .main-nav a {
        text-decoration: none;
        /* リンクの下線を削除 */
        color: #333 ;
        /* リンクの色を設定 */
        font-weight: 500;
        /* フォントの太さをやや太めに設定 */
        transition: color 0.3s;
        /* 色の変化をアニメーション化 */
    }
    
    .main-nav a:hover {
        color: #0066cc ;
        /* ホバー時(マウスが上に乗った時)のリンク色を変更 */
    }
    
    h1, h2, h3, h4, h5, h6 {
        margin-bottom: 20px;
        /* 見出し要素の下部マージンを設定 */
        line-height: 1.3;
        /* 見出しの行間をやや狭めに設定。見出しは通常本文より詰め気味 */
        word-wrap: break-word;
        /* 長い単語による横溢れを防止。単語内で折り返しを許可 */
        hyphens: auto;
        /* 長い単語をハイフネーションで折り返す。英語では特に重要 */
    }
    
    h1 {
        font-size: 2.5em;
        /* H1の文字サイズを基本サイズの2.5倍に設定 */
    }
    
    h2 {
        font-size: 2em;
        /* H2の文字サイズを基本サイズの2倍に設定 */
    }
    
    h3 {
        font-size: 1.5em;
        /* H3の文字サイズを基本サイズの1.5倍に設定 */
    }
    
    p {
        margin-bottom: 15px;
        /* 段落の下部マージンを設定 */
        max-width: 70ch;
        /* 段落の最大幅を約70文字分に制限。英文の可読性向上のため */
        /* ch単位は1文字の幅を基準とする単位。英語テキストでは65-75chが読みやすいとされる */
    }
    
    .service-grid {
        display: grid;
        /* グリッドレイアウトを適用 */
        grid-template-columns: repeat(3, 1fr);
        /* 3列のグリッドを作成。各列は均等な幅(1fr)を持つ */
        /* repeat()関数で繰り返し指定。1frは使用可能なスペースの1等分 */
        gap: 30px;
        /* グリッドアイテム間の間隔を設定 */
    }
    
    footer {
        background-color: #f5f5f5 ;
        /* フッターの背景色を薄いグレーに設定 */
        padding: 40px 0;
        /* フッターの上下のパディングを設定 */
        margin-top: 50px;
        /* フッターの上部マージンを設定。コンテンツとの間隔を作る */
    }
    
    .footer-content {
        display: flex;
        /* フッターコンテンツを横並びにする */
        flex-wrap: wrap;
        /* 画面幅が狭い場合に折り返し表示 */
        justify-content: space-between;
        /* 子要素間のスペースを均等に配分 */
    }
    
    .footer-nav {
        margin-bottom: 30px;
        /* フッターナビゲーションの下部マージン */
    }
    
    .footer-nav ul {
        list-style: none;
        /* リストマーカーを非表示 */
    }
    
    .footer-nav li {
        margin-bottom: 10px;
        /* リスト項目間の下部マージン */
    }
    
    .copyright {
        width: 100%;
        /* 著作権表示を親要素の幅いっぱいに設定 */
        text-align: center;
        /* テキストを中央揃えにする */
        margin-top: 30px;
        /* 上部マージンを設定。他の要素との間隔を作る */
        font-size: 0.9em;
        /* フォントサイズを基本サイズの0.9倍に設定 */
        color: #666 ;
        /* テキスト色をやや薄いグレーに設定 */
    }
    
    @media (max-width: 768px) {
        /* 画面幅が768px以下の場合に適用されるスタイル(タブレット向け) */
        
        header {
            flex-direction: column;
            /* ヘッダー内の子要素を縦方向に並べる */
            align-items: flex-start;
            /* 子要素を左端に揃える */
        }
        
        .main-nav {
            margin-top: 20px;
            /* ナビゲーションの上部マージンを設定。ロゴとの間隔を作る */
            width: 100%;
            /* 幅を親要素の100%に設定 */
        }
        
        .service-grid {
            grid-template-columns: repeat(2, 1fr);
            /* グリッドを2列に変更。画面幅に合わせて列数を減らす */
        }
        
        h1 {
            font-size: 2em;
            /* 見出しサイズを小さくして、小さい画面でも読みやすく */
        }
    }
    
    @media (max-width: 480px) {
        /* 画面幅が480px以下の場合に適用されるスタイル(スマートフォン向け) */
        
        body {
            font-size: 14px;
            /* 基本フォントサイズを小さくする。モバイル画面での可読性向上 */
        }
        
        .main-nav ul {
            flex-direction: column;
            /* ナビゲーションリンクを縦方向に並べる */
        }
        
        .main-nav li {
            margin-right: 0;
            /* 右側のマージンを削除 */
            margin-bottom: 10px;
            /* 下部マージンを追加。項目間の間隔を作る */
        }
        
        .service-grid {
            grid-template-columns: 1fr;
            /* グリッドを1列に変更。小さい画面では縦一列に表示 */
        }
    }
    

    3. JavaScript機能の解説

    3.1 言語切り替え機能

    // 言語切り替え機能のJavaScript
    // ユーザーの言語設定を保存し、適切なページにリダイレクトするためのスクリプト
    
    document.addEventListener('DOMContentLoaded', function() {
        // DOMコンテンツが完全に読み込まれた後にスクリプトを実行
        // これによりHTML要素が全て利用可能な状態でスクリプトが動作します
    
        const languageLinks = document.querySelectorAll('.language-switcher a');
        // 言語切り替えリンク要素をすべて取得
        // querySelectorAllはCSSセレクタに一致する全ての要素を返します
        
        languageLinks.forEach(link => {
            // 各言語リンクに対して処理を実行
            // forEachメソッドは配列の各要素に対して関数を実行します
            
            link.addEventListener('click', function(e) {
                // クリックイベントリスナーを追加
                // ユーザーがリンクをクリックしたときの動作を定義
                
                e.preventDefault();
                // リンクのデフォルト動作(ページ遷移)を停止
                // JavaScriptで制御するためにブラウザのデフォルト動作を抑制します
                
                const href = this.getAttribute('href');
                // クリックされたリンクのhref属性値を取得
                // 例: '/ja/' または '/en/'
                
                const lang = href.includes('/ja/') ? 'ja' : 'en';
                // リンク先のURLから言語コードを判断
                // 三項演算子を使用して、'/ja/'を含む場合は'ja'、それ以外は'en'と判定
                
                localStorage.setItem('preferredLanguage', lang);
                // ブラウザのローカルストレージに言語設定を保存
                // キー'preferredLanguage'に対して値(langの値)を保存します
                
                window.location.href = href;
                // 該当言語のページへリダイレクト
                // ブラウザの現在のページを指定したURLに変更します
            });
        });
        
        // 言語の自動検出とリダイレクト機能
        function detectAndRedirect() {
            // 言語を検出してリダイレクトする関数を定義
            
            const currentPath = window.location.pathname;
            // 現在のURLパスを取得
            // 例: '/', '/en/about/', '/ja/contact/' など
            
            const isJaPage = currentPath.includes('/ja/');
            const isEnPage = currentPath.includes('/en/');
            // 現在のページが言語固有のページかどうかを判定
            // URLパスに'/ja/'または'/en/'が含まれているかをチェック
            
            if (isJaPage || isEnPage) {
                return;
            }
            // すでに言語固有のページにいる場合は何もしない
            // 早期リターンでこの後の処理をスキップします
            
            const savedLang = localStorage.getItem('preferredLanguage');
            // ローカルストレージから保存された言語設定を取得
            
            if (savedLang) {
                // 保存された設定がある場合の処理
                
                const redirectPath = savedLang === 'ja' ? '/ja/' : '/en/';
                // 保存された言語に基づいてリダイレクト先を決定
                
                window.location.href = redirectPath;
                // 該当言語のページへリダイレクト
                
                return;
                // 処理を終了
            }
            
            // ブラウザの言語設定を取得
            const browserLang = navigator.language || navigator.userLanguage;
            // ブラウザの設定言語を取得
            // 'navigator.language'はモダンブラウザ用、'navigator.userLanguage'は古いIE用
            
            // 日本語ブラウザの場合は日本語ページへ、それ以外は英語ページへ
            if (browserLang.startsWith('ja')) {
                // ブラウザの言語が'ja'で始まる場合(ja, ja-JP など)
                window.location.href = '/ja/';
                // 日本語ページへリダイレクト
            } else {
                // それ以外の言語設定の場合
                window.location.href = '/en/';
                // 英語ページへリダイレクト
            }
        }
        
        // トップページでのみ言語検出機能を実行
        if (window.location.pathname === '/' || window.location.pathname === '/index.html') {
            // URLパスがルート('/')または'/index.html'の場合のみ
            detectAndRedirect();
            // 言語検出・リダイレクト機能を実行
        }
    });
    

    3.2 日時表示の国際化

    // 日時表示の国際化対応スクリプト
    // 日付や時間を各言語に適した形式で表示するためのスクリプト
    
    function getCurrentLang() {
        // 現在のページの言語を取得する関数
        
        return document.documentElement.lang;
        // html要素のlang属性から言語を取得して返す
        // 例: 'en'または'ja'
    }
    
    function formatDate(date, lang = getCurrentLang()) {
        // 日付フォーマット関数
        // 引数: date(日付オブジェクト)、lang(言語コード、デフォルトは現在のページ言語)
        
        if (!date) {
            date = new Date();
        }
        // 日付が指定されていない場合は現在の日時を使用
        
        try {
            // エラーが発生する可能性のあるコードをtryブロックで囲む
            
            const options = { 
                year: 'numeric', // 年を数字で表示(例: 2025)
                month: 'long',   // 月を完全な名前で表示(例: April、4月)
                day: 'numeric'   // 日を数字で表示(例: 24)
            };
            // Intl.DateTimeFormatに渡すオプション
            
            return new Intl.DateTimeFormat(lang, options).format(date);
            // Intl.DateTimeFormat APIを使用して言語に応じた日付フォーマットを適用
            // 例: 'en'の場合 "April 24, 2025"、'ja'の場合 "2025年4月24日"
            
        } catch (error) {
            console.error('日付のフォーマットに失敗しました:', error);
            // エラーが発生した場合はコンソールにエラーメッセージを出力
            
            return date.toISOString().split('T')[0];
            // フォールバック: ISO形式の日付を返す(YYYY-MM-DD形式)
            // toISOString()は"YYYY-MM-DDTHH:mm:ss.sssZ"形式を返すので、'T'で分割して日付部分のみ使用
        }
    }
    
    function formatTime(date, lang = getCurrentLang()) {
        // 時間フォーマット関数
        // 引数: date(日付オブジェクト)、lang(言語コード)
        
        if (!date) {
            date = new Date();
        }
        // 日付が指定されていない場合は現在の日時を使用
        
        try {
            const options = { 
                hour: '2-digit',    // 時を2桁で表示(例: 09, 15)
                minute: '2-digit',  // 分を2桁で表示(例: 05, 30)
                hour12: lang === 'en' // 英語の場合は12時間制、日本語は24時間制
                // true: AM/PM形式(12時間制)、false: 24時間制
            };
            // 時間表示のオプション
            
            return new Intl.DateTimeFormat(lang, options).format(date);
            // 言語に応じた時間フォーマットを適用
            // 例: 'en'の場合 "3:30 PM"、'ja'の場合 "15:30"
            
        } catch (error) {
            console.error('時間のフォーマットに失敗しました:', error);
            // エラーが発生した場合はコンソールにエラーメッセージを出力
            
            return date.toTimeString().split(' ')[0];
            // フォールバック: シンプルな時間表示(HH:MM:SS形式)
            // toTimeString()は"HH:MM:SS GMT+XXXX"形式を返すので、スペースで分割して時間部分のみ使用
        }
    }
    
    
    

    3.2 日時表示の国際化あたり

    function formatNumber(number, format = 'decimal', lang = getCurrentLang()) {
        // 数値フォーマット関数(通貨、パーセントなど)
        // 引数: number(数値)、format(フォーマットタイプ)、lang(言語コード)
        
        try {
            let options = {};
            // フォーマットオプションを格納するオブジェクト
            
            // フォーマットタイプに応じて設定を変更
            switch (format) {
                case 'currency':
                    // 通貨フォーマットの場合
                    options = { 
                        style: 'currency',  // 通貨スタイル
                        currency: lang === 'ja' ? 'JPY' : 'USD'  // 日本語ならJPY(円)、それ以外ならUSD(ドル)
                    };
                    break;
                case 'percent':
                    // パーセントフォーマットの場合
                    options = { style: 'percent' };  // パーセントスタイル
                    break;
                default:
                    // デフォルト(小数点付き数値)
                    options = { style: 'decimal' };  // 標準の数値スタイル
            }
            
            return new Intl.NumberFormat(lang, options).format(number);
            // Intl.NumberFormat APIを使用して言語に応じた数値フォーマットを適用
            // 例: 'en'での通貨 "$1,234.56"、'ja'での通貨 "¥1,234"
            
        } catch (error) {
            console.error('数値のフォーマットに失敗しました:', error);
            // エラーが発生した場合はコンソールにエラーメッセージを出力
            
            return number.toString();
            // フォールバック: 単純な文字列変換
        }
    }
    
    // DOMの読み込み完了時に実行
    document.addEventListener('DOMContentLoaded', function() {
        // DOMコンテンツの読み込みが完了した時点で実行
        
        // 日付表示要素を検索して適切なフォーマットを適用
        const dateElements = document.querySelectorAll('[data-format-date]');
        // data-format-date属性を持つ要素をすべて取得
        
        dateElements.forEach(element => {
            // 各日付表示要素に対して処理を実行
            
            // data-date属性から日付を取得、なければ現在日時を使用
            const dateStr = element.getAttribute('data-date');
            // 要素のdata-date属性から日付文字列を取得
            
            const date = dateStr ? new Date(dateStr) : new Date();
            // 日付文字列が存在すればそれをDateオブジェクトに変換、なければ現在日時を使用
            
            // フォーマットした日付をテキストとして設定
            element.textContent = formatDate(date);
            // 整形した日付文字列を要素のテキストコンテンツとして設定
        });
        
        // 時間表示要素にも同様に適用
        const timeElements = document.querySelectorAll('[data-format-time]');
        // data-format-time属性を持つ要素をすべて取得
        
        timeElements.forEach(element => {
            // 各時間表示要素に対して処理を実行
            
            const dateStr = element.getAttribute('data-date');
            // 要素のdata-date属性から日付文字列を取得
            
            const date = dateStr ? new Date(dateStr) : new Date();
            // 日付文字列が存在すればDateオブジェクトに変換、なければ現在日時
            
            element.textContent = formatTime(date);
            // 整形した時間文字列を要素のテキストコンテンツとして設定
        });
        
        // 数値フォーマット要素にも適用
        const numberElements = document.querySelectorAll('[data-format-number]');
        // data-format-number属性を持つ要素をすべて取得
        
        numberElements.forEach(element => {
            // 各数値表示要素に対して処理を実行
            
            const number = parseFloat(element.getAttribute('data-number'));
            // data-number属性から数値を取得して浮動小数点数に変換
            
            const format = element.getAttribute('data-format') || 'decimal';
            // data-format属性からフォーマットタイプを取得、なければデフォルトは'decimal'
            
            if (!isNaN(number)) {
                // 数値が有効(NaNでない)場合
                
                element.textContent = formatNumber(number, format);
                // 整形した数値文字列を要素のテキストコンテンツとして設定
            }
        });
    });
    

    4. 実装のポイントと解説

    HTML実装のポイント

    1. 適切な言語設定

      • <html lang="en"> で英語ページとして宣言します

      • 部分的に日本語が含まれる場合は lang="ja" を追加します(例:言語切り替えナビゲーション)

      • これはスクリーンリーダーや検索エンジンのための重要な設定です

    2. メタタグの適切な設定

      • <meta charset="UTF-8"> で文字化けを防止します

      • <meta name="viewport"...> でモバイル対応を確保します

      • <link rel="alternate" hreflang="..."> で言語間のリンクを明示します

    3. セマンティックHTML

      • <header>, <main>, <footer>, <section> などの意味的要素を使用

      • これによりアクセシビリティが向上し、SEOにも有利になります

    4. alt属性の翻訳

      • 画像の alt 属性は必ず英語に翻訳します

      • 例:<img src="logo.png" alt="Company Name Logo">

    5. URLパス構造

      • /en/ のように言語を明示的にURLに含めます

      • これにより言語切り替えが容易になり、SEOにも有利です

    CSS実装のポイント

    1. レスポンシブデザイン

      • メディアクエリを使用して異なる画面サイズに対応します

      • 例:@media (max-width: 768px) { ... }

    2. 英語テキストの適切な処理

      • word-wrap: break-word; で長い英単語の折り返しを処理

      • hyphens: auto; でハイフネーションを適用

      • 英文の適切な行長として max-width: 70ch; を使用(約70文字)

    3. フォント設定

      • システムフォントスタックを使用して最適なフォントを提供

      • 英語に適した行間設定 line-height: 1.6;

    4. フレックスボックスとグリッド

      • モダンなレイアウト技術を活用

      • 例:display: flex; や display: grid;

      • レスポンシブ対応のため flex-wrap: wrap; を適切に使用

    5. 段階的な劣化対応

      • 基本スタイルをまず定義し、メディアクエリで調整

      • すべてのデバイスで適切に機能するよう設計

    JavaScript実装のポイント

    1. 言語検出と切り替え

      • ブラウザの言語設定を検出:navigator.language

      • ユーザーの言語設定を記憶:localStorage.setItem()

      • 適切な言語版にリダイレクト:window.location.href = '/en/'

    2. 国際化APIの活用

      • Intl.DateTimeFormat で言語に応じた日付表示

      • Intl.NumberFormat で言語に応じた数値・通貨表示

      • 例:通貨表示、日付形式、12時間制/24時間制の切り替え

    3. エラー処理

      • try/catchブロックでエラーをキャッチ

      • フォールバックメカニズムを実装

      • 例:日付フォーマットに失敗した場合はISO形式で表示

    4. データ属性の活用

      • data-format-date, data-format-time などの属性を使用

      • HTMLからJavaScriptにデータを渡す際の標準的な方法

    5. イベントリスナーの適切な設定

      • DOMContentLoaded イベントでDOMの読み込み完了を待機

      • イベント委譲パターンの活用

    5. 技術的用語解説

    用語 解説
    UTF-8 マルチバイト文字エンコーディング方式。英語や日本語など多くの言語をサポートする国際標準。
    レスポンシブデザイン 異なる画面サイズに応じてレイアウトが自動的に調整されるデザイン手法。
    メディアクエリ CSSで特定の条件(画面サイズなど)に応じてスタイルを適用する仕組み。
    フレックスボックス CSS3の機能で、要素を柔軟に配置するためのレイアウトモデル。
    グリッドレイアウト 行と列の格子状の構造でページ要素を配置するCSS技術。
    セマンティックHTML 要素の見た目だけでなく意味を重視したHTMLの記述方法。
    ビューポート モバイルブラウザ上でのウェブページの表示領域を制御する設定。
    hreflang属性 多言語サイトで言語間の関係を示すリンク属性。SEOに重要。 localStorage ブラウザのストレージAPIで、データを永続的に保存する機能。
    Intl API JavaScript標準の国際化APIで、日付、数値、比較などの言語依存処理を行う。
    box-sizing CSSのボックスモデル計算方法を指定するプロパティ。
    ハイフネーション 長い単語を複数行に分割する際にハイフンを挿入する処理。
    イベント委譲 親要素に一つのイベントリスナーを設定し、複数の子要素のイベントを処理する技法。

    6. まとめ

    日本語サイトの英語版を作成する際には、単なる翻訳だけでなく、HTML、
    CSS、JavaScriptの各側面で適切な国際化対応が必要です。言語設定の正確な指定、テキスト長の違いに対応したレイアウト設計、日時や数値の言語固有表示など、多くの技術的な配慮が重要です。

    このガイドで解説したコード例は、新人エンジニアが具体的に実装するための基本的なスタートポイントとなります。実際のプロジェクトでは、より複雑なビジネス要件に対応するため、これらの基本技術を応用していくことになるでしょう。

    HTML、CSS、JavaScriptの各コード部分で一行ずつ丁寧に解説しましたが、国際化(i18n)と地域化(l10n)は継続的に学習が必要な分野です。ぜひ、このガイドを出発点として、実際のプロジェクトで経験を積みながら理解を深めていってくださいね。

    以上です。
    お読みいただきありがとうございます!

    あなたへのおすすめ