@deveco-test/deveco-code 1.0.3 → 1.0.5

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/12-navigation.md

@@ -0,0 +1,81 @@
+## 12. 导航与路由
+
+
+> **组件索引**：`Navigation`、`NavPathStack 操作`、`NavDestination`、`Router`
+
+### Navigation
+
+**构造：** `Navigation()`
+
+**属性方法：**
+
+| 方法 | 签名 | 默认值 | 说明 |
+|------|------|--------|------|
+| .navDestination | `.navDestination(builder: (name: string, param: unknown) => void)` | — | 路由目标映射 |
+| .title | `.title(value: ResourceStr \| CustomBuilder \| NavigationCommonTitle \| NavigationCustomTitle, options?: NavigationTitleOptions)` | — | 标题 |
+| .subTitle | `.subTitle(value: string)` | — | 副标题（API 8，已废弃，用 .title 替代） |
+| .mode | `.mode(NavigationMode)` | Auto | Stack/Split/Auto |
+| .hideNavBar | `.hideNavBar(value: boolean)` | false | 隐藏导航页（标题栏+内容区+工具栏）。栈中有 NavDestination 则显示栈顶页面，反之显示空白；API 11+ 单栏/双栏/自适应模式均生效，会失去自适应分栏能力；全屏需求改用 NavDestination 的 `.fullScreenOverlay(true)`，只藏标题用 `.hideTitleBar(true)` |
+| .hideTitleBar | `.hideTitleBar(value: boolean)` | false | 隐藏标题栏 |
+| .hideToolBar | `.hideToolBar(value: boolean)` | false | 隐藏工具栏 |
+| .toolBar | `.toolBar(value: object \| CustomBuilder)` | — | 工具栏（旧接口） |
+| .toolbarConfiguration | `.toolbarConfiguration(value: Array\<ToolbarItem\> \| CustomBuilder, options?)` | — | 工具栏（API 10+） |
+| .navBarWidth | `.navBarWidth(value: Length)` | 240vp | 导航栏宽度（仅 Split 模式） |
+| .navBarPosition | `.navBarPosition(value: NavBarPosition)` | Start | 导航栏位置 |
+
+### NavPathStack 操作
+
+| 方法 | 签名 | 说明 |
+|------|------|------|
+| pushPath | `pushPath(info: NavPathInfo, animated?: boolean)` | 压入页面（无错误码返回） |
+| pushPathByName | `pushPathByName(name: string, param: unknown, animated?: boolean)` | 按名称压入（无错误码返回） |
+| pushDestination | `pushDestination(info: NavPathInfo, options?: NavigationOptions): Promise<void>` | 压入页面，错误经 Promise reject 错误码返回（**推荐**） |
+| pushDestinationByName | `pushDestinationByName(name: string, param: unknown, options?: NavigationOptions): Promise<void>` | 按名称压入，错误经 reject 返回（**推荐**） |
+| pop | `pop(animated?: boolean): NavPathInfo \| undefined` | 弹出，返回 NavPathInfo |
+| pop | `pop(result: Object, animated?: boolean): NavPathInfo \| undefined` | 弹出并回传结果 |
+| replacePath | `replacePath(info: NavPathInfo, animated?: boolean)` | 替换 |
+| clear | `clear(animated?: boolean)` | 清空 |
+| size | `size(): number` | 栈大小（方法，非属性） |
+| getParent | `getParent(): NavPathStack \| null` | 获取父栈，无父返回 null |
+
+### NavDestination
+
+**构造：** `NavDestination()`
+
+**属性方法：**
+
+| 方法 | 签名 | 默认值 | 说明 |
+|------|------|--------|------|
+| .title | `.title(value: string \| CustomBuilder \| NavDestinationCommonTitle \| NavDestinationCustomTitle \| Resource, options?)` | — | 标题 |
+| .hideTitleBar | `.hideTitleBar(boolean)` | false | 隐藏标题栏 |
+| .hideBackButton | `.hideBackButton(boolean)` | false | 隐藏返回键 |
+| .backgroundColor | `.backgroundColor(ResourceColor)` | — | 背景色 |
+
+**事件：** `.onReady((context: NavDestinationContext) => void)` `.onWillShow()` `.onShown()` `.onHidden()` `.onWillHide()` `.onBackPressed()`
+
+### Router
+
+| 方法 | 签名 | 说明 |
+|------|------|------|
+| pushUrl | `router.pushUrl({url, params?})` | 压入页面 |
+| replaceUrl | `router.replaceUrl({url, params?})` | 替换当前页 |
+| back | `router.back(url?)` | 返回 |
+| clear | `router.clear()` | 清空栈 |
+| getLength | `router.getLength(): number` | 栈大小 |
+| getState | `router.getState(): RouterState` | 当前状态 |
+
+---
+### 典型用法
+
+#### 获取导航栈 NavPathStack 的方式
+
+| 方式 | 写法 | 说明 |
+|------|------|------|
+| `queryNavigationInfo`（12+，推荐） | `let info = this.queryNavigationInfo(); if (info !== undefined) { this.pathStack = info.pathStack }` | 自定义组件方法，任意时机可取、不依赖 NavDestination 生命周期 |
+| `onReady`（推荐） | `NavDestination().onReady((ctx: NavDestinationContext) => { this.navPathStack = ctx.pathStack; const p = ctx.pathInfo.param as DetailParams })` | NavDestination 生命周期回调，取栈同时可取本页参数 |
+| AppStorage 全局共享 | 宿主 `AppStorage.setOrCreate` / 页面 `AppStorage.get` | 不推荐 |
+| `@Provide`/`@Consume` | 跨层级传递 | 不推荐 |
+
+#### 全局路由状态监听
+
+`uiObserver.on('navDestinationUpdate', (info: NavDestinationInfo) => ...)` 监听 NavDestination 显示/隐藏状态变化（经 `this.getUIContext().getUIObserver()` 获取 observer，见 @ohos.arkui.observer）。

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/13-rendering.md

