整合营销服务商

电脑端+手机端+微信端=数据同步管理

免费咨询热线:

8个javascript获取元素的方法

我们的日常前端开发工作中,经常会用到javascript技术,那么javascript获取元素的方法有哪些,大家都知道吗?目前获取元素属性的方法中最常见的有8个,包括innerHTML、outerHTML、innerText 、outerText、value、text()、html(),val(),让我们分别了解下应用方法吧。

1、innerHTML 属性

在读模式下,innerHTML属性返回与调用元素的所有子节点(包括元素、注释和文本节点)对应的 HTML 标记。在写模式下,innerHTML 会根据指定的值创建新的 DOM 树,然后用这个 DOM 树完全替换调用元素原先的所有子节点。下面是一个例子:

对于上面的元素来说,它的 innerHTML 属性会返回如下字符串。

2、outerHTML 属性

在读模式下,outerHTML 返回调用它的元素及所有子节点的 HTML 标签。在写模式下,outerHTML 会根据指定的 HTML 字符串创建新的 DOM 子树完全替换调用元素。下面是一个例子。

如果在元素上调用 outerHTML,会返回与上面相同的代码,包括本身。使用 outerHTML 属性以下面这种方式设置值:

这行代码完成的操作与下面这些 DOM 脚本代码一样:

结果,就是新创建的元素会取代 DOM 树中的元素。

replaceChild() 方法用新节点替换某个子节点。

语法:

3、innerText 属性

通过 innerText 属性可以操作元素中包含的所有文本内容,包括子文档树中的文本。在通过 innerText 读取值时,它会按照由浅入深的顺序,将子文档树中的所有文本拼接起来。在通过 innerText 写入值时,结果会删除元素的所有子节点,插入包含相应文本值的文本节点。下面是一个例子:

对于这个例子中的元素而言,其中 innerText 属性会返回下列字符串:

使用 innerText 属性设置这个元素内容,则只需一行代码:

执行这行代码后,页面的 HTML 代码就会变成如下所示:

设置 innerText 属性移除了先前存在的所有子节点,完全改变了 DOM 树。设置 innerText 永远只会生成当前节点的一个子文本节点,而为了确保只生成一个字文本节点,就必须要对文本进行 HTML 编码。利用这一点,可以通过 innerText 属性过滤掉 HTML 标签。方法是将 innerText 设置等于 innerText,这样就可以去掉所有 HTML 标签,比如:

执行这行代码后,就用原来的文本内容替换了容器元素中的所有内容(包括子节点,因而也就去掉了 HTML 标签)。举个栗子:

输出:

4、outerText 属性

除了作用范围扩大到了包含 调用它的节点之外,outerText 与innerText 基本上没有多大区别。在读取文本值时,outerText 与 innerText 的结果完全一样。但在写模式下,outerText 就完全不同了:outerText 不只是替换调用它的元素的子节点,而是会替换整个元素(包括子节点)。比如:

这行代码实际上相当于如下两行代码:

本质上,新的文本节点会完全取代调用 outerText 的元素。此后,该元素就从文档中被删除,无法访问。

5、value 属性

属性可设置或返回密码域的默认值。获取文本框的值。

6、text()

设置或者获取所选元素的文本内容

1)无参text():取得所有匹配元素的内容。结果是由所有匹配元素包含的文本内容组合起来的文本。返回的是一个String。

2)有参text(val):设置所有匹配元素的文本内容,与 html() 类似, 但将编码 HTML (将 “<” 和 “>” 替换成相应的HTML实体).返回一个jquery对象。

7、html():

设置或者获取所选元素的内容(包括html标记)

1)无参html():取得第一个匹配元素的html内容。这个函数不能用于XML文档。但可以用于XHTML文档,返回的是一个String。

2)有参html(val):设置每一个匹配元素的html内容。这个函数不能用于XML文档。但可以用于XHTML文档。返回一个jquery对象。

8、val()方法

主要用于获取表单元素的值如input, select 和 textarea。当在一个空集合上调用,它返回undefined;1)无参 val():获取匹配的元素集合中第一个元素的当前值。例子:HTML代码:

控制台输出:

2)有参val(val):设置每一个匹配元素的值。返回一个jquery对象。

