wepy-plugin-iview

一个iView的wepy插件

特性

• 自动注入
• 简易配置
• px转换(rpx, rem, em, px)

用法

1. 安装iview-app

  $ npm i iview-weapp -S

2. 安装wepy-plugin-iview

  $ npm i wepy-plugin-iview

3. 在wepy.config.js中plugins项中添加 iview:{}

  plugins: {
    // ...
    iview: {
    }
    // ...
  }

4. 运行项目，即可使用iView的全部组件啦~~ 如:<i-button></i-button>

5. $toast、$Message的引入

    import {$Toast, $Message} from 'wepy-iview'

全局注入配置

默认是在pages目录下的所有页面的usingComponents中，自动注入全部iview的组件。

  iview: {
      pagePath: 'pages',
      // 可选，默认为 pages。如果页面目录不为pages，或有多个目录, 通过此值设置。
      // 参考配置：
      // pagePath: 'page2'                         page2为页面有目录
      // pagePath:['page1','page2',...]            多页面目录
         
      config: {
        inject: true,
        // 可选，默认为 true, 注入iView的全部组件。 如果不想全部, 通过此值设置。
        // 参考配置：
        // inject: false                           不注入任何组件 
        // inject:['button','icon',...]            只注入部分组件
                
        prefix: 'i-',
        // 可选，默认为 'i-', 组件名前缀。 如果使用其他组件名前缀, 通过此值设置。
        // 参考配置：
        // prefix: 'a-'                            button的组件名为'a-button'

        px2: false  
        // 可选，默认为false, 开启px单位转换。 可选值 true, false, config object {...}
       // 参考配置：
       // px2: true
       // px2: {}

      //  px2: {
      //       relative: 400,          // 相对值,rpx是 相对于750宽度 ；  rem，em 是相对的 font-size
      //       decimalPlaces: 2,       //  保留的小数位数
      //       targetUnits: 'rpx'      // 目标转换的单位 支持 rpx rem em px
      //   }
      }
    }

页面注入配置

很多情况下，不希望注入太多的组件。可以通过全局配置的inject:false或inject:['button','icon',...]来实现。 但是某些特殊的页面又需要一些特殊的组件。可以通过下面的方式设置。

1. 在页面的config中添加 iView: ['button', 'card'],即可快速注入。该配置在当前页面，权重高于全局的inject设置

  config = {
    iView: ['button', 'card']
  }