实现 HtmlEntity 工具

分类：developer ｜ 标签：HTML、实体、转义 特殊字符与 HTML 实体互转

2.1 功能说明

特殊字符与 HTML 实体互转

2.1.1 使用指南

功能说明

将文本中的特殊字符（& < > " '）与 HTML 实体互相转换；解码时同时支持命名实体与数值实体。

使用场景

富文本处理、XSS 排查、报文调试。

2.2 代码实现

2.2.1 组件结构

本工具是一个基于 Vue 3 <script setup> 语法的单文件组件（SFC），统一包裹在 ToolPageShell 组件内，由它提供页面标题、工具 ID、分类与「使用指南」插槽等通用外壳；核心业务逻辑（响应式状态、计算属性、事件处理函数）全部写在 <script setup> 中，输入/输出通过 el-input、el-button 等 Element Plus 组件与用户交互，所有数据均在浏览器本地处理，不会上传服务器。

2.2.2 核心逻辑概览

<script setup> 中定义的主要函数/方法：

• encode()
• decode()
• clear()
• copy()

2.2.3 关键实现代码

以下是该工具的完整 <script setup> 实现（核心代码）。模板（<template>）与样式（<style>）已省略。

import { ref } from 'vue'
import ToolPageShell from '@/components/ToolPageShell.vue'

const input = ref('')
const output = ref('')

const MAP = { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }
const UNMAP = { '&amp;': '&', '&lt;': '<', '&gt;': '>', '&quot;': '"', '&#39;': "'", '&apos;': "'" }

function encode() {
  output.value = input.value.replace(/[&<>"']/g, c => MAP[c])
}
function decode() {
  let s = input.value.replace(/&(amp|lt|gt|quot|#39|apos);/g, m => UNMAP[m])
  s = s.replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d)))
  s = s.replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16)))
  output.value = s
}
function clear() { input.value = output.value = '' }
function copy() { if (output.value) navigator.clipboard?.writeText(output.value) }

2.3 效果截图

工具访问地址：https://www.i91tools.com/tools/html-entity