Layui layer.prompt 输入框需通过 success 回调、layer.ready 或 layer.on('ready') 动态添加 placeholder,因 input 元素渲染后才存在;老版本需 setTimeout 保障,且须注意 type='password' 隐藏提示及自定义样式影响。

在 Layui 的 layer.prompt 弹窗中,输入框默认没有 placeholder 提示文字,用户首次打开时只能看到空白输入框,容易误以为没加载完成或缺少引导——必须通过 DOM 操作在弹层渲染完成后动态注入 placeholder 属性才能生效。
用 success 回调给 input 添加 placeholder
第一步:调用 layer.prompt 时传入 success 配置项,确保 DOM 已挂载;
第二步:在 success 函数内用 layero.find('input') 定位到输入框元素;
第三步:调用 attr('placeholder', '请输入关键词') 注入提示文字。
这一步必须写在 success 里,因为 layer.prompt 的 input 元素在弹层初始化前不存在,提前 querySelector 会返回 null。部分老版本(如 2.5.4 及更早)需加 setTimeout 包裹才稳定,但 2.5.5+ 可直接操作。
layer.prompt({
title: '请输入用户名',
value: '',
success: function(layero) {
layero.find('input').attr('placeholder', '例如:admin123');
}
}, function(value, index) {
layer.close(index);
});
用 layer.ready + 原生 DOM 方式补全(兼容性更强)
方法一:layer.ready 确保 layer 模块完全就绪后再操作
layer.prompt({ title: '请输入邮箱', value: 'user@example.com' }, function(value, index) { layer.close(index); });
layer.ready(function() {
const input = document.querySelector('.layui-layer-content input');
if(input) {
input.placeholder = '例如:name@domain.com';
}
});
方法二:监听弹层渲染完成事件(适用于动态频繁调用场景)
layer.prompt({ title: '请输入手机号', value: '' }, function(value, index) { layer.close(index); });
layer.on('ready', function() {
const lastLayer = $('.layui-layer:last');
const input = lastLayer.find('input');
if(input.length && !input.attr('placeholder')) {
input.attr('placeholder', '11位数字');
}
});
【注意】layer.ready 必须在 layer.prompt 调用之后执行,否则可能找不到 .layui-layer-content input 元素。
避免踩坑的硬性前提
placeholder 字符串必须是纯文本,不能是函数、undefined 或空数组;
如果同时设置了 type: 'password',浏览器会自动隐藏 placeholder 文字(这是原生行为,Layui 无法干预);
自定义 skin 样式时,若覆盖了 ::-webkit-input-placeholder 伪类且未设 color,placeholder 可能不可见——此时要检查控制台 Elements 面板中 input 元素是否真有 placeholder 属性;
移动端某些安卓机型在软键盘弹出瞬间 placeholder 会短暂消失,属 focus 渲染时机问题,无需额外处理。


















