Appearance
基本使用流程
js
import drawPainter from 'u-draw/plugins/painter'
import drawQrCode from 'u-draw/plugins/drawQrCode'
// 创建绘制工具
const dp = useDraw({
selector: 'canvas',
debugging: true,
plugins: [drawQrCode(), drawPainter()]
})
// 插入绘制描述信息
dp.painter([
{
type: 'rect',
width: 200,
height: 380,
background: 'grey'
},
{
type: 'image',
src: '/static/logo.jpg',
width: 200,
height: 380
},
{
type: 'text',
top: 20,
left: 10,
color: '#ffffff',
fontSize: 40,
fontWeight: 'bold',
content: '城市建筑摄影专题'
},
{
type: 'line-feed-text',
left: 10,
top: 300,
width: 150,
color: '#ffffff',
lineHeight: 25,
content: '老朋友向我频频挥手,告别了黄鹤楼,在这柳絮如烟、繁花似锦的阳春三月去扬州远游。'
},
{
type: 'qr-code',
left: 50,
top: 380 / 2 - 50,
size: 100,
content: 'http://www.baidu.com'
}
])
console.log(await dp.create())
typescript
interface PainterItemSize {
/** 容器的宽度,固定值 */
width: number
/** 容器的高度,固定值 */
height: number
}
/** 元素位置信息 */
interface PainterItemSite {
/** 元素锚点距左边的距离; 默认: 0 */
left?: number
/** 元素锚点距上边的距离; 默认: 0 */
top?: number
}
/** 绘制图片信息 */
interface PainterImageInfo extends PainterItemSize, PainterItemSite {
/** 绘制图片元素 */
type: 'image'
/** 图片地址 */
src: string
/** 图片自适应, 可参考 css 属性 object-fit */
objectFit?: ImageFitOption['objectFit']
/** 图片在元素容器中显示的位置,可参考 css 属性 object-position */
position?: ImageFitOption['intrinsicPosition']
/** 圆角尺寸; 默认: 0 */
radius?: number
}
/** 绘制矩形信息 */
interface PainterRectInfo extends PainterItemSize, PainterItemSite {
/** 绘制矩形元素 */
type: 'rect'
/** 矩形背景颜色; 默认: "#000" */
background?: string
/** 圆角尺寸; 默认: 0 */
radius?: number
}
/** 绘制单行文字信息 */
interface PainterTextInfo extends PainterItemSite {
/** 绘制文本元素 */
type: 'text'
/** 文本颜色; 默认: "#000" */
color?: string
/** 字体; 默认: "serial" */
fontFamily?: string
/** 字号(单位rpx); 默认: 30 rpx */
fontSize?: number
/** 字重; 默认: "normal" 可选项: "bold" */
fontWeight?: string
/** 字型 默认: "normal" 可选项: "italic" */
fontStyle?: string
/** 元素的宽度(单位rpx), 水平排布时影响后一个元素的位置,为 null 时根据文字实际占用的宽度计算 */
width?: number
/** 文本内容 */
content: string
}
/** 绘制多行文字信息 */
interface PainterLineFeedTextInfo extends PainterItemSite {
type: 'line-feed-text'
/** 文本颜色; 默认: "#000" */
color?: string
/** 字体; 默认: "serial" */
fontFamily?: string
/** 字号(单位rpx); 默认: 30 rpx */
fontSize?: number
/** 字重; 默认: "normal" 可选项: "bold" */
fontWeight?: string
/** 字型 默认: "normal" 可选项: "italic" */
fontStyle?: string
/** 文本块的宽度,不能为空 */
width: number
/** 行高; 默认取当前文字行高 */
lineHeight?: number
/** 文本最大行数,超出即显示省略号; 默认3行 */
lineClamp?: number
/** 文本内容 */
content: string
}
/** 绘制二维码信息 */
interface PainterQrCodeInfo extends PainterItemSite {
/** 绘制换行文本元素 */
type: 'qr-code'
/** 二维码尺寸 */
size: number
/** 二维码内容 */
content: string
/** 边距,二维码实际尺寸会根据所设边距值进行缩放调整(默认:5) */
margin?: number
/** 背景色(默认:'#ffffff')*/
backgroundColor?: string
/** 前景色(默认:'#000000') */
foregroundColor?: string
}
export interface PainterContainerOption extends PainterItemSize {
/** 绘制项的数组 */
contents: Array<
// 绘制图片信息
| PainterImageInfo
// 绘制矩形信息
| PainterRectInfo
// 绘制文字信息
| PainterTextInfo
// 绘制换行文字信息
| PainterLineFeedTextInfo
// 绘制扩展二维码信息
| PainterQrCodeInfo
>
}