/mini-ali-ui

阿里小程序扩展组件

Primary LanguageLessMIT LicenseMIT

Mini Ali UI

npm package GitHub stars GitHub forks NPM downloads GitHub issues GitHub license

示例

特性

  • 基于 Alipay Design 设计规范；
  • 支持多端小程序（支付宝，淘宝，钉钉等）；
  • 支持主题配置切换；
  • 支持 px 与 rpx；

安装

$ npm install mini-ali-ui --save

同时，我们提供了 rpx 版本的 mini-ali-ui，如需要使用 rpx 作为单位的组件，可以通过下述方式进行安装：

$ npm install mini-ali-ui-rpx --save

使用

在页面 json 中文件中进行注册，如 title 组件的注册如下所示：

{
  "usingComponents": {
    "title": "mini-ali-ui/es/title/index"
  }
}

如安装的是 rpx 版本的 mini-ali-ui，那么在进行组件注册时，修改一下名称即可，方式如下：

{
  "usingComponents": {
    "title": "mini-ali-ui-rpx/es/title/index"
  }
}

组件注册成功之后，具体的使用方式无差别。

在 axml 文件中进行调用：

<title
  hasLine="true"
  iconURL="https://t.alipayobjects.com/images/T1HHFgXXVeXXXXXXXX.png"
  type="close"
  onActionTap="titleClose"
>内部标题可关闭</title>

详细使用说明请参照官方文档使用自定义组件

国际化多语种的支持

对组件内部的文案进行梳理，将内部的文案提取后，并翻译。目前支持的语种如下：

默认为中文。

使用方式

在小程序中如需要使用非中文语种时，需要在 app.js 中的 globalData 加入指定 key 和 value。

key value
miniAliUiLang ''、'en-US'

miniAliUiLang 为空或者未定义，将作为以中文展示组件内部的默认文案。

App({
  globalData: {
    miniAliUiLang: 'en-US',
  },
  onLaunch() {},
});

贡献

如果你有好的意见或建议，欢迎给我们提 issue。

钉钉群

钉钉群：30147295 群号：30147295

链接