輕鬆生成小程式分享海報

jasondu發表於2019-03-03

小程式海報元件

github.com/jasondu/wxa…

需求

小程式分享到朋友圈只能使用小程式碼海報來實現，生成小程式碼的方式有兩種，一種是使用後端方式，一種是使用小程式自帶的canvas生成；後端的方式開發難度大，由於生成圖片耗用記憶體比較大對服務端也是不小的壓力；所以使用小程式的canvas是一個不錯的選擇，但由於canvas水比較深，坑比較多，還有不同海報需要重現寫渲染流程，導致程式碼冗餘難以維護，加上不同裝置版本的情況不一樣，因此小程式海報生成元件的需求十分迫切。

在實際開發中，我發現海報中的元素無非一下幾種，只要實現這幾種，就可以通過一份配置檔案生成各種各樣的海報了。

海報中的元素分類

輕鬆生成小程式分享海報

要解決的問題

  • 單位問題

  • canvas隱藏問題

  • 圓角矩形、圓角圖片

  • 多段文字

  • 超長文字和多行文字縮略問題

  • 矩形包含文字

  • 多個元素間的層級問題

  • 圖片尺寸和渲染尺寸不一致問題

  • canvas轉圖片

  • IOS 6.6.7 clip問題

  • 關於獲取canvas例項

單位問題

canvas繪製使用的是px單位，但不同裝置的px是需要換算的，所以在元件中統一使用rpx單位，這裡就涉及到單位怎麼換算問題。

通過wx.getSystemInfoSync獲取裝置螢幕尺寸，從而得到比例，進而做轉換，程式碼如下：

const sysInfo = wx.getSystemInfoSync();
const screenWidth = sysInfo.screenWidth;
this.factor = screenWidth / 750;	// 獲取比例
function toPx(rpx) {	// rpx轉px
	return rpx * this.factor;
}
function toRpx(px) {	// px轉rpx
	return px / this.factor;
},
複製程式碼

canvas隱藏問題

在繪製海報過程時，我們不想讓使用者看到canvas，所以我們必須把canvas隱藏起來，一開始想到的是使用display:none; 但這樣在轉化成圖片時會空白，所以這個是行不通的，所以只能控制canvas的絕對定位，將其移出可視介面，程式碼如下：

.canvas.pro {
    position: absolute;
    bottom: 0;
    left: -9999rpx;
}
複製程式碼

圓角矩形、圓角圖片

由於canvas沒有提供現成的圓角api，所以我們只能手工畫啦，實際上圓角矩形就是由4條線（黃色）和4個圓弧（紅色）組成的，如下：

輕鬆生成小程式分享海報

圓弧可以使用canvasContext.arcTo這個api實現，這個api的入參由兩個控制點一個半徑組成，對應上圖的示例

canvasContext.arcTo(x1, y1, x2, y2, r)
複製程式碼

接下來我們就可以非常輕鬆的寫出生成圓角矩形的函式啦

/**
 * 畫圓角矩形
 */
_drawRadiusRect(x, y, w, h, r) {
    const br = r / 2;
    this.ctx.beginPath();
    this.ctx.moveTo(this.toPx(x + br), this.toPx(y));    		// 移動到左上角的點
    this.ctx.lineTo(this.toPx(x + w - br), this.toPx(y));		// 畫上邊的線
    this.ctx.arcTo(this.toPx(x + w), this.toPx(y), this.toPx(x + w), this.toPx(y + br), this.toPx(br));													// 畫右上角的弧		
    this.ctx.lineTo(this.toPx(x + w), this.toPx(y + h - br));	// 畫右邊的線
    this.ctx.arcTo(this.toPx(x + w), this.toPx(y + h), this.toPx(x + w - br), this.toPx(y + h), this.toPx(br));											  // 畫右下角的弧
    this.ctx.lineTo(this.toPx(x + br), this.toPx(y + h));		// 畫下邊的線
    this.ctx.arcTo(this.toPx(x), this.toPx(y + h), this.toPx(x), this.toPx(y + h - br), this.toPx(br));													// 畫左下角的弧
    this.ctx.lineTo(this.toPx(x), this.toPx(y + br));			// 畫左邊的線
    this.ctx.arcTo(this.toPx(x), this.toPx(y), this.toPx(x + br), this.toPx(y), this.toPx(br));													// 畫左上角的弧
}
複製程式碼

