在小程序界里，生成圖片分享到朋友圈這個功能，是如此得光芒耀眼，以至于各個小程序都趨之若鶩地前來跪倒在她的石榴裙下。不幸的是，微信爸爸并沒有提供給我們很好很便捷的相關(guān)工具；恰恰相反，屏幕截屏的功能被殘忍丟進(jìn)歷史的垃圾桶，只留下一個Canvas組件以及圍繞在其周圍的深淵巨坑們。

所以我們準(zhǔn)備了一套名為Painter的工具， 為開發(fā)者提供一種簡單實(shí)用的“繪制”圖片的解決思路，讓開發(fā)者可以自由地生成自己想要的圖片文件。

github傳送門： github.com/Kujiale-Mob…

如果直接使用canvas進(jìn)行繪圖，那絕對是很酸爽的一次體驗(yàn)，除了失控的代碼，還有無數(shù)的天坑。先來列舉一下canvas 中踩過的坑以及我們的解決（或繞過）的方法。

canvas的坑

painter從實(shí)現(xiàn)上來講，是用了小程序的canvas作為載體來實(shí)現(xiàn)以上功能的。而canvas有很多著名的坑。有的坑，我們小心翼翼地繞了過去；有的坑，我們還是痛快淋漓地一腳踩了下去……

1. 在微信版本6.6.6的某些ios機(jī)型上，canvas的clip()方法不能被restore。導(dǎo)致在這些機(jī)型上無法進(jìn)行切圓角的操作。迫于無奈在開發(fā)中我們不得已拋棄了這些機(jī)型，用了一個if語句將這些機(jī)器的切圓角功能閹割了。。。
2. 小程序的canvas提供了measuretText()方法，暫時只支持測量文本寬度，無法知道文字的具體高度。因此一些元素對齊的需求無法做到很漂亮。
3. 在繪制圖片的時候，有幾率會發(fā)生很神奇的表現(xiàn)，即canvas繪圖的時候位置出現(xiàn)整體偏差，造成最后生成的圖片有殘缺。這種情況大多數(shù)時候發(fā)生在onLoad中調(diào)用painter的情況下。我們處理的方法是對圖片的寬和高比例進(jìn)行檢測，一旦出現(xiàn)異常，就重新繪制一遍。
4. canvas不能繪制網(wǎng)絡(luò)圖片。canvas.drawImage(url)方法，給url傳入一個網(wǎng)絡(luò)鏈接，在模擬器上表現(xiàn)完美，然而在真機(jī)上無法繪制。我們在Painter中引入了一套自己的網(wǎng)絡(luò)圖片下載后繪制的機(jī)制，并在其中加入了LRU存儲管理機(jī)制。
5. canvas是原生組件，始終位于視圖的最上層，z-index設(shè)置對其無效。這個就不多說了。。很多人應(yīng)該都踩過。
6. canvas要進(jìn)行繪制，則canvas組件必須真實(shí)地被寫在頁面上，而且其wx:if不能為false。不過，允許把canvas組件放置在屏幕之外，如設(shè)置position:fixed;left:750rpx;。這一方法是可以解決5，6兩點(diǎn)問題的黑科技

Painter的功能

如圖所示

通過右邊的類似于css又有點(diǎn)像json但其實(shí)上它是個js的寥寥幾行代碼，我們繪制出了左邊的這樣的圖形，包含了背景圖片、文字、圖片、二維碼這四種常用的元素。

Painter閱讀完代碼，繪制成圖片以后，會將圖片的鏈接返回給我們。此時，我們可以將圖片上傳、保存到本地或者顯示在屏幕上。

它可以很方便地定制所需要的圖片，還可以自由動態(tài)地給圖片更換風(fēng)格。

此外，小程序canvas.drawImage()方法在真機(jī)上不能繪制網(wǎng)絡(luò)圖片。而Painter 可以解決這個問題，如果有繪制網(wǎng)絡(luò)圖片的需求也可以考慮使用Painter。

Painter其它優(yōu)勢

1. painter可以下載網(wǎng)絡(luò)圖片到本地，并對下載到本地的網(wǎng)絡(luò)內(nèi)容進(jìn)行LRU管理。目前小程序允許的最大本地儲存為10m，我們默認(rèn)painter可使用的本地存儲為6m，超出時會對本地存儲進(jìn)行清理。如果需要自定義，可以在/painter/lib/downloader.js中修改MAX_SPACE_IN_B屬性。

2. 目前子 view 的 css 屬性支持 object 或 array。允許將幾個view公用的css屬性提取出來。

3. 由于palette 是以 js 承載的 json，所以你可以在每一個屬性中很方便的加上自己的邏輯。也可以把某些屬性單獨(dú)提取出來，讓多個 palette 共用，做到模塊化。

使用

demo下載

demo項(xiàng)目使用submodule的方式進(jìn)行管理，因此在clone時需要運(yùn)行

git clone https://github.com/Kujiale-Mobile/Painter.git --recursive

clone完成后可以看到目錄。其中，/pages/example中存放的是使用示例，/components/painter就是我們所引入的功能組件。此外還有一個palette目錄，里面存放是我們所需要繪圖代碼。實(shí)際工作時，painter會調(diào)取card.js里的信息，在圖片上繪制出相應(yīng)的圖形，就像一支畫筆在調(diào)色板上調(diào)制蘸取了顏料，然后在畫布上創(chuàng)作一樣。

將Painter引入到自己的項(xiàng)目

