微信小程序 MinUI 组件库系列之 price 价格组件

MinUI 是基于微信小程序自定义组件特性开发而成的一套简洁、易用、高效的组件库，适用场景广，覆盖小程序原生框架、小程序组件化框架等，并且提供了高效的命令行工具。MinUI 组件库包含了很多基础的组件，其中价格 price 组件是一个很常用的基础元件， MinUI 中 price 组件的效果图如下：

price

是不是看起来很方便很快捷的样子(^_^)。可以打开微信扫一扫下面的小程序二维码先一睹为快：

price

下面介绍 price 组件的使用方式。

1、使用下列命令安装 Min-Cli，如已安装，请进入到下一步。Min-Cli 的文档请猛戳这里：Min-Cli使用手册

npm install -g @mindev/min-cli

2、初始化一个小程序项目。

min init my-project

选择 新建小程序 选项，即可初始化一个小程序项目。创建项目后，在编辑器中打开项目，src 目录为源码目录，dist 目录为编译后用于在微信开发者工具中指定的目录。新建的项目中已有一个 home 页面。详细文档：Min 初始化小程序项目

3、安装 price 组件。

进入刚才新建的小程序项目的目录中：

cd my-project

安装组件：

min install @minui/wxc-price

4、开启dev。

min dev

开启之后，修改源码后都会重新编译。

5、在页面中引入组件。

在编辑器中打开 src/pages 目录下的 home/index.wxp 文件，在 script 中添加 config 字段，配置小程序自定义组件字段，代码如下：

export default {
    config: {
        "usingComponents": {
            'wxc-price': "@minui/wxc-price"
        }
    }
}

wxc-price 即为价格组件的标签名，可以在 wxml 中使用。

6、在 wxml 中使用 wxc-price标签。

在 home/index.wxp 文件的 template 中添加 wxc-price 标签，代码如下：

<view class="container">
  <wxc-price value="70" decimal="2"></wxc-price>
</view>

7、打开微信开发者工具，指定 dist 目录，预览项目。

home/index.wxp 文件的代码如下所示：

<!-- home/index.wxp -->
<template>
  <view class="container">
    <wxc-price value="70" decimal="2"></wxc-price>
  </view>
</template>
<script>
export default {
    config: {
        "usingComponents": {
            'wxc-price': "@minui/wxc-price"
        }
    }
}
</script>
<style>
  .container {
    padding: 20rpx;
  }
</style>

至此，minui 组件库的 price 价格组件在 Min 工具生成的小程序项目中的方法已介绍完毕，其他场景如在已有小程序项目中的使用方式请移步至如下链接：

在已有小程序项目中使用 MinUI 组件

了解组件的使用方式后，下面开始介绍价格 price 组件的 API 。

Price【props】

属性	描述
value	[可选] 价格数值，优先级高于标签内嵌套值
symbol	[可选] 货币符号。默认为 `￥`
status	[可选] 显示状态，若设置为 del 显示为删除态
icon	[可选] 人民币符号显示规则 <br/><br/> - 如不设置，人民币符号的字号同价格数字一致 <br/> - 设为 sup，人民币符号字号缩小，位于价格左上方 <br/> - 设为 sub，人民币符号字号缩小，位于价格左下方
decimal	[可选] 小数部分显示规则 <br/><br/> - 如不设置，显示 2 位小数，字号同整数部分一致 <br/> - 设置为 1，显示 1 位小数，小数部分向下取整 <br/> - 设为 none，不显示小数部分，只显示整数价格 <br/> - 设为 small，小数部分字号缩小
del-color	[可选] del 状态下文字颜色，只在del状态下有效，正常状态下文字颜色可继承父元素 <br/><br/> - 默认 #999

更多demo

1、设置货币符号为美元

<template>
    <wxc-price symbol="$">70.00</wxc-price>
</template>

<script>
    export default {
        config: {
            usingComponents: {
                'wxc-price': '@minui/wxc-price'
            }
        }
    }
</script>

<style></style>

图示：
小程序 price 价格组件-设置货币符号为美元

2、常用的删除状态的原价

<template>
  <wxc-price status="del" del-color="#666">140.00</wxc-price>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-price': '@minui/wxc-price'
    }
  }
}
</script>

<style></style>

图示：
小程序 price 价格组件-常用的删除状态的原价

3、小数部分字号缩小

<template>
  <wxc-price class="price-demo" value="39.00" decimal="small"></wxc-price>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-price': '@minui/wxc-price'
    }
  }
}
</script>

<style>
  .price-demo {
    font-size: 36rpx;
    font-weight: bold;
    color: #ff4422;
  }
</style>

小程序 price 价格组件-小数部分字号缩小

4、价格符号居下

<template>
  <wxc-price class="price-demo" icon="sub">100.02</wxc-price>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-price': '@minui/wxc-price'
    }
  }
}
</script>

<style>
  .price-demo {
    font-size: 36rpx;
    font-weight: bold;
    color: #ff4422;
  }
</style>

小程序 price 价格组件-价格符号居下

5、保留一位小数

<template>
  <wxc-price value="70.68" decimal="1"></wxc-price>
</template>

<script>
export default {
  config: {
    usingComponents: {
      'wxc-price': '@minui/wxc-price'
    }
  }
}
</script>

<style></style>

小程序 price 价格组件-保留一位小数

更多组件更新同步请关注MinUI小程序组件库示例查看，或请移步到实时同步更新的微信小程序 price 价格组件使用文档

沟通反馈

请添加群助手 wUf18018252882 好友或者扫码加好友，并与群助手对话发送验证码 10088 按照指引进群。

群二维码

相关链接

开源组件

                                            蘑菇街前端团队，2018.01.17 于杭州