更新记录

0.2.0（2026-09-05） 下载此版本

• 新增 centerClickable：中间区域（default 插槽）可接收点击；仅 Web / 小程序需要开启（#ifndef APP-ANDROID || APP-IOS || APP-HARMONY 下 pointer-events: auto），App 端无 pointer-events 限制无需处理
• 修复 App（含蒸汽）组件隔离下 type="primary" 时 CSS 变量失效：背景色与反白文字改用内联 var(--nax-color-*,fallback) 字符串兜底（#ifdef APP-ANDROID || APP-IOS || APP-HARMONY），其它端行为不变

0.1.6（2026-08-18） 下载此版本

• 蒸汽模式兼容：lines CSS 声明迁移为 <text> 的 :max-lines 属性（官方蒸汽模式方案），消除 Vapor 运行时与 CSS 编译器警告

0.1.4（2026-08-14） 下载此版本

• readme 统一主题小节：通过 CSS 变量覆盖表格（button 风格），补充组件可覆盖的主题 Token

平台兼容性

uni-app x(4.25)

其他

# nax-nav-bar

自定义顶部导航栏（需页面 navigationStyle: custom）。面向 uni-app x：状态栏安全区、fixed 占位、返回栈兜底、微信小程序胶囊预留。

用法

<template>
  <view class="page">
    <nax-nav-bar title="页面标题" home-url="/pages/index/index" />
    <view class="body">
      <!-- 页面内容；fixed 默认会插入占位 -->
    </view>
  </view>
</template>

pages.json：

{
  "path": "pages/demo/index",
  "style": {
    "navigationStyle": "custom",
    "navigationBarTitleText": ""
  }
}

自定义右侧

<nax-nav-bar title="详情">
  <template #right>
    <nax-icon name="search" size="22" @click="onSearch" />
  </template>
</nax-nav-bar>

仅事件、不自动返回

<nax-nav-bar title="编辑" :auto-back="false" @back="onBack" />

Props

事件

插槽

主题

通过 CSS 变量覆盖：

依赖

• nax-icon
• nax-ui-theme（可选，提供统一 token）

注意

1. 页面必须 navigationStyle: custom，否则会与系统导航栏叠层。
2. 微信小程序会为右侧预留胶囊宽度；其它小程序无胶囊 API 时不做错误 margin。
3. 首页 / tab 页通常设 show-back=false，或配置 home-url 作为栈底出口。
4. Web/小程序端中间插槽默认不接收点击（pointer-events: none），需开启 center-clickable 并在插槽内容上自行绑定 @click；App 端无此限制。