文档开发者中心
我的

#码上创新# 鸿蒙应用“PDF分割器”接入沉浸光感特性实战经验分享(干货)

浏览406发布于2026-05-19 14:52山东
本文章最后由 小鹿 于 2026-05-20 00:12 编辑

本文依托于“PDF分割器”应用的实战改造经验,同时结合官方文档中的示例代码,逐步介绍了接入沉浸光感特性的步骤,不玩虚的,全是干货,通过简单几步即可轻松实现沉浸光感效果!

0900086000300134184.20201216095126.86523331460016843504112994983392.png

从上图可以看到改造后的界面看起来非常精致,尤其是底部的HdsTabs悬浮页签,半透明的模糊效果和光影效果在梦幻背景下显得高级感十足。

PDF分割器是我自己开发的一款好用的工具类app,拥有页面级处理技术,专为解决移动端试卷拆分打印难题而生,已在应用市场上架(点击下载体验),也可以直接在应用市场搜索安装使用,欢迎批评指正,感谢支持!

再给大家看一下改造前的效果,比较简洁,也可以说简陋,哈哈~,感谢沉浸光感让不懂UI的我可以得到一丝安慰,见下图:

cke_8190.png

那么如何才能接入沉浸光感呢,我采用的做法是新建一个页面,将旧版和新版Page独立开来,既方便修改测试又可以兼容低版本系统,以下是详细步骤供大家参考:

1、使用沉浸光感开发指南中的使用系统自适应的沉浸光感示例代码创建一个新页面HdsIndex,代码如下:

收起
自动换行
深色代码主题
复制
import { HdsNavigation, HdsNavigationTitleMode, HdsTabs, HdsTabsController, HdsNavigationMenuContentOptions, ScrollEffectType, hdsMaterial } from '@kit.UIDesignKit';
import { SymbolGlyphModifier } from '@kit.ArkUI';

@Entry
@Component
export struct HdsIndex {
  private scrollerForScroll: Scroller = new Scroller();
  private controller: HdsTabsController = new HdsTabsController();

  private menus: HdsNavigationMenuContentOptions = {
    value: [{
      content: {
        label: 'menu1',
        icon: $r('sys.symbol.square_and_pencil')
      }
    }, {
      content: {
        label: 'menu2',
        icon: $r('sys.symbol.star')
      }
    },{
      content: {
        label: 'menu3',
        icon: $r('sys.symbol.more')
      }
    }
    ]
  };

  build() {
    HdsNavigation() {
      HdsTabs({ controller: this.controller }) {
        ForEach(MENU_CONFIG, (item: MenuItem) => {
          TabContent() {
            Stack() {
              Scroll(this.scrollerForScroll) {
                Column() {
                  //Image($r('app.media.scenery01')).width('100%') // scenery为自定义资源,开发者需替换本地资源
                }
              }
              .clipContent(ContentClipMode.SAFE_AREA)
              .height('100%')
            }
          }
          .tabBar(new BottomTabBarStyle({
            normal: item.symbolGlyph, selected: item.symbolGlyph1
          }, item.label))
        })
      }
      .barOverlap(true)
      .vertical(false)
      .barPosition(BarPosition.End)
      .barFloatingStyle({
        barBottomMargin: 28,
        // 设置沉浸光感效果:ADAPTIVE类型表示自适应系统材质,ADAPTIVE等级表示材质生效策略由系统根据设备性能自适应决定
        systemMaterialEffect: {
          materialType: hdsMaterial.MaterialType.ADAPTIVE,
          materialLevel: hdsMaterial.MaterialLevel.ADAPTIVE // 底部悬浮页签沉浸光感效果跟随系统策略自适应
        }
      })
    }
    .mode(NavigationMode.Stack)
    .titleBar({
      content: {
        title: {
          mainTitle: 'MainTitle',
        },
        menu: this.menus,
      },
      style: {
        scrollEffectOpts: {
          enableScrollEffect: false,
          scrollEffectType: ScrollEffectType.GRADIENT_BLUR,
        },
        // 设置沉浸光感效果:ADAPTIVE类型表示自适应系统材质,ADAPTIVE等级表示材质生效策略由系统根据设备性能自适应决定
        systemMaterialEffect: {
          materialType: hdsMaterial.MaterialType.ADAPTIVE,
          materialLevel: hdsMaterial.MaterialLevel.ADAPTIVE // 标题栏按钮沉浸光感效果跟随系统策略自适应
        },
      },
      avoidLayoutSafeArea: false,
      enableComponentSafeArea: false
    })
    .bindToScrollable([this.scrollerForScroll])
    .hideBackButton(false)
    .titleMode(HdsNavigationTitleMode.MINI)
    .ignoreLayoutSafeArea([LayoutSafeAreaType.SYSTEM], [LayoutSafeAreaEdge.TOP, LayoutSafeAreaEdge.BOTTOM])
  }
}