@@ -0,0 +1,22 @@
+## 13. 渲染控制
+
+| 语法 | 签名 | 说明 |
+|------|------|------|
+| **if/else** | `if (condition) {} else if {} else {}` | 条件渲染 |
+| **ForEach** | `ForEach(arr, (item, index?) => void, keyGen?)` | 迭代渲染 |
+| **LazyForEach** | `LazyForEach(dataSource, (item, index?) => void, keyGen?)` | 懒加载迭代 |
+| **Repeat** | `Repeat\<T\>(arr)` | API 12+ V2 版渲染控制 |
+
+**Repeat 方法链：**
+
+| 方法 | 签名 | 说明 |
+|------|------|------|
+| .each | `.each((ri: RepeatItem\<T\>) => void)` | 渲染每项 |
+| .key | `.key((item, index) => string)` | 生成 key |
+| .virtualScroll | `.virtualScroll(options?)` | 虚拟滚动 |
+| .template | `.template(name, itemGen, options?)` | 模板化 |
+| .cachedCount | `.cachedCount(value: number)` | 缓存数 |
+| .totalCount | `.totalCount(value: number)` | 总数 |
+| .onRequestItem | `.onRequestItem((index, key) => void)` | 请求数据 |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/14-extension.md

@@ -0,0 +1,22 @@
+## 14. 自定义扩展
+
+### Modifier 系列
+
+| Modifier | 签名 | 说明 |
+|----------|------|------|
+| **AttributeModifier** | `class M implements AttributeModifier { applyNormalAttribute(instance) }` | 动态属性修改 |
+| **AttributeUpdater** | `class M extends AttributeUpdater { ... }` | 高性能属性更新 |
+| **DrawModifier** | `class M implements DrawModifier { drawBehind?() drawContentBelow?() drawAbove?() }` | 自定义绘制 |
+| **GestureModifier** | `class M implements GestureModifier { applyGestureType() setGestureEnabled() }` | 动态手势 |
+| **ContentModifier** | `class M implements ContentModifier { applyContent(column) }` | 自定义内容 |
+
+### 自定义节点
+
+| 节点 | 签名 | 说明 |
+|------|------|------|
+| **FrameNode** | `FrameNode(uiContext)` | 帧节点 |
+| **RenderNode** | `new RenderNode()` | `.draw()` `.setBackgroundColor()` `.setOpacity()` `.setPosition()` `.setSize()` `.appendChild()` `.removeChild()` |
+| **BuilderNode** | `new BuilderNode(uiContext, options?)` | `.build(builder, args?)` |
+| **NodeController** | `class M extends NodeController { makeNode(uiContext) }` | 与 NodeContainer 配合 |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/15-theme-style.md