大家对以上的8个javascript获取元素的方法是否有了一些了解呢?根据获取元素方法的不同,所应用的场景也不相同。想要熟练地使用这8种方法,就需要了解它们各个特征。更多关于前端培训的问题,欢迎咨询云和数据官网。云和数据拥有多年IT培训服务经验,采用全程面授高品质、高体验培养模式,拥有国内一体化教学管理及学员服务,助力更多学员实现高薪梦

一篇文章我给大家说明了如何从零开始搭建一个node的服务端框架,我们用到了Egg框架。Egg框架我不再过多介绍,如果有小伙伴想了解,可以回去看我以前写的文章,会有相关的介绍。这次我将在上次搭建的框架上进行延伸,讲一下如果用Egg框架连接数据库,并且实现对数据的增删查改。接下来我们直接进入主题。

安装数据库插件

我本次选用的数据库是MySQL。所以我们安装Egg官方的数据库插件即可,首先我们安装插件 egg-mysql我们在项目根目录打开命令提示符,输入命令行:npm i --save egg-mysql 。回车等待插件下载安装完成。

npm i --save egg-mysql

配置插件

命令行下载安装插件完成后,我们下一步的工作就是在项目中开启并配置egg-mysql插件。具体操作如下:

首先我们要在项目中开启数据库。找到项目中的/config/plugin.js文件我们需要在里面添加几行代码,如下所示。

//开启数据库插件
  mysql : {
    enable: true,
    package: 'egg-mysql',
  }

然后我们还要在 config/config.default.js 中配置各个环境的数据库连接信息。具体配置如下。

//添加数据库连接信息
  config.mysql = {
    // 单数据库信息配置
    client: {
      // host
      host: 'localhost',
      // 端口号
      port: '3306',
      // 用户名
      user: 'root',
      // 密码
      password: '123456',
      // 数据库名
      database: 'testdb',
    },
    // 是否加载到 app 上,默认开启
    app: true,
    // 是否加载到 agent 上,默认关闭
    agent: false,
  };

到此步骤我们的数据库插件已经安装完成并且配置好了。那我们怎么实现数据的增删查改呢?大家请继续往下看。

数据操作-新增用户

首先我们看一下怎么新增数据。我们在mysql的testdb实例中新建一个user空表。如下图所示。

我们的egg框架也遵循MVC的架构所以我们一般会在service层里面写我们逻辑处理的代码,而controller层则是获取前端数据,回传数据的控制层。所以我们操作数据库的代码是写在service文件夹里面的。

我们在app/service文件夹里面新建一个user.js文件。在里面写个新增用户的方法,该方法就是把数据存到数据库中。具体代码如下。

const Service = require('egg').Service;

class UserService extends Service {

  //新增用户data是有controller层传递过来的数据记录。
  async addUser(data) {

    const {ctx, app} = this;
    let result = {};
    try {
      data.id = 0;//定义id=0,因为数据库已经设置id为主键,并且自增。所以只需要赋值0即可。
      // 在 user 表中,插入前端提交上来的数据记录
      const info = await app.mysql.insert('user', data); 
  
      //插入成功后。
      if(info.affectedRows === 1){
        //给前端返回一个Json的对象
        result = {
          state: 0, //自定义的状态码
          msg: "添加成功", //返回的消息
          data: info.insertId, //新增的记录的id
        }
      }

    } catch (err) {
      //插入数据失败的返回结果
      result = {
        state: 1, 
        msg: err,
        data: null,
      }
    }
    
    return result
  }
};
module.exports = UserService;

然后我们在app/controller文件夹里新建一个user.js文件。在这里我们需要获取前端提交上来的数据,并且将数据处理的结果返回给前端。具体代码如下。

'use strict';

const Controller = require('egg').Controller;
/**
 * @Controller 用户管理
 */
class UserController extends Controller {

  /**
  * @summary 新增用户
  * @router post /user/add
  * @request body userAddRequest 
  * @response 200 
  */
  async addUser() {
    const { ctx } = this;

    //通过ctx.request.body的方式,可以获取到前端post方式提交上来的数据
    const data = ctx.request.body;

    //调用service层的addUser方法。并且返回相应的结果
    const userInfo = await ctx.service.user.addUser(data);
    
    //向前端接口响应数据。
    ctx.body = userInfo;
  }

}

module.exports = UserController;

最后我们定义一个路由,让前端请求访问此路由。框架会监听路由是否被访问,如果被访问了则会调用我们定义在controller层的新增用户的方法。我们在app/router.js文件中添加如下代码,即可完成路由的定义。