interface MenuItem {
  symbolGlyph: SymbolGlyphModifier,
  symbolGlyph1: SymbolGlyphModifier,
  label: string,
  defaultBgColor: ResourceColor,
  hoverBgColor: ResourceColor,
  pressBgColor: ResourceColor,
};

const MENU_CONFIG: MenuItem[] = [
  {
    symbolGlyph: new SymbolGlyphModifier($r('sys.symbol.alarm_fill_1')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_bottom_tab_icon_off'),
        $r('sys.color.ohos_id_color_bottom_tab_icon_auxcolor_off02')]),
    symbolGlyph1: new SymbolGlyphModifier($r('sys.symbol.alarm_fill_1')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_activated'), $r('sys.color.ohos_id_color_primary_contrary')]),
    label: '闹钟',
    defaultBgColor: Color.Transparent,
    hoverBgColor: $r('sys.color.ohos_id_color_hover'),
    pressBgColor: $r('sys.color.ohos_id_color_click_effect')
  },
  {
    symbolGlyph: new SymbolGlyphModifier($r('sys.symbol.worldclock_fill_2')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_bottom_tab_icon_off'),
        $r('sys.color.ohos_id_color_bottom_tab_icon_auxcolor_off02')]),
    symbolGlyph1: new SymbolGlyphModifier($r('sys.symbol.worldclock_fill_2')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_activated'), $r('sys.color.ohos_id_color_primary_contrary')]),
    label: '时钟',
    defaultBgColor: Color.Transparent,
    hoverBgColor: $r('sys.color.ohos_id_color_hover'),
    pressBgColor: $r('sys.color.ohos_id_color_click_effect')
  },
  {
    symbolGlyph: new SymbolGlyphModifier($r('sys.symbol.stopwatch_2')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_bottom_tab_icon_off'),
        $r('sys.color.ohos_id_color_bottom_tab_icon_auxcolor_off02')]),
    symbolGlyph1: new SymbolGlyphModifier($r('sys.symbol.stopwatch_2')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_activated'), $r('sys.color.ohos_id_color_primary_contrary')]),
    label: '秒表',
    defaultBgColor: Color.Transparent,
    hoverBgColor: $r('sys.color.ohos_id_color_hover'),
    pressBgColor: $r('sys.color.ohos_id_color_click_effect')
  }
];

注:代码中Image组件图片不存在所以需要注释掉,页面改名为HdsIndex,其他未改动。

2、修改标题,查找“mainTitle”,替换为自己的app名称,如果需要副标题也可以mainTitle下方加上subTitle属性:

cke_1172526.png

代码:

收起
自动换行
深色代码主题
复制
title: {
    mainTitle: '小鹿的沉浸光感改造',
    subTitle: '就是这么简单'
}

3、隐藏返回按钮,查找“hideBackButton”属性,将值从false改为true:

cke_1375921.png

4、修改代码中的 const MENU_CONFIG: MenuItem[] 部分,将底部悬浮页签的图标和名称换成自己需要的功能,图标名称可以在 HarmonyOS Symbol 图标库 查找,label直接改名即可:

cke_848908.png

比如修改为爱心和星星,多余的可以删除,代码:

收起
自动换行
深色代码主题
复制
const MENU_CONFIG: MenuItem[] = [
  {
    symbolGlyph: new SymbolGlyphModifier($r('sys.symbol.heart_fill')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_bottom_tab_icon_off'),
        $r('sys.color.ohos_id_color_bottom_tab_icon_auxcolor_off02')]),
    symbolGlyph1: new SymbolGlyphModifier($r('sys.symbol.heart_fill')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_activated'), $r('sys.color.ohos_id_color_primary_contrary')]),
    label: '喜欢',
    defaultBgColor: Color.Transparent,
    hoverBgColor: $r('sys.color.ohos_id_color_hover'),
    pressBgColor: $r('sys.color.ohos_id_color_click_effect')
  },
  {
    symbolGlyph: new SymbolGlyphModifier($r('sys.symbol.star_fill')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_bottom_tab_icon_off'),
        $r('sys.color.ohos_id_color_bottom_tab_icon_auxcolor_off02')]),
    symbolGlyph1: new SymbolGlyphModifier($r('sys.symbol.star_fill')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_activated'), $r('sys.color.ohos_id_color_primary_contrary')]),
    label: '星标',
    defaultBgColor: Color.Transparent,
    hoverBgColor: $r('sys.color.ohos_id_color_hover'),
    pressBgColor: $r('sys.color.ohos_id_color_click_effect')
  }
];

