wepy plugin iview

wepy-plugin-iview

A wepy plug-in for iView

characteristic

• automatic injection
• Easy configuration
• px conversion (rpx, rem, em, px)

usage

1. Install iview-app

  $ npm i iview-weapp -S

2. Install wepy-plugin-iview

  $ npm i wepy-plugin-iview

3. Add iview:{} to the plugins item in wepy.config.js

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

4. Run the project and you can use all components of iView~~ For example: <i-button></i-button>

5. Introduction of $toast and $Message

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

Global injection configuration

By default, all iview components are automatically injected into usingComponents of all pages in the pages directory.

  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
      //   }
      }
    } 

Page injection configuration

In many cases, you don't want to inject too many components. This can be achieved through globally configured inject:false or inject:['button','icon',...] . But some special pages require some special components. It can be set in the following ways.

1. Add iView: ['button', 'card'] to the page's config for quick injection. This configuration is on the current page and has a higher weight than the global inject setting.

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