鸿蒙开发者社区

版本：v3.1Beta像素单位更新时间:2023021709:19为开发者提供4种像素单位，框架采用vp为基准数据单位。名称描述px屏幕物理像素单位。vp屏幕密度相关像素，根据屏幕像素密度转换为屏幕物理像素，当数值不带单位时，默认单位vp。fp字体像素，与vp类似适用屏幕密度变化，随系统字体大小设置变化。lpx视窗逻辑像素单位，lpx单位为实际屏幕宽度与逻辑宽度（通过designWidth配置）的比值，designWidth默认值为720。当designWidth为720...

版本：v3.1Beta枚举说明更新时间:2023021709:19Color颜色名称颜色值颜色示意Black0x000000Blue0x0000ffBrown0xa52a2aGray0x808080Grey0x808080Green0x008000Orange0xffa500Pink0xffc0cbRed0xff0000White0xffffffYellow0xffff00Transparent9+rgba(0,0,0,0)透明色ImageFit名称描述Contain保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。Cover保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。Auto自...

版本：v3.1Beta系统资源更新时间:2023021709:19表1系统颜色资源参数分组参数类型参数场景ID值浅色模式下的值浅色模式对应颜色深色模式下的值深色模式对应颜色系统色前背景前景色idcolorforeground000000FFFFFF前景反色idcolorforegroundcontraryFFFFFFE5E5E5idcolorforegroundcontrarydisableFFFFF666666背景色idcolorbackgroundFFFFFF000000辅助背景色idcolorsubbackgroundF1F3F5000000主色调高亮色idcoloremphasize0A59F7317A...

