Web/02-开始写JavaScript：hello world.md at a903cc798f4816f7c1abfcd442a155f915bbd8c6

mirror of https://github.com/qianguyihao/Web.git synced 2024-11-01 13:34:46 +08:00

qianguyihao dcc174bff3 update

2024-02-21 19:12:00 +08:00

17 KiB

Raw Blame History

title
02-开始写JavaScript：hello world

开始写第一行 JavaScript：hello world

JS 代码的书写位置在哪里呢？这个问题，也可以理解成：引入 JS 代码，有哪几种方式？有三种方式：（和 CSS 的引入方式类似）

行内式：写在HTML标签内部。
内嵌式（内联式）：写在 script 标签中。
外链式：引入外部 JS 文件。

方式 1：行内式

代码举例：

<input type="button" value="点我点我" onclick="alert('千古壹号 Hello 方式1')" />

完整的可执行代码如下：

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Document</title>
  </head>
  <body>
    <input type="button" value="点我点我" onclick="alert('千古壹号 Hello 方式1')" />
  </body>
</html>

解释：

可以将单行或少量 JS 代码写在 HTML 标签的事件属性中（以 on 开头的属性），比如放在上面的 onclick点击事件中。
这种书写方式，不推荐使用，原因是：可读性差，尤其是需要编写大量 JS 代码时，很难维护；引号多层嵌套时，也容易出错。
关于代码中的「引号」，在 HTML 标签中，我们推荐使用双引号，JS 中推荐使用单引号。

方式 2、内嵌式（内联式）

我们可以在 HTML 页面的 <body> 标签里放入<script type=”text/javascript”></script>标签对，并在<script>里书写 JavaScript 代码：

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Document</title>
  </head>
  <body>
    <script type="text/javascript">
      // 在这里写 js 代码
      alert('千古壹号 hello 方式2');
      console.log('qianguyihao hello 方式2');
    </script>
  </body>
</html>

解释：

tyue属性中的text 表示纯文本，因为 JavaScript 代码本身就是纯文本。当然，type属性可以省略，因为 JavaScript 是所有现代浏览器以及 HTML5 中的默认脚本语言。
可以将多行 JS 代码写到 <script> 标签中。
内嵌式 JS 是学习时常用的书写方式。

方式 3：外链式（引入独立的JS文件）

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Document</title>
  </head>
  <body>
    <!-- 外链式：引入外部的 js 文件：这个 utils.js 文件与当前的 html 文件，处于同一级目录 -->
    <script src="utils.js"></script>
  </body>
</html>

解释：

上面这段代码，依然是放到 body 标签里，可以和内嵌的 JS 代码并列。
上方代码的 script 标签已经引入了外部 JS 文件，所以这个标签里面，不可以再写 JS 代码。
方式2和方式3不能混用。

总结：

我们在实战开发中，基本都是采用方式 3，因为将 html 文件和 js 文件分开的方式，有利于代码的结构化和复用，符合高内聚、低耦合的思想。很少会有人把一大堆 JS 代码塞到单个 html 文件里。

拓展知识

window.onload：先加载，最后执行

上面的三种方式，有个共同的地方是：JS 代码都是写在 body 标签中的，准确来说，是在页面标签元素（比如 title 标签）的后面，在 </body>结束标签的前面。

为什么一般是按这样的顺序来写呢？这是因为：浏览器默认遵循HTML文档的加载顺序，即按照从上至下的加载顺序解析网页（这句话很重要）。所以，通常情况下，我们会把JS代码写在 body 内部的末尾。

然而，当你需要通过 JS 来操作界面上的标签元素时，假如将 JS 代码或者<script>标签写到<head>标签中，或者写在HTML标签元素的前面，那么这样的 JS 是无效的，因为标签元素在此时都还没来得及加载，自然无法操作这个元素。

重点来了：当你需要通过 JS 来操作界面上的标签元素时，如果实在想把 JS 写到<head>标签中，那么就必须用 window.onload 将 JS 代码进行包裹。代码格式如下：

<head>
  window.onload = function(){
    // 这里可以写操作界面元素的JS代码，等页面加载完毕后再执行。这里面的JS代码，会延迟执行。
    ...
  }
</head>

window.onload 的含义是：等界面上所有内容都加载完毕后（不仅要等文本加载完毕，而且要等图片也要加载完毕），再执行window.onload 内部的代码。做到了先加载，最后执行，也就是：延迟执行，等页面加载完毕后再执行。

我们可以根据具体需要来决定，将 window.onload 写在 <head>标签中，或者写在<script>标签中。

`<noscript>` 标签：浏览器不支持JS脚本时的降级方案

<noscript> 标签是一种HTML标签，用于提供在浏览器禁用JavaScript或无法执行JavaScript脚本时的替代内容。它允开发者在需要时向用户显示备用内容。这有助于提高网站的可访问性和用户体验。

