diff --git "a/14 \346\235\216\344\277\212\345\205\264/20231207 AJAX \346\246\202\345\277\265\345\222\214 axios \344\275\277\347\224\250.md" "b/14 \346\235\216\344\277\212\345\205\264/20231207 AJAX \346\246\202\345\277\265\345\222\214 axios \344\275\277\347\224\250.md" new file mode 100644 index 0000000000000000000000000000000000000000..1b091147edd134442b99e0efba88974331805086 --- /dev/null +++ "b/14 \346\235\216\344\277\212\345\205\264/20231207 AJAX \346\246\202\345\277\265\345\222\214 axios \344\275\277\347\224\250.md" @@ -0,0 +1,1028 @@ +## 01.AJAX 概念和 axios 使用 + +### 目标 + +了解 AJAX 概念并掌握 axios 库基本使用 + + + +### 讲解 + +1. 什么是 AJAX ? [mdn](https://developer.mozilla.org/zh-CN/docs/Web/Guide/AJAX/Getting_Started) + + * 使用浏览器的 XMLHttpRequest 对象 与服务器通信 + + * 浏览器网页中,使用 AJAX技术(XHR对象)发起获取省份列表数据的请求,服务器代码响应准备好的省份列表数据给前端,前端拿到数据数组以后,展示到网页 + + ![image-20230403173156484](https://s2.loli.net/2023/12/07/jY52LokwtmSTI6f.png) + +2. 什么是服务器? + + * 可以暂时理解为提供数据的一台电脑 + +3. 为何学 AJAX ? + + * 以前我们的数据都是写在代码里固定的, 无法随时变化 + * 现在我们的数据可以从服务器上进行获取,让数据变活 + +4. 怎么学 AJAX ? + + * 这里使用一个第三方库叫 axios, 后续在学习 XMLHttpRequest 对象了解 AJAX 底层原理 + * 因为 axios 库语法简单,让我们有更多精力关注在与服务器通信上,而且后续 Vue,React 学习中,也使用 axios 库与服务器通信 + +5. 需求:从服务器获取省份列表数据,展示到页面上(体验 axios 语法的使用) + + > 获取省份列表数据 - 目标资源地址:http://hmajax.itheima.net/api/province + + * 完成效果: + + ![image-20230220113157010](https://s2.loli.net/2023/12/07/WuZSrHGV1joiex9.png) + +6. 接下来讲解 axios 语法,步骤: + + 7. 引入 axios.js 文件到自己的网页中 + + > axios.js文件链接: https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js + + 8. 明确axios函数的使用语法 + + ```js + axios({ + url: '目标资源地址' + }).then((result) => { + // 对服务器返回的数据做后续处理 + }) + ``` + + > 注意:请求的 url 地址, 就是标记资源的网址 + > + > 注意:then 方法这里先体验使用,由来后续会讲到 + + + +9. 对应代码 + + ```html + + + + + + + + AJAX概念和axios使用 + + + + +

