鸿蒙5.0开发进阶:ArkTS组件-卡片(FormMenu)

鸿蒙5.0版开发:ArkTS组件-卡片(FormMenu) 通过桌面访问该应用快捷卡片,可以直接访问该组件功能。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


FormMenu

本组件封装了一个“添加至桌面”菜单,用于实现应用内长按组件生成“添加至桌面”菜单,点击该菜单,触发卡片添加至桌面操作。通过桌面访问该应用快捷卡片,可以直接访问该组件功能。在应用使用过程中,该组件作为留存和复访入口,可吸引用户将功能快捷添加到桌面。

本组件支持应用内支持长按菜单快捷添加卡片到桌面:

  1. 开发者将卡片数据以及应用内功能组件ID传给卡片框架。

  2. 点击事件会根据组件ID获取应用内功能组件的快照和位置,用于添加到桌面时的过渡动效。

  3. 卡片框架通过将加桌数据通知给桌面,触发卡片添加到桌面操作。

说明

该组件从API Version 12开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

导入模块

import { AddFormMenuItem } from '@kit.ArkUI';

子组件

无

属性

不支持通用属性。

AddFormMenuItem

AddFormMenuItem(

want: Want,

componentId: string,

options?: AddFormOptions

): void

装饰器类型:@Component

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

名称参数类型必填装饰器类型说明
wantWant是@Prop待发布功能组件的want信息。
componentIdstring是-应用内功能组件ID,组件ID对应的界面与待添加的服务卡片界面相似。
AddFormOptionsAddFormOptions否-添加卡片选项。

AddFormOptions

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

名称参数类型必填说明
formBindingDataformBindingData.FormBindingData否卡片数据。
callbackAsyncCallback<string>否返回结果的回调。
styleFormMenuItemStyle否菜单自定义样式信息。

FormMenuItemStyle

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

名称参数类型必填说明
optionsMenuItemOptions否包含设置MenuItem的各项信息。

说明

仅在 style配置为空或不配置时,使用默认的图标和menu文字。

事件

支持菜单点击事件。

示例

// index.ets
import { AddFormMenuItem } from '@kit.ArkUI';
import { formBindingData } from '@kit.FormKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

const tag = 'AddFormMenuItem';

@Entry
@Component
struct Index {
  @State message: string = 'Long press show menu';
  private compId: string = 'addforms@d46313145';

  @Builder
  MyMenu() {
    Menu() {
      AddFormMenuItem(
        {
          bundleName: 'com.example.myapplication', // 包名
          abilityName: 'EntryFormAbility', // 模块ability名称
          parameters: {
            'ohos.extra.param.key.form_dimension': 2,
            'ohos.extra.param.key.form_name': 'widget',
            'ohos.extra.param.key.module_name': 'entry'
          },
        },
        this.compId,
        {
          formBindingData: formBindingData.createFormBindingData({}),
          // formBindingData: formBindingData.createFormBindingData({ data: 'share' }),
          callback: (error, formId) => {
            hilog.info(0x3900, tag, `callback info:error = ${JSON.stringify(error)}, formId = ${formId}`);
            if (error?.code === 0) {
              hilog.info(0x3900, tag, "添加至桌面成功")
            } else {
              hilog.info(0x3900, tag, "添加至桌面失败,请尝试其它添加方式")
            }
          },
          style: {
            // options: {
            //   startIcon: $r("app.media.icon"), // 菜单图标,可以自己提供。系统默认采用"sys.media.ic_public_add"
            //   content: "添加到桌面",  // 菜单内容,可以自己提供。默认使用"sys.string.ohos_add_form_to_desktop"
            //   endIcon: $r("app.media.icon") // 菜单图标,可以自己提供
            // }
          }
        }
      )
    }
  }