版本：v3.1BetaOffscreenCanvasRenderingContext2D对象更新时间:2023030317:21使用OffscreenCanvasRenderingContext2D在Canvas上进行离屏绘制，绘制对象可以是矩形、文本、图片等。离屏绘制是指将需要绘制的内容先绘制在缓存区，然后将其转换成图片，一次性绘制到canvas上，加快了绘制速度。说明从APIVersion8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。接口OffscreenCanvasRenderingContext2D(wi...

版本：v3.1Beta媒体查询更新时间:2023021709:19说明从APIversion4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。media属性值默认为设备的真实尺寸大小、物理像素和真实的屏幕分辨率。请勿与以720px为基准的项目配置宽度px混淆。媒体查询（MediaQuery）在移动设备上应用十分广泛，开发者经常需要根据设备的大致类型或者特定的特征和设备参数（例如屏幕分辨率）来修改应用的样式。为此媒体查询提供了如...

版本：v3.1Beta通用属性更新时间:2023021709:19说明从APIversion4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。常规属性常规属性是指组件普遍支持的用来设置组件基本标识和外观显示特征的属性。名称类型默认值必填描述idstring否组件的唯一标识。stylestring否组件的样式声明。classstring否组件的样式类，用于引用样式表。refstring否用来指定指向子元素或子组件的引用信息，该引用将注册到父组件...

版本：v3.1Beta通用样式更新时间:2023021709:19说明从APIversion4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。组件普遍支持的可以在style或css中设置组件外观样式。名称类型默认值描述width<length><percentage>设置组件自身的宽度。缺省时使用元素自身内容需要的宽度。height<length><percentage>设置组件自身的高度。缺省时使用元素自身内容需要的高度。minwidth5+<length><percentage>6+0设置元...

Stage模型开发概述基本概念下图展示了Stage模型中的基本概念。图1Stage模型概念图​​UIAbility组件​​​和​​ExtensionAbility组件​​Stage模型提供UIAbility和ExtensionAbility两种类型的组件，这两种组件都有具体的类承载，支持面向对象的开发方式。他们是Ability抽象概念在Stage模型上的具体实现。他们是Ability管理服务调度的单元，其生命周期都是由Ability管理服务进行调度的。○UIAbility组件是一种包含UI界面的应用...

访问控制（权限）开发概述ATM(AccessTokenManager)是HarmonyOS上基于AccessToken构建的统一的应用权限管理能力。默认情况下，应用只能访问有限的系统资源。但某些情况下，应用为了扩展功能的诉求，需要访问额外的系统或其他应用的数据（包括用户个人数据）、功能。系统或应用也必须以明确的方式对外提供接口来共享其数据或功能。HarmonyOS提供了一种访问控制机制来保证这些数据或功能不会被不当或恶意使用，即应用权限。应用权...

用户认证开发概述用户认证模块的定义用户认证模块提供用户认证能力，对应用开发者而言，可使用该模块进行用户身份认证，用于设备解锁、支付、应用登录等身份认证场景。当前用户认证提供人脸识别和指纹识别能力，设备具备哪种识别能力，取决于当前设备的硬件能力和技术实现。基本概念人脸识别：基于人的脸部特征信息进行身份识别的一种生物特征识别技术，用摄像机或摄像头采集含有人脸的图像或视频流，并自动在图像中检测和跟踪...

版本：v3.1Beta页面间转场更新时间:2023021709:19在全局pageTransition方法内配置页面入场和页面退场时的自定义转场动效。说明从APIVersion7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。名称参数参数描述PageTransitionEnter{type:RouteType,duration:number,curve:​​Curve​​string,delay:number}设置当前页面的自定义入场动效。type：页面转场效果生效的路由类型。默认值：RouteType.None。说...

版本：v3.1Beta日期滑动选择器弹窗更新时间:2023021709:19根据指定的日期范围创建日期滑动选择器，展示在弹窗上。说明该组件从APIVersion8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。DatePickerDialog.showshow(options:DatePickerDialogOptions)定义日期滑动选择器弹窗并弹出。DatePickerDialogOptions参数：参数名参数类型必填默认值参数描述startDate否Date('197011')设置选择器的起始日期。en...

Canvas对象Canvas组件提供画布，用于自定义绘制图形。具体用法请参考​​CanvasRenderingContext2D对象​​。创建Canvas组件在pagesindex目录下的hml文件中创建一个Canvas组件。<!xxx.hml><divclass"container"><canvas><canvas><div>xxx.css.container{width:100%;height:100%;flexdirection:column;justifycontent:center;alignitems:center;backgroundcolor:F1F3F5;}canvas{backgroundcolor:00ff73;}说明Canvas组件默认背景...

版本：v3.1BetaLottie更新时间:2023021709:19提供Lottie动画。说明从APIVersion8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。导入模块importlottiefrom'ohoslottie'说明在Terminal窗口使用npminstallohoslottie命令下载Lottie，下载之前需要配置权限。安装npm三方包时，需要先执行npmconfigsetohos:registryhttps:repo.harmonyos.comnpm设置仓库地址。lottie.loadAnimationloadAnimation(path:stri...

版本：v3.1Betaslot插槽更新时间:2023021709:19说明从APIVersion7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。默认插槽自定义组件中通过slot标签来承载父组件中定义的内容，使用slot标签可以更加灵活的控制自定义组件的内容元素，使用方式如下：<!comp.hml><divclass"item"><textclass"textstyle">下面使用父组件定义的内容<text><slot><slot><div>引用该自定义组件方式如下：<!xxx.hml><elementna...

栅格布局栅格布局容器根节点，使用gridrow与gridcol进行栅格布局。具体请参考​​Gridcontainer​​。创建gridcontainer组件在pagesindex目录下的hml文件中创建一个gridcontainer组件，并添加​​Gridrow​​子组件。<!index.hml><divclass"container"><gridcontainerid"mygrid"columns"5"gutter"20px"style"backgroundcolor:pink;"><gridrowstyle"height:100px;justifycontent:spacearound;width:80%;backgroundcolor:f67002;m...

版本：v3.1Beta属性动画更新时间:2023021709:19组件的某些通用属性变化时，可以通过属性动画实现渐变过渡效果，提升用户体验。支持的属性包括width、height、backgroundColor、opacity、scale、rotate、translate等。说明从APIVersion7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。animation(value:{duration:number,tempo:number,curve:stringCurveICurve,delay:number,iterations:number,playMode...

tabs开发指导tabs是一种常见的界面导航结构。通过页签容器，用户可以快捷地访问应用的不同模块。具体用法请参考​​tabsAPI​​。创建tabs在pagesindex目录下的hml文件中创建一个tabs组件。<!xxx.hml><divclass"container"><tabs><tabbar><text>item1<text><text>item2<text><tabbar><tabcontent><divclass"text"><text>content1<text><div><divclass"text"><text>content2<text><div><tabcontent><tabs><div>xxx.css.container...

text开发指导text是文本组件，用于呈现一段文本信息。具体用法请参考​​textAPI​​。创建text组件在pagesindex目录下的hml文件中创建一个text组件。<!xxx.hml><divclass"container"style"textalign:center;justifycontent:center;alignitems:center;"><text>HelloWorld<text><div>xxx.css.container{width:100%;height:100%;flexdirection:column;alignitems:center;justifycontent:center;backgroundcolor:F1F3F5;}设置text...

marquee开发指导marquee为跑马灯组件，用于展示一段单行滚动的文字。具体用法请参考​​marquee​​。创建marquee组件在pagesindex目录下的hml文件中创建一个marquee组件。<!xxx.hml><divclass"container"><marqueestyle"width:100%;height:80px;color:ffffff;backgroundcolor:0820ef;paddingleft:200px;">Thisisamarquee.<marquee><div>xxx.css.container{width:100%;height:100%;flexdirection:column;justifycontent:center;...