Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“7d8f6398832a2285a3c1deeefa4073fc52d1c371”上不存在“git@gitcode.net:s920243400/PaddleDetection.git”
提交 2bb0cc6e 编写于 作者: H HelloCrease
浏览文件
操作

update docs 

Signed-off-by: NHelloCrease <lian15@huawei.com>
上级 fea720f6
展开全部 隐藏空白更改
内联 并排
Showing with 655 addition and 665 deletion
zh-cn/application-dev/quick-start/Readme-CN.md
浏览文件 @ 2bb0cc6e
...@@ -9,6 +9,5 @@ ...@@ -9,6 +9,5 @@
- 开发基础知识 - 开发基础知识
- [应用包结构说明(FA模型)](package-structure.md) - [应用包结构说明(FA模型)](package-structure.md)
- [应用包结构说明(Stage模型)](stage-structure.md) - [应用包结构说明(Stage模型)](stage-structure.md)
- [资源文件的分类](basic-resource-file-categories.md)
- [SysCap说明](syscap.md) - [SysCap说明](syscap.md)
zh-cn/application-dev/reference/arkui-ts/Readme-CN.md
浏览文件 @ 2bb0cc6e
# 基于TS扩展的声明式开发范式 # 基于TS扩展的声明式开发范式
- 组件 - 组件通用信息
- 通用 - 通用事件
- 通用事件 - [点击事件](ts-universal-events-click.md)
- [点击事件](ts-universal-events-click.md) - [触摸事件](ts-universal-events-touch.md)
- [触摸事件](ts-universal-events-touch.md) - [挂载卸载事件](ts-universal-events-show-hide.md)
- [挂载卸载事件](ts-universal-events-show-hide.md) - [拖拽事件](ts-universal-events-drag-drop.md)
- [拖拽事件](ts-universal-events-drag-drop.md) - [按键事件](ts-universal-events-key.md)
- [按键事件](ts-universal-events-key.md) - [焦点事件](ts-universal-focus-event.md)
- [焦点事件](ts-universal-focus-event.md) - [鼠标事件](ts-universal-mouse-key.md)
- [鼠标事件](ts-universal-mouse-key.md) - [组件区域变化事件](ts-universal-component-area-change-event.md)
- [组件区域变化事件](ts-universal-component-area-change-event.md) - 通用属性
- 通用属性 - [尺寸设置](ts-universal-attributes-size.md)
- [尺寸设置](ts-universal-attributes-size.md) - [位置设置](ts-universal-attributes-location.md)
- [位置设置](ts-universal-attributes-location.md) - [布局约束](ts-universal-attributes-layout-constraints.md)
- [布局约束](ts-universal-attributes-layout-constraints.md) - [Flex布局](ts-universal-attributes-flex-layout.md)
- [Flex布局](ts-universal-attributes-flex-layout.md) - [边框设置](ts-universal-attributes-border.md)
- [边框设置](ts-universal-attributes-border.md) - [背景设置](ts-universal-attributes-background.md)
- [背景设置](ts-universal-attributes-background.md) - [透明度设置](ts-universal-attributes-opacity.md)
- [透明度设置](ts-universal-attributes-opacity.md) - [显隐控制](ts-universal-attributes-visibility.md)
- [显隐控制](ts-universal-attributes-visibility.md) - [禁用控制](ts-universal-attributes-enable.md)
- [禁用控制](ts-universal-attributes-enable.md) - [浮层](ts-universal-attributes-overlay.md)
- [浮层](ts-universal-attributes-overlay.md) - [Z序控制](ts-universal-attributes-z-order.md)
- [Z序控制](ts-universal-attributes-z-order.md) - [图形变换](ts-universal-attributes-transformation.md)
- [图形变换](ts-universal-attributes-transformation.md) - [图像效果](ts-universal-attributes-image-effect.md)
- [图像效果](ts-universal-attributes-image-effect.md) - [形状裁剪](ts-universal-attributes-sharp-clipping.md)
- [形状裁剪](ts-universal-attributes-sharp-clipping.md) - [文本样式设置](ts-universal-attributes-text-style.md)
- [文本样式设置](ts-universal-attributes-text-style.md) - [栅格设置](ts-universal-attributes-grid.md)
- [栅格设置](ts-universal-attributes-grid.md) - [颜色渐变](ts-universal-attributes-gradient-color.md)
- [颜色渐变](ts-universal-attributes-gradient-color.md) - [Popup控制](ts-universal-attributes-popup.md)
- [Popup控制](ts-universal-attributes-popup.md) - [Menu控制](ts-universal-attributes-menu.md)
- [Menu控制](ts-universal-attributes-menu.md) - [点击控制](ts-universal-attributes-click.md)
- [点击控制](ts-universal-attributes-click.md) - [焦点控制](ts-universal-attributes-focus.md)
- [焦点控制](ts-universal-attributes-focus.md) - [悬浮态效果](ts-universal-attributes-hover-effect.md)
- [悬浮态效果](ts-universal-attributes-hover-effect.md) - [组件标识](ts-universal-attributes-component-id.md)
- [组件标识](ts-universal-attributes-component-id.md) - [触摸热区设置](ts-universal-attributes-touch-target.md)
- [触摸热区设置](ts-universal-attributes-touch-target.md) - [多态样式](ts-universal-attributes-polymorphic-style.md)
- [多态样式](ts-universal-attributes-polymorphic-style.md) - 手势处理
- 手势处理 - [绑定手势方法](ts-gesture-settings.md)
- [绑定手势方法](ts-gesture-settings.md) - 基础手势
- 基础手势 - [TapGesture](ts-basic-gestures-tapgesture.md)
- [TapGesture](ts-basic-gestures-tapgesture.md) - [LongPressGesture](ts-basic-gestures-longpressgesture.md)
- [LongPressGesture](ts-basic-gestures-longpressgesture.md) - [PanGesture](ts-basic-gestures-pangesture.md)
- [PanGesture](ts-basic-gestures-pangesture.md) - [PinchGesture](ts-basic-gestures-pinchgesture.md)
- [PinchGesture](ts-basic-gestures-pinchgesture.md) - [RotationGesture](ts-basic-gestures-rotationgesture.md)
- [RotationGesture](ts-basic-gestures-rotationgesture.md) - [SwipeGesture](ts-basic-gestures-swipegesture.md)
- [SwipeGesture](ts-basic-gestures-swipegesture.md) - [组合手势](ts-combined-gestures.md)
- [组合手势](ts-combined-gestures.md) - 基础组件
- 基础组件 - [Blank](ts-basic-components-blank.md)
- [Blank](ts-basic-components-blank.md) - [Button](ts-basic-components-button.md)
- [Button](ts-basic-components-button.md) - [Checkbox](ts-basic-components-checkbox.md)
- [Checkbox](ts-basic-components-checkbox.md) - [CheckboxGroup](ts-basic-components-checkboxgroup.md)
- [CheckboxGroup](ts-basic-components-checkboxgroup.md) - [DataPanel](ts-basic-components-datapanel.md)
- [DataPanel](ts-basic-components-datapanel.md) - [DatePicker](ts-basic-components-datepicker.md)
- [DatePicker](ts-basic-components-datepicker.md) - [Divider](ts-basic-components-divider.md)
- [Divider](ts-basic-components-divider.md) - [Gauge](ts-basic-components-gauge.md)
- [Gauge](ts-basic-components-gauge.md) - [Image](ts-basic-components-image.md)
- [Image](ts-basic-components-image.md) - [ImageAnimator](ts-basic-components-imageanimator.md)
- [ImageAnimator](ts-basic-components-imageanimator.md) - [LoadingProgress](ts-basic-components-loadingprogress.md)
- [LoadingProgress](ts-basic-components-loadingprogress.md) - [Marquee](ts-basic-components-marquee.md)
- [Marquee](ts-basic-components-marquee.md) - [Navigation](ts-basic-components-navigation.md)
- [Navigation](ts-basic-components-navigation.md) - [Progress](ts-basic-components-progress.md)
- [Progress](ts-basic-components-progress.md) - [QRCode](ts-basic-components-qrcode.md)
- [QRCode](ts-basic-components-qrcode.md) - [Radio](ts-basic-components-radio.md)
- [Radio](ts-basic-components-radio.md) - [Rating](ts-basic-components-rating.md)
- [Rating](ts-basic-components-rating.md) - [RichText](ts-basic-components-richtext.md)
- [RichText](ts-basic-components-richtext.md) - [ScrollBar](ts-basic-components-scrollbar.md)
- [ScrollBar](ts-basic-components-scrollbar.md) - [Search](ts-basic-components-search.md)
- [Search](ts-basic-components-search.md) - [Select](ts-basic-components-select.md)
- [Select](ts-basic-components-select.md) - [Slider](ts-basic-components-slider.md)
- [Slider](ts-basic-components-slider.md) - [Span](ts-basic-components-span.md)
- [Span](ts-basic-components-span.md) - [Stepper](ts-basic-components-stepper.md)
- [Stepper](ts-basic-components-stepper.md) - [StepperItem](ts-basic-components-stepperitem.md)
- [StepperItem](ts-basic-components-stepperitem.md) - [Text](ts-basic-components-text.md)
- [Text](ts-basic-components-text.md) - [TextArea](ts-basic-components-textarea.md)
- [TextArea](ts-basic-components-textarea.md) - [TextClock](ts-basic-components-textclock.md)
- [TextClock](ts-basic-components-textclock.md) - [TextInput](ts-basic-components-textinput.md)
- [TextInput](ts-basic-components-textinput.md) - [TextPicker](ts-basic-components-textpicker.md)
- [TextPicker](ts-basic-components-textpicker.md) - [TextTimer](ts-basic-components-texttimer.md)
- [TextTimer](ts-basic-components-texttimer.md) - [TimePicker](ts-basic-components-timepicker.md)
- [TimePicker](ts-basic-components-timepicker.md) - [Toggle](ts-basic-components-toggle.md)
- [Toggle](ts-basic-components-toggle.md) - [Web](ts-basic-components-web.md)
- [Web](ts-basic-components-web.md) - [Xcomponent](ts-basic-components-xcomponent.md)
- [Xcomponent](ts-basic-components-xcomponent.md) - 容器组件
- 容器组件 - [AlphabetIndexer](ts-container-alphabet-indexer.md)
- [AlphabetIndexer](ts-container-alphabet-indexer.md) - [Badge](ts-container-badge.md)
- [Badge](ts-container-badge.md) - [Column](ts-container-column.md)
- [Column](ts-container-column.md) - [ColumnSplit](ts-container-columnsplit.md)
- [ColumnSplit](ts-container-columnsplit.md) - [Counter](ts-container-counter.md)
- [Counter](ts-container-counter.md) - [Flex](ts-container-flex.md)
- [Flex](ts-container-flex.md) - [GridContainer](ts-container-gridcontainer.md)
- [GridContainer](ts-container-gridcontainer.md) - [Grid](ts-container-grid.md)
- [Grid](ts-container-grid.md) - [GridItem](ts-container-griditem.md)
- [GridItem](ts-container-griditem.md) - [List](ts-container-list.md)
- [List](ts-container-list.md) - [ListItem](ts-container-listitem.md)
- [ListItem](ts-container-listitem.md) - [Navigator](ts-container-navigator.md)
- [Navigator](ts-container-navigator.md) - [Panel](ts-container-panel.md)
- [Panel](ts-container-panel.md) - [Refresh](ts-container-refresh.md)
- [Refresh](ts-container-refresh.md) - [Row](ts-container-row.md)
- [Row](ts-container-row.md) - [RowSplit](ts-container-rowsplit.md)
- [RowSplit](ts-container-rowsplit.md) - [Scroll](ts-container-scroll.md)
- [Scroll](ts-container-scroll.md) - [SideBarContainer](ts-container-sidebarcontainer.md)
- [SideBarContainer](ts-container-sidebarcontainer.md) - [Stack](ts-container-stack.md)
- [Stack](ts-container-stack.md) - [Swiper](ts-container-swiper.md)
- [Swiper](ts-container-swiper.md) - [Tabs](ts-container-tabs.md)
- [Tabs](ts-container-tabs.md) - [TabContent](ts-container-tabcontent.md)
- [TabContent](ts-container-tabcontent.md) - 媒体组件
- 媒体组件 - [Video](ts-media-components-video.md)
- [Video](ts-media-components-video.md) - 绘制组件
- 绘制组件 - [Circle](ts-drawing-components-circle.md)
- [Circle](ts-drawing-components-circle.md) - [Ellipse](ts-drawing-components-ellipse.md)
- [Ellipse](ts-drawing-components-ellipse.md) - [Line](ts-drawing-components-line.md)
- [Line](ts-drawing-components-line.md) - [Polyline](ts-drawing-components-polyline.md)
- [Polyline](ts-drawing-components-polyline.md) - [Polygon](ts-drawing-components-polygon.md)
- [Polygon](ts-drawing-components-polygon.md) - [Path](ts-drawing-components-path.md)
- [Path](ts-drawing-components-path.md) - [Rect](ts-drawing-components-rect.md)
- [Rect](ts-drawing-components-rect.md) - [Shape](ts-drawing-components-shape.md)
- [Shape](ts-drawing-components-shape.md) - 画布组件
- 画布组件 - [Canvas](ts-components-canvas-canvas.md)
- [Canvas](ts-components-canvas-canvas.md) - [CanvasRenderingContext2D对象](ts-canvasrenderingcontext2d.md)
- [CanvasRenderingContext2D对象](ts-canvasrenderingcontext2d.md) - [OffscreenCanvasRenderingConxt2D对象](ts-offscreencanvasrenderingcontext2d.md)
- [OffscreenCanvasRenderingConxt2D对象](ts-offscreencanvasrenderingcontext2d.md) - [Lottie](ts-components-canvas-lottie.md)
- [Lottie](ts-components-canvas-lottie.md) - [Path2D对象](ts-components-canvas-path2d.md)
- [Path2D对象](ts-components-canvas-path2d.md) - [CanvasGradient对象](ts-components-canvas-canvasgradient.md)
- [CanvasGradient对象](ts-components-canvas-canvasgradient.md) - [ImageBitmap对象](ts-components-canvas-imagebitmap.md)
- [ImageBitmap对象](ts-components-canvas-imagebitmap.md) - [ImageData对象](ts-components-canvas-imagedata.md)
- [ImageData对象](ts-components-canvas-imagedata.md)
- 动画 - 动画
- [属性动画](ts-animatorproperty.md) - [属性动画](ts-animatorproperty.md)
- [显式动画](ts-explicit-animation.md) - [显式动画](ts-explicit-animation.md)
......
zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
浏览文件 @ 2bb0cc6e
...@@ -21,44 +21,44 @@ ...@@ -21,44 +21,44 @@
Swiper(value:{controller?: SwiperController}) Swiper(value:{controller?: SwiperController})
- 参数 - 参数
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- | | ---------- | ------------------------------------- | ---- | ---- | -------------------- |
| controller | [SwiperController](#swipercontroller) | 否 | null | 给组件绑定一个控制器，用来控制组件翻页。 | | controller | [SwiperController](#swipercontroller) | 否 | null | 给组件绑定一个控制器，用来控制组件翻页。 |
## 属性 ## 属性
| 名称 | 参数类型 | 默认值 | 描述 | | 名称 | 参数类型 | 默认值 | 描述 |
| -------- | -------- | -------- | -------- | | --------------------------- | ---------------------------------------- | ---------- | ---------------------------------------- |
| index | number | 0 | 设置当前在容器中显示的子组件的索引值。 | | index | number | 0 | 设置当前在容器中显示的子组件的索引值。 |
| autoPlay | boolean | false | 子组件是否自动播放，自动播放状态下，导航点不可操作。 | | autoPlay | boolean | false | 子组件是否自动播放，自动播放状态下，导航点不可操作。 |
| interval | number | 3000 | 使用自动播放时播放的时间间隔，单位为毫秒。 | | interval | number | 3000 | 使用自动播放时播放的时间间隔，单位为毫秒。 |
| indicator | boolean | true | 是否启用导航点指示器。 | | indicator | boolean | true | 是否启用导航点指示器。 |
| loop | boolean | true | 是否开启循环。 | | loop | boolean | true | 是否开启循环。<br> 设置为true时表示开启循环，在LazyForEach懒循环加载模式下，加载的组件数量建议大于5个。 |
| duration | number | 400 | 子组件切换的动画时长，单位为毫秒。 | | duration | number | 400 | 子组件切换的动画时长，单位为毫秒。 |
| vertical | boolean | false | 是否为纵向滑动。 | | vertical | boolean | false | 是否为纵向滑动。 |
| itemSpace | Length | 0 | 设置子组件与子组件之间间隙。 | | itemSpace | Length | 0 | 设置子组件与子组件之间间隙。 |
| cachedCount<sup>8+</sup> | number | 1 | 设置预加载子组件个数。 | | cachedCount<sup>8+</sup> | number | 1 | 设置预加载子组件个数。 |
| disableSwipe<sup>8+</sup> | boolean | false | 禁用组件滑动切换功能。 | | disableSwipe<sup>8+</sup> | boolean | false | 禁用组件滑动切换功能。 |
| curve<sup>8+</sup> | [Curve](ts-animatorproperty.md#Curve枚举说明) \| Curves | Curve.Ease | 设置Swiper的动画曲线，默认为淡入淡出曲线，常用曲线参考[Curve枚举说明](ts-animatorproperty.md#Curve枚举说明)，也可以通过插值计算模块提供的接口创建自定义的Curves([插值曲线对象](ts-interpolation-calculation.md))。 | | curve<sup>8+</sup> | [Curve](ts-animatorproperty.md#Curve枚举说明) \| Curves | Curve.Ease | 设置Swiper的动画曲线，默认为淡入淡出曲线，常用曲线参考[Curve枚举说明](ts-animatorproperty.md#Curve枚举说明)，也可以通过插值计算模块提供的接口创建自定义的Curves([插值曲线对象](ts-interpolation-calculation.md))。 |
| indicatorStyle<sup>8+</sup>| {<br/>left?:&nbsp;Length,<br/>top?:&nbsp;Length,<br/>right?:&nbsp;Length,<br/>bottom?:&nbsp;Length,<br/>size?:&nbsp;Length,<br/>color?:&nbsp;Color,<br/>selectedColor?:&nbsp;Color<br/>} | - |设置indicator样式：<br/>-&nbsp;left:&nbsp;设置导航点距离Swiper组件左边的距离。<br/>-&nbsp;top:&nbsp;设置导航点距离Swiper组件顶部的距离。<br/>-&nbsp;right:&nbsp;设置导航点距离Swiper组件右边的距离。<br/>-&nbsp;bottom:&nbsp;设置导航点距离Swiper组件底部的距离。<br/>-&nbsp;size:&nbsp;设置导航点的直径。<br/>-&nbsp;color:&nbsp;设置导航点的颜色。<br/>-&nbsp;selectedColor:&nbsp;设置选中的导航点的颜色。 | | indicatorStyle<sup>8+</sup> | {<br/>left?:&nbsp;Length,<br/>top?:&nbsp;Length,<br/>right?:&nbsp;Length,<br/>bottom?:&nbsp;Length,<br/>size?:&nbsp;Length,<br/>color?:&nbsp;Color,<br/>selectedColor?:&nbsp;Color<br/>} | - | 设置indicator样式：<br/>-&nbsp;left:&nbsp;设置导航点距离Swiper组件左边的距离。<br/>-&nbsp;top:&nbsp;设置导航点距离Swiper组件顶部的距离。<br/>-&nbsp;right:&nbsp;设置导航点距离Swiper组件右边的距离。<br/>-&nbsp;bottom:&nbsp;设置导航点距离Swiper组件底部的距离。<br/>-&nbsp;size:&nbsp;设置导航点的直径。<br/>-&nbsp;color:&nbsp;设置导航点的颜色。<br/>-&nbsp;selectedColor:&nbsp;设置选中的导航点的颜色。 |
## SwiperController ## SwiperController
Swiper容器组件的控制器，可以将此对象绑定至Swiper组件，然后通过它控制翻页。 Swiper容器组件的控制器，可以将此对象绑定至Swiper组件，然后通过它控制翻页。
| 接口名称 | 功能描述 | | 接口名称 | 功能描述 |
| -------- | -------- | | ------------------- | ------ |
| showNext():void | 翻至下一页。 | | showNext():void | 翻至下一页。 |
| showPrevious():void | 翻至上一页。 | | showPrevious():void | 翻至上一页。 |
## 事件 ## 事件
| 名称 | 功能描述 | | 名称 | 功能描述 |
| -------- | -------- | | ---------------------------------------- | ------------------ |
| onChange(&nbsp;index:&nbsp;number)&nbsp;=&gt;&nbsp;void | 当前显示的组件索引变化时触发该事件。 | | onChange(&nbsp;index:&nbsp;number)&nbsp;=&gt;&nbsp;void | 当前显示的组件索引变化时触发该事件。 |
## 示例 ## 示例
......
zh-cn/application-dev/ui/Readme-CN.md
浏览文件 @ 2bb0cc6e
...@@ -80,10 +80,9 @@ ...@@ -80,10 +80,9 @@
- [目录结构](ts-framework-directory.md) - [目录结构](ts-framework-directory.md)
- [应用代码文件访问规则](ts-framework-file-access-rules.md) - [应用代码文件访问规则](ts-framework-file-access-rules.md)
- [js标签配置](ts-framework-js-tag.md) - [js标签配置](ts-framework-js-tag.md)
- 资源访问 - 资源管理
- [访问应用资源](ts-application-resource-access.md) - [资源文件的分类](ui-ts-basic-resource-file-categories.md)
- [访问系统资源](ts-system-resource-access.md) - [资源访问](ts-resource-access.md)
- [媒体资源类型说明](ts-media-resource-type.md)
- [像素单位](ts-pixel-units.md) - [像素单位](ts-pixel-units.md)
- [类型定义](ts-types.md) - [类型定义](ts-types.md)
- 声明式语法 - 声明式语法
......
zh-cn/application-dev/ui/ts-media-resource-type.md 已删除 100644 → 0
浏览文件 @ fea720f6
# 媒体资源类型说明
- 图片资源类型说明
| 格式 | 文件后缀名 |
| -------- | -------- |
| JPEG | .jpg |
| PNG | .png |
| GIF | .gif |
| SVG | .svg |
| WEBP | .webp |
| BMP | .bmp |
- 音视频资源类型说明
| 格式 | 支持的文件类型 |
| -------- | -------- |
| H.263 | .3gp <br>.mp4 |
| H.264 AVC <br> Baseline Profile (BP) | .3gp <br>.mp4 |
| MPEG-4 SP | .3gp |
| VP8 | .webm <br> .mkv |
zh-cn/application-dev/ui/ts-application-resource-access.md → zh-cn/application-dev/ui/ts-resource-access.md
浏览文件 @ 2bb0cc6e
# 访问应用资源 # 资源访问
## 资源定义 ## 访问应用资源
应用资源由开发者在工程的resources目录中定义，resources目录按照两级目录的形式来组织： 在工程中，通过```"$r('app.type.name')"```的形式引用应用资源。app代表是应用内resources目录中定义的资源；type代表资源类型（或资源的存放位置），可以取“color”、“float”、“string”、“plural”、“media”，name代表资源命名，由开发者定义资源时确定。
- 一级目录为base目录、限定词目录以及rawfile目录 引用rawfile下资源时使用```"$rawfile('filename')"```的形式，当前$rawfile仅支持Image控件引用图片资源，filename需要表示为rawfile目录下的文件相对路径，文件名需要包含后缀，路径开头不可以以"/"开头。
- base目录是默认存在的目录。当应用的resources资源目录中没有与设备状态匹配的限定词目录时，会自动引用该目录中的资源文件。
- 限定词目录需要开发者自行创建，其可以由一个或多个表征应用场景或设备特征的限定词组合而成，包括移动国家码和移动网络码、语言、文字、国家或地区、横竖屏、设备类型、颜色模式和屏幕密度等维度，限定词之间通过下划线（_）或者中划线（-）连接。
- 在引用rawfile中的资源时，不会根据系统的状态去匹配，rawfile目录中可以直接存放资源文件。
- 二级目录为资源目录 > **说明：**
- 用于存放字符串、颜色、浮点数等基础元素，以及媒体等资源文件。 > 资源描述符不能拼接使用，仅支持普通字符串如`'app.type.name'`。
- 当前支持的文件和资源类型如下：
| 文件名 | 资源类型 |
| ----------- | ------------ |
| color.json | 颜色资源。 |
| float.json | 间距、圆角、字体等资源。 |
| string.json | 字符串资源。 |
| plural.json | 字符串资源。 |
| media目录 | 图片资源。 |
在xxx.ets文件中，可以使用在resources目录中定义的资源。
## 资源引用 ```ts
Text($r('app.string.string_hello'))
.fontColor($r('app.color.color_hello'))
.fontSize($r('app.float.font_hello'))
}
在工程中，通过```"$r('app.type.name')"```的形式引用应用资源。app代表是应用内resources目录中定义的资源；type代表资源类型（或资源的存放位置），可以取“color”、“float”、“string”、“plural”、“media”，name代表资源命名，由开发者定义资源时确定。 Text($r('app.string.string_world'))
.fontColor($r('app.color.color_world'))
.fontSize($r('app.float.font_world'))
}
引用rawfile下资源时使用```"$rawfile('filename')"```的形式，当前$rawfile仅支持Image控件引用图片资源，filename需要表示为rawfile目录下的文件相对路径，文件名需要包含后缀，路径开头不可以以"/"开头。 Text($r('app.string.message_arrive', "five of the clock")) // 引用string资源，$r的第二个参数用于替换%s
.fontColor($r('app.color.color_hello'))
.fontSize($r('app.float.font_hello'))
}
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** Text($r('app.plural.eat_apple', 5, 5)) // plural$r引用，第一个指定plural资源，第二个参数指定单复数的数量，此处第三个数字为对%d的替换
> 资源描述符不能拼接使用，仅支持普通字符串如`'app.type.name'`。 .fontColor($r('app.color.color_world'))
.fontSize($r('app.float.font_world'))
}
Image($r('app.media.my_background_image')) // media资源的$r引用
Image($rawfile('test.png')) // rawfile$r引用rawfile目录下图片
## 示例 Image($rawfile('newDir/newTest.png')) // rawfile$r引用rawfile目录下图片
```
## 访问系统资源
base目录中部分自定义资源如下所示： 系统资源包含色彩、圆角、字体、间距、字符串及图片等。通过使用系统资源，不同的开发者可以开发出具有相同视觉风格的应用。
开发者可以通过```“$r('sys.type.resource_id')”```的形式引用系统资源。sys代表是系统资源；type代表资源类型，可以取“color”、“float”、“string”、“media”；resource_id代表资源id。
```ts
Text('Hello')
.fontColor($r('sys.color.ohos_id_color_emphasize'))
.fontSize($r('sys.float.ohos_id_text_size_headline1'))
.fontFamily($r('sys.string.ohos_id_text_font_family_medium'))
.backgroundColor($r('sys.color.ohos_id_color_palette_aux1'))
Image($r('sys.media.ohos_app_icon'))
.border({color: $r('sys.color.ohos_id_color_palette_aux1'), radius: $r('sys.float.ohos_id_corner_radius_button'), width: 2})
.margin({top: $r('sys.float.ohos_id_elements_margin_horizontal_m'), bottom: $r('sys.float.ohos_id_elements_margin_horizontal_l')})
.height(200)
.width(300)
``` ```
resources ## 资源文件示例
├─ base
│ ├─ element
│ │ ├─ color.json
│ │ ├─ string.json
│ │ └─ float.json
│ └─ media
│ └─ my_background_image.png
└─ rawfile
├─ test.png
└─ newDir
└─ newTest.png
```
color.json文件的内容如下： color.json文件的内容如下：
...@@ -133,35 +141,7 @@ plural.json文件的内容如下： ...@@ -133,35 +141,7 @@ plural.json文件的内容如下：
} }
``` ```
在ets文件中，可以使用在resources目录中定义的资源。
```
Text($r('app.string.string_hello'))
.fontColor($r('app.color.color_hello'))
.fontSize($r('app.float.font_hello'))
}
Text($r('app.string.string_world'))
.fontColor($r('app.color.color_world'))
.fontSize($r('app.float.font_world'))
}
Text($r('app.string.message_arrive', "five of the clock")) //引用string资源，$r的第二个参数用于替换%s
.fontColor($r('app.color.color_hello'))
.fontSize($r('app.float.font_hello'))
}
Text($r('app.plural.eat_apple', 5, 5)) //plural$r引用，第一个指定plural资源，第二个参数指定单复数的数量，此处第三个数字为对%d的替换
.fontColor($r('app.color.color_world'))
.fontSize($r('app.float.font_world'))
}
Image($r('app.media.my_background_image')) //media资源的$r引用
Image($rawfile('test.png')) //rawfile$r引用rawfile目录下图片
Image($rawfile('newDir/newTest.png')) //rawfile$r引用rawfile目录下图片
```
## 相关实例 ## 相关实例
......
zh-cn/application-dev/ui/ts-system-resource-access.md 已删除 100644 → 0
浏览文件 @ fea720f6
# 访问系统资源
系统资源包含色彩、圆角、字体、间距、字符串及图片等。通过使用系统资源，不同的开发者可以开发出具有相同视觉风格的应用。
开发者可以通过```“$r('sys.type.resource_id')”```的形式引用系统资源。sys代表是系统资源；type代表资源类型，可以取“color”、“float”、“string”、“media”；resource_id代表资源id。
```
Text('Hello')
.fontColor($r('sys.color.ohos_id_color_emphasize'))
.fontSize($r('sys.float.ohos_id_text_size_headline1'))
.fontFamily($r('sys.string.ohos_id_text_font_family_medium'))
.backgroundColor($r('sys.color.ohos_id_color_palette_aux1'))
Image($r('sys.media.ohos_app_icon'))
.border({color: $r('sys.color.ohos_id_color_palette_aux1'), radius: $r('sys.float.ohos_id_corner_radius_button'), width: 2})
.margin({top: $r('sys.float.ohos_id_elements_margin_horizontal_m'), bottom: $r('sys.float.ohos_id_elements_margin_horizontal_l')})
.height(200)
.width(300)
```
zh-cn/application-dev/quick-start/basic-resource-file-categories.md → zh-cn/application-dev/ui/ui-ts-basic-resource-file-categories.md
浏览文件 @ 2bb0cc6e
...@@ -71,8 +71,62 @@ base目录与限定词目录下面可以创建资源组目录（包括element、 ...@@ -71,8 +71,62 @@ base目录与限定词目录下面可以创建资源组目录（包括element、
**表3** 资源组目录说明 **表3** 资源组目录说明
| 资源组目录 | 目录说明 | 资源文件 | | 资源组目录 | 目录说明 | 资源文件 |
| --------- | ---------------------------------------- | ---------------------------------------- | | ------- | ---------------------------------------- | ---------------------------------------- |
| element | 表示元素资源，以下每一类数据都采用相应的JSON文件来表征。<br/>-&nbsp;boolean，布尔型<br/>-&nbsp;color，颜色<br/>-&nbsp;float，浮点型<br/>-&nbsp;intarray，整型数组<br/>-&nbsp;integer，整型<br/>-&nbsp;pattern，样式<br/>-&nbsp;plural，复数形式<br/>-&nbsp;strarray，字符串数组<br/>-&nbsp;string，字符串 | element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。<br/>-&nbsp;boolean.json<br/>-&nbsp;color.json<br/>-&nbsp;float.json<br/>-&nbsp;intarray.json<br/>-&nbsp;integer.json<br/>-&nbsp;pattern.json<br/>-&nbsp;plural.json<br/>-&nbsp;strarray.json<br/>-&nbsp;string.json | | element | 表示元素资源，以下每一类数据都采用相应的JSON文件来表征。<br/>-&nbsp;boolean，布尔型<br/>-&nbsp;color，颜色<br/>-&nbsp;float，浮点型<br/>-&nbsp;intarray，整型数组<br/>-&nbsp;integer，整型<br/>-&nbsp;pattern，样式<br/>-&nbsp;plural，复数形式<br/>-&nbsp;strarray，字符串数组<br/>-&nbsp;string，字符串 | element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。<br/>-&nbsp;boolean.json<br/>-&nbsp;color.json<br/>-&nbsp;float.json<br/>-&nbsp;intarray.json<br/>-&nbsp;integer.json<br/>-&nbsp;pattern.json<br/>-&nbsp;plural.json<br/>-&nbsp;strarray.json<br/>-&nbsp;string.json |
| media | 表示媒体资源，包括图片、音频、视频等非文本格式的文件。 | 文件名可自定义，例如：icon.png。 | | media | 表示媒体资源，包括图片、音频、视频等非文本格式的文件。 | 文件名可自定义，例如：icon.png。 |
| profile | 表示其他类型文件，以原始文件形式保存。 | 文件名可自定义。 | | profile | 表示其他类型文件，以原始文件形式保存。 | 文件名可自定义。 |
### 媒体资源类型说明
表1 图片资源类型说明
| 格式 | 文件后缀名 |
| ---- | ----- |
| JPEG | .jpg |
| PNG | .png |
| GIF | .gif |
| SVG | .svg |
| WEBP | .webp |
| BMP | .bmp |
表2 音视频资源类型说明
| 格式 | 支持的文件类型 |
| ------------------------------------ | --------------- |
| H.263 | .3gp <br>.mp4 |
| H.264 AVC <br> Baseline Profile (BP) | .3gp <br>.mp4 |
| MPEG-4 SP | .3gp |
| VP8 | .webm <br> .mkv |
## 创建资源文件
在resources目录下，可按照限定词目录和资源组目录的说明创建子目录和目录内的文件。
同时，DevEco Studio也提供了创建资源目录和资源文件的界面。
- 创建资源目录及资源文件
在resources目录右键菜单选择“New > Resource File”，此时可同时创建目录和文件。
文件默认创建在base目录的对应资源组下。如果选择了限定词，则会按照命名规范自动生成限定词+资源组目录，并将文件创建在目录中。
目录名自动生成，格式固定为“限定词.资源组”，例如创建一个限定词为横竖屏类别下的竖屏，资源组为绘制资源的目录，自动生成的目录名称为“vertical.graphic”。
![create-resource-file-1](figures/create-resource-file-1.png)
- 创建资源目录
在resources目录右键菜单选择“New > Resource Directory”，此时可创建资源目录。
选择资源组类型，设置限定词，创建后自动生成目录名称。目录名称格式固定为“限定词.资源组”，例如创建一个限定词为横竖屏类别下的竖屏，资源组为绘制资源的目录，自动生成的目录名称为“vertical.graphic”。
![create-resource-file-2](figures/create-resource-file-2.png)
- 创建资源文件
在资源目录的右键菜单选择“New > XXX Resource File”，即可创建对应资源组目录的资源文件。
例如，在element目录下可新建Element Resource File。
![create-resource-file-3](figures/create-resource-file-3.png)
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或