PyScript 的 py-click 事件绑定要求 Python 函数显式声明事件参数（如 evt），否则会因参数不匹配而静默失败或报错；本文详解正确写法、常见误区及调试技巧。
pyscript 的 `py-click` 事件绑定要求 python 函数显式声明事件参数（如 `evt`），否则会因参数不匹配而静默失败或报错；本文详解正确写法、常见误区及调试技巧。
在 PyScript 中，使用 py-click="hello" 绑定点击事件时，底层机制会自动将浏览器原生的 MouseEvent（或其他对应事件对象）作为第一个参数传入 Python 函数。这意味着：即使你的逻辑不需要访问事件细节，函数签名也必须兼容该调用约定。
你当前的定义：
def hello():
link = url.value
display.innerText = link会导致运行时报错：
TypeError: hello() takes 0 positional arguments but 1 was given
因为 PyScript 实际执行的是 hello(event)，而函数未声明接收参数。
✅ 正确写法（推荐）——显式接收并可选使用事件对象：
import requests
from pyscript import document
url = document.querySelector("#url")
display = document.querySelector("#display")
display.innerText = "a"
def hello(evt): # ← 关键：添加 evt 参数
link = url.value.strip()
if link:
display.innerText = f"Submitted: {link}"
else:
display.innerText = "⚠️ URL cannot be empty"✅ 替代写法（不推荐用于生产）——忽略所有参数：
def hello(*args):
link = url.value.strip()
display.innerText = link⚠️ 注意事项：
-
evt参数是标准 DOM 事件对象，支持evt.preventDefault()（防止表单默认提交）、evt.target等操作； - 若按钮位于
<form></form>内且未阻止默认行为，页面可能意外刷新——建议在hello(evt)中调用evt.preventDefault()； - 确保
main.py已被 PyScript 正确加载（检查浏览器控制台是否有Failed to load module错误）； -
document.querySelector应在函数内或确保 DOM 已就绪时调用；当前代码中提前获取url和display是安全的，因为 PyScript 默认在 DOMContentLoaded 后执行脚本。
? 小技巧：添加简单日志辅助调试：
def hello(evt):
print("? Button clicked! Event:", evt.type) # 输出到浏览器控制台
# ... 其余逻辑总结：PyScript 的事件处理器不是“无参回调”，而是严格遵循 Web API 的事件驱动模型。始终为 py-click、py-input、py-submit 等事件函数预留至少一个参数（通常命名为 evt），这是保证交互逻辑可靠触发的关键前提。
