JavaScript 文件上传：实时获取选定文件名教程-html教程-PHP中文网

JavaScript 文件上传：实时获取选定文件名教程

心靈之曲

发布： 2025-10-08 11:16:01

原创

492人浏览过

JavaScript 文件上传：实时获取选定文件名教程

本文旨在解决HTML文件输入框在用户选择文件后，无法立即获取并显示文件名的常见问题。通过深入解析JavaScript的事件监听机制，特别是change事件的应用，我们将展示如何构建一个响应式的文件上传界面，确保用户选择文件后，文件名能够即时准确地显示在页面上，并提供相关的HTML结构、CSS样式以及完整的代码示例和注意事项。

理解文件输入与事件时序

在web开发中，我们经常需要允许用户上传文件。html的<input type="file">元素是实现此功能的关键。然而，直接操作这个元素来获取文件信息时，可能会遇到时序问题。例如，当一个自定义按钮触发隐藏的<input type="file">的点击事件后，如果立即尝试通过input.value获取文件名，通常会得到一个空字符串或者旧的文件名。这是因为文件选择对话框是一个操作系统级别的异步操作，javascript代码在触发对话框后会继续执行，而不会等待用户完成文件选择。只有当用户实际选择了一个文件并关闭对话框后，文件输入元素的状态才会更新。

为了解决这个问题，我们需要依赖于特定的事件来感知用户的文件选择行为。

核心解决方案：监听 change 事件

正确获取用户选择的文件名，需要监听<input type="file">元素的change事件。当用户选择一个或多个文件并关闭文件选择对话框时，change事件就会被触发。此时，我们可以通过事件对象访问到选定的文件信息。

以下是实现这一功能的JavaScript代码：

// 获取DOM元素
let fileInput = document.getElementById('filee');
let chooseButton = document.getElementById("btn");
let fileNameSpan = document.getElementById("filename");

// 监听文件输入框的 'change' 事件
fileInput.addEventListener('change', event => {
  // event.target.files 是一个 FileList 对象，包含用户选择的所有文件
  // 对于单文件选择，我们取第一个文件
  const [selectedFile] = event.target.files;

  if (selectedFile) {
    // 获取文件的名称并显示
    fileNameSpan.innerText = selectedFile.name;
  } else {
    // 用户取消了文件选择
    fileNameSpan.innerText = '未选择文件';
  }
});

// 监听自定义按钮的 'click' 事件，用于触发文件输入框的点击
chooseButton.addEventListener('click', () => {
  fileInput.click(); // 模拟点击隐藏的文件输入框
});

登录后复制

代码解析：

立即学习“Java免费学习笔记（深入）”；

fileInput.addEventListener('change', ...)：这是核心。它注册了一个事件监听器，当fileInput的值发生改变（即用户选择了一个文件）时，回调函数就会执行。
event.target.files：这是一个FileList对象，包含了用户选择的所有文件。即使是单文件选择，它也是一个类数组对象。
const [selectedFile] = event.target.files;：这是一个ES6解构赋值的简洁写法，用于获取FileList中的第一个文件对象。
selectedFile.name：File对象的一个属性，返回文件的名称字符串。

HTML 结构与样式

为了提供更好的用户体验，我们通常会隐藏原生的<input type="file">元素，并使用一个自定义的按钮来触发它的点击事件。同时，需要一个<span>或其他元素来显示选定的文件名。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

<input type="file" name="uploadFile" id="filee">
<button type="button" id="btn">选择文件</button>
<span id="filename"></span>

登录后复制

CSS 样式（隐藏文件输入框并保持可访问性）：

为了在视觉上隐藏<input type="file">元素，同时确保它在辅助技术（如屏幕阅读器）下仍然可访问，推荐使用以下CSS样式，而不是简单的display: none或visibility: hidden。

#filee {
  clip: rect(0 0 0 0); /* 裁剪元素，使其在视觉上不可见 */
  clip-path: inset(50%); /* 现代替代方案 */
  height: 1px; /* 最小化尺寸 */
  overflow: hidden; /* 隐藏超出部分 */
  position: absolute; /* 绝对定位，不影响布局 */
  white-space: nowrap; /* 防止文本换行 */
  width: 1px; /* 最小化尺寸 */
}

登录后复制

这种方法将元素缩小到1x1像素，并将其从常规文档流中移除，但它仍然存在于DOM中，可以被程序化地触发和被辅助技术识别。

完整示例代码

将上述HTML、CSS和JavaScript结合起来，形成一个完整的可运行示例：

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>实时获取文件上传文件名</title>
    <style type="text/css">
        /* 隐藏文件输入框并保持可访问性 */
        #filee {
            clip: rect(0 0 0 0); 
            clip-path: inset(50%);
            height: 1px;
            overflow: hidden;
            position: absolute;
            white-space: nowrap; 
            width: 1px;
        }
    </style>
</head>
<body>
    <input type="file" name="uploadFile" id="filee">
    <button type="button" id="btn">选择文件</button>
    <span id="filename">未选择文件</span> 

    <script type="text/javascript">
        let fileInput = document.getElementById('filee');
        let chooseButton = document.getElementById("btn");
        let fileNameSpan = document.getElementById("filename");

        // 监听文件输入框的 'change' 事件
        fileInput.addEventListener('change', event => {
            const [selectedFile] = event.target.files;

            if (selectedFile) {
                fileNameSpan.innerText = selectedFile.name;
            } else {
                fileNameSpan.innerText = '未选择文件';
            }
        });

        // 监听自定义按钮的 'click' 事件，用于触发文件输入框的点击
        chooseButton.addEventListener('click', () => {
            fileInput.click();
        });
    </script>
</body>
</html>

登录后复制

注意事项

多文件选择： 如果<input type="file">元素带有multiple属性（例如：<input type="file" multiple>），event.target.files将包含用户选择的所有文件。你可以遍历FileList来获取每个文件的信息。
安全性与文件路径： 出于安全考虑，浏览器不会向JavaScript暴露文件的完整本地路径，file.name只会提供文件名。
用户取消： 如果用户打开文件选择对话框后，没有选择任何文件而是直接关闭，change事件可能不会触发，或者event.target.files会是一个空的FileList。在处理selectedFile时，应进行null或undefined检查。
文件大小与类型验证： 在实际应用中，你可能还需要在change事件中对selectedFile.size（文件大小）和selectedFile.type（MIME类型）进行验证，以确保用户上传的文件符合要求。

总结

通过利用JavaScript的事件监听机制，特别是针对<input type="file">元素的change事件，我们可以有效地解决文件上传时无法实时获取文件名的挑战。这种方法不仅保证了功能的正确性，还通过自定义按钮和恰当的CSS样式提升了用户界面的美观性和可访问性。理解并正确应用change事件是构建健壮且用户友好的文件上传功能的基础。

以上就是JavaScript 文件上传：实时获取选定文件名教程的详细内容，更多请关注php中文网其它相关文章！