• 视频
  • 直播
  • 凤凰卫视
  • 财经
  • 娱乐
  • 体育
  • 时尚
  • 汽车
  • 房产
  • 科技
  • 军事
  • 文化
  • 旅游
  • 佛教
  • 国学
  • 数码
  • 注册登录
    站内 输入关键词

    网站代码基础入门:从搭建页面到完成 API 联调的 4 步

    网站代码基础入门:从搭建页面到完成 API 联调的 4 步

    网站代码入门可以按“先显示页面、再调整样式、接着添加交互、最后连接接口”的顺序进行。HTML 负责内容结构,CSS 控制呈现,JavaScript 处理用户操作;需要与服务器交换数据时,再按明确的 API 契约发起请求。

    第一步:准备文件并搭出页面结构

    新建一个项目文件夹,放入 index.html、styles.css 和 app.js。先让 HTML 具备可见内容,再逐步添加样式和行为,出错时更容易定位是哪一层的问题。下面的页面包含输入框、按钮和显示结果的区域。

    <!doctype html>
    <html lang="zh-CN">
    <head>
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <title>问候页面</title>
      <link rel="stylesheet" href="styles.css">
      <script src="app.js" defer></script>
    </head>
    <body>
      <main class="card">
        <h1>今日问候</h1>
        <label for="name">姓名</label>
        <input id="name" type="text" placeholder="输入姓名">
        <button id="submit" type="button">生成问候</button>
        <p id="result" aria-live="polite">输入姓名后点击按钮。</p>
      </main>
    </body>
    </html>

    label 的 for 与输入框的 id 对应,点击文字也能定位输入框;defer 让脚本在 HTML 解析后运行,避免脚本执行时页面元素尚未生成。把文件保存后在浏览器打开,应该能看到标题、输入框和按钮。此时按钮还没有功能,这是预期结果。

    第二步:用 CSS 调整布局和可读性

    样式放在 styles.css,选择器通过元素、类名或 ID 找到 HTML 内容。先处理页面宽度、间距和输入控件,不必一开始追求复杂效果。

    body {
      margin: 0;
      padding: 32px 16px;
      font-family: sans-serif;
      background: #f3f5f7;
    }
    .card {
      max-width: 420px;
      margin: 0 auto;
      padding: 24px;
      background: white;
      border-radius: 12px;
    }
    input, button {
      box-sizing: border-box;
      width: 100%;
      margin-top: 12px;
      padding: 10px;
    }
    

    max-width 限制卡片在宽屏上的尺寸,左右自动外边距使它居中;窄屏时卡片会随可用宽度缩小。若改了 CSS 却看不到变化,先确认链接文件名和相对路径,再保存文件并刷新页面。

    第三步:添加前端交互并处理空输入

    JavaScript 可以监听按钮点击、读取输入值并更新结果。下面的逻辑只在浏览器本地生成问候,不需要服务器或接口,因此适合先验证页面元素和事件是否连通。

    const nameInput = document.querySelector('#name');
    const submitButton = document.querySelector('#submit');
    const result = document.querySelector('#result');
    
    submitButton.addEventListener('click', () => {
      const name = nameInput.value.trim();
      if (!name) {
        result.textContent = '请先输入姓名';
        return;
      }
      result.textContent = `你好,${name}!`;
    });

    这里用 trim() 去掉姓名前后的空格,空字符串会显示提示并提前结束;有内容时才更新结果。输入姓名后点击按钮,若结果改变,说明 HTML 的 ID 与脚本选择器匹配,事件监听也已生效。若点击没有反应,打开浏览器开发者工具的 Console,检查脚本路径、拼写或语法错误。

    第四步:按契约把页面连接到 API

    需要由服务器生成问候或读取业务数据时,前端不能只凭猜测调用接口,前后端应先约定请求和响应。以下是一个自建项目可采用的示例契约,并不表示某个现成服务已经提供该接口:

    • 请求:GET /api/greeting?name=林,姓名作为查询参数。
    • 成功:HTTP 状态码为 200,响应类型为 JSON,内容形如 {"message":"你好,林!"}。
    • 参数缺失:服务器返回 400,并以 JSON 错误对象说明原因;具体错误字段也应纳入契约。

    若服务器按此契约实现,可用 fetch 发出请求。将本地生成结果的点击处理替换为下面的函数和监听逻辑;只有接口确实存在并返回约定数据时,页面才会显示服务器结果。

    async function requestGreeting(name) {
      const query = new URLSearchParams({ name });
      const response = await fetch(`/api/greeting?${query}`);
      const data = await response.json();
      if (!response.ok) {
        throw new Error(data.error || `HTTP ${response.status}`);
      }
      if (typeof data.message !== 'string') {
        throw new Error('响应中缺少 message 字符串');
      }
      return data.message;
    }
    
    submitButton.addEventListener('click', async () => {
      const name = nameInput.value.trim();
      if (!name) {
        result.textContent = '请先输入姓名';
        return;
      }
      result.textContent = '正在请求…';
      try {
        result.textContent = await requestGreeting(name);
      } catch (error) {
        result.textContent = `请求失败:${error.message}`;
      }
    });

    URLSearchParams 会处理查询参数的编码,response.ok 用来区分成功状态与 HTTP 错误;校验 message 可以发现响应结构与约定不一致的情况。真实项目还应由服务端明确错误格式,并根据需要校验响应的内容类型。

    联调异常怎么定位

    若出现 404,检查请求路径是否与后端路由一致;若浏览器提示跨域,确认前端和接口的部署来源,以及服务端是否允许该来源访问;若 JSON 解析失败,检查服务端返回体是否为有效 JSON。使用开发者工具的 Network 面板查看请求方法、路径、状态码和响应内容,能把“页面没显示数据”拆成具体问题。若项目尚未实现该路由,前端请求失败是正常现象,不能把示例契约当作可直接访问的在线接口。

    完成这四步后,你会得到一个结构清楚、样式可调整、交互可验证的页面;要接入真实数据,则需要前后端共同落实请求路径、参数、状态码和响应字段。先让本地交互正确,再逐项对照契约联调,是网站代码入门时较稳妥的实现路径。

    [责任编辑:王志郁]

    为您推荐