//新增用户路由
  router.post('/user/add', controller.user.addUser);

完成这步骤后,我们一个新增用户的功能就已经完成了。接下里我们就测试一下它的实际效果。我们运行命令:npm run dev。启动项目,然后打开网页http://127.0.0.1:7001,可以直接在swagger-ui.html页面中进行测试。结果如下图所示。

经过测试,数据已经添加完成。所以数据库连接也是正常的。

本次分享暂时先告一段落。请各位小伙伴抬起你们发财的小手,点个赞呗。下次我将会进行和大家分享对数据查改删的方法。关注我!!!更多精彩分享不迷路。

载说明:原创不易,未经授权,谢绝任何形式的转载

在当今充满活力的网络开发领域中,实现强大的搜索功能是一个关键特性,可以极大地增强用户体验,并使浏览大型数据集变得轻松自如。如果您想要为您的网站或网络应用程序添加实时搜索功能,那么您来对地方了。本篇全面的文章将探讨使用JavaScript实现实时搜索功能的方方面面。

无论您是经验丰富的开发人员还是刚开始编码之旅的新手,本文旨在为您提供一般编码知识和工具,以便将实时搜索功能融入到您的项目中。通过本指南的学习,您将对相关概念和技术有扎实的理解,从而能够创建响应式和交互式的搜索功能,实现用户输入时动态更新的效果。

为了有效地跟随本指南,建议您对HTML、CSS和JavaScript的基本知识有扎实的理解。熟悉DOM操作和事件处理将有助于我们深入了解实现细节。然而,即使您对JavaScript或Web开发相对较新,本指南的结构也旨在提供清晰的解释和逐步的说明,使其适用于不同技能水平的学习者。

现在,为了更好地理解这个功能的重要性和使用方法,我们将创建一个非常基本的项目作为示例;更具体地说,一个如下所示的电影应用程序:

您可以在这里查看实时实施情况。

https://search-movies-live.netlify.app/

在这个项目中,我们将利用实时搜索功能来搜索电影数据库中的电影列表。我知道你迫不及待地想要开始了,我们马上就会开始。但首先,让我们更多地了解一下实时搜索功能及其重要性。

实时搜索功能的重要性

在当今数字化的环境中,实时搜索功能变得至关重要,满足了高效信息检索的需求,提升了整体用户体验。通过在用户输入时实时更新搜索结果,实时搜索提供即时反馈,便于快速获取相关信息。这种动态交互式的搜索功能带来了许多好处,使用户和网站所有者受益。

  • 改进的用户体验:实时搜索通过提供无缝和直观的搜索过程显著提升了用户体验。当用户开始输入查询时,搜索结果会实时更新,提供即时反馈,消除了手动提交或页面刷新的需求。这种互动性节省了用户宝贵的时间和精力,从而实现了更高效和令人满意的搜索体验。
  • 更快的信息检索:通过实时搜索,用户可以快速找到所需的信息,无需浏览多个页面或等待搜索结果加载。随着用户的输入,搜索结果立即缩小范围,显示相关建议,无需输入完整的搜索查询。这种速度和响应能够使用户在传统搜索方法所需时间的一小部分内找到他们想要的内容。
  • 增加参与度和转化率:实时搜索的无缝和响应性特性鼓励用户更积极地与网站或网络应用程序互动。提供即时反馈和相关建议可以保持用户的参与度,减少跳出率和沮丧感的可能性。这种增加的参与度可以提高转化率,因为用户更有可能进一步探索网站并将他们的搜索意图转化为行动。
  • 增强的过滤和细化功能:实时搜索功能通常包括额外的功能,如过滤器、建议和自动完成选项。这些功能帮助用户细化搜索并缩小结果范围,使他们能够找到他们想要的内容。通过提供这些工具,实时搜索不仅改善了搜索体验,还帮助用户发现可能一开始没有考虑到的相关内容或产品。
  • 网站所有者的宝贵见解:实时搜索功能可以为用户行为和偏好提供宝贵的见解。通过分析搜索查询和模式,网站所有者可以更好地了解用户的需求,识别流行趋势或话题,并在内容创作、产品提供或用户界面改进方面做出明智决策。这些见解使网站所有者能够根据用户需求量身定制自己的产品,从而提高客户满意度和业务增长。

