@taole/giftstage 0.1.13 → 0.1.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -6
- package/dist/gift-stage.cjs.js +28 -28
- package/dist/gift-stage.es.js +3064 -3068
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -161,7 +161,7 @@ await stage.addGift({
|
|
|
161
161
|
插入一个礼物，返回：
|
|
162
162
|
|
|
163
163
|
```ts
|
|
164
|
-
Promise<GiftHandle
|
|
164
|
+
Promise<GiftHandle>;
|
|
165
165
|
```
|
|
166
166
|
|
|
167
167
|
### `stage.removeGift(id)`
|
|
@@ -196,7 +196,7 @@ Promise<GiftHandle>
|
|
|
196
196
|
- `width?: number`
|
|
197
197
|
- `height?: number`
|
|
198
198
|
- `useOriginalSize?: boolean`
|
|
199
|
-
- `objectFit?: 'contain' | 'fill'`
|
|
199
|
+
- `objectFit?: 'contain' | 'cover' | 'fill'`
|
|
200
200
|
- `loop?: number`
|
|
201
201
|
- `0` 表示无限循环
|
|
202
202
|
- `mute?: boolean`
|
|
@@ -223,7 +223,8 @@ Promise<GiftHandle>
|
|
|
223
223
|
- 两个都传：按传入值显示
|
|
224
224
|
- 只传 `width`：`height` 按礼物原始宽高比自动补全
|
|
225
225
|
- 只传 `height`：`width` 按礼物原始宽高比自动补全
|
|
226
|
-
-
|
|
226
|
+
- 两个都不传：默认按当前画布尺寸做等比 `contain`
|
|
227
|
+
- 如果 `objectFit: 'cover'` 且两个都不传：按整个画布作为显示区域做等比 `cover`
|
|
227
228
|
- 也就是会在画布内尽可能放大或缩小，并保持礼物原始宽高比
|
|
228
229
|
- 如果 `useOriginalSize: true`，且礼物原始尺寸本身小于画布，则优先使用礼物原始尺寸
|
|
229
230
|
- 如果 `useOriginalSize: true`，但礼物原始尺寸超出画布，则仍会按画布尺寸等比缩小
|
|
@@ -242,6 +243,21 @@ await stage.addGift({
|
|
|
242
243
|
|
|
243
244
|
这时会按舞台尺寸做等比适配，并保持礼物原始宽高比。
|
|
244
245
|
|
|
246
|
+
如果希望礼物铺满整个画布，并按中心裁剪超出的部分，可以使用 `cover`：
|
|
247
|
+
|
|
248
|
+
```ts
|
|
249
|
+
await stage.addGift({
|
|
250
|
+
type: 'svga',
|
|
251
|
+
source: 'https://example.com/demo.svga',
|
|
252
|
+
x: '50%',
|
|
253
|
+
y: '50%',
|
|
254
|
+
objectFit: 'cover',
|
|
255
|
+
loop: 0,
|
|
256
|
+
});
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
当 `x: '50%'`、`y: '50%'` 且未传 `width / height` 时，显示区域会居中放在整个画布上；`cover` 会保持礼物原始宽高比铺满该区域，并从中心裁剪溢出的部分。
|
|
260
|
+
|
|
245
261
|
如果你希望“小礼物保持原始尺寸，大礼物再缩小”，可以这样：
|
|
246
262
|
|
|
247
263
|
```ts
|
|
@@ -448,7 +464,7 @@ await stage.addGift({
|
|
|
448
464
|
|
|
449
465
|
入口文件：
|
|
450
466
|
|
|
451
|
-
- [src/index.ts](
|
|
467
|
+
- [src/index.ts](/D:/MyDocuments/UnityProjects/SVGAPlayer-Unity/gift-stage/src/index.ts)
|
|
452
468
|
|
|
453
469
|
主要导出：
|
|
454
470
|
|
|
@@ -466,7 +482,7 @@ await stage.addGift({
|
|
|
466
482
|
|
|
467
483
|
Demo 入口：
|
|
468
484
|
|
|
469
|
-
- [index.html](
|
|
485
|
+
- [index.html](/D:/MyDocuments/UnityProjects/SVGAPlayer-Unity/gift-stage/index.html)
|
|
470
486
|
|
|
471
487
|
可用于验证：
|
|
472
488
|
|
|
@@ -478,4 +494,4 @@ Demo 入口：
|
|
|
478
494
|
## 相关文档
|
|
479
495
|
|
|
480
496
|
- 优化汇总：
|
|
481
|
-
[docs/giftstage-optimization-summary.md](
|
|
497
|
+
[docs/giftstage-optimization-summary.md](/D:/MyDocuments/UnityProjects/SVGAPlayer-Unity/gift-stage/docs/giftstage-optimization-summary.md)
|