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

バイブコーディングでも、知っていると違う。HTML・CSS・JavaScriptで作るランディングページの基本

    今は、AIに「パン教室のランディングページを作って」と頼むと、それらしいページが数分でできあがります。言葉で頼んでAIにコードを書いてもらうこのやり方は「バイブコーディング」と呼ばれ、英国のCollins辞書が2025年の「今年の言葉」に選びました[1]。

    ただ、できあがったページが本当に良いかを確認し、直してほしい点を伝えるのは、頼む側の仕事です。ページの裏で動いている基本を知っていると、確認の目と頼み方がはっきり変わります。

    この記事では、記事用に作った架空のパン教室のランディングページを例に、HTML・CSS・JavaScriptのコードを見ながら、その「知っていると違う細かいこと」をまとめました。

    ランディングページは、3つのファイルで作れる

    ランディングページ(LP)は、広告や検索から来た人が最初に見る、1枚で完結するページです。商品や教室の紹介から、申し込みや問い合わせまでを1ページで案内します。

    NDシステムズは、ふだんのホームページ制作に Next.js という仕組みを使っています。ページが多いサイトや、更新が続くサイトを作るのに向いた道具です。ただ、1枚で完結するLPには大げさなことが多く、HTML・CSS・JavaScriptの3つのファイルで十分に作れます。

    3つのファイルには、それぞれ役割があります。

    • HTML:ページの骨組みと意味。「ここは見出し」「ここは申し込みのフォーム」と、内容を書きます。

    • CSS:見た目。色・文字の大きさ・並べ方を決めます。

    • JavaScript:動き。ボタンを押したときにメニューを開くなど、操作に応じた変化をつけます。

    画像
    家にたとえると、HTMLは柱と部屋の名前、CSSは内装、JavaScriptは電気で動く設備

    例に使うのは、次のようなページです。スマートフォンでは縦に1列、パソコンでは横に並べて見せています。

    画像
    記事用に作った架空のパン教室のLP。左がスマートフォン、右がパソコンで見たところ

    ファイルの置き方は、次のとおりです。

    lp/
    ├── index.html   … ページの本体(HTML)
    ├── style.css    … 見た目(CSS)
    ├── main.js      … 動き(JavaScript)
    └── images/      … 写真やイラスト

    ブラウザは、まず index.html を読み、その中に書かれた style.css・main.js・画像を順に取りにいきます。この「取りにいく順番」が、あとで出てくる表示の速さに関わります。

    画像
    ブラウザは HTML を読み、そこに書かれた CSS・JavaScript・画像を取りにいく

    HTML:最初の数行で、スマートフォンでの見え方が決まる

    HTMLの最初の数行は、どのLPでもほぼ同じです。AIが書いたコードにも必ず入っていますが、1行ずつ意味があります。

    <!doctype html>
    <html lang="ja">
    <head>
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <title>週末のパン教室|こむぎ堂</title>
    </head>
    • <!doctype html>:今のHTMLの決まりで書いた文書だと、ブラウザに伝えます。

    • lang="ja":日本語で書かれたページだと伝えます。

    • charset="utf-8":文字の符号の種類です。抜けると文字化けの原因になります。

    • viewport:スマートフォンの画面の幅に合わせて表示するための1行です。

    いちばん影響が大きいのは viewport です。この1行がないと、スマートフォンのブラウザは、ページを980pxほどのパソコン向けの幅で描いてから、画面に縮めて表示することがあります。その場合、画面の幅で切り替えるCSSを書いていても、スマートフォン向けの形に切り替わらないことがあります。

    画像
    同じページを、viewport の1行を消して表示した例(左)。パソコン向けの形が縮んで表示され、文字が読めないほど小さくなる

    HTML:見た目ではなく、意味でタグを選ぶ

    HTMLのタグは、見た目ではなく「その部分が何か」を表すものです。例のLPでは、ページを次のように分けています。

    <header class="site-header">…ロゴとメニュー…</header>
    <main>
      <section class="hero">
        <h1>2時間で、食パンが焼ける。週末のパン教室</h1>
        …
      </section>
      <section id="features">
        <h2>教室の特徴</h2>
        …
      </section>
    </main>
    <footer class="site-footer">…</footer>

    すべてを <div> で書いても、見た目は同じにできます。ただ、<header> <nav> <main> <footer> で分けておくと、読み上げソフトを使う人に、今どの部分にいるかの手がかりを伝えられます。あとでページを直す人にとっても、どこに何があるかが読み取りやすくなります。

    見出しも同じです。文字を大きくしたいから <h2> を使うのではなく、話の区切りに <h2>、その中の小さな区切りに <h3> を使います。大きさは、CSSで決めます。多くの読み上げソフトは見出しから見出しへ移動できるため、見出しの順番がそのまま目次の役割をします。

    画像
    ページを意味で分けたときの構造。見出しは h1 → h2 → h3 の順に、話の区切りに合わせる

    HTML:押すものは button、移動するものは a

    AIが書いたコードで見落としやすいのが、<div> に「クリックしたら動く」処理を付けたボタンです。マウスでは問題なく押せますが、キーボードでは選べず、押せないことがあります。

    HTMLの <button> には、Tabキーで選び、EnterキーやSpaceキーで押せる仕組みが最初から入っています。<div> で作ると、この仕組みが失われます。

    使い分けは、次のとおりです。

    • 別の場所へ移動する:<a href="#contact">(リンク)

    • その場で何かを動かす:<button type="button">(メニューを開く、など)

    • フォームを送る:<button type="submit">

    画像
    移動はリンク、その場の操作はボタン。div で作ったボタンは、キーボードで押せない

    CSS:スマートフォンの形を先に書く

    CSSは、まずスマートフォン(狭い画面)の形を書き、画面が広いときだけ並べ方を変える、という順番で書くと整理しやすくなります。この書き方を「モバイルファースト」と呼びます。

    /* まず、スマートフォンの形(1列) */
    .cards {
      display: grid;
      grid-template-columns: 1fr;
      gap: 1rem;
    }
    
    /* 画面の幅が 768px 以上のときだけ、3列に */
    @media (min-width: 768px) {
      .cards { grid-template-columns: repeat(3, 1fr); }
    }

    @media (min-width: 768px) は「画面の幅が768px以上のとき」という条件です。この条件の中には、広い画面で変える点だけを書きます。スマートフォンから見られることが多いLPでは、スマートフォンの形が土台になります。

    画像
    狭い画面の形を土台にし、広い画面では並べ方だけを変える

    CSS:並べ方は Flexbox と Grid で

    要素を並べる方法は、主に2つあります。

    • Flexbox(display: flex):1方向に並べるのが得意です。ヘッダーのロゴとメニューを左右に分ける、といった使い方をします。

    • Grid(display: grid):縦と横の両方を決めて並べるのが得意です。カードを3列に並べる、写真と文章を左右に置く、といった使い方をします。

    例のLPでは、ヘッダーに Flexbox、カードと最初の画面(写真と見出し)に Grid を使っています。AIに頼むときも「カードは Grid で、スマートフォンでは1列、パソコンでは3列に」と伝えると、意図に近いコードが返ってきます。

    画像
    Flexbox は1方向、Grid は縦横の両方

    色や余白は、最初に変数としてまとめておくと、あとで直しやすくなります。

    :root {
      --color-text: #3a3029;
      --color-bg: #fbf6ee;
      --color-accent: #9c4a2f;
      --space: 1rem;
    }
    .button { background: var(--color-accent); }

    「ボタンの色を少し明るく」と頼むときも、直す場所が1か所で済みます。

    画像:幅と高さを書き、遅れて読み込む

    画像の書き方には、表示の速さと見やすさに関わる細かい点がいくつかあります。

    <!-- 最初の画面に見える写真 -->
    <img src="images/hero.webp" alt="焼き上がった山型の食パンと、粉をふった木の台"
         width="1200" height="800" fetchpriority="high">
    
    <!-- 下のほうにある画像 -->
    <img src="images/feature-1.webp" alt="" width="600" height="400" loading="lazy">

    width と height を書く

    画像に width と height を書いておくと、ブラウザは画像が届く前に、その縦横の比で場所を空けておけます。書かないと、画像が届いた瞬間に下の文章が押し下げられ、読んでいた場所がずれます。CSSで幅を100%にしていても、比を伝えるために書いておきます。

    画像
    幅と高さを書かないと、画像が届いた瞬間に文章が下にずれる

    下のほうの画像は、遅れて読み込む

    loading="lazy" を付けた画像は、画面に近づいてから読み込まれます。最初の画面に見えない画像を後回しにすることで、最初の表示が軽くなります。

    ただし、最初の画面に見える大きな写真には付けません。いちばん先に見せたい写真の読み込みが遅れるためです。例のLPでは、最初の写真に fetchpriority="high"(先に読み込む)を付け、下の3枚に loading="lazy" を付けています。

    画像
    最初の画面の写真はすぐに、下のほうの画像は近づいてから読み込む

    alt には、画像が伝えている内容を書く

    alt は、画像が表示されないときや、読み上げソフトで読むときに使われる文章です。画像が伝えている内容を短く書きます。飾りの画像は、alt=""(空)にします。例のLPでは、カードの小さなイラストは見出しと内容が重なるため、空にしています。

    画像の形式は、JPEGやPNGより軽くなりやすい WebP を使っています。

    表示の速さ:Googleが示す3つの目安

    表示の速さや見やすさには、Googleが「Core Web Vitals」として示している3つの目安があります[2]。

    • LCP(いちばん大きな部分が表示されるまで):2.5秒以内

    • INP(操作してから画面が反応するまで):200ミリ秒以内

    • CLS(表示中のずれの大きさ):0.1以下

    どれも、スマートフォンとパソコンのそれぞれで、ページを開いた回数の75%が満たしているかを見るのが目安とされています[2]。先ほどの画像の幅と高さは CLS に、最初の写真を先に読み込むことは LCP に関わります。

    画像
    Core Web Vitals の3つの目安(web.dev の資料から作成)

    JavaScriptの読み込み方も、速さに関わります。

    <script src="main.js" defer></script>

    defer を付けると、ブラウザはHTMLを最後まで読み終えてから、JavaScriptを実行します。付けないと、JavaScriptを読み込む間、ページを描く作業が止まることがあります。

    JavaScript:動かなくても、内容は読めるように

    LPに必要なJavaScriptは、多くありません。例のLPで使っているのは、スマートフォンのメニューを開け閉めする部分だけです。

    const button = document.querySelector('.menu-button');
    const nav = document.getElementById('site-nav');
    
    button.addEventListener('click', () => {
      const open = button.getAttribute('aria-expanded') === 'true';
      button.setAttribute('aria-expanded', String(!open)); // 開いた・閉じたを伝える
      nav.classList.toggle('is-open', !open);
    });

    ボタンに付けた aria-expanded は、メニューが開いているかどうかを、読み上げソフトに伝えるための印です。見た目を切り替えるだけでなく、この印も一緒に書き換えます。

    もう1つの工夫は、JavaScriptが動かないときにメニューを隠さないことです。JavaScriptが動くときだけ、ページに js という印を付け、その印があるときだけメニューを畳むようにしています。

    <script>document.documentElement.classList.add('js')</script>
    .js .site-nav { display: none; }          /* JavaScript が動くときだけ畳む */
    .js .site-nav.is-open { display: block; } /* ボタンで開く */

    こうしておくと、JavaScriptの読み込みに失敗しても、メニューのリンクはそのまま見えて使えます。

    画像
    左から、JavaScriptが動かないとき(リンクがそのまま見える)、閉じたとき、開いたとき

    ページ内のリンクで、なめらかに移動させる動きは、JavaScriptがなくても CSS の1行でできます。

    html { scroll-behavior: smooth; }
    
    /* 動きを減らす設定にしている人には、動かさない */
    @media (prefers-reduced-motion: reduce) {
      html { scroll-behavior: auto; }
    }

    パソコンやスマートフォンで「視差効果を減らす」「アニメーションを減らす」設定をしている人には、動きを止めます。

    フォーム:入力欄と名前を結びつける

    申し込みのフォームでは、入力欄ごとに <label> を付け、for と id で結びつけます。

    <label for="email">メールアドレス</label>
    <input id="email" name="email" type="email" autocomplete="email" required>
    • <label for="email"> と id="email":読み上げソフトが「メールアドレス、入力欄」と読めるようになります。ラベルを押しても、入力欄が選ばれます。

    • type="email":スマートフォンで、@ の入ったキーボードが出ます。形の誤りも、送る前にブラウザが知らせます。

    • autocomplete="email":ブラウザに保存した情報で、自動入力できます。

    • required:空のまま送れないようにします。

    画像
    label と入力欄を for と id で結びつける。入力欄の種類で、スマートフォンのキーボードも変わる

    なお、HTML・CSS・JavaScriptのファイルだけでは、フォームの内容をメールで受け取ることはできません。送られた内容を受け取る仕組み(フォームの送信サービスや、サーバーの処理)が別に必要です。AIに頼むときも、送信先をどうするかは最初に決めておきます。

    見やすさ:文字と背景の差

    文字と背景の色の差は「コントラスト比」という数字で確かめられます。ウェブのアクセシビリティの国際的な基準(WCAG)では、ふつうの文字で4.5:1以上、大きな文字で3:1以上が求められています[3]。

    例のLPのボタンは、白い文字に茶色(#9c4a2f)の地で、比は約6.1:1です。淡いオレンジ(#e0a080)の地に白い文字にすると、約2.2:1まで下がり、基準に届きません。おしゃれに見える淡い色の組み合わせほど、読みにくくなりがちです。

    画像
    同じ白い文字でも、地の色で読みやすさが変わる。ふつうの文字は 4.5:1 以上が目安

    キーボードで移動したとき、今どこを選んでいるかの枠(フォーカスの枠)も、消さずに見えるようにしておきます。

    a:focus-visible, button:focus-visible {
      outline: 3px solid #2f4866;
      outline-offset: 3px;
    }

    検索とSNS:head に書く、見えない情報

    ページの <head> には、画面には出ないものの、検索結果やSNSでの見え方を決める情報を書きます。

    <title>週末のパン教室|こむぎ堂</title>
    <meta name="description" content="初めての方でも、2時間で食パンが焼ける週末のパン教室です。…">
    
    <meta property="og:title" content="週末のパン教室|こむぎ堂">
    <meta property="og:type" content="website">
    <meta property="og:url" content="https://example.com/">
    <meta property="og:image" content="https://example.com/images/ogp.jpg">
    <meta property="og:description" content="初めての方でも、2時間で食パンが焼ける週末のパン教室です。">
    <meta name="twitter:card" content="summary_large_image">
    • <title>:ブラウザのタブや、検索結果の見出しに使われます。

    • description:ページの説明です。検索結果の説明文は、主にページの本文から作られ、この説明のほうが内容を正確に表すときに使われることがあります。

    • og: で始まる行(OGP):LINEやFacebookなどでURLを共有したときに出る、題・説明・画像を決めます。OGPの決まりでは、og:title og:type og:image og:url の4つが必須です[4]。

    OGPの画像のURLは、https:// から始まる完全な形で書きます。書き忘れると、共有したときに画像の出ない、さみしい見え方になります。

    画像
    OGP の各行が、共有したときの表示のどこに出るか

    AIに頼むときは、こう伝える

    ここまでの細かい点を知っていると、AIへの頼み方を具体的にできます。たとえば「パン教室のLPを作って」だけで頼むより、次のように条件を添えたほうが、確認と手直しの手間が減ります。

    1. 「HTML・CSS・JavaScriptの3つのファイルで。スマートフォンの形を先に書き、768px以上で並べ方を変えて」

    2. 「header・nav・main・section・footer で分け、見出しは h1 を1つ、その下に h2 で」

    3. 「メニューを開くボタンは button 要素で。aria-expanded も切り替えて」

    4. 「画像には width と height を書き、最初の写真以外は loading="lazy" に」

    5. 「フォームの入力欄には label を付け、メールは type="email" に」

    6. 「title・description・OGP の4つの必須の項目を head に」

    できあがったあとも、同じ点を一つずつ確認します。知らない言葉は、そのままAIに「この1行は何のためのものか」と聞くと、学ぶきっかけにもなります。

    画像
    漠然とした頼み方と、条件を添えた頼み方

    Next.js にするか、HTMLにするか

    NDシステムズがふだん使っている Next.js は、ページが多いサイト、ブログやお知らせを続けて増やすサイト、データとつながるサイトで力を発揮します。Next.js で作ったサイトも、静的な HTML・CSS・JavaScript のファイルとして書き出せます。

    一方、1枚で完結し、内容の変更も少ないLPなら、HTML・CSS・JavaScriptの3つのファイルで十分です。準備する道具が少なく、どのサーバーにも置けて、あとから直す人も中身を読みやすくなります。

    画像
    ページの数と更新の多さで、作り方を選ぶ

    公開する前に確認すること

    最後に、公開する前に確認する点をまとめます。AIに作ってもらったページでも、自分で書いたページでも同じです。

    画像
    公開する前の確認の一覧
    • スマートフォンの実機で、文字の大きさとボタンの押しやすさを見る

    • 画面の幅を変えて、768px の前後で崩れないかを見る

    • Tabキーだけで、メニュー・ボタン・フォームを操作できるかを見る

    • Chrome の Lighthouse(ページの速さや見やすさを点検する機能)で、表示の速さとアクセシビリティを確認する

    • URLをLINEなどに貼って、OGPの画像と題が出るかを見る

    まとめ

    バイブコーディングで、LPの形はすぐにできるようになりました。それでも、viewport の1行、button と div の違い、画像の幅と高さのような細かい点は、知っていないと確認できず、頼むこともできません。

    コードを全部書けなくても、裏で何が動いているかを知っていると、AIの書いたコードを確認し、直してほしい点を言葉にできます。NDシステムズも、AIを使いながら、こうした基本を一つずつ確認して制作しています。

    NDシステムズのサービスについて

    NDシステムズは、月額制のホームページ制作をお引き受けしています。制作の費用を月額に含め、公開後の更新と改善まで続けてお手伝いします。初回の無料相談(オンライン・30分)は、お問い合わせのフォームまたはメールで承ります。

    参考文献

    1. 'Vibe coding' named word of the year by Collins dictionary(The Korea Times、2025年11月6日)(英語)

    2. Web Vitals(web.dev)

    3. Understanding SC 1.4.3: Contrast (Minimum)(W3C)(英語)

    4. The Open Graph protocol(英語)

     
     
    福岡県久留米市のNDシステムズです。IT・AI、語学、会計、数学、九州北部の風景などについて、調べて考えたことを書いています。記事は筆者が個人として調べた執筆時点の内容で、専門家の助言ではありません。最新の情報は出典でご確認ください。

    あなたへのおすすめ