设置HTML结构

既然我们已经完全了解了实时搜索功能以及它的重要性,那么让我们深入探讨一下如何在您自己的项目中实现这个功能。

首先,让我们建立项目的结构。对于这个项目,我们只需要三个文件,即HTML、CSS和JavaScript文件。

现在让我们开始设置项目的HTML结构:在HTML文件中,我们首先需要包含我们的标准HTML样板,包括链接和脚本到我们的CSS和JS文件中:

<!doctype html>
<html lang="en">
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <link rel="stylesheet" href="./live-search.css" />
   <title> </title>
 </head>
 <body>
   <script src="./live-search.js"></script>
 </body>
</html>

现在在 body 标签中,我们包含了 header 和 main 语义标签。在 header 标签内,我们设置了项目的标题部分,这里只包括应用程序的名称和一个视频图标。

<header>
 <ion-icon name="videocam"></ion-icon>
 <h1>Search Movies</h1>
</header>

在我们继续讲解 main 标签之前,在 body 标签的末尾,让我们包含所需的 script 标签,以便能够使用这些图标:

<script
 type="module"
 src="https://unpkg.com/ionicons@7.1.0/dist/ionicons/ionicons.esm.js"
></script>
<script
 nomodule
 src="https://unpkg.com/ionicons@7.1.0/dist/ionicons/ionicons.js"
></script>

您可以在Ionicons网站上找到这些图标。

https://ionic.io/ionicons

现在,在 main 标签内,我们将包含我们的第一个 div 标签,这将是我们的搜索栏容器,在其中,我们放置我们的搜索输入标签和一个搜索图标:

<div id="search-container">
 <ion-icon name="search-outline"></ion-icon>
 <input type="search" id="search-bar" placeholder="Search movies..." />
</div>

然后,我们将在这个“div”下面创建另一个 div 标签。这将包含所有电影数据的结果:

<div id="results-container"></div>

我们暂时将其留空,因为其内容将在JavaScript部分生成。

最后,在 main 标签中,我们将包含一个 p 标签。这个标签只是为了在稍后向用户显示错误或空消息的响应。

<p id="movie-unavailable-txt"></p>

这就是HTML文件的全部内容,整体代码应该是这样的:

<!doctype html>
<html lang="en">
 <head>
   <meta charset="UTF-8" />
   <meta http-equiv="X-UA-Compatible" content="IE=edge" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <link rel="stylesheet" href="./live-search.css" />
   <title>Live Search Functionality</title>
 </head>
 <body>
   <header>
     <ion-icon name="videocam"></ion-icon>
     <h1>Search Movies</h1>
   </header>

   <main>
     <div id="search-container">
       <ion-icon name="search-outline"></ion-icon>
       <input type="search" id="search-bar" placeholder="Search movies..." />
     </div>

     <div id="results-container"></div>

     <p id="movie-unavailable-txt"></p>
   </main>

   <script src="./live-search.js"></script>
   <script
     type="module"
     src="https://unpkg.com/ionicons@7.1.0/dist/ionicons/ionicons.esm.js"
   ></script>
   <script
     nomodule
     src="https://unpkg.com/ionicons@7.1.0/dist/ionicons/ionicons.js"
   ></script>
 </body>
</html>

既然我们已经完成了项目的HTML结构的实现,那么让我们给页面添加一些样式。

为页面添加样式

在这个部分,我们将为页面的各个部分添加基本的样式。所以让我们开始吧。首先,让我们为页面的整体部分添加一些常规样式:

html{
 scroll-behavior: smooth;
 background-color: #111;
 color: whitesmoke;
}

*{
 margin: 0;
 padding: 0;
 box-sizing: border-box;
}

现在让我们为头部部分及其内容添加一些样式:

header{
 display: flex;
 justify-content: center;
 padding: 25px;
 letter-spacing: 2px;
 position: sticky;
 top: 0%;
 z-index: 2;
 border-bottom: 2px solid ;
 background-color: black;
 text-shadow: 3px 3px 5px #fd1d6b;   
 box-shadow: 10px 10px 20px -10px #fd1d6b; 
}

header > ion-icon{
 color:#fd1d6b;
 font-size: 60px;
 position: absolute;
 left: 5%;
}

接下来,我们开始对搜索容器及其内容进行样式设置:

