设置窗口动效

介绍

本示例演示在Stage模型下设置窗口显示和隐藏过程中的自定义过渡动画。应用启动后点击按钮创建窗口，并播放显示或隐藏动画。

效果预览

设置窗口显示/隐藏动效

使用说明

1. 安装并打开应用。
2. 点击“show window”按钮，创建窗口并播放显示动画。
3. 点击“hide window”按钮，播放隐藏动画并销毁窗口。

工程目录

WindowAnimationSample
|---entry/src/main/ets
|   |---entryability
|   |   |---EntryAbility.ets              // 加载示例页面
|   |---pages
|   |   |---AnimationConfig.ts            // 窗口动效配置
|   |   |---WindowAnimationDemo.ets       // 创建窗口并触发显示/隐藏动效
|   |   |---WindowContent.ets             // 被创建窗口加载的内容页面
|---screenshots
|   |---showAndHideWindow.gif            // 效果预览图

具体实现

窗口动效配置封装在AnimationConfig.ts中：

• 调用getTransitionController()获取窗口属性转换控制器。
• 设置animationForShown和animationForHidden，分别配置显示、隐藏过程的动画回调。
• 调用showWithAnimation()和hideWithAnimation()播放显示、隐藏动画。

窗口创建和动效触发在WindowAnimationDemo.ets中：

• 通过window.createWindow()创建WindowType.TYPE_FLOAT类型窗口。
• 通过setUIContent()加载WindowContent.ets。
• 通过animateTo()配置平移、旋转、缩放和透明度变化。
• 在动画结束时调用completeTransition(true)完成属性转换。

相关权限

权限名	权限说明	级别
ohos.permission.SYSTEM_FLOAT_WINDOW	允许应用使用悬浮窗的能力	system_basic

依赖

不涉及。

约束与限制

1. 本示例仅支持标准系统上运行，工程配置支持设备：phone、tablet。
2. 本示例为Stage模型，支持API Version 20及以上版本SDK。
3. 本示例需要使用DevEco Studio 6.0.0 Release及以上版本才可编译运行。
4. 本示例所配置的权限ohos.permission.SYSTEM_FLOAT_WINDOW为system_basic级别，需要配置系统应用签名，可参考特殊权限配置方法。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/DocsSample/ArkUISample/ArkUIWindowSamples/WindowAnimationSample/ > .git/info/sparse-checkout
git remote add origin https://gitcode.com/openharmony/applications_app_samples.git
git pull origin master