如果是畫線框就使用this.ctx.stroke();

如果是畫色塊就使用this.ctx.fill();

如果是圓角圖片就使用

this.ctx.clip();
this.ctx.drawImage(***);
複製程式碼

clip() 方法從原始畫布中剪下任意形狀和尺寸。一旦剪下了某個區域，則所有之後的繪圖都會被限制在被剪下的區域內（不能訪問畫布上的其他區域）。可以在使用 clip() 方法前通過使用 save() 方法對當前畫布區域進行儲存，並在以後的任意時間對其進行恢復（通過 restore() 方法）。

多段文字

如果是連續多段不同格式的文字，如果讓使用者每段文字都指定座標是不現實的，因為上一段文字的長度是不固定的，這裡的解決方案是使用ctx.measureText （基礎庫 1.9.90 開始支援）Api來計算一段文字的寬度，記住這裡返回寬度的單位是px（坑），從而知道下一段文字的座標。

超長文字和多行文字縮略問題

設定文字的寬度，通過ctx.measureText知道文字的寬度，如果超出設定的寬度，超出部分使用“...”代替；對於多行文字，經測試發現字型的高度大約等於字型大小，並提供lineHeight引數讓使用者可以自定義行高，這樣我們就可以知道下一行的y軸座標了。

矩形包含文字

這個同樣使用ctx.measureText介面，從而控制矩形的寬度，當然這裡使用者還可以設定paddingLeft和paddingRight欄位；

文字的垂直居中問題可以設定文字的基線對齊方式為middle（this.ctx.setTextBaseline('middle');），設定文字的座標為矩形的中線就可以了；水平居中this.ctx.setTextAlign('center');;

輕鬆生成小程式分享海報

多個元素間的層級問題

由於canvas沒有Api可以設定繪製元素的層級，只能是根據後繪製層級高於前面繪製的方式，所以需要使用者傳入zIndex欄位，利用陣列排序（Array.prototype.sort）後再根據順序繪製。

圖片尺寸和渲染尺寸不一致問題

繪製圖片我們使用ctx.drawImage()API；

如果使用drawImage(dx, dy, dWidth, dHeight)，圖片會壓縮尺寸以適應繪製的尺寸，圖片會變形，如下圖：

在基礎庫1.9.0起支援drawImage(sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight)，sx和sy是源影象的矩形選擇框左上角的座標，sWidth和sHeight是源影象的矩形選擇框的寬度和高度，如下圖：

輕鬆生成小程式分享海報

如果繪製尺寸比源圖尺寸寬，那麼繪製尺寸的寬度就等於源圖寬度；反之，繪製尺寸比源圖尺寸高，那麼繪製尺寸的高度等於源圖高度；

我們可以通過wx.getImageInfoApi獲取源圖的尺寸；

canvas轉圖片

在canvas繪製完成後呼叫wx.canvasToTempFilePathApi將canvas轉為圖片輸出，這樣需要注意，wx.canvasToTempFilePath需要寫在this.ctx.draw的回撥中，並且在元件中使用這個介面需要在第二個入參傳入this（坑），如下

this.ctx.draw(false, () => {
    wx.canvasToTempFilePath({
        canvasId: 'canvasid',
        success: (res) => {
            wx.hideLoading();
            this.triggerEvent('success', res.tempFilePath);
        },
        fail: (err) => {
            wx.hideLoading();
            this.triggerEvent('fail', err);
        }
    }, this);
});
複製程式碼

IOS 6.6.7 clip問題

在IOS 6.6.7版本中clip方法連續裁剪圖片時,只有第一張有效，這是微信的bug，官方也證實了（developers.weixin.qq.com/community/d…

關於獲取canvas例項

我們可以使用wx.createCanvasContext獲取小程式例項，但在元件中使用切記第二個引數需要帶上this，如下

this.ctx = wx.createCanvasContext('canvasid', this);
複製程式碼

如何使用元件

github.com/jasondu/wxa…

相關文章