esay-canvas

新增 esay-canvas烁峭。之后同步更新。

做微信小程序中最好用的 canvas 繪圖組件之一秕铛。

當(dāng)前環(huán)境下约郁，大家都非常需要分享到朋友圈這個(gè)功能，但是實(shí)現(xiàn)起來各有心酸（坑比較多）但两，所以才有了如下的 canvas 繪圖工具鬓梅。

具有如下特性：

• 簡單易用 —— 一個(gè) json 搞定繪制圖片
• 功能全 —— 滿足 90% 的使用場景
  • 繪制文本（換行、超出內(nèi)容省略號谨湘、中劃線绽快、下劃線、文本加粗）
  • 繪制圖片
  • 繪制矩形
  • 保存圖片
  • 多圖繪制
  • 圓形圖片
  • 繪制圓角矩形
  • ...
• 代碼量小

體驗(yàn)

git clone https://github.com/AfanSama/esay-canvas

想在手機(jī)上使用配置自己的 appid 即可紧阔。

編譯模式中已經(jīng)為你配置好比較常用的兩種模式：

• 普通繪制坊罢，繪制單張分享圖。
• 多圖繪制擅耽，連續(xù)繪制分享圖

使用

• git clone https://github.com/AfanSama/esay-canvas 到本地
• 把 components 中的 esay-canvas 拷貝到自己項(xiàng)目下。
• 在使用頁面注冊組件

  {
    "usingComponents": {
      "esay-canva": "/components/esay-canva/esay-canva"
    }
  }
  

• 在頁面 **.wxml 文件中加入如下代碼

  <esay-canvas painting="{{painting}}" bind:getImage="eventGetImage"/>
  

  painting 是需要傳入的 json。 getImage 方法是繪圖完成之后的回調(diào)函數(shù)绍傲，在 event.detail 中返回繪制完成的圖片地址规哲。
• 當(dāng)前栗子中的 painting 簡單展示一下。詳細(xì)配置請看 API

<details><summary>painting（點(diǎn)擊展開）</summary>

painting: {
      width: 375,
      height: 555,
      clear: true,
      views: [{
          type: 'image',
          url: '/images/background.jpg',
          top: 0,
          left: 0,
          width: 375,
          height: 555
        },
        {
          type: 'roundrect',
          background: "#fff",
          top: 57.5,
          left: 88,
          width: 280,
          height: 25,
          radius:10
        },
        {
          type: 'image',
          url: 'https://wx.qlogo.cn/mmhead/Q3auHgzwzM7v6mLlMiblTaIBuq8VYHVBj61wC69r1jfz4wvjicSsMnKg/0',
          top: 27.5,
          left: 29,
          width: 55,
          height: 55,
          borderRadius: true
        },
        {
          type: 'text',
          content: '您的好友【Afan】',
          fontSize: 16,
          color: '#fff',
          textAlign: 'left',
          top: 33,
          left: 96,
          bolder: true
        },
        {
          type: 'text',
          content: '發(fā)現(xiàn)一件好貨这敬，邀請你一起0元免費(fèi)拿航夺！',
          fontSize: 15,
          color: '#563D20',
          textAlign: 'left',
          top: 59.5,
          left: 96
        },
        {
          type: 'image',
          url: '/images/pic.jpg',
          top: 136,
          left: 42.5,
          width: 290,
          height: 186
        },
        {
          type: 'image',
          url: '/images/qrcode.jpg',
          top: 470,
          left: 85,
          width: 68,
          height: 68,
          borderRadius: true
        },
        {
          type: 'text',
          content: '正品MAC魅可口紅禮盒生日唇膏小辣椒Chili西柚情人',
          fontSize: 16,
          lineHeight: 21,
          color: '#fff',
          textAlign: 'left',
          top: 336,
          left: 44,
          width: 287,
          MaxLineNumber: 2,
          breakWord: true,
          bolder: true
        },
        {
          type: 'text',
          content: '￥0.00',
          fontSize: 19,
          color: '#E62004',
          textAlign: 'left',
          top: 387,
          left: 44.5,
          bolder: true
        },
        {
          type: 'text',
          content: '原價(jià):￥138.00',
          fontSize: 13,
          color: '#7E7E8B',
          textAlign: 'left',
          top: 391,
          left: 110,
          textDecoration: 'line-through'
        },
        {
          type: 'text',
          content: '長按識別圖中二維碼幫我砍個(gè)價(jià)唄~',
          fontSize: 14,
          color: '#383549',
          textAlign: 'left',
          top: 483,
          left: 165.5,
          lineHeight: 20,
          MaxLineNumber: 2,
          breakWord: true,
          width: 125
        }
      ]
    }

</details>

API

<details><summary>對象結(jié)構(gòu)一覽</summary>

{
  width: 375,
  height: 555,
  views: [
    {
      type: 'image',
      url: 'url',
      top: 0,
      left: 0,
      width: 375,
      height: 555,
      borderRadius: true
    },
    {
      type: 'text',
      content: 'content',
      fontSize: 16,
      color: '#402D16',
      textAlign: 'left',
      top: 33,
      left: 96,
      bolder: true
    },
    {
      type: 'rect',
      background: 'color',
      top: 0,
      left: 0,
      width: 375,
      height: 555
    },
    {
      type: 'roundrect',
      background: "#fff",
      y: 57.5,
      x: 88,
      width: 280,
      height: 25,
      radius:10
    }
  ]
}

</details>

數(shù)據(jù)對象的第一層需要三個(gè)參數(shù): width、height崔涂、mode阳掐、views。配置中所有的數(shù)字都是沒有單位的冷蚂。這就意味著 canvas 繪制的是一個(gè)比例圖缭保。具體顯示的大小直接把返回的圖片路徑放置到 image 標(biāo)簽中即可。

mode 可選值有 same, 默認(rèn)值為空蝙茶，常規(guī)下盡量不要使用艺骂。如要使用請看 Q&A的第1點(diǎn)。

當(dāng)前可以繪制3種類型的配置: image隆夯、text钳恕、rect别伏、roundrect。配置的屬性基本上使用的都是 css 的駝峰名稱忧额，還是比較好理解的厘肮。

image（圖片）

text（文本）

rect (矩形丑搔，線條)

roundrect(圓角矩形)

Q&A

1. 最佳實(shí)踐

   繪制操作的時(shí)候最好 鎖住屏幕 厦瓢，例如在點(diǎn)擊繪制的時(shí)候

   wx.showLoading({
     title: '繪制分享圖片中',
     mask: true
   })
   

   繪制完成之后

   wx.hideLoading()
   

他們都在用 esay-canvas

<img src="https://user-gold-cdn.xitu.io/2018/8/8/1651749935cebb2b" width=150 height=150 />

TIPS

如果有什么疑問，歡迎 issues啤月。 如果覺得不錯(cuò)煮仇，能不能送我小 ? ? ，讓我有更多的動(dòng)力谎仲。