# MessageView

**Repository Path**: HarmonyOS-tpc/MessageView

## Basic Information

- **Project Name**: MessageView
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-09-17
- **Last Updated**: 2023-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MessageView

MessageView : MessageView helps you to create chat message view or a social media message view quickly like a typical chatting application or social post view Its a container view,
so you can add any type of message or social post such as Text or any customize Text, Image, etc. 

MessageView includes
* Can have any child inside of it.
* Change color of MessageView, normal and pressed.
* Adjustable arrow position (top, bottom, left, right).
* Adjustable arrow gravity (start, end, center).
* Message view without arrow.

------
<img src="./images/MessageView.png" width=300 ></img>

# Usage Instructions
Add namespace for app in layout root.
```
xmlns:app="http://schemas.huawei.com/hap/res-auto"
```

Include MessageView inside the layout with the required content/child component as below :

```
<com.developer.messageview.MessageView
        ohos:id="$+id:chatMessageView"
        ohos:height="match_content"
        ohos:width="match_content"
        app:arrowGravity="start"
        app:arrowMargin="3vp"
        app:arrowPosition="right"
        app:backgroundColor="#88BABABA"
        app:backgroundColorPressed="#FFBABABA"
        app:padding="0vp"
        app:radius="3vp"
        app:showArrow="true">

        <DirectionalLayout
            ohos:height="match_content"
            ohos:width="match_content"
            ohos:left_padding="8vp"
            ohos:orientation="vertical"
            ohos:right_padding="8vp"
            ohos:top_padding="8vp">

            <Image
                ohos:id="$+id:iv_image"
                ohos:height="match_content"
                ohos:width="match_content"
                ohos:background_element="#aaffffff"
                ohos:component_description="$string:app_name"
                ohos:image_src="$media:img_sample"
                ohos:top_margin="8vp"/>

            <Text
                ohos:id="$+id:tv_message"
                ohos:height="match_content"
                ohos:width="match_content"
                ohos:text="$string:app_name"/>

            <Text
                ohos:id="$+id:tv_time"
                ohos:height="match_content"
                ohos:width="match_content"
                ohos:bottom_margin="8vp"
                ohos:layout_alignment="end"
                ohos:text="$string:app_name"
                ohos:text_size="12vp"/>
        </DirectionalLayout>
</com.developer.messageview.MessageView>
```

Attributes 
app:arrowGravity="start|end|center"
app:arrowPosition="right|left|top|bottom"
app:arrowMargin="3dp"
app:contentPadding="10dp"
app:backgroundColor="#88BABABA"
app:backgroundColorPressed="#FFBABABA"
app:cornerRadius="3dp"
app:showArrow="true|false"


# Installation Instructions
1.For using MessageView module in sample application, include the below library dependency to generate hap/library.har.

Modify entry build.gradle as below :
```
dependencies {
    implementation project(path: ':library')
}
```

2.For using MessageView in separate application, add the "library.har" in libs folder of "entry" module.

Modify entry build.gradle as below :

```
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.har'])
}
```

3.For using MessageView from a remote repository in separate application, add the below dependency in entry/build.gradle file.
 
 Modify entry build.gradle as below :
             
             
             ```gradle
             dependencies {
                    implementation 'io.openharmony.tpc.thirdlib:MessageView:1.0.0'
             }
             ```
             
# License

Apache Version 2.0
```
Copyright 2019 MessageView

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```