使用 JavaScript 将文本转换为文件

2,068 阅读6分钟

我正在参加「创意开发 投稿大赛」详情请看:掘金创意开发大赛来了!

在线演示地址:haiyong.site/tools/wenbe…
码上掘金地址:code.juejin.cn/pen/7130896…

✨ 项目基本结构

目录结构如下:

├── css
│   └── style.css
└── index.html

本节教程我们通过文本转换为文件的案例(如下图所示)带大家去认识一下 JavaScript 吧!

知识点

  • textarea 标签
  • placeholder 属性
  • calc 函数
  • js 中三种引入方式
  • js 中三种声明方法

首先还是跟往常一样新建一个 HTML 页面,在文件中输入英文 !,然后按 tab 键生成模板。

在文件中添加 HTML 和 CSS 代码创建这个项目的基础结构。

<div id="container"></div>
* {
  box-sizing: border-box;
}
body {
  height: 100vh;
  margin: 0;
  display: flex;
  align-items: center;
  justify-content: center;
  background-image: url(https://labfile.oss.aliyuncs.com/courses/8605/bg-451838.jpeg);
  background-size: 100% 100%;
  font-family: "Kanit", Verdana, Arial, sans-serif;
}
#container {
  width: 430px;
  padding: 40px 20px;
  background: white;
}

效果如下所示:

图片描述

在上面代码中,我们添加了一张背景图片,并且在这里创建了一个宽度为 430px,背景颜色为白色的容器。

添加标题

基本结构有了,现在,我们在容器(#container)的头部添加一个 h1 标题。

<h1>将文本保存到文件中</h1>

这里我们设置标题的字体大小为 30px,颜色为蓝色。

h1 {
  color: #0773d7;
  font-size: 30px;
  width: 100%;
  margin-top: -15px;
  margin-bottom: 30px;
  text-align: center;
  text-transform: uppercase;
}

效果如下所示:

图片描述

创建一个多行文本框

现在我们在标题下面创建一个文本框用来输入(待转换的)文本内容。这个文本框是用 HTML 中的 textarea 标签来创建的。

<textarea placeholder="在此输入文字..." id="text"></textarea>

然后给文本框添加一些样式。

#text {
  display: block;
  width: 100%;
  background-color: transparent;
  color: #021652;
  border: 2px solid #3ba9f4;
  border-radius: 2px;
  resize: none;
  margin-bottom: 35px;
  height: 200px;
  padding: 10px;
  font-size: 20px;
}

效果如下所示:

图片描述

属性说明如下:

  • textarea 标签定义多行的文本输入控件,文本区中可容纳一段相当长的、不限格式的文本。
  • placeholder 属性规定描述文本区域预期值的简短提示,提示会在文本区域为空时显示。

创建一个单行文本框

接下来我们创建一个单行文本框用来输入文件名。该框使用 input 标签来创建。

<input id="filename" placeholder="起一个文件名..." />

然后给输入框添加一些样式。

#filename {
  width: calc(100% - 200px);
  border: 2px solid #3ba9f4;
  border-radius: 2px;
  background-color: transparent;
  color: #052a53;
  padding: 0 10px;
  height: 50px;
  line-height: 50px;
  font-size: 20px;
  margin-right: 20px;
}

效果如下所示:

图片描述

属性说明如下:

  • calc() 函数用于动态计算长度值,需要注意的是运算符前后都需要保留一个空格,可参考 MDN calc()

保存文件的按钮

现在我们需要创建一个下载按钮。单击此按钮将下载转换后的文本文件。

<button id="download">下载文件</button>

我们给按钮设置一下样式,盒子的宽度为 174 像素,高度为 50 像素,背景颜色使用了蓝色。

#download {
  background-color: #3ba9f4;
  color: #fff;
  font-size: 20px;
  height: 50px;
  border: none;
  border-radius: 2px;
  width: 174px;
  cursor: pointer;
}

效果如下所示:

图片描述

页面的效果现在已经完成了,但是现在点击按钮,还不能下载文件。

JavaScript 该出场了。

使用 JavaScript 将文本保存到文件

在实验介绍中已经为大家介绍过了 JavaScript,这里给大家说一说它的引入方式。

如何在 HTML 页面中引入 JavaScript?

与 CSS 类似,HTML 也可以使用三种方式引入 JavaScript。

  • 内联:在标签的事件属性中添加 js 代码,当事件触发时执行 js 代码。
  • 内部:在 HTML 页面的任意位置添加 script 标签,标签体内写 js 代码,当页面加载时执行。
  • 外部:在单独的 js 文件中写 js 代码,在 HTML 页面中通过 script 标签的 src 属性引入,页面加载时执行。

这里需要同学们注意一下,CSS 和 JS 的外部引入之间的区别,CSS 是使用 link 标签的 href 属性来引入的,而 JS 是通过 script 标签的 src 属性引入的。

我们来看一看下面的例子:

