docs: 优化部分注释文案,避免非技术人员理解错位

尽量避免词汇:监听、侦听。可用事件「触发」或「响应」等相近含义的词语替代
pull/2637/head
贤心 2025-04-16 19:39:45 +08:00
parent fd7ea4592d
commit 8cc9949bdf
1 changed files with 7 additions and 7 deletions

View File

@ -680,15 +680,15 @@
}();
/**
* 监听指定元素外部的点击
* @param {HTMLElement} target - 被监听的元素
* 绑定指定元素外部的点击事件
* @param {HTMLElement} target - 响应事件的元素
* @param {(e: Event) => void} handler - 事件触发时执行的函数
* @param {object} [options] - 选项
* @param {string} [options.event="pointerdown"] - 监听的事件类型
* @param {HTMLElement | Window} [options.scope=document] - 监听范围
* @param {Array<HTMLElement | string>} [options.ignore] - 忽略监听的元素或选择器字符串
* @param {boolean} [options.capture=true] - 对内部事件侦听器使用捕获阶段
* @returns {() => void} - 返回一个停止事件监听的函数
* @param {string} [options.event="pointerdown"] - 事件类型
* @param {HTMLElement | Window} [options.scope=document] - 事件范围
* @param {Array<HTMLElement | string>} [options.ignore] - 忽略触发事件的元素或选择器字符串
* @param {boolean} [options.capture=true] - 对内部事件 listener 使用捕获阶段
* @returns {() => void} - 返回一个停止事件响应的函数
*/
lay.onClickOutside = function(target, handler, options){
options = options || {};