查看ArkUI预览效果
===========

ArkUI预览支持页面预览、组件预览、多断点预览和卡片预览，下图中左侧图标![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/10/v3/SCGBG6QySNKMCyeF22lJkg/zh-cn_image_0000002594634888.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=EAFEA0DCC970E419CD4E537D492F8AF8C08D71DFF2CDA9556DD22DD3C542C9CF)为页面预览，中间图标![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/gWzh1AGJRryv5g0KY1lZzA/zh-cn_image_0000002594474966.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=020CFB3B5EF26DBF8DB41C06D772513A79FBC53604D468FDB4E316843D4FB92B)为组件预览，右侧图标![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/reaOtgqyTG6AUMoHSkHI0g/zh-cn_image_0000002594634886.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=5A0F8D6D9FE659E2F361E376F954CC9E7475FF75098F91188B937E092928835F)为多断点预览，卡片预览在创建卡片文件后可直接预览。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/34/v3/8pNDofiSTKmX4nqj2bFSTg/zh-cn_image_0000002594474964.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=BC854A5C82A20583322CCD60166C2B15DA5238C393889BAC26610974D5E7EDFD)

#### 页面预览

ArkTS应用/元服务支持页面预览。页面预览通过在工程的ets文件头部添加@Entry实现。

@Entry的使用参考如下示例：

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

#### 组件预览

ArkTS应用/元服务支持组件预览。组件预览支持实时预览，不支持动态图和动态预览。组件预览通过在组件前添加注解@Preview实现，在单个源文件中，最多可以使用10个@Preview装饰自定义组件。

@Preview的使用参考如下示例：

@Preview({
  title: 'ContentTable'
})
@Component
struct ContentTablePreview {
  build() {
    Flex() {
      ContentTable({ foodItem: getDefaultFoodData() })
    }
  }
}

以上示例的组件预览效果如下图所示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b0/v3/upS5R8CtTLGhh-pzYxZYqg/zh-cn_image_0000002594634894.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=FC24BFDD844EF79411025D125A49FE403E253085477E5413762C38E2B99E662A "点击放大")

组件预览默认的预览设备为Phone，若您想查看不同的设备，或者不同的屏幕形状，或者不同设备语言等情况下的组件预览效果，可以通过设置@Preview的参数，指定预览设备的相关属性。若不设置@Preview的参数，默认的设备属性如下所示：

@Preview({
  title: 'Component1',  //预览组件的名称
  deviceType: 'phone',  //指定当前组件预览渲染的设备类型，默认为Phone
  width: 1080,  //预览设备的宽度，单位：px
  height: 2340,  //预览设备的长度，单位：px
  colorMode: 'light',  //显示的亮暗模式，当前支持取值为light
  dpi: 480,  //预览设备的屏幕DPI值
  locale: 'zh\_CN',  //预览设备的语言，如zh\_CN、en\_US等
  orientation: 'portrait',  //预览设备的横竖屏状态，取值为portrait或landscape
  roundScreen: false  //设备的屏幕形状是否为圆形
})

请注意，如果被预览的组件是依赖参数注入的组件，建议的预览方式是：定义一个组件片段，在该片段中声明将要预览的组件，以及该组件依赖的入参，并在组件片段上标注@Preview注解，以表明将预览该片段中的内容。例如，要预览如下组件：

@Component
struct Title {
  @Prop context: string; 
  build() {
    Text(this.context)
  }
}

建议按如下方式预览：

@Preview
@Component    //定义组件片段TitlePreview
struct TitlePreview {
  build() {
    Title({ context: 'MyTitle' })    //在该片段中声明将要预览的组件Title，以及该组件依赖的入参 {context: 'MyTitle'}
  }
}

#### 多断点预览

从26.0.0 Beta1版本开始，ArkTS应用/元服务支持多断点预览，可以同时展示8个典型档位[断点](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-multi-device-responsive-layout#section1532120147301)的预览画面。在多断点预览模式下，不支持实时预览和极速预览；如果图片太大或图片太多，预览时可能无法显示。

多断点预览通过在工程的ets文件头部添加@Entry实现，示例如下：

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

以上示例的多断点预览效果如下图所示，会展示8个典型档位断点下的预览效果：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/79/v3/0Dc1nP3YR6ubm929K-McNA/zh-cn_image_0000002594474968.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=E981BBDC9C6EEF028256A2C87D31952019C2C7BCA57CC6DB9FD2945EC8FF8F41 "点击放大")

每个断点预览画面上均可点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/68/v3/dQxkokEZTR-WvqSZIo9z1w/zh-cn_image_0000002624994331.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=B3C588ED7AC5F3313AA21178F392119E8B709FB6BFF31C0C12A13D171E0C3D0B)查看该断点档位下的组件树。

支持代码编辑器、UI界面和组件树三者之间的联动：

*   选中预览器UI界面中的组件，则组件树上对应的组件将被选中，同时代码编辑器中的布局文件中对应的代码块高亮显示。
*   选中布局文件中的代码块，则在UI界面会高亮显示，组件树上的组件节点也会呈现被选中的状态。
*   选中组件树中的组件，则对应的代码块和UI界面也会高亮显示。
*   不支持修改属性面板上的组件属性。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3f/v3/appzBQ3JSrGAjNjJAdGoYQ/zh-cn_image_0000002594634896.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=E95711F71ABFEA753A87DEF738127CE76DE4828044B8452D515CACE2EF04D2C5 "点击放大")

#### 卡片预览

创建卡片并选中卡片文件后，点击右侧边栏**Previewer**按钮即可预览卡片。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/55/v3/CwXBsi6ORgCoIosOQg5_LQ/zh-cn_image_0000002594634890.png?HW-CC-KV=V1&HW-CC-Date=20260612T073855Z&HW-CC-Expire=86400&HW-CC-Sign=22557EBFA109BB29C8E2CD87343F23E4F8E1875AF3112F28EDCC6155D33D0F3C "点击放大")