@@ -0,0 +1,10 @@
+## 15. 主题与样式
+
+| API | 签名 | 说明 |
+|-----|------|------|
+| **WithTheme** | `WithTheme({theme}) { ... }` | 为子树绑定主题 |
+| **@Styles** | `@Styles function name() { .width(100).height(100) }` | 通用样式提取 |
+| **@Extend** | `@Extend(Component) function name(params) { ... }` | 组件扩展方法 |
+| **@StateStyles** | `@StateStyles({ normal:{}, pressed:{}, disabled:{}, focused:{}, selected:{} })` | 多态样式 |
+
+---

package/resources/deveco/skills/hmos-arkui-develop-skill/references/quick-apis/16-enums.md

@@ -0,0 +1,87 @@
+## 16. 枚举类型速查
+
+
+> **组件索引**：`布局`、`组件`、`手势`、`动画`、`效果`
+
+### 布局
+
+| 枚举 | 值 | API |
+|------|----|----|
+| Alignment | TopStart(0), Top(1), TopEnd(2), Start(3), Center(4), End(5), BottomStart(6), Bottom(7), BottomEnd(8) | 7 |
+| FlexAlign | Start, Center, End, SpaceBetween, SpaceAround, SpaceEvenly | 7 |
+| FlexDirection | Row, RowReverse, Column, ColumnReverse | 7 |
+| FlexWrap | NoWrap, Wrap, WrapReverse | 7 |
+| ItemAlign | Auto, Start, Center, End, Stretch, Baseline | 7 |
+| VerticalAlign | Top, Center, Bottom | 7 |
+| HorizontalAlign | Start, Center, End | 7 |
+| Axis | Vertical(0), Horizontal(1) | 7 |
+| Direction | Ltr(0), Rtl(1), Auto(2) | 7 |
+| ScrollDirection | Vertical(0), Horizontal(1), None(3), FREE(4) | 7 |
+| EdgeEffect | Spring(0), Fade(1), None(2) | 7 |
+| BarState | Off(0), Auto(1), On(2) | 7 |
+
+### 组件
+
+| 枚举 | 值 | API |
+|------|----|----|
+| ButtonType | Capsule, Circle, Normal, ROUNDED_RECTANGLE(3) | 7/15 |
+| ImageFit | Contain(0), Cover(1), Auto(2), Fill(3), ScaleDown(4), None(5) | 7 |
+| **ImageRenderMode** | **Original, Template** | 7 |
+| InputType | Normal, Number, PhoneNumber, Email, Password, NUMBER_PASSWORD(8), USER_NAME(10), NEW_PASSWORD(11), NUMBER_DECIMAL(12), URL(13) | 7 |
+| SliderStyle | OutSet(0), InSet(1) | 7 |
+| ToggleType | Checkbox(0), Switch(1), Button(2) | 7 |
+| ProgressType | Linear(0), Ring(1), Eclipse(2), ScaleRing(3), Capsule(4) | 7 |
+| **DataPanelType** | **Circle(0), Line(1)** | 7 |
+| TextAlign | Start(0), Center(1), End(2), Justify(3) | 7 |
+| TextOverflow | None(0), Clip(1), Ellipsis(2), Marquee(3) | 7 |
+| FontWeight | Lighter(0), Normal(1), Regular(2), Medium(3), Bold(4), Bolder(5) | 7 |
+| FontStyle | Normal(0), Italic(1) | 7 |
+| TextDecorationType | None(0), Underline(1), Overline(2), LineThrough(3) | 7 |
+| LineCapStyle | Butt(0), Round(1), Square(2) | 7 |
+| Visibility | Visible(0), Hidden(1), None(2) | 7 |
+| CopyOptions | None(0), InApp(1), LocalDevice(2), CrossDevice(3) | 9 |
+| EnterKeyType | Go(2), Search(3), Send(4), Next(5), Done(6), PREVIOUS(7), NEW_LINE(8) | 7 |
+| PanelType | Minibar(0), Foldable(1), Temporary(2) | 7 |
+| BarMode | Scrollable(0), Fixed(1) | 7 |
+| BarPosition | Start(0), End(1) | 7 |
+| NavigationMode | Stack(0), Split(1), Auto(2) | 9 |
+| EllipsisMode | HEAD(0), CENTER(1), TAIL(2) | 11 |
+| WordBreak | NORMAL(0), BREAK_ALL(1), BREAK_WORD(2) | 11 |
+
+> **枚举名易错提示：**
+> - 属性名是 `.renderMode()`，枚举是 `ImageRenderMode`（不是 ImageRenderingMode）
+> - DataPanelType 是 `Circle/Line`（不是 Close/Ring）
+> - `Sticky.Normal`（不是 StickyStyle.Normal，StickyStyle 枚举不存在）
+> - `TextInputStyle` 无 `Normal` 值，不要使用 `.style(TextInputStyle.Normal)`
+> - `GradientDirection` 无 `BottomRight`，可用：Top, Bottom, Left, Right, TopLeft, TopRight, BottomLeft
+
+### 手势
+
+| 枚举 | 值 | API |
+|------|----|----|
+| GestureMode | Sequence, Parallel, Exclusive | 7 |
+| PanDirection | All(15), Horizontal(3), Vertical(12), Left(1), Right(2), Up(4), Down(8) | 7 |
+| SwipeDirection | All(15), Horizontal(3), Vertical(12) | 7 |
+| TouchType | Down(0), Up(1), Move(2), Cancel(3) | 7 |
+
+### 动画
+
+| 枚举 | 值 | API |
+|------|----|----|
+| AnimationStatus | Initial(0), Running(1), Paused(2), Stopped(3) | 7 |
+| PlayMode | Normal(0), Reverse(1), Alternate(2), AlternateReverse(3) | 7 |
+| FillMode | None(0), Forwards(1), Backwards(2), Both(3) | 7 |
+| Curve | Linear, Ease, EaseIn, EaseOut, EaseInOut, FastOutSlowIn, LinearOutSlowIn, FastOutLinearIn, ExtremeDeceleration, Sharp, Rhythm, Smooth, Friction | 7 |
+
+### 效果
+
+| 枚举 | 值 | API |
+|------|----|----|
+| BlurStyle | Thin, Regular, Thick, BackgroundThin, BackgroundRegular, BackgroundThick | 9 |
+| ImageRepeat | NoRepeat(0), X(1), Y(2), XY(3) | 7 |
+| HoverEffect | Auto, Scale, Highlight, None | 8 |
+| HitTestMode | Default(0), Block(1), Transparent(2), None(3) | 9 |
+| RenderFit | TOP_LEFT, TOP, TOP_RIGHT, LEFT, CENTER, RIGHT, BOTTOM_LEFT, BOTTOM, BOTTOM_RIGHT | 10 |
+| BorderStyle | Dotted(0), Dashed(1), Solid(2) | 7 |
+| SafeAreaType | SYSTEM, CUTOUT, KEYBOARD | 10 |
+| KeyboardAvoidMode | OFFSET, RESIZE, RESIZE_ONLY | 11 |