#search-container{
 display: flex;
 justify-content: center;
 padding: 20px;
 margin-bottom: 20px;
 position: sticky;
 top: 100px;
}

#search-bar{
 border: none;
 width: 60%;
 padding: 15px;
 padding-left: 40px;
 border-radius: 15px;
 font-size: 15px;
}

#search-container>ion-icon{
 color: gray;
 position: relative;
 left: 30px;
 top: 13px;
 z-index: 3;
 font-size: 19px;
}

之后,我们继续设计将来从电影数据库中获取的所有电影的 results-container 的样式

#results-container{
 border-right: 5px solid #fd1d6b;
 border-left: 5px solid #fd1d6b;     
 border-radius: 25px;
 display: flex;
 justify-content: center;
 flex-wrap: wrap;
 width: 90vw;
}

接下来,我们在 movie-unavailable-txt 中添加样式,同时将 display 设置为 none ,因为我们暂时不希望它可见

#movie-unavailable-txt{
 text-align: center;
 letter-spacing: 2px;
 display: none;
 margin-top: 15%;
 text-shadow: 3px 3px 5px #fd1d6b;
}

接下来,我们将为一些尚未声明但将通过JavaScript创建的元素添加一些样式。这是电影卡片,将显示电影的详细信息,包括电影图片和标题:

.movie-cards{
 padding: 25px;
 max-width: 250px;
 border-radius: 15px;
 display: grid;
 place-items: center;
 box-shadow: 1px 1px 20px -1px #fd1d6b ;
 margin: 50px;
}

.title{
 margin: 20px auto;
 text-align: center;
 font-size: 1.2rem;
 text-shadow: 3px 3px 5px #fd1d6b;  
}

.date{
 margin-top: 15px;
 font-size: 0.8rem;
 text-shadow: 3px 3px 5px #fd1d6b;  
}

.movie-image{
 width: 90%;
 max-width: 400px;
 object-fit: contain;
 border-radius: 5px;
}

既然我们已经完成了页面的样式,那么让我们继续进行最有趣和最重要的部分,即Javascript的实现。

向电影数据库API发送异步搜索请求

在本节中,我们将调用我们选择的电影数据库API来填充我们的页面,展示各种电影。在这种情况下,我将使用RapidAPI Hub中的IMDb Top 100 Movies免费电影API。在API页面中,我们选择要使用的特定数据,然后复制页面右侧提供的javascript(fetch)代码,如下所示:

https://rapidapi.com/rapihub-rapihub-default/api/imdb-top-100-movies

首先,在您使用API之前,请先订阅它(无需信用卡),以便为您生成一个API密钥。您可以在API的定价页面上进行订阅。

继续,我们进入我们的空的JavaScript文件,并将我们复制的代码粘贴进去:

const url = "https://imdb-top-100-movies.p.rapidapi.com/";
const options = {
 method: "GET",
 headers: {
   "X-RapidAPI-Key": "YOUR GENERATED API KEY",
   "X-RapidAPI-Host": "imdb-top-100-movies.p.rapidapi.com",
 },
};

try {
 const response = await fetch(url, options);
 const result = await response.text();
 console.log(result);
} catch (error) {
 console.error(error);
}

既然我们已经将电影数据库的API引入到我们的项目中,我们可以使用它的数据了。接下来,我们将声明一些我们需要的变量,并将它们放在我们复制的代码中 try 块的上方。

const searchBar = document.getElementById("search-bar");
const resultsContainer = document.getElementById("results-container");
const movieUnavailableTxt = document.getElementById("movie-unavailable-txt");
let movieList;
let searchValue;
let searchedMovies;

我们正在接近刚刚创建的这些变量的目的,坚持住。

接下来,我们对复制的代码中的 try 块进行一些更改,因为我们希望将其与我们的项目完全集成。所以首先,我们需要创建一个异步函数:

const fetchMovies = async () => {
 // try catch block goes in here.
};

在这个函数内部,我们将放置从我们复制的代码中的整个 try catch 块,以便我们可以进行异步API调用。

在 try 块内,我们将删除 console.log(result) 行,并将 result 变量更改为先前声明的 movieList 变量,并将同一行中的 response.text() 更改为 response.json() 。这样,我们从API调用中接收到的数据将以 JSON 格式呈现,这是我们所需的。因此,该行现在应该是这样的

movieList = await response.json();