你可以直接將demo里的painter復(fù)制粘貼到自己的項(xiàng)目下，當(dāng)然也可以更為優(yōu)雅地運(yùn)行一下這個代碼：

git submodule add https://github.com/Kujiale-Mobile/PainterCore.git painter

它會將Painter工具放置在你當(dāng)前的目錄下。我們推薦的做法是把它放在你的components下。

引入組件

像其它的組件一樣，在需要引入Painter的頁面.json文件中添加：

"usingComponents":{
  "painter":"/components/painter/painter"
}

組件調(diào)用

在頁面的xml文件中調(diào)用painter組件，并傳入pallete規(guī)則的數(shù)據(jù)，以及繪制結(jié)束以后的回調(diào)。

<painter palette="{{data}}" bind:imgOK="onImgOK" bind:imgErr="onImgErr"/>

palette即是我們的調(diào)色板數(shù)據(jù)，以json形式根據(jù)一定規(guī)范創(chuàng)建，詳細(xì)信息請移步下文。

繪制回調(diào)

bind:imgOK="onImgOK"
bind:imgErr="onImgErr"

數(shù)據(jù)傳入后，painter就會開始繪制，無論繪制成功或是失敗，都能在相應(yīng)的回調(diào)方法里獲取相關(guān)的信息，如：

 

Pallette

說到底，Painter是一支畫筆工具，具體要讓這支畫筆畫什么東西，還得由我們，天資聰穎的程序猿們，來告訴它。告訴它應(yīng)該畫什么，在哪里畫，畫的時候用什么姿勢……等等。這需要用一些別的手段，因?yàn)榭茖W(xué)的實(shí)驗(yàn)證明過，試圖用普通話這門語言跟它進(jìn)行溝通，是不會有任何效果的。

調(diào)色板屬性

每一塊調(diào)色板都它自己的整體屬性，它一般規(guī)定了整個繪圖范圍的大小、樣式、背景等

它處于整個json文件的最外層，需要指定以下幾個屬性：

示例代碼：

{
      background: 'https://qhyxpicoss.kujiale.com/2018/06/12/LMPUSDAKAEBKKOASAAAAAAY8_981x600.png',
      width: '654rpx',
      height: '400rpx',
      borderRadius: '20rpx',
      views: []
 }

view屬性

畫完了調(diào)色板的整體屬性以后，就可以向views中增加一些元素了。元素支持四種類型，用type字段進(jìn)行區(qū)分分類。不同種類的view又要求提供有不同的數(shù)據(jù)，如image元素需要提供它的url，text元素需要提供text文字內(nèi)容：

除了各view的私有屬性之外，view還有一些公共屬性可以設(shè)置：

rotate

控制元素的旋轉(zhuǎn)，如下圖，將一行文字順時針旋轉(zhuǎn)了6度。

{
    type: 'text',
    text: '酷家樂 移動前端',
    css: {
     left: '20rpx',
     top: '50rpx',
     fontSize: '40rpx'
   },
},

效果：

 

borderRadius

代碼(圓形)：

{
          type: 'image',
          url: this.cardInfo.avatar,
          css: {
            top: '48rpx',
            left: '448rpx',
            width: '192rpx',
            height: '192rpx',
            borderRadius:'96rpx',
          },
        },

方角-->8rpx圓角-->圓形

 

align

這個屬性值比較有意思，它被用來設(shè)置元素在水平方向的、相對于位置設(shè)置的對齊方式。

什么意思呢？

比如說你設(shè)置了某元素的left為100rpx，并設(shè)置align屬性為left，那么該元素的左端就與100rpx對齊；若設(shè)置align為center，則該元素的中軸線與100rpx對齊。

在下面的例子中，三行文字的left都是230rpx，align分別為left, center, right。紅線是橫坐標(biāo)為230rpx的軸線。

即，當(dāng)設(shè)置了align屬性的時候，left值表達(dá)的是元素屬性中align的位置。

代碼：

{
          type: 'text',
          text: '酷家樂 移動前端',
          css: {
            left: '330rpx',
            top: '100rpx',
            fontSize: '40rpx',
          },
        },
        {
          type: 'text',
          text: '酷家樂 移動前端',
          css: {
            left: '330rpx',
            top: '200rpx',
            fontSize: '40rpx',
            align: 'center'
          },
        },
        {
          type: 'text',
          text: '酷家樂 移動前端',
          css: {
            left: '330rpx',
            top: '300rpx',
            fontSize: '40rpx',
            align: 'right'
          },
        },

有了這個屬性，就可以設(shè)置元素的對齊形式，完成下面的布局要求了：

注意：align屬性請和left屬性配合使用，設(shè)置right值將造成錯誤。

align與rotate

當(dāng)align屬性與rotate屬性同時存在時，元素的旋轉(zhuǎn)表現(xiàn)是以元素的中心點(diǎn)為中心的。

 

尺寸單位

目前 Painter 中支持兩種尺寸單位，px 和 rpx，代表的意思和小程序中一致。目前還沒有很好地支持百分比的使用。

保存圖片演示

獲得圖片的url后，可以設(shè)置一個點(diǎn)擊按鈕，點(diǎn)擊保存到本地

onImgOK(e) {
    this.imagePath = e.detail.path;
  },

  saveImage() {
    wx.saveImageToPhotosAlbum({
      filePath: this.imagePath,
    })
  },

按鈕綁定saveImage方法，點(diǎn)擊進(jìn)行保存：

 

生成朋友圈分享圖

最后，利用Painter工具可以生成不同樣式的朋友圈分享圖(下圖為微信小程序 酷咖名片 線上版部分截圖)