基于原生CSS+JS实现一个标签输入框
最近在项目中需要做一个标签输入框，还挺实用的，演示效果如下：
主要交互要求是这样的：
- 点击输入框可以输入内容。
- 按回车可以生成标签。
- 按退格键可以删除标签。
- 点击标签上的关闭按钮可以删除标签。
习惯了各种 react 框架或者UI库，大家有多久没接触没有原生开发了呢?有时候页面比较简单，没必要引入一个完整的框架，原生实现就完全满足了，一起看看吧！
一、自适应输入框布局
不管什么组件，布局都是最重要的。这个布局分为标签和输入框两个部分，假设 HTML 如下：
<div class="tags-content"> <tag>CSS<a class="tag-close"></a></tag> <input class="tags-input" placeholder="添加标签"> </div>
简单修饰一下：
.tags-content{
display: flex;
flex-wrap: wrap;
align-items: flex-start;
gap: 6px;
width: 400px;
box-sizing: border-box;
padding: 8px 12px;
border: 1px solid #D9D9D9;
border-radius: 4px;
font-size: 16px;
line-height: 24px;
color: #333;
outline-color: #4F46E5;
overflow: auto;
cursor: text;
}
tag{
display: flex;
align-items: center;
padding: 4px 0 4px 8px;
font-size: 16px;
line-height: 24px;
background: #F5F5F5;
color: rgba(0, 0, 0, 0.85);
cursor: default;
}
tag-close{
width: 18px;
height: 18px;
cursor: pointer;
background: url("data:image/svg+xml,%3Csvg width='10' height='10' viewBox='0 0 10 10' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M5.578 5l2.93-3.493a.089.089 0 0 0-.068-.146h-.891a.182.182 0 0 0-.137.064l-2.417 2.88-2.416-2.88a.178.178 0 0 0-.137-.064h-.89a.089.089 0 0 0-.069.146L4.413 5l-2.93 3.493a.089.089 0 0 0 .068.146h.89a.182.182 0 0 0 .138-.064l2.416-2.88 2.417 2.88c.033.04.083.064.137.064h.89a.089.089 0 0 0 .069-.146l-2.93-3.493z' fill='%23000' fill-opacity='.45'/%3E%3C/svg%3E") center no-repeat;
}
.tags-input{
flex: auto;
border: 0;
outline: 0;
padding: 4px 0;
line-height: 24px;
font-size: 16px;
}
.tags-content:focus-within,
.tags-content:active{
outline: auto #4F46E5;
}
注意几点实现技巧：
- 标签的间隔可以用 gap 实现。
- 为了让输入框的区域铺满剩余空间，这里用到了flex: auto。
- 为了让父级处于聚焦状态，这里用到了:focus-within。
效果如下：
但是这里的输入框用 input 还是有些问题的，如下所示：
由于 input 输入内容无法跟随宽度自适应，所以有时候会出现文字被截断的情况：
理想情况下，当输入内容较多时，应该整体换行。如何实现呢?可以用普通的 div 来实现。
<div class="tags-content"> <tag>CSS<a class="tag-close"></a></tag> <div class="tags-input" placeholder="添加标签"></div> </div>
可以通过添加contenteditable或者以下 CSS 来实现：
.tags-input{
-webkit-user-modify: read-write-plaintext-only;
}
这个属性表示只允许输入纯文本，有兴趣的可以参考张鑫旭的这篇文章：小tip: 如何让contenteditable元素只能输入纯文本[1]。
这样可以自适应内容宽度了。
二、输入框占位提示
由于输入框已经从 input 换成了普通的 div 标签，并没有 placeholder 特性。不过，我们仍然可以通过其他 CSS 特性来实现占位效果，当输入框没有内容时，就可以匹配到 :empty选择器，然后通过伪元素::before动态生成 placeholder 内容，具体实现如下：
.tags-input:empty::before{
content: attr(placeholder);
color: #828282;
}
效果如下：
这样就几乎和 input 的占位效果一致了。
另外还有一种情况，如果需要仅在没有任何标签的情况下才显示占位，如何实现呢?可以想想，在没有任何标签的情况下，HTML 就变成了这样：
<div class="tags-content"> <div class="tags-input" placeholder="添加标签"></div> </div>
这种情况，就仅剩输入框唯一元素了，唯一元素可以通过:only-child来匹配，所以实现如下：
.tags-input:only-child:empty::before{
content: attr(placeholder);
color: #828282;
}
这样添加一个伪类就解决了。
两种需求都符合认知，看设计如何决定了。
三、标签的输入与删除
要实现标签的输入与删除就需要 JS 出马了，只需要监听键盘的“回车”和“退格”两个键值。需要注意的是，默认情况下，普通 contenteditable元素在回车时，会出现换行，如下：
因此，在监听键盘事件时需要阻止默认事件，然后动态创建标签元素，通过 before添加到输入框前面，具体实现如下：
// TagInput是输入框
TagInput.addEventListener('keydown', function(ev) {
if (ev.key === 'Enter') {
ev.preventDefault()
if (this.innerText) { // 输入框内容通过 innerText 获取
const tag = document.createElement('TAG');
tag.innerHTML = this.innerText + '<a class="kalos-tag-close"></a>';
this.before(tag);
this.innerText = '';
}
}
})
这样就能正常创建标签了。
然后是标签的删除。
这里有两种途径，首先看键盘的删除，具体逻辑是当输入框内容为空时删除标签，很简单，删除的标签就是输入框的前面一个元素，通过previousElementSibling获取，具体实现如下：
TagInput.addEventListener('keydown', function(ev) {
if (ev.key === 'Backspace' && !this.innerText) {
this.previousElementSibling?.remove(); // 需要判断前一个元素是否存在
}
})
然后是点击删除图标的删除。由于标签是动态生成的，所以这里需要用事件委托的方式来添加删除事件。
// TagContent是父级容器
TagContent.addEventListener('click', function(ev) {
if (ev.target.className === 'tag-close') {
ev.target.parentNode.remove();
}
TagInput.focus(); //点击任意地方输入框都需要聚焦
})
这样就实现了文章开头的所示效果：
四、选择框架还是原生
总结一下！
整体实现并不算复杂，不少交互逻辑 CSS 也可以轻松实现，JS 也就 10 来行代码，这里总结一下实现要点：
- 普通 div 元素输入纯文本可以使用 -webkit-user-modify: read-write-plaintext-only
- 普通 div 元素输入可以自适应内容宽度
- 普通 div 元素输入框的 placeholder 占位可以通过 :empty 结合伪元素实现
- 回车事件需要阻止默认事件，不然会换行
- 在一个元素的前面新增元素可以用 before 方法
- 删除一个元素的前面一个元素，可以用 previousElementSibling.remove 方法
- 给动态生成的元素绑定事件可以用事件委托的方式
在各种框架大行其道的氛围下，有些原生的属性和方法可能都不太关注了，这也不失为是一种损失。当然，我本身也是各种框架都会用，特别是大型、复杂的交互页面，一般比较小的交互，比如文章这个例子，在 ant design 中有相关的组件，也使用过，因为整体 UI 全是这种风格，设计也是按照这个设计的。后来需要单独开发一个 chrome 插件，也用到了这样一个交互，但是仅仅用了这样一个组件，引入整个框架就过于累赘了，所以还是选择直接原生实现，简单方便。
