凌云UI 使用手册
接入
组件
图表
页面
  • 总览
  • 组件 1.0.42
  • 图表 1.0.27
  • 页面包 1.0.3
GitHub
接入
组件
图表
页面
  • 总览
  • 组件 1.0.42
  • 图表 1.0.27
  • 页面包 1.0.3
GitHub
  • 组件

    • 目录
  • 页面与导航

    • 页面壳
    • 窄屏
    • 平板与电脑
    • 宽屏目录
    • 顶栏
    • 主题切换
    • 底栏
    • 搜索栏
    • 侧栏浮层
  • 基础控件

    • 布局
    • 按钮
    • 图标
    • 角标
    • 分段控件
    • 标签
    • 筛选胶囊
    • 文本
    • 图片
    • 头像
    • 分页点
  • 表单

    • 输入框
    • 表单
    • 表单分组
    • 表单行
    • 开关
    • 步进器
    • 日期切换器
    • 复选框
    • 单选
    • 单选组
    • 多选列表
    • 单选列表
    • 滑条
    • 选择器
    • 日期选择器
    • 级联选择
  • 列表与内容

    • 列表
    • 列表行
    • 分组卡片
    • 表格
    • 滑动容器
    • 滑动行
    • 空状态
    • 骨架屏
    • 下拉刷新
    • 宫格
    • 索引列表
  • 反馈

    • 加载转圈
    • 进度
    • 轻提示
    • 加载遮罩
    • 反馈宿主
  • 浮层

    • 弹窗
    • 底部面板
    • 操作列表
    • 分享面板
    • 气泡
    • 菜单
    • 上下文菜单
    • 悬浮按钮
    • 商品导航

lingyun-alert

居中确认框。两种用法:用 JS 直接弹(uni.showLingyunAlert),或在页面里放组件。

JS 调用

不用放组件,页面在 lingyun-app-page 里就行。返回 Promise,关闭时告诉你点了哪个按钮。

await uni.showLingyunAlert('保存成功')

const res = await uni.showLingyunAlert({
  title: '删除这张订单?',
  message: '删除后不能恢复。',
  showCancel: true,
  confirmText: '删除',
})
if (res.confirm) remove()

uni.hideLingyunAlert()
选项说明默认值
title / message标题 / 正文。直接传字符串时是正文''
actions按钮,同组件。不传时按下面三项生成—
confirmText确定按钮文字确定
cancelText取消按钮文字取消
showCancel带取消按钮false
inputs输入框,最多 2 个[]
layout / maskClosable同组件—

结果:{ confirm, cancel, index, action, values }。confirm 表示点了非取消的按钮;点遮罩或调 hideLingyunAlert 关闭时 cancel 为 true、index 为 -1;values 是输入框的值。新弹一个会顶掉旧的,旧的按取消结束。

组件示例

<lingyun-alert
  v-model:show="visible"
  title="删除这张订单?"
  message="删除后不能恢复。"
  :actions="[
    { text: '取消', role: 'cancel' },
    { text: '删除', primary: true },
  ]"
  @action="onAction"
/>

属性

属性说明默认值
show / modelValue是否打开—
title标题''
message正文''
actions按钮:{ text, role, primary }[]
layoutauto 按按钮数量横排或竖排auto
inputs可选输入行:{ key, type, password, value, placeholder, maxlength, multiline, autoHeight, rows },最多 2 个;内部使用 lingyun-text-field。multiline: true 或 type: 'textarea' 为多行备注模式[]
autoFocus打开后自动聚焦第一个输入框。输入弹窗不做缩放入场,等输入框挂载稳定后再聚焦(约 220ms);键盘上推走布局位移,不做补间true
maskClosable点遮罩关闭false
closeOnAction点按钮后关闭true

含输入框时,键盘上推使用布局位移,不对原生输入层所在容器做 transform,也不做位移补间;打开时等输入框挂载稳定后再聚焦。关闭时若键盘还开着,会先收起键盘,等键盘落下后再播放正常退场动画。页面请保持 lingyun-app-page 默认页面级滚动(pageScroll=true),不要把 alert 放进内层 scroll-view,与仓库 design/TEXTFIELDS.md §5 的键盘避让约束一致。

事件

事件说明
action点了哪个按钮
Edit this page
最近更新: 2026/10/24 13:48
Contributors: qiu, Claude Fable 5
Next
底部面板