MediaWiki 里精妙的法条检索设计
Jump to navigation
Jump to search
检索法条时,有两大痛点:
- 汉字序号,Ctrl F 查找时,打字很麻烦
- Ctrl F 关键字时,总得瞅一眼关键字在哪里,产生了心智负担
解决方案:
- 自动根据汉字序号,生成透明的数字序号。以后可以 Ctrl F 查法条了
- 查到法条后,短暂地自动定位并高亮
以前:
想起法条 → 把 538 翻译成「五百三十八」→ Ctrl+F → 搜索 → 眼睛在屏幕中找位置 → 阅读
现在:
想起 538 → Ctrl+F → 输入数字 → 法条自动定位并短暂高亮 → 阅读
可以在 民法典 测试这炫酷的效果。
ChatGPT 的代码设计有三大妙处:
- 原文零侵入:官方法条一字不动,保证文献忠实性。
- 交互零学习:继续使用几十年来习惯的 Ctrl+F,不创造新操作。
- 提示零打扰:需要时突出显示,三秒后自动消失。
具体实现,把以下放入 MediaWiki:Common.js 即可。
/* 以下专为法条设计,生成透明的数字,Ctrl F 检索时只用输数字。且会有一个短暂的位置显色提示 */
/* 法条中文编号自动生成数字搜索别名 */
(function () {
'use strict';
if (mw.config.get('wgAction') !== 'view') return;
// 中文数字转整数
function chineseToNumber(s) {
const digits = {
零: 0, 〇: 0, 一: 1, 二: 2, 两: 2,
三: 3, 四: 4, 五: 5, 六: 6,
七: 7, 八: 8, 九: 9
};
const units = { 十: 10, 百: 100, 千: 1000 };
let total = 0, section = 0, digit = 0;
for (const ch of s) {
if (Object.hasOwn(digits, ch)) {
digit = digits[ch];
} else if (Object.hasOwn(units, ch)) {
section += (digit || 1) * units[ch];
digit = 0;
} else if (ch === '万') {
total += (section + digit) * 10000;
section = 0;
digit = 0;
}
}
return total + section + digit;
}
mw.hook('wikipage.content').add(function ($content) {
const root = $content[0];
if (!root) return;
// 只处理段落、列表项和标题
root.querySelectorAll(
'p, dd, dt, li, h2, h3, h4, h5, h6'
).forEach(function (el) {
if (el.querySelector(':scope > .qlzq-law-alias')) {
return;
}
// 只识别段落开头的“第……条”
const match = el.textContent.match(
/^\s*第([零〇一二两三四五六七八九十百千万]+)条(?=\s|[::]|$)/
);
if (!match) return;
const number = chineseToNumber(match[1]);
if (!number) return;
// 生成透明、可搜索的数字别名
const alias = document.createElement('span');
alias.className = 'qlzq-law-alias';
alias.setAttribute('aria-hidden', 'true');
alias.textContent = '#' + number;
alias.style.cssText =
'position:absolute;' +
'opacity:0;' +
'white-space:nowrap;' +
'pointer-events:none;' +
'user-select:none;';
el.insertBefore(alias, el.firstChild);
});
});
}());
/* Ctrl+F 命中法条时,短暂突出整条法条 */
(function () {
'use strict';
if (mw.config.get('wgAction') !== 'view') return;
// 注入提示样式
const style = document.createElement('style');
style.textContent = `
.qlzq-law-located {
background-color: rgba(245, 197, 61, 0.15) !important;
box-shadow: inset 3px 0 0 #d4a037 !important;
border-radius: 3px;
}
`;
document.head.appendChild(style);
let previous = null;
let timer = null;
function findAlias(node) {
if (!node) return null;
const el = node.nodeType === 1
? node
: node.parentElement;
return el && el.closest
? el.closest('.qlzq-law-alias')
: null;
}
document.addEventListener('selectionchange', function () {
const selection = window.getSelection();
if (!selection || selection.isCollapsed ||
!selection.rangeCount) return;
// 只响应纯数字法条搜索
const text = selection.toString().trim();
if (!/^#?\d+$/.test(text)) return;
// 判断命中的是否为之前生成的法条别名
const alias =
findAlias(selection.anchorNode) ||
findAlias(selection.focusNode) ||
findAlias(selection.getRangeAt(0).startContainer);
if (!alias) return;
const target = alias.parentElement;
if (!target) return;
// 清除上一次提示
if (previous) {
previous.classList.remove('qlzq-law-located');
}
clearTimeout(timer);
// 突出当前法条
target.classList.add('qlzq-law-located');
previous = target;
// 3秒后自动恢复
timer = setTimeout(function () {
target.classList.remove('qlzq-law-located');
if (previous === target) previous = null;
}, 3000);
});
}());