1. 选择弹窗到底解决的是什么问题
1.1 从页面跳转到弹窗的交互演进
很多人在第一次接触前端开发时,遇到"需要做一个选择"的需求,第一反应是跳转页面:列表页跳到详情页,详情页跳到编辑页,编辑页提交完再跳回来。但实际做下来会发现,这种方式在"临时选择"场景下特别别扭——用户本来只是想选一个负责人、挑一种支付方式、确认一个操作,结果被迫离开当前页面,来回加载,不仅慢,而且很容易在跳转过程中丢掉之前的操作状态。
我自己第一次被"弹窗需求"打脸,是做一个后台工单系统。当时需求方说"在工单列表里加一个分配功能,点击分配按钮弹出一个框,里面列出所有处理人,选了之后工单直接挂上去"。当时图省事,直接跳转到单独的分配页面,结果被吐槽"为什么我每条工单都要跳转一次?"从那以后我就明白了:当选择动作本身是当前流程的中间步骤,而不是终点时,弹窗是最自然的交互形态。
选择弹窗的本质,是在不打断当前上下文的前提下,把"选择"这个动作压缩成一个即时响应的小交互。用户不用离开当前页面,不用记忆临时信息,点了就有反馈,选完就带回结果。这种模式在电商支付、后台分配、商品筛选、数据管理等场景里无处不在。
1.2 选择弹窗和普通弹窗的分界点
说到弹窗,很多人会把提示弹窗、广告弹窗、选择弹窗混为一谈。但从代码实现看,它们的侧重点完全不同。
- 提示类弹窗(如"保存成功"):核心是单向通知,用户只能点确认,几乎没有反馈回路。
- 广告类弹窗(如优惠券弹窗):核心是曝光和引流,通常带图片和跳转按钮。
- 选择类弹窗(如选支付方式、选负责人):核心是用户主动决策,需要明确的可选项、选中状态、确认/取消动作,以及结果回传。
这也是为什么很多UI库里的Modal组件,虽然能满足80%的弹窗场景,但真正做选择弹窗时,还是需要自己再封装一层。因为选择弹窗的复杂度不在于"弹出来"这个动作,而在于"选项怎么组织、怎么选中、结果怎么带回来"这一条完整链路。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 手写一个原子级选择弹窗:结构、状态、交互拆开看
2.1 弹窗的HTML骨架:遮罩层与面板缺一不可
一个最基础的选择弹窗,HTML结构就三块:触发按钮、遮罩层、弹窗面板。遮罩层负责把背景压暗、拦截背景点击;面板负责承载选项内容和操作按钮。
我习惯的写法是这样:
html复制<!DOCTYPE html>
<html lang="zh-cn">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>选择弹窗基础示例</title>
<style>
/* 遮罩层 */
.modal-mask {
display: none;
position: fixed;
inset: 0;
background: rgba(0, 0, 0, 0.45);
z-index: 999;
}
/* 弹窗面板 */
.modal-panel {
display: none;
position: fixed;
left: 50%;
top: 50%;
transform: translate(-50%, -50%);
width: 320px;
background: #fff;
border-radius: 8px;
z-index: 1000;
box-shadow: 0 6px 24px rgba(0, 0, 0, 0.15);
}
.modal-panel.active,
.modal-mask.active {
display: block;
}
.modal-header {
padding: 14px 16px;
border-bottom: 1px solid #eee;
font-size: 16px;
font-weight: 600;
}
.modal-body {
padding: 16px;
}
.modal-footer {
padding: 12px 16px;
text-align: right;
border-top: 1px solid #eee;
}
.modal-footer button {
margin-left: 8px;
padding: 6px 16px;
border: none;
border-radius: 4px;
cursor: pointer;
}
.btn-confirm {
background: #1677ff;
color: #fff;
}
.btn-cancel {
background: #f0f0f0;
color: #333;
}
</style>
</head>
<body>
<button id="openModalBtn">选择处理人</button>
<!-- 遮罩层 -->
<div class="modal-mask" id="mask"></div>
<!-- 弹窗面板 -->
<div class="modal-panel" id="panel">
<div class="modal-header">选择处理人</div>
<div class="modal-body">
<!-- 选项列表由JS生成 -->
<ul id="optionList"></ul>
</div>
<div class="modal-footer">
<button class="btn-cancel" id="cancelBtn">取消</button>
<button class="btn-confirm" id="confirmBtn">确定</button>
</div>
</div>
<script>
// 状态定义
const state = {
visible: false,
selectedUser: null,
users: [
{ id: 1, name: '张三' },
{ id: 2, name: '李四' },
{ id: 3, name: '王五' }
]
};
</script>
</body>
</html>
这里有几个结构上的关键点:
第一,遮罩层和弹窗面板是兄弟节点。有些同学会把面板直接套在遮罩里面,写成mask > panel的结构,虽然视觉上没问题,但后续做点击遮罩关闭、动画分离的时候会变得很麻烦。兄弟节点可以各自控制显隐、各自做过渡动画,互不干扰。
第二,z-index一定要给遮罩和面板留出足够层级。我见过不少项目里弹窗被某个position: relative的父级容器盖住的情况,最后排查下来都是z-index和层叠上下文的问题。这里的取值只是一个基准,实际项目里如果页面结构复杂,建议把弹窗层统一提到body下直接挂载,避免被嵌套容器的层叠上下文锁死。
2.2 打开、关闭、回收:最少的状态管理
弹窗核心的状态其实只有三个:是否可见、当前选中的项、确认或取消后的回调。没必要一上来就用Vue、React的全局状态管理,简单场景里一个局部对象就够了。
先看最原始的原生写法:
javascript复制// DOM引用
const mask = document.getElementById('mask');
const panel = document.getElementById('panel');
const optionList = document.getElementById('opti
