# NotificationContent (System API)

The **NotificationContent** module provides APIs for defining the notification content.

> **NOTE**
>
> The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
>
> This topic describes only system APIs provided by the module. For details about its public APIs, see [NotificationContent](./js-apis-inner-notification-notificationContent.md).

## NotificationContent

**System capability**: SystemCapability.Notification.Notification

| Name          | Type                                                                       | Read-Only| Optional| Description              |
| -----------   | --------------------------------------------------------------------------- | ---- | --- | ------------------ |
| liveView<sup>11+</sup>       | [NotificationLiveViewContent](#notificationliveviewcontent11)              | No | Yes | Common live view.<br>**System API**: This is a system API.|

## NotificationLiveViewContent<sup>11+</sup>

Describes the common live view.

**System capability**: SystemCapability.Notification.Notification

**System API**: This is a system API.

| Name          | Type                                                               | Read-Only| Optional| Description                                                 |
| -------------- | ------------------------------------------------------------------ | --- | --- | ------------------------------------------------------|
| status         | [LiveViewStatus](#liveviewstatus11)                                | No | No | Notification status.                 |
| version        | number                                                             | No | Yes | If the version number stored in the database is not **0xffffffff**, the version number needs to be verified when the live view is updated or ended to ensure that the current version number is greater than the version number stored in the database. The default value is **0xffffffff**.|
| extraInfo      | Record<string, Object\>                                               | No | Yes | Extra information of the live view.          |
| pictureInfo    | Record<string, Array<[image.PixelMap](../apis-image-kit/arkts-apis-image-PixelMap.md)\>\> | No | Yes | Extra image information of the live view.|
| isLocalUpdateOnly<sup>12+</sup> | boolean                                           | No | Yes | Whether the live view is updated only locally.  <br> - **true**: Yes.<br> - **false** (default): No.    |
| liveViewType<sup>18+</sup>  | [LiveViewTypes](#liveviewtypes18)  | No| Yes | Live view types. |
| cardButtons<sup>18+</sup> | Array\<[NotificationIconButton](#notificationiconbutton18)\>    |  No |  Yes | Live view buttons (a maximum of three buttons are supported).     |

## NotificationCapsule<sup>11+</sup>

Describe the notification capsule.

**System capability**: SystemCapability.Notification.Notification

**System API**: This is a system API.

| Name                 |  Type                        | Read-Only| Optional| Description                             |
| --------------------- | ---------------------------- | ---- | ---- | -------------------------------- |
| content<sup>12+</sup> | string                       |  No |  Yes | Extended text of the capsule.                  |
| time<sup>18+</sup> | number                       |  No |  Yes | Display duration of the notification capsule of an instant task, in seconds.  |
| capsuleButtons<sup>18+</sup> | Array\<[NotificationIconButton](#notificationiconbutton18)\>    |  No |  Yes | Buttons of the notification capsule of an instant task. A maximum of two buttons are supported.     |

## LiveViewStatus<sup>11+</sup>

Enumerates the statuses of the common live view.

**System capability**: SystemCapability.Security.AccessToken

**System API**: This is a system API.

| Name                        | Value|   Description  |
| ---------------------------- |----|----------|
| LIVE_VIEW_CREATE             | 0  | The live view is created.    |
| LIVE_VIEW_INCREMENTAL_UPDATE | 1  | The live view is updated in incremental mode.|
| LIVE_VIEW_END                | 2  | The live view is ended.    |
| LIVE_VIEW_FULL_UPDATE        | 3  | The live view is updated in full mode.|

## NotificationIconButton<sup>18+</sup>

Describes the information of a system notification button.

**System capability**: SystemCapability.Notification.Notification

**System API**: This is a system API.

| Name         | Type                   | Read-Only| Optional| Description                                     |
| ------------ | ----------------------- | ---- | ---- | ---------------------------------------- |
| name         | string                  | No  |  No | Button ID, which is used to distinguish multiple buttons of the same notification.  |
| iconResource | [IconType](#icontype18) | No  |  No | Background image of a button.                            |
| text         | string                  | No  |  Yes | Text displayed on the button.                          |
| hidePanel    | boolean                 | No  |  Yes | Whether to hide the notification panel when the button is tapped.  <br> - **true**: Yes.<br> - **false** (default): No.  |

## IconType<sup>18+</sup>

type IconType = Resource | image.PixelMap

**System capability**: SystemCapability.Notification.Notification

**System API**: This is a system API.

| Type                                                            | Description                             |
| ---------------------------------------------------------------- | -------------------------------- |
| [Resource](../apis-arkui/arkui-ts/ts-types.md#resource)          | Image resource.            |
| [image.PixelMap](../apis-image-kit/arkts-apis-image-PixelMap.md) | Image.                |

## LiveViewTypes<sup>18+</sup>

Enumerates live view types.

**System capability**: SystemCapability.Notification.Notification

**System API**: This is a system API.

| Name                        | Value|   Description  |
| ---------------------------- |----|----------|
| LIVE_VIEW_ACTIVITY           | 0  | Real-time activity (progress).|
| LIVE_VIEW_INSTANT            | 1  | Instant task.|
| LIVE_VIEW_LONG_TERM          | 2  | Long-term task.|

## NotificationMultiLineContent

**System capability**: SystemCapability.Notification.Notification

| Name          | Type   | Read-Only| Optional| Description                            |
| -------------- | ------ | ---- | --- | -------------------------------- |
| lineWantAgents<sup>20+</sup>       | Array<[wantAgent](../apis-ability-kit/js-apis-app-ability-wantAgent.md)> |  No | Yes | **wantAgent**s triggered when a line of text in the multi-line text is tapped. The text in different lines corresponds to different **wantAgent**s. The maximum number of lines configured for this field is equal to the value of [lines](./js-apis-inner-notification-notificationContent.md#notificationmultilinecontent).<br>**System API**: This is a system API.<br>**Required permissions**: ohos.permission.NOTIFICATION_AGENT_CONTROLLER|