现在我们已经成功从API中获取了电影并返回了我们的数据集,我们需要将这些数据填充到我们的页面中。为此,我们将调用 renderMovies() 函数,并将参数设置为从API调用中获取的数据。不用担心,我们很快就会创建这个函数:

renderMovies(movieList);

现在让我们创建 renderMovies 函数,这个函数刚刚在 fetchMovies() 函数中调用过,这个函数将用于创建动态电影卡片模板,我们之前在CSS文件中设置了样式,模板中的每个元素的内容都将设置为从API获取的数据,这样我们就可以使用相同的模板渲染不同的电影。然后,我们将把电影卡片放在 resultsContainer 元素中。每次调用函数时,我们需要清除 resultsContainer ,并将 moviesUnavailableTxt 设置为 display="none" ,因为我们希望在渲染电影到页面时文本不可见,同时清除 moviesReturnedOnSearch 数组,然后将从搜索输入字段返回的新数据设置到其中。

const renderMovies = (movies) => {
 resultsContainer.innerHTML = ""; // Clear the existing movies
 movieUnavailableTxt.style.display = "none"; // Hide the "No movies found" message
 moviesReturnedOnSearch = []; // Clear the movies returned on search array

 movies.forEach((movie) => {
   resultsContainer.innerHTML += `
     <div class="movie-cards">
       <img src="${movie.image}" alt="movie image" class="movie-image" />
       <h2 class="title">${movie.title}</h2>
       <p class="plot">${movie.description}</p>
       <p class="date">${movie.year}</p>
     </div>
   `;

   moviesReturnedOnSearch.push(movie); // Add the movies that are a result to the search input value
 });
};

捕捉用户输入并实时显示电影搜索结果

现在我们已经将所有电影数据加载到我们的页面上,接下来是真正有趣的部分,我们要实现实时搜索功能,所以,不浪费时间,让我们开始吧。

为了捕获用户输入,我们将使用 input 事件监听器,并将其链接到 searchBar 元素。我们使用这个特定的事件监听器,因为它可以捕获搜索框内的每一个活动,包括输入、清除和粘贴,这正是我们想要的。所以让我们继续创建它:

searchBar.addEventListener("input", (event) => {
 // live functionality code
});

好的,现在我们已经将事件监听器链接到搜索栏,以便监听用户的任何输入。在第二个参数中,我们添加了事件处理程序,这是每当搜索栏有输入时将被调用的函数。现在,在该函数内部,我们将编写处理实时搜索的代码。

在搜索功能中,我们需要做的第一件事是编辑从用户那里获取到的输入值,并将其转换为全小写,同时去除任何不必要的空格:

searchValue = event.target.value.trim().toLowerCase();

在那之后,我们继续根据用户的搜索输入,通过检查用户输入的电影标题是否包含在 movieList 数据中的任何电影标题中,并将电影标题设置为小写以与用户输入匹配,来在页面上按标题筛选电影

const filteredMovies = movieList.filter( (movie) => movie.title.toLowerCase().includes(searchValue) );

接下来,我们将通过再次调用 renderMovies() 函数,并将参数设置为 filtered Movies 变量的值,来显示与用户在搜索栏中输入的字符匹配的电影标题的实时搜索结果。

renderMovies(filteredMovies);

通过调用此函数,它仅将与搜索栏中键入的字符匹配的电影渲染到页面上,使用函数中提供的电影卡片模板,同时将每个匹配的电影添加到 moviesReturnedOnSearch 数组中,以便我们可以跟踪每个字符输入的匹配搜索值的电影数量。在处理空响应错误时,这将非常有用,现在我们将进入这个部分。

处理空或错误响应

在任何应用程序中,有效处理空或错误的响应至关重要。在这种情况下,这些情景可能发生在搜索查询没有结果或API请求存在问题时。

处理错误或空响应时,向用户提供清晰的反馈是至关重要的。话虽如此,由于这是一个相对简单的应用程序,我们不必过多担心错误,因为我们只需要处理由API引起的错误。例如,API服务可能暂时不可用,或者应用程序可能刚刚超过了请求限制。为了处理这个错误,我们只需要将 movieUnavailableTxt 元素的 display 设置为 block ,并将 innerHTML 设置为向用户显示错误消息,并将其放置在 fetchMovies() 函数的 catch 块中。因此,现在 catch 块的代码如下所示:

