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

    • 目录
  • 页面与导航

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

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

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

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

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

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

lingyun-page-nav

宽屏左侧目录。一般不用单独放:小程序由 lingyun-app-page 嵌进来,H5 在 app.use(lingyunUi) 时挂到 body。

顶部默认两行:名称「凌云UI」,副标题「一套对齐 Apple Liquid Glass 的 uni-app 多端组件库」。名称和右侧顶栏标题对齐,副标题挂在名称下面,栏高不变。侧栏较窄,介绍超出一行会省略。

示例

<lingyun-page-nav :sections="sections" />

业务页不要直接改这一列。头像、名称、副标题写在 lingyun-app-page 上,见 页面壳。后台数据在登录后写一次:

import { setLingyunPageNavProfile, setLingyunPageNavSections } from '@/router/pageNav'

setLingyunPageNavSections(sections)
setLingyunPageNavProfile({
  avatar: user.avatar,
  name: user.name,
  subtitle: user.org,
})

H5 侧栏只挂一次,页面上的 sections 到不了它。全局菜单用 setLingyunPageNavSections,首页列表读的是同一份。组件演示列表是 /pages/demo/demo,不读这份运行时菜单。

数据源优先级:组件 sections > 全局 setLingyunPageConfig({ tabs }) > setLingyunPageNavSections。使用全局 tabs 时不显示内置「首页」行;badge 渲染角标,match 让详情页继续高亮所属项。宽屏常驻导航仍是分组实底,不是浮动玻璃侧栏。

切换页面时选中项胶囊做 280ms 上下滑动,右侧内容区淡入;小程序宽屏的常驻宿主切换同样适用。

属性

属性说明默认值
sections分组目录。每组 { title, items: [{ title, url, note, icon, badge, match }] }。显式传入时优先级最高;只影响当前这次渲染。H5 常驻侧栏请用 setLingyunPageConfig 或 setLingyunPageNavSections默认目录
avatar顶部头像地址。有头像插槽时不用这张图''
name顶部名称。有名称插槽时不用这段文字凌云UI
subtitle顶部副标题。有副标题插槽时不用这段文字。传入自定义名称且不传副标题时,不显示默认介绍一套对齐 Apple Liquid Glass 的 uni-app 多端组件库

插槽

插槽说明
avatar顶部头像。外框 36 圆,与名称垂直居中
name顶部名称。占原来「凌云UI」那一行
subtitle挂在名称下面

页面上请用 lingyun-app-page 的 nav-avatar、nav-name、nav-subtitle,三个可以只传一部分。

窗口宽度小于 690 时页面壳不会显示这一列。完整宽度 220;全局 tabs 驱动时(iPad / PC,≥690)收窄为 84 通高窄栏,图标在上、文字在下;不再区分平板与 PC。整列铺满左侧区域(无外边距、无圆角、无侧边线),底色与内容卡片相同的 grouped 背景,叠加固定的顶栏同款 tint(不随滚动变化),滚动后与顶栏玻璃同亮度。.lingyun-page-safe-left 保留兼容。未配置 tabs 时仍为 220 行布局。

二级菜单

全局 tabs 的每一项可加 children:

{
  key: 'charts',
  text: '图表',
  icon: 'bars',
  url: '/pages/demo/charts/column',
  children: [
    { key: 'column', text: '柱状图', url: '/pages/demo/charts/column' },
    { key: 'line', text: '折线图', url: '/pages/demo/charts/line' },
  ],
}
  • 宽屏左侧(Web / 小程序一致):点击左侧父项,右侧用 lingyun-menu 弹出二级项;再次点击父项或点击外部关闭。
  • 窄屏 / Duo:点击父项进入固定工作台页(workspaceUrl?tab=<key>),由工作台展示二级入口。
  • workspaceUrl 可配在全局 setLingyunPageConfig,也可配在单个 Tab;没有配置时仍直接进 url。
  • 子项路径自动归入父 Tab 高亮。
Edit this page
最近更新: 2026/10/30 16:08
Contributors: qiu, Claude Fable 5
Prev
平板与电脑
Next
顶栏