<!-- 内联引入方式 -->
<input type="button" value="按钮" onclick="alert('内联引入成功!')" />
<!-- 内部引入方式 -->
<script type="text/javascript">
  alert("内部引入成功!");
</script>
<!-- 引入外部js文件 -->
<script src="my.js" type="text/javascript" charset="utf-8"></script>

my.js 中的内容:

alert("外部引入成功!");

三种方式均可成功输出内容,效果如下(点击右下方 Go Live 启动 8080 端口,打开 Web 服务):

图片描述

在上面例子中,onclick 是绑定的点击事件,当点击这个元素会被触发;alert 是弹出一个警告框。

接下来我们使用内部引入的方式添加 JS 代码,用来实现文件下载的功能。

<script type="text/javascript">
// js 中方法声明:function 方法名(参数列表){方法体}
function downloadFile(filename, content) {
  // 它适用于所有支持 HTML5 的浏览器,因为它使用了 <a> 元素的下载属性:
  const element = document.createElement("a");

  // Blob 是一种可以存储二进制数据的数据类型
  // 根据要保存的文件,它可以有不同的值
  const blob = new Blob([content], { type: "plain/text" });

  // createObjectURL() 静态方法创建一个 DOMString,其中包含一个 URL,该 URL 表示参数中给定的对象。
  const fileUrl = URL.createObjectURL(blob);

  // setAttribute() 设置指定元素的属性值。
  element.setAttribute("href", fileUrl); // 文件位置
  element.setAttribute("download", filename); // 文件名
  element.style.display = "none";

  // 使用 appendChild() 方法将一个节点附加到指定父节点的子节点列表的末尾处
  document.body.appendChild(element);
  element.click();

  // Node 接口的 removeChild() 方法从 DOM 中移除一个子节点并返回移除的节点
  document.body.removeChild(element);
}

window.onload = () => {
  document.getElementById("download").addEventListener("click", (e) => {
    // 文件名输入框的值
    const filename = document.getElementById("filename").value;

    // 文本中输入的值
    const content = document.getElementById("text").value;

    // &&(逻辑与)运算符指示两个操作数是否为真。 如果两个操作数都具有非零值,则结果的值为 1。否则,结果的值为 0。

    if (filename && content) {
      downloadFile(filename, content);
    }
  });
};
</script>

最终效果如下所示:

图片描述

接下来,我们对上面的 JS 代码做一下说明~

  • function downloadFile(filename, content) {} 定义了一个名为 downloadFile 的函数,该函数可以传入两个参数 filename(保存文本的文件名) 和 content(文本内容)。
  • const 是定义常量的关键字,还有两种定义变量的关键字 varlet
  • document 是 JS 的 DOM 操作,DOM 的全称为 Document Object Model,就是对 HTML 文档中的元素进行操作,比如修改、删除、增加。那么 document.createElement("a") 就是在 HTML 文档中创建了一个 <a> 元素。
  • new Blob() 是实例化了一个 Blob 对象,它表示一个不可变、原始数据的类文件对象,它的数据可以按文本或二进制的格式进行读取,也可以转换成 ReadableStream 来用于数据操作。其中:
    • [content] 是多行输入框中的文本内容。
    • { type: "plain/text" } 是 MIME 类型,表示文本的类型为数组或者字符串。例如:
      var blob = new Blob(["<html>…</html>"], { type: "text/html" });
      
  • URL.createObjectURL() 表示静态方法会创建一个 DOMString,其中包含一个表示参数中给出的对象的 URL,这个 URL 对象表示指定的 File 对象或 Blob 对象。
  • element.setAttribute() 用来给指定 HTML 元素设置属性,使用格式如下:
    // name 为属性名称的字符串,value 为属性的值
    element.setAttribute(name, value);
    
  • element.style.display = "none" 给元素设置 CSS 为 display:none
  • appendChild() 用于将一个节点附加到指定父节点的子节点列表的末尾。
  • click() 是点击事件。
  • removeChild() 用于从 DOM 中删除一个子节点,返回删除的节点。
  • window.onload 用于处理元的加载事件。
  • addEventListener("click", (e)=>{}),表示监听 click 事件,(e)=>{} 是一个回调函数。
  • => 表示箭头函数。
  • if 语句,括号中的条件为真时,会执行 if 语句 {} 中的内容。

到此我们将文本内容保存到文件的小项目就完成啦!

📑 完整源码下载⬇

这里我给出了完整的源代码,你可以下载并在自己的学习或者工作中使用,下载地址:

1.码上掘金地址:code.juejin.cn/pen/7130896…
2.GitHub 地址(给个star ❤️ 吧):github.com/wanghao221/…

总结

希望通过上面的教程,大家已经学会了如何使用 JavaScript 将文本内容保存到文件。同时我们也了解了 CSS 和 JS 中一些基础知识,例如 <textarea> 标签、placeholder 属性、calc() 函数,还认识了 JavaScript 中三种引入方式和三种声明方法。