catch (error) {
 movieUnavailableTxt.innerHTML = 'An error occurred while fetching movies. <br /> Please try again later.';
 movieUnavailableTxt.style.display = "block";
 console.error(error);
}

现在我们已经处理完错误响应,接下来我们要处理空响应。如果用户搜索的电影与页面上的任何电影都不匹配,我们需要向用户提示所搜索的电影不可用。为了做到这一点,首先我们需要检查之前声明的 moviesReturnedOnSearch 数组的内容,如果数组的长度小于或等于0,我们将设置 movieUnavailableTxt 元素的 display 为 block ,并将 innerHTML 设置为空响应消息,如下所示:

if (moviesReturnedOnSearch.length <= 0) {
 movieUnavailableTxt.innerHTML = "OOPS! <br/><br/> Movie not available";
 movieUnavailableTxt.style.display = "block"; // Show the "No movies found" message if no movies match the search
}

我们将把这个 if 块放在 searchBar 事件处理程序的闭合括号之前。

通过缓存提高搜索性能

在使用API实现实时搜索功能时,提高性能的一种有效技术是缓存。缓存涉及存储先前获取的搜索结果,并在再次请求相同的搜索查询时重复使用它们。这可以显著减少API调用的次数,有助于防止超过API的请求限制,并改善搜索功能的响应速度以及网站的加载时间。

要在我们的项目中实现缓存,首先,我们需要确定哪些项目需要被缓存,而在这种情况下,那将是 movieList 变量的值,它是我们从 fetch API请求中得到的 JSON 格式的数据。通过缓存这个项目,我们将能够在页面重新加载时使用API的数据,而无需进行额外的 fetch 请求。但是对于这个项目,我们将为我们的缓存数据设置一个过期时间,为6小时,这意味着页面每6小时只会进行一次API请求,而不是在每次页面重新加载时都进行请求。这样做是为了保持页面的数据新鲜和最新,同时将API请求保持在最低限度。

回到我们的代码中,现在我们需要将数据存储在浏览器的本地存储中,但为了做到这一点,我们需要首先将其转换为一个 string ,并设置一个键名,用于在本地存储中标识数据。让我们将其设置为 movieData ,如下所示:

localStorage.setItem("moviedata", JSON.stringify(movieList));

接下来我们需要将当前日期和时间存储在本地存储中:

localStorage.setItem("cacheTimestamp", Date.now());

这将当前日期和时间以毫秒为单位存储,键名为 cacheTimeStamp 。

我们将把这两行代码放在 try 块的 fetchMovies() 函数中,就在 movieList 变量的下方。

接下来,在 fetchMovies() 函数之外,紧接着 renderMovies() 函数的下方,我们将把缓存数据的过期时间设置为6小时(以毫秒为单位)

const expirationDuration = 21600000; // 6 hours in milliseconds

之后,我们需要取回之前在本地存储中设置的 cacheTimestamp

const cacheTimestamp = localStorage.getItem("cacheTimestamp");

现在,我们将检查缓存数据是否已过期或不可用,这意味着它尚未被存储。如果是这种情况,我们将通过调用 fetch 函数向API发出新的请求。另一方面,如果缓存数据存在且尚未过期,我们将使用它来渲染页面上的电影,而不是再次发出新的 fetch 请求。我们通过检索缓存的电影数据并将其解析回 JSON 格式来使用,然后将参数设置为从缓存中获取的数据,调用 render 函数来实现这一点。

// Check if cache has expired or data is not available
if (
 !cacheTimestamp ||
 Date.now() - parseInt(cacheTimestamp) > expirationDuration
) {
 // Cache expired or data not available, fetch movies again
 fetchMovies();
} else {
 // Use cached movie data
 movieList = JSON.parse(localStorage.getItem("moviedata"));
 renderMovies(movieList);
}

在 if 语句中, !cacheTimestamp 检查 cacheTimestamp 变量是否为假值,意味着它可以是 null 、 undefined 、0、 false 或空字符串。如果 cacheTimestamp 为假,表示没有存储现有缓存时间戳。 Date.now() - parseInt(cacheTimestamp) 计算当前时间戳与解析的 cacheTimestamp 的整数值之间的时间差。简单来说,这就是说:“当前时间的值减去我们之前存储在缓存中的时间的值,是否大于我们设置的过期时间?如果是,就从API中重新获取电影数据;如果不是,就使用缓存的数据。”