5、修改标签页内容,查找“ForEach”循环,增加index参数,根据index的值显示不同的内容,形成条件渲染:

cke_2184531.png

6、修改右上角菜单按钮,查找“private menus”,为了简洁便于演示我们修改为一个更多按钮,label直接改名,这里的icon图标名称同样可以在 HarmonyOS Symbol 图标库 查找,增加了action属性,可以写跳转页面等业务逻辑:

收起
自动换行
深色代码主题
复制
  private menus: HdsNavigationMenuContentOptions = {
    value: [{
      content: {
        label: '更多',
        icon: $r('sys.symbol.more'),
        action:()=>{
          //略
        }
      }
    }]
  };

7、由于从6.1.0(23) 版本开始,才支持沉浸光感材质能力,可以在EntryAbility中做低版本兼容判断。打开EntryAbility.ets文件,在顶部引入deviceInfo:

收起
自动换行
深色代码主题
复制
import { deviceInfo } from '@kit.BasicServicesKit';

查找“pages/Index”,修改为以下代码,即当API>=23时加载沉浸光感页面,否则加载未改造前的页面:

收起
自动换行
深色代码主题
复制
windowStage.loadContent(deviceInfo.sdkApiVersion >= 23 ? 'pages/HdsIndex' : 'pages/Index', (err) => {//略

cke_3917252.png

这样简单几步我们就完成了沉浸光感的改造,其他部分甚至不用修改就可以直接用,改造后的实际运行效果如下:

0900086000300134184.20201216095126.86523331460016843504112994983392.png

附完整示例代码(增加了渐变背景):

收起
自动换行
深色代码主题
复制
import {
  HdsNavigation,
  HdsNavigationTitleMode,
  HdsTabs,
  HdsTabsController,
  HdsNavigationMenuContentOptions,
  ScrollEffectType,
  hdsMaterial
} from '@kit.UIDesignKit';
import { SymbolGlyphModifier } from '@kit.ArkUI';

/**
 * 本示例依托于作者(小鹿)开发“PDF分割器”应用的实战经验,同时结合文档中的示例代码,实现了沉浸光感的改造
 */
@Entry
@Component
export struct HdsIndex {
  private scrollerForScroll: Scroller = new Scroller();
  private controller: HdsTabsController = new HdsTabsController();
  private menus: HdsNavigationMenuContentOptions = {
    value: [{
      content: {
        label: '更多',
        icon: $r('sys.symbol.more'),
        action: () => {
          //略
        }
      }
    }]
  };

  build() {
    HdsNavigation() {
      HdsTabs({ controller: this.controller }) {
        ForEach(MENU_CONFIG, (item: MenuItem, index) => {
          TabContent() {
            Stack() {
              Scroll(this.scrollerForScroll) {
                Column() {
                  if (index == 0) {
                    //页签1内容
                    Text('喜欢的内容')
                  } else if (index == 1) {
                    //页签2内容
                    Text('星标的内容')
                  }
                }
              }
              .clipContent(ContentClipMode.SAFE_AREA)
              .height('100%')
            }
          }
          .tabBar(new BottomTabBarStyle({
            normal: item.symbolGlyph, selected: item.symbolGlyph1
          }, item.label))
        })
      }
      .barOverlap(true)
      .vertical(false)
      .barPosition(BarPosition.End)
      .barFloatingStyle({
        barBottomMargin: 28,
        // 设置沉浸光感效果:ADAPTIVE类型表示自适应系统材质,ADAPTIVE等级表示材质生效策略由系统根据设备性能自适应决定
        systemMaterialEffect: {
          materialType: hdsMaterial.MaterialType.ADAPTIVE,
          materialLevel: hdsMaterial.MaterialLevel.ADAPTIVE // 底部悬浮页签沉浸光感效果跟随系统策略自适应
        }
      })
    }
    .mode(NavigationMode.Stack)
    .titleBar({
      content: {
        title: {
          mainTitle: '小鹿的沉浸光感改造',
          subTitle: '就是这么简单' //副标题
        },
        menu: this.menus, //右上角菜单,如不需要可以去掉
      },
      style: {
        scrollEffectOpts: {
          enableScrollEffect: false,
          scrollEffectType: ScrollEffectType.GRADIENT_BLUR,
        },
        // 设置沉浸光感效果:ADAPTIVE类型表示自适应系统材质,ADAPTIVE等级表示材质生效策略由系统根据设备性能自适应决定
        systemMaterialEffect: {
          materialType: hdsMaterial.MaterialType.ADAPTIVE,
          materialLevel: hdsMaterial.MaterialLevel.ADAPTIVE // 标题栏按钮沉浸光感效果跟随系统策略自适应
        },
      },
      avoidLayoutSafeArea: false,
      enableComponentSafeArea: false
    })
    .bindToScrollable([this.scrollerForScroll])
    .hideBackButton(true) //隐藏返回按钮
    .titleMode(HdsNavigationTitleMode.MINI)
    // 渐变背景 从上到下
    .linearGradient({
      direction: GradientDirection.Bottom,
      colors: [
        [Color.White, 0.0],
        [Color.Yellow, 1.0]
      ]
    })
    .ignoreLayoutSafeArea([LayoutSafeAreaType.SYSTEM], [LayoutSafeAreaEdge.TOP, LayoutSafeAreaEdge.BOTTOM])
  }
}

interface MenuItem {
  symbolGlyph: SymbolGlyphModifier,
  symbolGlyph1: SymbolGlyphModifier,
  label: string,
  defaultBgColor: ResourceColor,
  hoverBgColor: ResourceColor,
  pressBgColor: ResourceColor,
};

const MENU_CONFIG: MenuItem[] = [
  {
    symbolGlyph: new SymbolGlyphModifier($r('sys.symbol.heart_fill')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_bottom_tab_icon_off'),
        $r('sys.color.ohos_id_color_bottom_tab_icon_auxcolor_off02')]),
    symbolGlyph1: new SymbolGlyphModifier($r('sys.symbol.heart_fill')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_activated'), $r('sys.color.ohos_id_color_primary_contrary')]),
    label: '喜欢',
    defaultBgColor: Color.Transparent,
    hoverBgColor: $r('sys.color.ohos_id_color_hover'),
    pressBgColor: $r('sys.color.ohos_id_color_click_effect')
  },
  {
    symbolGlyph: new SymbolGlyphModifier($r('sys.symbol.star_fill')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_bottom_tab_icon_off'),
        $r('sys.color.ohos_id_color_bottom_tab_icon_auxcolor_off02')]),
    symbolGlyph1: new SymbolGlyphModifier($r('sys.symbol.star_fill')).renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
      .fontColor([$r('sys.color.ohos_id_color_activated'), $r('sys.color.ohos_id_color_primary_contrary')]),
    label: '星标',
    defaultBgColor: Color.Transparent,
    hoverBgColor: $r('sys.color.ohos_id_color_hover'),
    pressBgColor: $r('sys.color.ohos_id_color_click_effect')
  }
];

就写到这里啦,如果您觉得有用欢迎点赞、评论、关注、转发,也希望大家多多支持我的应用~

收藏
4
回复
6
分享
全部评论
authorIcon
飞b6
学到了,之前想改造来着,然后也问了ai,还给导航条给改丢了,最后放弃了
回复于2026-07-03 17:25辽宁
authorIcon
晴天

你好,如果我想要APP自定义主题颜色同步到选中的高亮图标颜色同步(不一直要蓝色)应该怎么写呢,因为源代码在数组里面不知道怎么写进去


回复于2026-05-29 16:33贵州
authorIcon作者
小鹿
沉浸光感改造保姆级教程,感谢支持~
回复于2026-05-21 06:58山东
authorIcon
hid40612273
😀
回复于2026-05-20 07:25广东
authorIcon
飞行员舒克
优秀
回复于2026-05-20 06:00广东
authorIcon
投资堂
赞
回复于2026-05-20 01:14浙江
写评论
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。
发表
我要写文章
了解社区公约,与您携手共创和谐专业的开发者社区。