/wepy-plugin-iview

A wepy plugin for weapp-iview

Primary LanguageJavaScript

wepy-plugin-iview

一个iView的wepy插件

特性

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

用法

  1. 安装iview-app
  $ npm i iview-weapp -S
  1. 安装wepy-plugin-iview
  $ npm i wepy-plugin-iview
  1. wepy.config.jsplugins项中添加 iview:{}
  plugins: {
    // ...
    iview: {
    }
    // ...
  }
  1. 运行项目,即可使用iView的全部组件啦~~ 如:<i-button></i-button>

  2. $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:falseinject:['button','icon',...]来实现。 但是某些特殊的页面又需要一些特殊的组件。可以通过下面的方式设置。

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