+ + + + + + ``` + + + +### 小结 + +1. AJAX 有什么用? + +
+ 答案 + +
+ + + +2. AJAX 如何学: + +
+ 答案 + +
+ + + +3. 这一节 axios 体验步骤(语法)? + +
+ 答案 + +
+ + + +## 02.认识 URL + +### 目标 + +了解 URL 的组成和作用 + + + +### 讲解 + +1. 为什么要认识 URL ? [mdn](https://developer.mozilla.org/zh-CN/docs/Web/Guide/AJAX/Getting_Started) + + * 虽然是后端给我的一个地址,但是哪部分标记的是服务器电脑,哪部分标记的是资源呢?所以为了和服务器有效沟通我们要认识一下 + +2. 什么是 URL ? + + * 统一资源定位符,简称网址,用于定位网络中的资源(资源指的是:网页,图片,数据,视频,音频等等) + + ![image-20230403185206384](https://s2.loli.net/2023/12/07/Ua4EL7TkcAxdjpr.png) + +3. URL 的组成? + + * 协议,域名,资源路径(URL 组成有很多部分,我们先掌握这3个重要的部分即可) + + ![image-20230403185305934](https://s2.loli.net/2023/12/07/toZ9XjWvFcd8yRM.png) + + + +4. 什么是 http 协议 ? + + * 叫超文本传输协议,规定了浏览器和服务器传递数据的格式(而格式具体有哪些稍后我们就会学到) + + ![image-20230403185356997](https://s2.loli.net/2023/12/07/yjTftKXv43lPGhM.png) + +5. 什么是域名 ? + + * 标记服务器在互联网当中的方位,网络中有很多服务器,你想访问哪一台,就需要知道它的域名才可以 + + ![image-20230403185406674](https://s2.loli.net/2023/12/07/VdGvzQEqDuhcKbr.png) + +6. 什么是资源路径 ? + + * 一个服务器内有多个资源,用于标识你要访问的资源具体的位置 + + ![image-20230403185428276](https://s2.loli.net/2023/12/07/j9mzhO7P2k5cxZL.png) + +7. 接下来做个需求,访问新闻列表的 URL 网址,打印新闻数据 + + * 效果图如下: + + ![image-20230220122455915](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230220122455915.png) + + > 新闻列表数据 URL 网址:http://hmajax.itheima.net/api/news + + ```js + axios({ + url: 'http://hmajax.itheima.net/api/news' + }).then(result => { + console.log(result) + }) + ``` + + > url解释:从黑马服务器使用http协议,访问/api/news路径下的新闻列表资源 + + + +### 小结 + +1. URL 是什么? + +
+ 答案 + +
+ + + +2. 请解释这个 URL,每个部分作用? + + http://hmajax.itheima.net/api/news + +
+ 答案 + +
+ + + +## 03.URL 查询参数 + +### 目标 + +掌握-通过URL传递查询参数,获取匹配的数据 + + + +### 讲解 + +1. 什么是查询参数 ? + + * 携带给服务器额外信息,让服务器返回我想要的某一部分数据而不是全部数据 + + * 举例:查询河北省下属的城市列表,需要先把河北省传递给服务器 + + ![image-20230404101257205](https://s2.loli.net/2023/12/07/zQ5C2nXGVkiB4uN.png) + +2. 查询参数的语法 ? + + * 在 url 网址后面用?拼接格式:http://xxxx.com/xxx/xxx?参数名1=值1&参数名2=值2 + * 参数名一般是后端规定的,值前端看情况传递即可 + +3. axios 如何携带查询参数? + + * 使用 params 选项即可 + + ```js + axios({ + url: '目标资源地址', + params: { + 参数名: 值 + } + }).then(result => { + // 对服务器返回的数据做后续处理 + }) + ``` + + > 查询城市列表的 url地址:[http://hmajax.itheima.net/api/city](http://hmajax.itheima.net/api/city?pname=河北省) + > + > 参数名:pname (值要携带省份名字) + +4. 需求:获取“河北省”下属的城市列表,展示到页面,对应代码: + + ```html + + + + + + + 查询参数 + + + +

+ + + + + ``` + + + +### 小结 + +1. URL 查询参数有什么用? + +
+ 答案 + +
+ + + +2. axios 要如何携带查询参数? + +
+ 答案 + +
+ + + +## 04.案例-查询-地区列表 + +### 目标 + +巩固查询参数的使用,并查看多对查询参数如何传递 + + + +### 讲解 + +1. 需求:根据输入的省份名字和城市名字,查询下属地区列表 + + * 完成效果如下: + + ![image-20230220125428695](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230220125428695.png) + + * 相关参数 + + > 查询地区: http://hmajax.itheima.net/api/area + > + > 参数名: + > + > pname:省份名字 + > + > cname:城市名字 + + + +2. 正确代码如下: + + ```js + /* + 获取地区列表: http://hmajax.itheima.net/api/area + 查询参数: + pname: 省份或直辖市名字 + cname: 城市名字 + */ + // 目标: 根据省份和城市名字, 查询地区列表 + // 1. 查询按钮-点击事件 + document.querySelector('.sel-btn').addEventListener('click', () => { + // 2. 获取省份和城市名字 + let pname = document.querySelector('.province').value + let cname = document.querySelector('.city').value + + // 3. 基于axios请求地区列表数据 + axios({ + url: 'http://hmajax.itheima.net/api/area', + params: { + pname, + cname + } + }).then(result => { + // console.log(result) + // 4. 把数据转li标签插入到页面上 + let list = result.data.list + console.log(list) + let theLi = list.map(areaName => `
  • ${areaName}
  • `).join('') + console.log(theLi) + document.querySelector('.list-group').innerHTML = theLi + }) + }) + ``` + + + +### 小结 + +1. ES6 对象属性和值简写的前提是什么? + +
    + 答案 + +
    + + + +## 05.常用请求方法和数据提交 + +### 目标 + +掌握如何向服务器提交数据,而不单单是获取数据 + + + +### 讲解 + +1. 想要提交数据,先来了解什么是请求方法 + + * 请求方法是一些固定单词的英文,例如:GET,POST,PUT,DELETE,PATCH(这些都是http协议规定的),每个单词对应一种对服务器资源要执行的操作 + + ![image-20230220130833363](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230220130833363.png) + + ![image-20230404104319428](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230404104319428.png) + + * 前面我们获取数据其实用的就是GET请求方法,但是axios内部设置了默认请求方法就是GET,我们就没有写 + + * 但是提交数据需要使用POST请求方法 + +2. 什么时候进行数据提交呢? + + * 例如:多端要查看同一份订单数据,或者使用同一个账号进行登录,那订单/用户名+密码,就需要保存在服务器上,随时随地进行访问 + + ![image-20230404104328384](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230404104328384.png) + + ![image-20230404104333584](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230404104333584.png) + +3. axios 如何提交数据到服务器呢? + + * 需要学习,method 和 data 这2个新的选项了(大家不用担心,这2个学完,axios常用的选项就都学完了) + + ```js + axios({ + url: '目标资源地址', + method: '请求方法', + data: { + 参数名: 值 + } + }).then(result => { + // 对服务器返回的数据做后续处理 + }) + ``` + + + +4. 需求:注册账号,提交用户名和密码到服务器保存 + + > 注册用户 URL 网址:http://hmajax.itheima.net/api/register + > + > 请求方法:POST + > + > 参数名: + > + > username:用户名(要求中英文和数字组成,最少8位) + > + > password:密码(最少6位) + + ![image-20230404104350387](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230404104350387.png) + +5. 正确代码如下: + + ```js + /* + 注册用户:http://hmajax.itheima.net/api/register + 请求方法:POST + 参数名: + username:用户名(中英文和数字组成,最少8位) + password:密码 (最少6位) + + 目标:点击按钮,通过axios提交用户和密码,完成注册 + */ + document.querySelector('.btn').addEventListener('click', () => { + axios({ + url: 'http://hmajax.itheima.net/api/register', + method: 'POST', + data: { + username: 'itheima007', + password: '7654321' + } + }) + }) + ``` + + + + + +### 小结 + +1. 请求方法最常用的是哪2个,分别有什么作用? + +
    + 答案 + +
    + +2. axios 的核心配置项? + +
    + 答案 + +
    + + + +## 06.axios 错误处理 + +### 目标 + +掌握接收 axios 响应错误信息的处理语法 + + + +### 讲解 + +1. 如果注册相同的用户名,则会遇到注册失败的请求,也就是 axios 请求响应失败了,你会在控制台看到如图的错误: + + ![image-20230220131753051](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230220131753051.png) + +2. 在 axios 语法中要如何处理呢? + + * 因为,普通用户不会去控制台里看错误信息,我们要编写代码拿到错误并展示给用户在页面上 + +3. 使用 axios 的 catch 方法,捕获这次请求响应的错误并做后续处理,语法如下: + + ```js + axios({ + // ...请求选项 + }).then(result => { + // 处理成功数据 + }).catch(error => { + // 处理失败错误 + }) + ``` + +4. 需求:再次重复注册相同用户名,提示用户注册失败的原因 + + ![image-20230404104440224](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230404104440224.png) + + ![image-20230404104447501](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230404104447501.png) + +5. 对应代码 + + ```js + document.querySelector('.btn').addEventListener('click', () => { + axios({ + url: 'http://hmajax.itheima.net/api/register', + method: 'post', + data: { + username: 'itheima007', + password: '7654321' + } + }).then(result => { + // 成功 + console.log(result) + }).catch(error => { + // 失败 + // 处理错误信息 + console.log(error) + console.log(error.response.data.message) + alert(error.response.data.message) + }) + }) + ``` + + + +### 小结 + +1. axios 如何拿到请求响应失败的信息? + +
    + 答案 + +
    + + + +## 07.HTTP 协议-请求报文 + +### 目标 + +了解 HTTP 协议中,请求报文的组成和作用 + + + +### 讲解 + +1. 首先,HTTP 协议规定了浏览器和服务器返回内容的格式 + +2. 请求报文:是浏览器按照协议规定发送给服务器的内容,例如刚刚注册用户时,发起的请求报文: + + ![image-20230404104508764](https://s2.loli.net/2023/12/07/bcwQ7JUP3iqNE8D.png) + + ![image-20230220132229960](https://s2.loli.net/2023/12/07/drNwTHkSsfvpVDR.png) + +3. 这里的格式包含: + + * 请求行:请求方法,URL,协议 + * 请求头:以键值对的格式携带的附加信息,比如:Content-Type(指定了本次传递的内容类型) + * 空行:分割请求头,空行之后的是发送给服务器的资源 + * 请求体:发送的资源 + +4. 我们切换到浏览器中,来看看刚才注册用户发送的这个请求报文以及内容去哪里查看呢 + +5. 代码:直接在上个代码基础上复制,然后运行查看请求报文对应关系即可 + + + +### 小结 + +1. 浏览器发送给服务器的内容叫做,请求报文 + +2. 请求报文的组成是什么? + +
    + 答案 + +
    + +3. 通过 Chrome 的网络面板如何查看请求体? + + ![image-20230220132617016](https://s2.loli.net/2023/12/07/hjq3sb4Lz58rxyM.png) + + + +## 08.请求报文-错误排查 + +### 目标 + +了解学习了查看请求报文之后的作用,可以用来辅助错误排查 + + + +### 讲解 + +1. 学习了查看请求报文有什么用呢? + * 可以用来确认我们代码发送的请求数据是否真的正确 +2. 配套模板代码里,对应 08 标题文件夹里是我同桌的代码,它把登录也写完了,但是无法登录,我们来到模板代码中,找到运行后,在不逐行查看代码的情况下,查看请求报文,看看它登录提交的相关信息对不对,帮他找找问题出现的原因 +3. 发现请求体数据有问题,往代码中定位,找到类名写错误了 +4. 代码:在配套文件夹素材里,找到需要对应代码,直接运行,根据报错信息,找到错误原因 + + + +### 小结 + +1. 学会了查看请求报文,对实际开发有什么帮助呢? + +
    + 答案 + +
    + + + +## 09.HTTP 协议-响应报文 + +### 目标 + +了解响应报文的组成 + + + +### 讲解 + +1. 响应报文:是服务器按照协议固定的格式,返回给浏览器的内容 + + ![image-20230404104556531](https://s2.loli.net/2023/12/07/RyLVuheDwY3K24b.png) + + ![image-20230220133141151](https://s2.loli.net/2023/12/07/QgGviCd3KBjzDnR.png) + +2. 响应报文的组成: + + * 响应行(状态行):协议,HTTP响应状态码,状态信息 + * 响应头:以键值对的格式携带的附加信息,比如:Content-Type(告诉浏览器,本次返回的内容类型) + * 空行:分割响应头,控制之后的是服务器返回的资源 + * 响应体:返回的资源 + +3. HTTP 响应状态码: + + * 用来表明请求是否成功完成 + + * 例如:404(客户端要找的资源,在服务器上不存在) + + ![image-20230220133344116](https://s2.loli.net/2023/12/07/v8kEhT1wDCMW2Ip.png) + + + + +### 小结 + +1. 响应报文的组成? + +
    + 答案 + +
    + +2. HTTP 响应状态码是做什么的? + +
    + 答案 + +
    + + + +## 10.接口文档 + +### 目标 + +掌握接口文档的使用,配合 axios 与服务器进行数据交互 + + + +### 讲解 + +1. 接口文档:描述接口的文章(一般是后端工程师,编写和提供) + +2. 接口:指的使用 AJAX 和 服务器通讯时,使用的 URL,请求方法,以及参数,例如:[AJAX阶段接口文档](https://apifox.com/apidoc/shared-1b0dd84f-faa8-435d-b355-5a8a329e34a8) + +3. 例如:获取城市列表接口样子 + + ![image-20230404104720587](https://s2.loli.net/2023/12/07/Sw9intIuk5B2CZd.png) + +4. 需求:打开 AJAX 阶段接口文档,查看登录接口,并编写代码,完成一次登录的效果吧 + +5. 代码如下: + + ```js + document.querySelector('.btn').addEventListener('click', () => { + // 用户登录 + axios({ + url: 'http://hmajax.itheima.net/api/login', + method: 'post', + data: { + username: 'itheima007', + password: '7654321' + } + }) + }) + ``` + + + + + +### 小结 + +1. 接口文档是什么? + +
    + 答案 + +
    + +2. 接口文档里包含什么? + +
    + 答案 + +
    + + + +## 11.案例-用户登录-主要业务 + +### 目标 + +尝试通过页面获取用户名和密码,进行登录 + + + +### 讲解 + +1. 先来到备课代码中,运行完成的页面,查看要完成的登录效果(登录成功和失败) + +2. 需求:编写代码,查看接口文档,填写相关信息,完成登录业务 + +3. 分析实现的步骤 + + 1. 点击登录,获取并判断用户名和长度 + + 2. 提交数据和服务器通信 + + 3. 提示信息,反馈给用户(这节课先来完成前 2 个步骤) + + ![image-20230404104851497](https://s2.loli.net/2023/12/07/HLU9DeAqQld7rhZ.png) + +4. 代码如下: + + ```js + // 目标1:点击登录时,用户名和密码长度判断,并提交数据和服务器通信 + + // 1.1 登录-点击事件 + document.querySelector('.btn-login').addEventListener('click', () => { + // 1.2 获取用户名和密码 + const username = document.querySelector('.username').value + const password = document.querySelector('.password').value + // console.log(username, password) + + // 1.3 判断长度 + if (username.length < 8) { + console.log('用户名必须大于等于8位') + return // 阻止代码继续执行 + } + if (password.length < 6) { + console.log('密码必须大于等于6位') + return // 阻止代码继续执行 + } + + // 1.4 基于axios提交用户名和密码 + // console.log('提交数据到服务器') + axios({ + url: 'http://hmajax.itheima.net/api/login', + method: 'POST', + data: { + username, + password + } + }).then(result => { + console.log(result) + console.log(result.data.message) + }).catch(error => { + console.log(error) + console.log(error.response.data.message) + }) + }) + ``` + + + + +### 小结 + +1. 总结下用户登录案例的思路? + +
    + 答案 + +
    + + + +## 12.案例-用户登录-提示信息 + +### 目标 + +根据准备好的提示标签和样式,给用户反馈提示 + + + +### 讲解 + +1. 需求:使用提前准备好的提示框,来把登录成功/失败结果提示给用户 + + ![image-20230404104955330](https://s2.loli.net/2023/12/07/f8yL7nkAUGvd3BC.png) + + ![image-20230404105003019](E:\前端\Ajax\Ajax 资料\代码和笔记\Day01_AJAX入门\02-笔记\images\image-20230404105003019.png) + + + +2. 使用提示框,反馈提示消息,因为有4处地方需要提示框,所以封装成函数 + + 1. 获取提示框 + + 2. 封装提示框函数,重复调用,满足提示需求 + + 功能: + + 1. 显示提示框 + 2. 不同提示文字msg,和成功绿色失败红色isSuccess参数(true成功,false失败) + 3. 过2秒后,让提示框自动消失 + +3. 对应提示框核心代码: + + ```js + /** + * 2.2 封装提示框函数,重复调用,满足提示需求 + * 功能: + * 1. 显示提示框 + * 2. 不同提示文字msg,和成功绿色失败红色isSuccess(true成功,false失败) + * 3. 过2秒后,让提示框自动消失 + */ + function alertFn(msg, isSuccess) { + // 1> 显示提示框 + myAlert.classList.add('show') + + // 2> 实现细节 + myAlert.innerText = msg + const bgStyle = isSuccess ? 'alert-success' : 'alert-danger' + myAlert.classList.add(bgStyle) + + // 3> 过2秒隐藏 + setTimeout(() => { + myAlert.classList.remove('show') + // 提示:避免类名冲突,重置背景色 + myAlert.classList.remove(bgStyle) + }, 2000) + } + ``` + + + + +### 小结 + +1. 我们什么时候需要封装函数? + +
    + 答案 + +
    + +2. 如何封装一个函数呢? + +
    + 答案 + +
    + +3. 我们的提示框是如何控制出现/隐藏的? + +
    + 答案 + +
    + + + +## 13.form-serialize 插件 + +### 目标 + +使用 form-serialize 插件,快速收集目标表单范围内表单元素的值 + + + +### 讲解 + +1. 我们前面收集表单元素的值,是一个个标签获取的 + + ![image-20230404105134538](https://s2.loli.net/2023/12/07/nv1KgkqFDV7sREA.png) + +2. 如果一套表单里有很多很多表单元素,如何一次性快速收集出来呢? + + ![image-20230404105141226](https://s2.loli.net/2023/12/07/6DtGbMv3d7ZxlcT.png) + +3. 使用 form-serialize 插件提供的 serialize 函数就可以办到 + +4. form-serialize 插件语法: + + 1. 引入 form-serialize 插件到自己网页中 + + 2. 使用 serialize 函数 + + * 参数1:要获取的 form 表单标签对象(要求表单元素需要有 name 属性-用来作为收集的数据中属性名) + + * 参数2:配置对象 + * hash: + * true - 收集出来的是一个 JS 对象结构 + * false - 收集出来的是一个查询字符串格式 + * empty: + * true - 收集空值 + * false - 不收集空值 \ No newline at end of file