# wepy-com-dialog

**Repository Path**: fudiwei/wepy-com-dialog

## Basic Information

- **Project Name**: wepy-com-dialog
- **Description**: A component for displaying a dialog based on wepy.js 1.x.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-05-12
- **Last Updated**: 2022-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wepy-com-dialog

一个对话框组件。

此组件依赖 [wepy](https://github.com/Tencent/wepy) 1.7.0+。

如果你正在使用 wepy 2.x，请移步 [wepy2-com-dialog](https://github.com/fudiwei/wepy2-com-dialog)。

---

## 用法

安装：

``` shell
npm install @skit/wepy-com-dialog --save
```

导入：

``` html
<template>
    <ui-dialog />
</template>
<script>
    import Wepy from 'wepy';
    import UIDialog from '@skit/wepy-com-dialog';

    export default class DemoPage extends Wepy.page {
        components = {
            'ui-dialog': UIDialog
        };
    }
</script>
```

### 可配置项

#### 属性

参数项 | 说明 | 类型 | 是否必填 | 默认值
:---: | :--: | :--: | :---: | :---:
primaryTextColor | 确认按钮文字颜色<br>（支持 16 进制色或 RGB/RGBA 色） | String | 否 | #90241a |

#### 方法

``` javascript
/**
 * 显示提示对话框。
 * @param {Object} options 配置项。
 * @param {String} options.title 提示标题。
 * @param {String} options.content 提示文本。
 * @param {String} options.confirmText 确定按钮的文字，默认为"好的"。
 * @param {String} options.confirmTextColor 确定按钮的文字颜色（会覆盖 primaryTextColor 属性）。
 * @param {String} options.textAlign 提示文本的对齐方式，支持“left”、“center”、“right”，默认值为“center”。
 * @param {Function} options.success 点击按钮后的回调方法。
 */
this.$invoke('ui-dialog', 'alert', {
    title: '这是标题',
    content: '这是内容',
    confirmText: '确认',
    confirmTextColor: '#1fb8ca',
    textAlign: 'left',
    success: (res) => {
        // 点击确定按钮后执行操作
    }
});

/**
 * 显示提示对话框。
 * @param {String} content 提示文本。
 */
this.$invoke('ui-dialog', 'alert', '这是内容');

/**
 * 显示确认对话框。
 * @param {Object} options 配置项。
 * @param {String} options.title 提示标题。
 * @param {String} options.content 提示文本。
 * @param {String} options.confirmText 确定按钮的文字，默认为"好的"。
 * @param {String} options.confirmTextColor 确定按钮的文字颜色（会覆盖 primaryTextColor 属性）。
 * @param {String} options.cancelText 取消按钮的文字，默认为"取消"。
 * @param {String} options.textAlign 提示文本的对齐方式，支持“left”、“center”、“right”，默认值为“center”。
 * @param {Function} options.success 点击按钮后的回调方法，该方法将接收一个表示被点击按钮索引的参数。
 */
this.$invoke('ui-dialog', 'confirm', {
    title: '这是标题',
    content: '这是内容',
    confirmText: '确认',
    confirmTextColor: '#1fb8ca',
    cancelText: '取消',
    textAlign: 'left',
    success: (res) => {
        switch (res.index) {
            case 0:
                // 点击取消按钮后执行操作
                break;
            case 1:
                // 点击确定按钮后执行操作
                break;
        }
    }
});

/**
 * 显示确认对话框。
 * @param {String} content 提示文本。
 */
this.$invoke('ui-dialog', 'confirm', '这是内容');
```