就是这样,这就是我们如何将数据缓存起来以便重复使用,而不是在每次用户输入或每次页面重新加载时发起请求。正如你所看到的,这将极大地优化应用程序的性能,因为它可以防止由于网络慢而导致的电影渲染缓慢。

我们已经完成了我们的小电影应用程序中展示实时搜索功能的所有特性的实现。以下是该应用程序的整体JavaScript代码:

const url = "https://imdb-top-100-movies.p.rapidapi.com/";
const options = {
 method: "GET",
 headers: {
   "X-RapidAPI-Key": "Your Generated API Key",
   "X-RapidAPI-Host": "imdb-top-100-movies.p.rapidapi.com",
 },
};

const searchBar = document.getElementById("search-bar");
const resultsContainer = document.getElementById("results-container");
const movieUnavailableTxt = document.getElementById("movie-unavailable-txt");
let movieList;
let searchValue;
let moviesReturnedOnSearch;

// Function to fetch movies from the API
const fetchMovies = async () => {
 try {
   const response = await fetch(url, options);
   movieList = await response.json();

   // Storing the Movie Data in browser storage
   localStorage.setItem("moviedata", JSON.stringify(movieList));
   localStorage.setItem("cacheTimestamp", Date.now()); // Update cache timestamp

   // Render the movies on the page
   renderMovies(movieList);
 } catch (error) {
   movieUnavailableTxt.innerHTML =
     "An error occurred while fetching movies. <br /> Please try again later.";
   movieUnavailableTxt.style.display = "block";
   console.error(error);
 }
};

// Function to render movies on the page
const renderMovies = (movies) => {
 resultsContainer.innerHTML = ""; // Clear the existing movies
 movieUnavailableTxt.style.display = "none"; // Hide the "No movies found" message
 moviesReturnedOnSearch = []; // Clear the movies returned on search array

 movies.forEach((movie) => {
   resultsContainer.innerHTML += `
     <div class="movie-cards">
       <img src="${movie.image}" alt="movie image" class="movie-image" />
       <h2 class="title">${movie.title}</h2>
       <p class="plot">${movie.description}</p>
       <p class="date">${movie.year}</p>
     </div>
   `;

   moviesReturnedOnSearch.push(movie); // Add the movies that are a result to the search input value
 });
};

const cacheTimestamp = localStorage.getItem("cacheTimestamp");
const expirationDuration = 21600000; // 6 hours in milliseconds

// Check if cache has expired or data is not available
if (
 !cacheTimestamp ||
 Date.now() - parseInt(cacheTimestamp) > expirationDuration
) {
 // Cache expired or data not available, fetch movies again
 fetchMovies();
} else {
 // Use cached movie data
 movieList = JSON.parse(localStorage.getItem("moviedata"));
 renderMovies(movieList);
}

// Event listener and handler for search bar input
searchBar.addEventListener("input", (event) => {
 searchValue = event.target.value.trim().toLowerCase();

 // Filter movies based on search input
 const filteredMovies = movieList.filter((movie) =>
   movie.title.toLowerCase().includes(searchValue),
 );

 // Render the filtered movies on the page
 renderMovies(filteredMovies);

 if (moviesReturnedOnSearch.length <= 0) {
   movieUnavailableTxt.style.display = "block"; // Show the "No movies found" message if no movies match the search
 }
});

结论

在本指南中,我们探讨了使用API在JavaScript中实现实时搜索功能的方法。按照所述步骤,您可以创建一个动态搜索体验,当用户在搜索栏中输入时,可以提供实时结果。

通过在您的网站上实现实时搜索功能,您可以增强用户参与度,提高您的网站或应用程序的可用性。用户将欣赏能够快速方便地找到相关信息,而无需重新加载页面。

通过这个指南所获得的知识,您已经具备了在JavaScript中有效实现实时搜索功能的能力。拥抱动态搜索的力量,创造一个无缝的用户体验,给人留下深刻的印象。

由于文章内容篇幅有限,今天的内容就分享到这里,文章结尾,我想提醒您,文章的创作不易,如果您喜欢我的分享,请别忘了点赞和转发,让更多有需要的人看到。同时,如果您想获取更多前端技术的知识,欢迎关注我,您的支持将是我分享最大的动力。我会持续输出更多内容,敬请期待。