如果有些浏览器不支持 JS 脚本，或者用户禁用了浏览器的JS脚本（如下图），那么，该如何给用户提供一个友好的提示呢？我们可以通过 <noscript> 标签作为降级的处理方案。

<noscript> 标签的基础语法：

<noscript>
  <!-- 降级方案：这里放置备用内容，当浏览器禁用 JS 或者浏览器不支持 JS 时将显示 -->
  <p>请启用JavaScript以获得最佳网站体验。</p>
</noscript>

说明：

<noscript> 标签内部可以包含任何HTML内容，通常包括用于向用户传达信息或提供备用功能的文本、图像、链接等。
<noscript> 标签的内容仅在浏览器不支持或禁用 JS 的情况下才会显示。换而言之，如果用户的浏览器支持JS脚本，则<noscript> 标签里的内容将无法显示，会被忽略；如果用户的浏览器不支持JS脚本（或者关闭了JS脚本），则会显示<noscript> 标签的内容。

JavaScript 一些简单的语法规则

学习编程语言，是有规律可循的，程序会有相同的部分，这些部分就是一种规定，不能更改，我们称之为：语法。我们先来了解一个简单的语法规则。

1、JS 对换行、缩进、空格不敏感。每一条语句以分号结尾。

也就是说：

代码一：

<script type="text/javascript">
    alert('今天蓝天白云');
    alert('我很高兴');
</script>

等价于代码二：

<script type="text/javascript">
    alert('今天蓝天白云');alert('我很高兴');
</script>

2、每一条语句末尾建议加上分号。

当存在换行符（line break）时，大多数情况下可以省略分号，JavaScript 会将换行符理解成“隐式”的分号，进而自动添加分号。

也就是说，分号不是必须加的，如果不写分号，浏览器会在换行符的位置自动添加分号，但是会消耗一些系统资源和性能，甚至有可能添加错误，导致一些奇怪的bug。

3、所有的符号都是英文的，比如括号、引号、分号。

如果你用的是搜狗拼音，建议不要用 shift 切换中英文（可以在搜狗软件里进行设置），不然很容易输入中文的分号；建议用 ctrl+space 切换中英文输入法。

4、JS 严格区分大小写。HTML和CSS不区分大小写，但是 JS 严格区分大小写。

前端代码的注释

注释：即解释、注解。注释有利于提高代码的可读性，且有利于程序员之间的沟通和工作交接。

注释可以用来解释某一段代码的功能和作用；通过注释，还可以补充代码中未体现出来的部分。代码只是开发工作的结果，注释可以阐述开发工作的过程、思路、注意事项，以及踩过的坑。

注释可以是任何文字，可以写中文。

我们不要把 HTML、CSS、JavaScript 三者的注释格式搞混淆了。

HTML 的注释

格式：

<!-- 我是 HTML 注释  -->

举例：

<!--头部开始-->
<div class="header"></div>
<!--头部结束-->

<!--内容开始-->
<div class="main"></div>
<!--内容结束-->

<!--底部开始-->
<div class="footer"></div>
<!--底部结束-->

CSS 的注释

举例：

<style type="text/css">
  /* 我是 CSS 注释 */
  p {
    font-weight: bold;
    font-style: italic;
    color: red;
  }
</style>

注意：CSS 只有/* */这种注释，没有//这种注释。而且注释要写在<style>标签里面才算生效。

JavaScript 的注释

单行注释：

// 我是注释

多行注释：（写法1）

/*
 多行注释1
 多行注释2
*/

多行注释：（写法2）

/**
 * 多行注释1
 * 多行注释2
 */

补充：VS Code 中，单行注释的快捷键是「Ctrl + /」，多行注释的默认快捷键是「Alt + Shift + A」。

当然，如果你觉得多行注释的默认快捷键不方便，我们还可以修改默认快捷键。操作如下：

VS Code --> 首选项 --> 键盘快捷方式 --> 查找“注释”这两个字 --> 将原来的快捷键修改为其他的快捷键，比如「Ctrl + Shift + /」。

注释的高级用法：文档注释（JSDoc）

JSDoc 是 JavaScript 中用于文档注释的一种标准化格式。写完 JSDoc 的注释之后，再通过相关工具，开发者便可以为函数、方法、类和变量等添加注释，以便生成可读性强的API文档。

以下是一个基本的 JSDoc 注释示例：

/**
 * 这是一个示例函数，用于求两个数字的和。
 * @param {number} num1 - 第一个数字
 * @param {number} num2 - 第二个数字
 * @returns {number} - 两个数字的和
 */
function sum(num1, num2) {
  return num1 + num2;
}

如上图所示，鼠标悬停在函数调用的地方就能看到关于这个函数的文档说明，而不需要定位函数的源码处，很神奇吧？

JSDoc经常应用于工具函数，我们甚至可以借助 JSDoc的相关工具，生成函数的一系列的API文档，部署到到网站上，方便其他开发者查阅，非常方便。这种协作方式在日常开发中极为常见。具体如何实战，各位读者可自行查阅 JSDoc 这个关键词。

