南宫NG28

网站代码基础入门:从搭建页面到完成 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 面板查看请求方法、路径、状态码和响应内容,能把“页面没显示数据”拆成具体问题。若项目尚未实现该路由,前端请求失败是正常现象,不能把示例契约当作可直接访问的在线接口。

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

[责任编辑:余非]

为您推荐