Input 输入框¶

现代化的文本输入框，支持前置图标、密码模式和焦点高亮。设计风格参考 shadcn-ui。

基础用法¶

输入框预览

from monkeyqt import MkInput

# 普通输入框
input_field = MkInput(placeholder="请输入内容" ))

带前置图标¶

使用 Phosphor 图标库中的图标名称作为前置图标：

# 带用户图标的输入框input_user = MkInput(placeholder="请输入用户名", leading_icon="user")

# 带搜索图标的输入框input_search = MkInput(placeholder="搜索...", leading_icon="magnifying-glass")

# 带邮箱图标的输入框input_email = MkInput(placeholder="请输入邮箱",  leading_icon="envelope")

图标名称

图标名称来自 Phosphor Icons，例如 user、envelope、lock、magnifying-glass 等。图标会在输入框获得焦点时自动变为蓝色高亮。

密码输入框 &¶

# 密码模式：输入内容后右侧会出现显示/隐藏密码的眼睛按钮input_pwd = MkInput(placeholder="请输入密码",  is_password=True, leading_icon="lock")

密码输入框的特性：

默认以圆点遮挡输入内容
当输入框中有内容时，右侧自动显示 👁 切换按钮
点击切换按钮可以切换密码的明文//密文显示

禁用状态 &¶

input_disabled = MkInput(placeholder="不可编辑")
input_disabled.setEnabled(False)

API¶

构造函数 &¶

MkInput(placeholder="", is_password=False, leading_icon=None, parent=None)

参数	类型	默认值	说明
`placeholder`	`str`	`""`	占位文本
`is_password`	`bool`	`False`	是否为密码模式
`leading_icon`	`str`	`None`	前置 Phosphor 图标名称
`parent`	`QWidget`	`None`	父组件

样式特性¶

状态	边框颜色	说明
默认	`#e2e8f0`	浅灰边框
悬停	`#cbd5e1`	边框加深
聚焦	`#3b82f6`	蓝色聚焦环
禁用	`#e2e8f0`	灰色背景

继承¶

MkInput 继承自 QLineEdit，支持 textChanged、text()、setText() 等所有原生方法