另外需要说明的是，VS Code默认集成了文档注释的显示功能，可以在单独的 JS 文件中显示文档注释的效果，但是无法在 HTML 文件中显示效果：

对注释的认知

很多人认为：代码注释是多余的。他们的理由是：如果注释太多，说明代码写得不清晰；而且，代码更新的同时，如果注释没更新，那段注释就成了磁盘上的垃圾，误导他人。

还有人认为：注释应该尽可能详细，就像写小作文一样。

上面这样的理由，都不具有说服力。我告诉你为什么要写注释：

注释有利于提高代码的可读性，且有利于程序员之间的沟通和工作交接。
所有注释都是必要的吗？当然不是。注释不应该用来解释某些代码正在做什么。如果代码无法清楚到去解释自己时，那么代码需要变得更简单。有一些例外，比如正则表达式和复杂算法通常会从解释他们正在做什么事情的注释中获益很多。
注释用于解释为什么某些代码存在时很有用。大多数注释都是针对代码本身无法包含的信息，例如决策背后的推理、业务流程、业务逻辑、注意事项、踩坑经验总结、参考链接。
注释的本质是文档，需要持续更新维护，新陈代谢。文档也会过期，但不能因噎废食。即便文档过期，至少它记载了曾经的开发记录。

关注注释，还有一个悖论：“我最喜欢的事情是别人写注释，我最不喜欢的事情是自己写注释”。无论如何，建议各位开发者多写注释、多写技术文档，越详细越好、越系统越好，这样才能提高协作效率，促进良性循环。

JavaScript 输出语句

在下面的这几个输出语句中，按照使用频率来排序的话，console.log()用得最多，其次是 alert()语句；其他语句用得较少，了解即可。

弹窗：alert()语句

我们要学习的第一个语句，就是 alert 语句。

代码举例如下：

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Document</title>
  </head>
  <body>
    <script>
      alert('千古壹号');
    </script>
  </body>
</html>

alert（中文翻译为“警报、警告”）的用途：弹出“警告框”。它会在弹窗中显示一条信息，并等待用户按下 “OK”。

这个弹窗，在 IE 浏览器中长这样：

上面的代码中，如果写了两个 alert()语句，则网页的效果是：弹出第一个警告框，点击确定后，继续弹出第二个警告框。

补充：该方法只能传入一个参数。

控制台输出：console.log() 打印日志

console.log()用于在浏览器的控制台中输出信息，里面可以传入一个或多个参数，常用于代码调试和测试。console 表示“控制台”，log 表示“输出”。括号里可以写字符串、数字、变量、表达式等。

语法格式：

console.log('传入一个参数：' +arg1);
// 传入多个参数时，可以用逗号隔开
console.log('传入多个参数：', arg2, arg3);

控制台是程序员调试程序的地方。我们可以使用 console 语句打印日志，在控制台的 console 面板查看打印的内容，测试程序是否运行正常。

在 Chrome 浏览器中，按 F12 即可打开控制台，选择「console」栏，即可看到打印的内容。

console 语句可以设置不同的打印等级：

console.log('千古壹号1'); // 普通打印
console.warn('千古壹号2'); // 警告打印
console.error('千古壹号3'); // 错误打印

效果如下：

上图中，不同的打印等级，区别不大，只是颜色背景上的区别，方便肉眼区分、过滤信息。

普通人是不会在意控制台的，但是有些网站另藏玄机。比如百度首页的控制台，悄悄地放了一段招聘信息的彩蛋，挺有意思：

做前端开发时需要经常使用控制台做调试，我们甚至可以直接在控制台输入 JS 语句，然后打印执行结果，你可以自行试一试。

总结：alert() 主要用来显示消息给用户，console.log() 用来给程序员做调试用。

弹窗：confirm()语句（含确认/取消）

代码举例如下：

var result = confirm('你听说过千古壹号吗？');
console.log(result);

代码运行后，页面上会显示一个弹窗。弹窗上有“确认”和“取消”两个按钮，点击“确定”返回 true，点击“取消”返回 false。

弹出输入框：prompt()语句

prompt()就是专门弹出能够让用户输入内容的对话框。用得少，测试的时候偶尔会用。

JS 代码如下：

var a = prompt('请随便输入点什么东西吧');
console.log(a);

上方代码中，用户输入的内容，将被传递到变量 a 里面，并在控制台打印出来。

alert()和 prompt()的区别：

alert() 语句中可以输出数字和字符串，如果要输出字符串，则必须用引号括起来；prompt()语句中，用户不管输入什么内容，都是字符串。
prompt() 会返回用户输入的内容。我们可以用一个变量，来接收用户输入的内容。

网页内容区域输出：document.write()语句

该方法的作用是向网页中写入文本内容，可以是 HTML 代码。传入的参数可以是一个或者多个字符串。