  build() {
    Row() {
      Column() {
        Image($r("app.media.startIcon"))   // 自定义图片
          .id(this.compId)
          .width(200)
          .height(200)
          .bindContextMenu(this.MyMenu, ResponseType.LongPress, {
            placement: Placement.TopLeft
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}
// WidgetCard.ets
const local = new LocalStorage()

@Entry(local)
@Component
struct WidgetCard {
  @LocalStorageProp('data') data: string = 'defaultdata'; // 定义需要刷新的卡片数据
  /*
   * The action type.
   */
  readonly ACTION_TYPE: string = 'router';
  /*
   * The ability name.
   */
  readonly ABILITY_NAME: string = 'EntryAbility';
  /*
   * The message.
   */
  readonly MESSAGE: string = 'add detail';
  /*
   * The width percentage setting.
   */
  readonly FULL_WIDTH_PERCENT: string = '100%';
  /*
   * The height percentage setting.
   */
  readonly FULL_HEIGHT_PERCENT: string = '100%';

  build() {
    Row() {
      Column() {
        Text(this.data)
          .fontSize($r('app.float.font_size'))
          .fontWeight(FontWeight.Medium)
          .fontColor($r('app.color.item_title_font'))
      }
      .width(this.FULL_WIDTH_PERCENT)
    }
    .height(this.FULL_HEIGHT_PERCENT)
    .backgroundImage($r('app.media.startIcon'))
    .backgroundImageSize({ width: '100%', height: '100%' })
    .onClick(() => {
      postCardAction(this, {
        action: this.ACTION_TYPE,
        abilityName: this.ABILITY_NAME,
        params: {
          message: this.MESSAGE
        }
      });
    })
  }
}

高级自定义控件界面

调用高级自定义控件桌面加桌结果

左侧是formbdingdata为空加桌结果,右侧是formbindingdata为{ data: 'share' }的加桌结果。

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.FormMenu (应用内添加卡片到桌面菜单) 通过桌面访问该应用快捷卡片,可以直接访问该组件功能。 阅读详情

相关推荐

OpenHarmony实战开发-如何通过ArkTS卡片实现一个简单的音乐卡片

本示例展示了如何通过ArkTS卡片实现一个简单的音乐卡片

2401_82546228的博客 1358

HarmonyOS实战开发:ArkTS卡片运行机制

与动态卡片相比,静态卡片整体的运行框架和渲染流程是一致的

2401_84194030的博客 1014

如何使用命令行对RK开发板进行OpenHarmony版本烧录?

开发版烧录

m0_64420071的博客 2317

HarmonyOS/OpenHarmony原生应用-ArkTS万能卡片组件Badge

方法1: Badge(value: {count: number, position?子组件类型:系统组件和自定义组件,支持渲染控制类型(if/else、ForEach和LazyForEach)。从API version 9开始,该接口支持在ArkTS卡片中使用。从API version 9开始,该接口支持在ArkTS卡片中使用。从API version 9开始,该接口支持在ArkTS卡片中使用。从API version 9开始,该接口支持在ArkTS卡片中使用。根据字符串创建标记组件。

weixin_69135651的博客 1019

【鸿蒙实战开发】—— ArkTS卡片开发(二)

FormExtensionAbility进程不能常驻后台,即在卡片生命周期回调函数中无法处理长时间的任务,在生命周期调度完成后会继续存在5秒,如5秒内没有新的生命周期回调触发则进程自动退出。ArkTS卡片创建完成后,工程中会新增如下卡片相关文件:卡片生命周期管理文件(EntryFormAbility.ets)、卡片页面文件(WidgetCard.ets)和卡片配置文件(form_config.json)。创建服务卡片后,也可以在卡片的 form_config.json配置文件 中,通过。

2401_88547687的博客 718

HarmonyOS Next开发学习手册——开发卡片页面(三)

ArkTS卡片开放了自定义绘制的能力,在卡片上可以通过 Canvas 组件创建一块画布,然后通过 CanvasRenderingContext2D 对象在画布上进行自定义图形的绘制,如下示例代码实现了在画布的中心绘制了一个笑脸。@Entry@Component// 初始化CanvasRenderingContext2D和RenderingContextSettingsbuild() {Column() {Row() {// 在onReady回调中获取画布的实际宽和高。

maniuT的博客 659

Flutter + HarmonyOS 跨平台示例项目

服务卡片(Form)是 HarmonyOS 的重要特性,允许用户将应用功能快捷添加到桌面。是 HarmonyOS API 12+ 提供的组件,可实现应用内长按菜单添加卡片,无需用户手动到桌面添加。本文基于 Flutter + HarmonyOS PlatformView 项目,完整介绍如何使用 FormMenu 实现应用内创建服务卡片功能。是Menu的子组件,用于在应用内弹出菜单时提供「添加到桌面」选项。用户长按指定组件后,选择该菜单项即可将服务卡片添加到桌面。

夏天的博客 299

鸿蒙5.0版开发:ArkTS高级组件-@ohos.arkui.advanced.ChipGroup (操作块组组件)

ChipGroup高级组件,提供操作块群组,用于对文件或者资源内容进行分类等场景。

m0_69424697的博客 1068

【鸿蒙next开发】ArkUI框架:ArkTS组件-卡片(FormMenu)

本文介绍了鸿蒙HarmonyOS中的AddFormMenuItem组件,该组件可实现应用内长按生成"添加至桌面"菜单功能。

m0_73088370的博客 754

HarmonyOS(鸿蒙)ArkUI组件

方舟开发框架(简称ArkUI)为HarmonyOS应用的UI开发提供了完整的基础设施,包括简洁的UI语法、丰富的UI功能(组件、布局、动画以及交互事件),以及实时界面预览工具等,可以支持开发者进行可视化界面开发。一:Image图片的数据源,支持本地图片和网络图片属性名称参数类型描述altstring |加载时显示的占位图,支持本地图片(png、jpg、bmp、svg和gif类型),不支持网络图片。默认值:null从API version 9开始,该接口支持在ArkTS卡片中使用。

小炫风技术旅行 1223

避坑指南:PVE下N卡直通错误代码43的终极解决思路与dmesg日志分析

本文详细解析了PVE环境下NVIDIA显卡直通时遇到的错误代码43问题,提供了从dmesg日志分析到BIOS配置、PVE宿主机优化及虚拟机设置的完整解决方案。特别针对GTX1060等显卡,分享了驱动版本选择、ROM修补及高级排错技巧,帮助用户彻底解决这一常见难题。

weixin_28693683的博客 292

Flutter鸿蒙 FormMenu 应用内添加服务卡片实战

服务卡片(Form)是 HarmonyOS 的重要特性,允许用户将应用功能快捷添加到桌面。是 HarmonyOS API 12+ 提供的组件,可实现应用内长按菜单添加卡片,无需用户手动到桌面添加。本文基于 Flutter + HarmonyOS PlatformView 项目,完整介绍如何使用 FormMenu 实现应用内创建服务卡片功能。是Menu的子组件,用于在应用内弹出菜单时提供「添加到桌面」选项。用户长按指定组件后,选择该菜单项即可将服务卡片添加到桌面。

夏天的博客 487

MagicDraw-用例图

MagicDraw-用例图

木头征的博客 3135

Stage模型HarmonyOS服务卡片开发ArkTS卡片相关模块

Stage模型HarmonyOS服务卡片开发ArkTS卡片相关模块

weixin_69135651的博客 1358

jmeter5.4.1 使用案例

jmeter主要用于接口压力测试,模拟海量请求并发访问接口 1.下载jmeter https://jmeter.apache.org/download_jmeter.cgi 2.启动jemter 双击即可 3.配置jmeter 1.先更改语言 2.创建线程组 配置线程执行规划 3.创建http请求默认值 4.创建http请求 5.创建http信息头管理器 指定 Content-Type:application/json 6.创建响应断言 7.创建察看结果数 直接点击 执行 按.

SpringHASh的博客 1223

Cadence仿真笔记(二):传统noise仿真—共源极的噪声

cadence中进行传统噪声仿真

Bao_xue的博客 1万+

鸿蒙API13开发【卡片FormMenu】ArkTS组件

本组件封装了一个“添加至桌面”菜单,用于实现应用内长按组件生成“添加至桌面”菜单,点击该菜单,触发卡片添加至桌面操作。通过桌面访问该应用快捷卡片,可以直接访问该组件功能。在应用使用过程中,该组件作为留存和复访入口,可吸引用户将功能快捷添加到桌面。

鸿蒙的技术博客 1318

GBase8a-GDCA认证考试-复习参考题

为提升产品服务水平定期举办GBase产品认证培训,培训更多GBase数据库专业人员,满足用户快速成长的业务需求,建设GBase产品生态。请注意甄别,根据所学知识综合判断,正确率97%(97分)。

weixin_41826637的博客 2382

关于HarmonyOS Next中卡片的使用方法

静态卡片是Harmony OS中的一种交互组件,用于静态卡片内部和提供方应用间的交互。它支持三种类型的事件:router、message和call。这些事件可以触发不同的操作,如跳转到指定的UIAbility、自定义消息触发后调用FormExtensionAbility的onFormEvent回调以及后台启动提供方应用等。静态卡片只能在静态卡片中使用,并且该组件从API Version 10开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

Lin_Zhong_的博客 1377

5G边缘计算:核心网下沉革命

5G核心网与边缘计算的深度融合,通过UPF下沉、本地流量卸载等关键技术,实现了低时延、高效能的分布式计算架构。该技术将数据处理从核心网向边缘节点转移,支持工业控制、车联网、远程医疗等场景的1-10ms超低时延需求。5G核心网的SBA架构和CUPS设计为边缘计算提供了灵活部署基础,SMF、PCF等网元协同确保业务质量与可靠性。

Qinti_mm的博客 1403

求助:有没有基于pscad的锂电池仿真模型

求助:有没有基于pscad的锂电池仿真模型 欢迎使用Markdown编辑器 你好! 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章,了解一下Markdown的基本语法知识。 新的改变没有 我们对Markdown编辑器进行了一些功能拓展与语法支持,除了标准的Markdown编辑器功能,我们增加了如下几点新功能,帮助你用它写...

qq_38922523的博客 1223

ArkTS - HarmonyOS服务卡片(创建)

只是在已有的应用上添加华为的服务卡片

yasinawolaopo的博客 1396

BQ25713寄存器配置全解析:从基础原理到笔记本充电实战

在电源管理系统中,寄存器配置是实现精细化控制的核心技术。其原理是通过I2C等总线向芯片内部特定地址写入二进制代码,直接设定其工作参数与行为逻辑,从而实现对电压、电流、功率及保护阈值的底层控制。这项技术的价值在于,它能将通用电源管理芯片灵活适配于千差万别的具体应用,是提升系统性能、可靠性与能效的关键。在便携设备、嵌入式系统等场景中,精准的寄存器配置决定了充电效率、动态响应和故障保护能力。本文聚焦于**BQ25713**这款经典充电管理芯片,深入剖析其**ChargeOption**、**ProchotOpti

weixin_42713608的博客 287

鸿蒙HarmonyOS开发:如何灵活运用服务卡片提升用户体验

服务卡片(以下简称“卡片”)是一种界面展示形式,可以将应用的重要信息或操作前置到卡片,以达到服务直达、减少体验层级的目的。卡片常用于嵌入到其他应用(当前卡片使用方只支持系统应用,如桌面)中作为其界面显示的一部分,并支持拉起页面、发送消息等基础的交互功能。

在这里,我乐于倾囊相授,分享我的技术心得、项目实战经验、技术技巧。希望能够惠及更多的开发者,助力大家在技术的海洋中扬帆远航。 2620

C# WinForm 基于DirectShow.dll编写的程序,可边预览边保存视频,音频和图片

基于微软的DirectShow.dll的二次开发1.自动识别连接的摄像头跟麦克风且可以对其进行选择(默认选中第一个)2.可录制wmv和avi两种格式的视频并且都带有音频,avi可以录制的分辨率和帧数进行选择,wmv默认进行了淸晰度优化如不喜欢可去除代码中有相关提示3.可在预览点开之后进行拍照,也可边录制视频边拍照4.添加了视频和音频的压缩功能(酌情使用)这次二次开发发现C#对DirectShow的相关信息太少,这次做完也不敢藏私共享出来,还望大家指正

android 蓝牙通讯demo

android 下蓝牙通讯demo,实现了发现蓝牙,使能蓝牙,通过蓝牙发送消息。

鸿蒙征文 | 鸿蒙服务卡片

服务卡片(以下简称“卡片”)是一种界面展示形式,可以将应用的重要信息或操作前置到卡片,以达到服务直达、减少体验层级的目的。卡片常用于嵌入到其他应用(当前卡片使用方只支持系统应用,如桌面)中作为其界面显示的一部分,并支持拉起页面、发送消息等基础的交互功能。

2301_76430284的博客 1437

OV9734 DATASHEET,完整规格书

OV9734完整规格书,包括电气参数,尺寸规格,寄存器配置表等

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:背景设置)

ArkTS声明式开发(通用属性:背景设置)

m0_64420071的博客 1万+
上一篇: 鸿蒙5.0开发进阶:ArkTS组件-卡片(FormLink)
下一篇: 鸿蒙5.0开发进阶:ArkTS组件-安全控件通用属性
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值