v-conversion-image 指令

介绍

v-conversion-image 指令用于图片转换格式。

使用方法

不压缩转换 (oto)

大压缩到小空间 (lts)

小压缩到大空间 (stl)

查看代码

<template>
    <div class="image-container">
        <!-- 不压缩转换 -->
        <div class="image-card">
            <h3>不压缩转换 (oto)</h3>
            <img v-conversion-image="{ to: 'webp', compression: 'oto' }" src="https://picsum.photos/800/400?random=1"
                alt="Original Image" class="image" />
        </div>

        <!-- 大压缩到小空间 -->
        <div class="image-card">
            <h3>大压缩到小空间 (lts)</h3>
            <img v-conversion-image="{ to: 'jpeg', compression: 'lts', ratio: 0.01 }"
                src="https://picsum.photos/800/400?random=2" alt="Compressed Image" class="image" />
        </div>

        <!-- 小压缩到大空间 -->
        <div class="image-card">
            <h3>小压缩到大空间 (stl)</h3>
            <img v-conversion-image="{ to: 'png', compression: 'stl', ratio: 0.9 }"
                src="https://picsum.photos/800/400?random=3" alt="High Quality Image" class="image" />
        </div>
    </div>
</template>
<script lang="ts" setup>
import { vConversionImage } from '@cp-vuedir/core'
</script>

<style scoped>
.image-container {
    display: flex;
    flex-wrap: wrap;
    gap: 20px;
    padding: 20px;
    justify-content: center;
}

.image-card {
    background: #ffffff;
    border-radius: 12px;
    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
    overflow: hidden;
    transition: transform 0.3s ease, box-shadow 0.3s ease;
    max-width: 400px;
    width: 100%;
}

.image-card:hover {
    transform: translateY(-5px);
    box-shadow: 0 8px 16px rgba(0, 0, 0, 0.2);
}

.image-card h3 {
    margin: 0;
    padding: 16px;
    font-size: 18px;
    font-weight: 600;
    color: var(--vp-c-text-1);
    background: var(--vp-c-bg-soft);
    border-bottom: 1px solid #e0e0e0;
}

.image {
    width: 100%;
    height: auto;
    display: block;
}
</style>

API

属性名	说明	类型	是否必选	默认值
to	目标图片格式。支持常见图片格式，如 "webp"、"jpeg"、"png" 等。	String	✓	-
compression	压缩方式。可选值为 "oto"（不压缩，保持原始图片质量。）、"lts"（大压缩到小空间，降低图片质量以减小文件大小。）、"stl"（小压缩到大空间，提高图片质量以增加文件大小。）。	String	✓	-
ratio	压缩质量比例，范围在 0 到 1 之间。仅在 compression 为 "lts" 或 "stl" 时生效。	Number	✓	-

注意事项

注意

• 图片格式支持：确保目标格式（to）在浏览器中受支持。例如，某些旧版浏览器可能不支持 webp 格式。如果目标格式不支持，指令会保留原始图片。
• 性能影响：图片转换操作会消耗一定的计算资源，尤其是在处理大图或高分辨率图片时。建议在需要时使用，避免不必要的转换。
• 错误处理：如果转换失败（如网络错误或格式不支持），指令会保留原始图片地址，并在控制台输出错误信息。