当前位置: 首页 > article >正文

nuxt常用组件库html-validator、@nuxtjs/i18n、@nuxt/image、@unocss/nuxt使用解析

html-validator

主要用于自动验证nuxt服务器呈现的HTML(SSR和SSG),以检测可能导致水合错误的HTML常见问题,有助于减少水合错误,检测常见的可访问性错误。

安装

npx nuxi@latest module add html-validator

配置

若自动更新nuxt.config.ts配置文件失败,可手动添加下面代码:

nuxt3

defineNuxtConfig({modules: ['@nuxtjs/html-validator',//其他配置项]})

nuxt2.9+

 export default {buildModules: ['@nuxtjs/html-validator']}

nuxt2

 export default {// Install @nuxtjs/html-validator as dependency instead of devDependencymodules: ['@nuxtjs/html-validator']}

使用

html-validator有四个选项

1.usePrettier允许更美观地打印源代码,以便在上下文中显示错误。 


如果使用的是TailwindCSS,请考虑不要启用此功能,因为在开发模式下,prettier将难以处理解析HTML的大小。

2.logLevel设置详细信息为verbose、warning或error。在dev中默认为verbose,在生成时为warning。 


您可以使用此配置选项来关闭控制台日志记录的No HTML validation errors found for…消息。

3.如果生成的页面有任何验证错误,failOnError将在运行nuxt generate后抛出一个错误。

 
在持续集成中很有用。

4.Options允许您传入html-validate选项,这些选项将与默认配置合并 


更多关于配置 html- validate 的信息,可以参考 官方文档。

默认配置

{htmlValidator: {usePrettier: false,logLevel: 'verbose',failOnError: false,/** A list of routes to ignore (that is, not check validity for). */ignore: [/\.(xml|rss|json)$/],options: {extends: ['html-validate:document','html-validate:recommended','html-validate:standard'],rules: {'svg-focusable': 'off','no-unknown-elements': 'error',// Conflicts or not needed as we use prettier formatting'void-style': 'off','no-trailing-whitespace': 'off',// Conflict with Nuxt defaults'require-sri': 'off','attribute-boolean-style': 'off','doctype-style': 'off',// Unreasonable rule'no-inline-style': 'off'}}}
}


规则参考

html语法和概念

与HTML语法和概念相关的规则。

attr-delimiter禁止属性键和值之间有空格
attr-spacing要求属性之间用空格分隔
close-attr禁止结束标记具有属性
close-order要求元素按正确顺序关闭
element-name禁止使用无效的元素名称
form-dup-name要求表单控件具有唯一的名称
map-dup-name要求‘ <map name> ’是唯一的
map-id-name要求name和id在<map>元素上匹配
no-dup-attr禁止重复属性
no-dup-class禁止重复的类
no-raw-characters禁止使用未转义的特殊字符
no-redundant-for禁止对属性使用冗余标签
script-type要求‘ <script> ’元素的有效类型
unrecognized-char-ref禁止无法识别的字符引用
valid-autocomplete要求自动完成属性有效
valid-id要求‘ id ’是一个有效的标识符


内容模型

attribute-allowed-values验证允许的属性值
attribute-misuse要求属性在正确的上下文中使用
element-permitted-content验证允许的内容
element-permitted-occurrences验证允许的元素出现次数
element-permitted-order验证所需的元素顺序
element-permitted-parent验证允许的元素父元素
element-required-ancestor验证所需的元素祖级
element-required-attributes确保设置了所需的属性
element-required-content确保必需的元素存在
input-attributes验证输入属性的使用
no-multiple-main禁用多个“<main>”
script-element为‘ <script> ’要求结束标签
void-content禁止包含内容的void元素


弃用规则 
 


与已弃用或过时功能的使用相关的规则。

deprecated禁止使用废弃的元素
deprecated-rule禁止使用不推荐的规则
no-conditional-comment禁止使用条件注释
no-deprecated-attr禁止使用弃用的属性


可行性

area-alt要求‘ <area> ’元素上的替代文本
aria-hidden-body禁止在“<body>”上设置“aria-hidden”
aria-label-misuse禁止误用“aria-label”
empty-heading要求标题头有文字内容
empty-title要求标题有文字内容
hidden-focusable在可聚焦的元素上禁用“aria-hidden”
input-missing-label要求输入有标签
meta-refresh要求元刷新具有0秒延迟
multiple-labeled-controls禁止与多个控件关联的标签
no-abstract-role禁止使用抽象的WAI-ARIA角色
no-autoplay禁止自动播放媒体元素
no-implicit-button-type禁止隐式按钮类型
no-redundant-aria-label禁止arial -label和label具有相同的文本内容
no-redundant-role禁止使用冗余角色
prefer-native-element更倾向使用原生HTML元素而不是角色
svg-focusable要求<svg>具有可聚焦属性
tel-non-breaking要求在电话号码中使用不间断字符
text-content要求元素具有有效的文本内容
unique-landmark要求地标有唯一的名称
wcag/h30WCAG H30:提供链接文本
wcag/h32WCAG H32:提供提交按钮
wcag/h36WCAG H36:要求在图片上使用所有文本作为提交按钮
wcag/h37WCAG H37:在img元素上使用alt属性
wcag/h63WCAG H63:使用scope属性来关联标题单元格和数据单元格
wcag/h67WCAG H67:在img元素上使用空alt文本和没有标题属性
wcag/h71WCAG H71:为表单控件组提供描述


验证

require-csp-nonce需要CSP的资源
require-sri要求资源的SRI


SEO

long-title要求标题不要有太长的文字


模式

attr-case要求属性名使用特定的大小写
attr-pattern要求属性匹配已配置的模式
attr-quotesRequire attribute quoting
attribute-boolean-style要求属性引用
attribute-empty-style为空属性要求特定的样式
class-pattern要求类匹配特定的模式
doctype-style需要DOCTYPE的特定案例
element-case要求元素名称使用特定的大小写
id-pattern要求id匹配特定的模式
name-pattern要求表单控件名称匹配特定的模式
no-implicit-close要求带有可选结束标签的元素显式关闭
no-implicit-input-type禁止隐式输入类型
no-inline-style禁止内联样式
no-self-closing禁止自闭元素
no-style-tag禁止使用<style>标记
no-trailing-whitespace禁止尾随空格
prefer-button对于按钮,更喜欢使用<button>而不是<input>
prefer-tbody更喜欢把<tr>包装在<tbody>里面
void-style需要一个特定的样式来关闭void元素


文档

这些规则适用于完整的单据。

allowed-links禁用链接类型
doctype-html要求使用“html”文档类型
heading-level要求标题从h1开始并递增1
missing-doctype要求文档具有doctype
no-dup-id不允许重复的id
no-missing-references要求所有元素引用都存在
no-utf8-bom禁止文档具有UTF-8 BOM


未知元素

no-unknown-elements禁止使用未知元素
no-unused-disable禁用未使用的禁用指令


预设配置

HTML-validate带有一些预定义的预设。

示例 .htmlvalidate.json

{"extends": ["html-validate:PRESET"]
}

示例 .htmlvalidate.cjs

const { defineConfig } = require("html-validate");module.exports = defineConfig({extends: ["html-validate:PRESET"],
});

示例 .htmlvalidate.mjs

import { defineConfig } from "html-validate";export default defineConfig({extends: ["html-validate:PRESET"],
});

可以设置多个预设,并将按照它们出现在“extends”中的顺序启用。


预设类型

html-validate:recommended

这是默认的预设,支持大多数规则,包括标准验证、WCAG和最佳实践。它是其他预设的超集。

html-validate:standard

启用与根据WHATWG HTML标准(生活标准)进行验证相关的规则。

如果您想要类似于Nu Html检查器和类似工具的验证,请使用此预设。

html-validate:prettier

自:v7.18.0 
如果您正在使用Prettier来格式化HTML标记,则可以使用此预设来禁用诸如void-style之类的矛盾规则。 
 
这个预设应该与另一个预设(如html-validate:)结合使用,因为它只禁用规则。

html-validate:a11y

启用与可访问性相关的规则。大多数规则(但不是所有已启用的规则)都与WCAG遵从性有关。它本身不会验证文档/模板本身是否有效,而只会在发现可访问性问题时进行验证。 
 
这个预设应该与html-validate:standard一起使用,以确保文档结构是有效的(WCAG的要求),如果可能的话,还应该与html-validate:document(确保引用是有效的,等等)一起使用。

html-validate:browser

自:8.24.0 
如果要从浏览器中获取源代码,请使用此预设来禁用受浏览器规范化影响的规则,例如属性布尔样式。这些规则大多只是表面上的。 
 
这个预设应该与另一个预设(如html-validate:)结合使用,因为它只禁用规则。

html-validate:document

启用需要验证完整文档的规则,即不需要验证部分模板。示例包括缺少文档类型和无效引用。 
 
将此预设与其他预设一起使用以实现全覆盖。这个预设是由cypress-html-validate和protractor-html-validate等插件启用的。


2.@nuxtjs/i18n

安装

npx nuxi@latest module add i18n

配置

{modules: ['@nuxtjs/i18n',],i18n: {locales: [{ code: 'en', language: 'en-US' },{ code: 'fr', language: 'fr-FR' }],defaultLocale: 'en',}
}

实战示例

import process from 'node:process'const isDev = process.env.NODE_ENV === 'development'// const apiBaseUrl = 'http://localhost:3001'
const apiBaseUrl = 'https://movies-proxy.vercel.app'export default defineNuxtConfig({modules: ['@vueuse/nuxt','@unocss/nuxt','@nuxt/image','@nuxtjs/i18n','@nuxtjs/html-validator',],experimental: {inlineSSRStyles: false,viewTransition: true,renderJsonPayloads: true,},routeRules: {'/**': isDev ? {} : { cache: { swr: true, maxAge: 120, staleMaxAge: 60, headersOnly: true } },},runtimeConfig: {public: {apiBaseUrl,},},devtools: {enabled: true,},image: {provider: 'proxy',providers: {proxy: {provider: 'ipx',options: {baseURL: `${apiBaseUrl}/ipx`,},},},},nitro: {routeRules: {'/**': { isr: false },},},i18n: {detectBrowserLanguage: {useCookie: true,fallbackLocale: 'en',},strategy: 'no_prefix',locales: [{code: 'en',name: 'English',file: 'en.json',},{code: 'fa-IR',name: 'فارسی',file: 'fa-IR.json',},{code: 'de-DE',name: 'Deutsch',file: 'de-DE.json',},{code: 'es-ES',name: 'Español',file: 'es-ES.json',},{code: 'it',name: 'Italiano',file: 'it.json',},{code: 'ja',name: '日本語',file: 'ja.json',},{code: 'zh-CN',name: '简体中文',file: 'zh-CN.json',},{code: 'pt-PT',name: 'Português',file: 'pt-PT.json',},{code: 'pt-BR',name: 'Português do Brasil',file: 'pt-BR.json',},{code: 'ru-RU',name: 'Русский',file: 'ru-RU.json',},{code: 'fr-FR',name: 'Français',file: 'fr-FR.json',},{code: 'uk-UA',name: 'Українська',file: 'uk-UA.json',},{code: 'vi',name: 'Tiếng Việt',file: 'vi.json',},],lazy: true,langDir: 'internationalization',defaultLocale: 'en',},htmlValidator: {usePrettier: false,logLevel: 'verbose',failOnError: false,/** A list of routes to ignore (that is, not check validity for). */ignore: [/\.(xml|rss|json)$/],options: {extends: ['html-validate:document','html-validate:recommended','html-validate:standard'],rules: {'svg-focusable': 'off','no-unknown-elements': 'error',// Conflicts or not needed as we use prettier formatting'void-style': 'off','no-trailing-whitespace': 'off',// Conflict with Nuxt defaults'require-sri': 'off','attribute-boolean-style': 'off','doctype-style': 'off',// Unreasonable rule'no-inline-style': 'off'}}},
})


3.@nuxt/image

为nuxt优化的图像,具有渐进式处理,延迟加载,支持图像CDN,实时调整大小和提供者支持。

安装

npx nuxi@latest module add image

nuxt2 可参考 v0文档

其他相关命令

启用corepack enable

corepack enable

安装依赖项

pnpm install

生成类型存根

pnpm dev:prepare

开发模式

pnpm dev

测试添加到test/目录中

pnpm test

检查代码风格

pnpm lint

在创建PR之前

pnpm build

确保构建并没有报错

开发模式启动文档

pnpm docs:dev

打开http://localhost:3000在浏览器中查看。

更新docs/content/目录下的文档内容。

配置

在nuxt.config.ts添加模块支持

export default defineNuxtConfig({modules: ['@nuxt/image',]
})

边缘通道更新

在package.json 添加如下

删除lockfile  (package-lock.jsonyarn.lock, or pnpm-lock.yaml) 并重新安装依赖项。

退出边缘通道

删除lockfile  (package-lock.jsonyarn.lock, or pnpm-lock.yaml) 并重新安装依赖项。

升级最新版本

pnpm up @nuxt/image

重新创建锁文件

npx nuxt@latest upgrade --force

要配置image模块并自定义它的行为,你可以使用next .config中的image属性:

配置参数

示例

export default defineNuxtConfig({image: {// Options}
})

详细参数可参考上文实战示例,下文详细解释参数信息:

inject

默认情况下,nuxt Image v1采用可组合的方法。如果不使用这些组件,就不会向包中添加额外的代码。但是,如果您希望全局初始化将在整个应用程序中可用的 $img 帮助,则可以这样做。

示例

export default defineNuxtConfig({image: {inject: true}
})


quality

生成图像的质量。 
 
您还可以在组件级别使用质量属性覆盖此选项。

示例

export default defineNuxtConfig({image: {quality: 80,}
})


format

Default: ['webp']

您可以使用该选项为<NuxtPicture>使用的图像配置默认格式。支持的格式有webp、avif、jpeg、jpg、png和gif。

格式的顺序很重要,因为浏览器支持的第一种格式将被使用。您可以传递多个值,如['avif', 'webp']。

还可以通过使用format prop在组件级别重写此选项。

示例

export default defineNuxtConfig({image: {format: ['webp']}
})


screens

预定义屏幕尺寸的列表。 


 
这些大小将用于生成图像的调整大小和优化版本(例如,使用大小修改器)。

示例

export default defineNuxtConfig({image: {// The screen sizes predefined by `@nuxt/image`:screens: {'xs': 320,'sm': 640,'md': 768,'lg': 1024,'xl': 1280,'xxl': 1536,'2xl': 1536},}
})

与Tailwind CSS共享相同的命名和大小,只是增加了xs和xxl(为了向后兼容)。


domains

为了在外部网站上启用图像优化,可以指定允许优化的域。此选项将用于检测是否应该优化远程映像。这是确保外部url不会被滥用所必需的。

示例

export default defineNuxtConfig({image: {domains: ['nuxtjs.org']}
})


presets

预设是项目的预定义配置集合。预设将帮助您统一整个项目中的图像。

示例 nuxt.config.ts

export default defineNuxtConfig({image: {presets: {avatar: {modifiers: {format: 'jpg',width: 50,height: 50}}}}
})

示例 index.vue

<template><NuxtImg preset="avatar" src="/nuxt-icon.png" />
</template>


providers

为了创建和使用自定义提供程序,您需要使用providers选项并定义自定义提供程序。

示例 nuxt.config.ts

export default defineNuxtConfig({image: {providers: {random: {provider: '~/providers/random',options: {}}}}
})

示例 index.vue

<template><NuxtImg provider="random" src="main.png" width="300" height="169" />
</template>


provider

默认值:ipx(或ipxStatic,如果与静态nitro预设一起使用,例如运行nuxt generate) 
 
我们可以指定在组件中没有指定或调用$img时使用的默认提供商。

示例 nuxt.config.ts

export default defineNuxtConfig({image: {provider: 'twicpics',twicpics: {baseURL: 'https://nuxt-demo.twic.pics'}}
})

modifiers

您可以为所选的提供程序设置默认修饰符。

示例

export default defineNuxtConfig({image: {provider: 'cloudinary',cloudinary: {baseURL: 'https://res.cloudinary.com/<company>/image/fetch/',modifiers: {effect: 'sharpen:100',quality: 'auto:best',}}}
})


densities

Default: [1, 2]

指定一个值来处理devicePixelRatio > 1(这些是带有视网膜显示和其他的设备)。您必须指定要为哪个devicePixelRatio值调整图像。 
 
你可以在MDN上关于devicePixelRatio的信息。

示例 nuxt.config.ts

export default defineNuxtConfig({image: {densities: [1, 2, 3],}
})


dir

Default: public

这个选项允许您在使用ipx或ipxStatic提供程序时指定源映像的位置。 
 
例如,你可能希望源图像在assets/images目录中,而不是默认的公共目录中,这样源图像就不会被复制到dist中并被部署:

示例 nuxt.config.ts

export default defineNuxtConfig({image: {dir: 'assets/images'}
})

注: 
 
对于ipxStatic提供程序,如果在生成过程中没有抓取图像(不可访问的模式、页面或动态运行时大小),将dir从public更改将导致404错误。 


对于ipx提供程序,也要确保部署自定义的目录。 


对于某些提供程序(如vercel),不支持使用public/以外的目录作为资产,因为调整大小发生在运行时(而不是构建/生成时),并且从public/目录(部署URL)获取源代码。


alias

这个选项允许你为src指定别名。 
 
当使用默认的ipx提供程序时,URL别名会在服务器端缩短。这对于优化外部url而不将它们包含在HTML中特别有用。 
 
当使用其他提供程序时,别名将在运行时解析并包含在HTML中。(只是用法简化了)

示例 nuxt.config.ts

export default defineNuxtConfig({image: {domains: ['images.unsplash.com'],alias: {unsplash: 'https://images.unsplash.com'}}
})

示例 使用别名之前

<NuxtImg src="https://images.unsplash.com/<id>" />

生成

<img src="/_ipx/https://images.unsplash.com/<id>">

示例 在使用别名之后

<NuxtImg src="/unsplash/<id>" />

生成

<img src="/_ipx/unsplash/<id>" />


Providers

nuxt Image支持多个提供程序以实现高性能。

简介 


 
提供者是next Image和第三方图像转换服务之间的集成。每个提供者负责为该图像转换服务生成正确的url。 


 
next Image可以配置为使用任何外部图像转换服务。签出侧栏以获取预配置的提供程序列表。 


 
如果您正在寻找不受支持的特定提供程序,您可以创建自己的提供程序。 


 
next Image将自动优化<NuxtImg>或<NuxtPicture>源,并接受指定目标的所有选项,除了特定于其他提供程序的修饰符。


默认提供者 


 
nuxt Image的默认优化器和提供程序是ipx。任何一个选项都可以在没有任何配置的情况下使用。

本地图片 


 
图像应该存储在项目的public/目录中。 
 
例如,当使用 <NuxtImg src="/nuxt-icon.png" /> 时,它应该放在public/文件夹下的 public/nuxt-icon.png 路径下。 
 
 

注意:存储在assets/目录中的图像不会被nuxt Image处理,因为这些图像是由您的打包器(如Vite或webpack)管理的。


远程图像 


 
使用默认提供程序,您还可以优化外部url。为此,您需要将它们添加到 domains 选项中。 
 


还可以通过将 NUXT_IMAGE_DOMAINS 环境变量设置为逗号分隔的域列表来为远程映像添加域。

示例 

NUXT_IMAGE_DOMAINS="example.com,yourdomain.com"


环境检测 


 
您可以使用 NUXT_IMAGE_PROVIDER 环境变量设置默认提供程序。 
 
自动检测到的提供者:

Vercel - 优化图像在Vercel的边缘网络,下文单独介绍


自定义服务提供方程序 


 
可以定义自己的提供程序,详细了解如何创建自定义提供程序。

下文单独介绍


 NuxtImg

了解如何使用和配置next Image组件。

简介

<NuxtImg>是本机<img>标记的临时替代品。 


 
使用内置提供程序来优化本地和远程映像 


将src转换为提供程序优化的url 


根据宽度和高度自动调整图像大小 


提供大小选项时生成响应大小 


支持本机延迟加载以及其他<img>属性


用法 


 
<NuxtImg>直接输出原生img标记(没有任何包装器)。像使用<img>标签一样使用它:

示例 

<NuxtImg src="/nuxt-icon.png" />

输出

<img src="/nuxt-icon.png" />

使用默认的提供程序,您应该将 /nuxt-icon.png 放在 public/ 目录中,以便让上面的示例工作。


元素

custom

自定义道具决定了<NuxtImg>应该作为一个简单的<img>元素呈现还是仅仅作为自定义呈现的提供者。当设置为true时,它禁用默认呈现行为,允许完全控制图像的显示方式。这对于实现自定义功能(如占位符)非常有用。 
 
当使用自定义道具时,<NuxtImg>将必要的数据和属性传递给其默认槽。你可以通过v-slot指令访问以下值: 
 
imgAttrs: <img>元素的属性(例如,alt, width, height, srcset, sizes)。 


src:计算图像源URL。 


isLoaded:一个布尔值,指示图像是否已加载。 


示例使用

<nuxt-imgsrc="/images/nuxt.png"alt="image"width="400" height="400" :custom="true"v-slot="{ src, isLoaded, imgAttrs }"
><!-- Show the actual image when loaded --><img v-if="isLoaded" v-bind="imgAttrs" :src="src" /><!-- Show a placeholder while loading --><img v-else src="https://placehold.co/400x400" alt="placeholder" />
</nuxt-img>

这种方法确保了自定义呈现场景的灵活性,而<NuxtImg>继续在幕后处理图像优化和数据供应。


src 
 


镜像文件路径 
 
SRC应该是公共/目录中静态图像的绝对路径的形式。否则,提供程序期望的以/或URL开头的路径。

示例

<NuxtImg src="/nuxt.png" />

为了在src中使用外部url进行图像优化,我们需要使用domains选项将它们列入白名单。


width / height

指定图像的宽度/高度。 
 
使用所需的宽度/高度的静态大小的图像,如图标或头像 


响应式图像使用原始图像的宽度/高度(当使用大小时)


alt

尽管next Image没有应用任何特殊处理,但值得一提的是alt属性。它是一个本地全局属性,如果不能显示图像,则为图像指定替代文本。 


 
它应该总是被提供。 


 
如果图像包含信息,则文本应该描述图像 


如果图像位于<a>元素中,文本应该解释链接的位置 


如果图像仅用于装饰,则使用alt=“”

eg

<NuxtImg src="/nuxt.png" alt="My image file description" />


sizes

指定响应大小。 
 
这是一个以空格分隔的屏幕大小/宽度对列表。在上文nuxt.config.ts文件默认配置可以参看默认大小。 
 
默认情况下,next生成响应优先大小。 
 
如果你省略了屏幕尺寸前缀(比如sm:),那么这个尺寸就是图像的“默认”尺寸。否则,next将选择最小的大小作为图像的默认大小。 


这个默认大小一直使用到下一个指定的屏幕宽度,依此类推。每个指定的尺寸对都适用-所以md:400px意味着图像将在md屏幕上的大小为400px。 


例子:

<NuxtImgsrc="/logos/nuxt.png"sizes="100vw sm:50vw md:400px"
/>


densities

为增加像素密度的屏幕生成特殊版本的图像。 
 
例子:

<NuxtImgsrc="/logos/nuxt.png"height="50"densities="x1 x2"
/>
<!--
<imgsrc="/_ipx/w_50/logos/nuxt.png" srcset="/_ipx/w_100/logos/nuxt.png x2"
/>
-->


placeholder

在实际图像完全加载之前显示占位符图像。 


 
您还可以使用自定义道具制作任何您想要的占位符。 


 
占位符道具可以是字符串、布尔值、数字或数组。每种情况的用法如下所示。

<!-- 自动生成一个基于原始图像的占位符 -->
<NuxtImg src="/nuxt.png" placeholder /><!-- 为自动生成的占位符 设置宽度、高度  -->
<NuxtImg src="/nuxt.png" :placeholder="[50, 25]" /><!-- 为自动生成的占位符 设置宽度、高度、质量和模糊  -->
<NuxtImg src="/nuxt.png" :placeholder="[50, 25, 75, 5]" /><!-- 设置自动生成占位符的宽度和高度,图像将是一个正方形 -->
<NuxtImg src="/nuxt.png" :placeholder="15" /><!-- 提供你自己的图片 -->
<NuxtImg src="/nuxt.png" placeholder="./placeholder.png" />

你也可以利用useImage()来生成一个基于原始图像的占位符图像,如果源是SVG或者你想更好地控制修饰符,这是有用的:

<script setup>
const img = useImage()
</script><template><NuxtImg :placeholder="img(`/nuxt.svg`, { h: 10, f: 'png', blur: 2, q: 50 })" src="/nuxt.svg`" />
</template>


placeholder-class

在使用占位符时,可以使用占位符类将类应用于原始的底层<img>元素(在呈现占位符时)。

<!-- 对原始图像应用静态类 -->
<NuxtImg src="/nuxt.png" placeholder placeholder-class="custom" /><!-- 对原始图像应用动态类 -->
<NuxtImg src="/nuxt.png" placeholder :placeholder-class="custom" />

如果你只需要对加载的图像应用一些CSS,你可以这样做:

img:not(.my-placeholder-class) {/* styles here */
}


provider

使用其他提供商,而不是在nuxt .config中指定的默认提供商选项 


 
示例 nuxt.config.ts

export default defineNuxtConfig({image: {cloudinary: {baseURL: 'https://res.cloudinary.com/nuxt/image/upload/',},},
})

index.vue

<template><NuxtImgprovider="cloudinary"src="/remote/nuxt-org/blog/going-full-static/main.png"width="300"height="169"/>
</template>


preset

预设是预定义的图像修改器集,可用于在项目中创建统一形式的图像。

我们可以使用next .config中的预置选项来定义预置

示例 nuxt.config.ts

export default defineNuxtConfig({image: {presets: {cover: {modifiers: {fit: 'cover',format: 'jpg',width: 300,height: 300,},},},},
})

index.vue

<template><NuxtImg preset="cover" src="/nuxt-icon.png" />
</template>


format

如果您想以特定格式提供图像,请使用此道具。

示例

<NuxtImg format="webp" src="/nuxt-icon.png" ... />

可用的格式是webp, avif, jpeg, jpg, png, gif和svg。如果没有指定格式,它将遵循默认的图像格式。


quality

生成图像的质量。

<NuxtImg src="/nuxt.jpg" quality="80" width="200" height="100" />


fit

fit属性指定图像的大小。此属性可以使用五个标准值。

cover: (默认)保留宽高比,确保图像覆盖两个提供的尺寸裁剪/剪辑以适应。


contain:保留长宽比,在必要时使用“letterboxing”包含在两个提供的维度中。


fill: 忽略输入的宽高比,并拉伸到两个提供的尺寸。


inside: 保留宽高比,将图像调整为尽可能大,同时确保其尺寸小于或等于指定的两个。


outside: 保留宽高比,将图像调整为尽可能小,同时确保其尺寸大于或等于指定的尺寸。

示例

<NuxtImg fit="cover" src="/nuxt-icon.png" width="200" height="100" />

一些提供程序支持其他值。


modifiers

除了标准修饰符之外,每个提供程序可能还有自己的附加修饰符。由于这些修饰符依赖于提供程序,因此请参阅其文档以了解可以使用哪些修饰符。 
 
使用modifiers道具可以使用这些转换中的任何一种。

示例

<NuxtImgprovider="cloudinary"src="/remote/nuxt-org/blog/going-full-static/main.png"width="300"height="169":modifiers="{ roundCorner: '0:100' }"
/>


preload

如果您想预加载图像,请使用此道具。这将在页面头部放置一个相应的 link 链接标记。

<NuxtImg preload src="/nuxt-icon.png" />


loading

这是一个原生属性,它向浏览器提供了一个提示,告诉浏览器如何处理视图外的图像加载。自2022年3月起,所有主流浏览器的最新版本都支持它。 
 
设置loading="lazy"来延迟图像的加载,直到它出现在视窗中。

示例

<NuxtImg src="/nuxt-icon.png" loading="lazy" />


nonce

这是一个本地全局属性,它定义了一个加密nonce(一次使用的数字),内容安全策略可以使用它来确定是否允许对给定元素进行给定的获取。提供nonce允许您避免使用CSP不安全的内联指令,该指令将允许列出所有内联脚本或样式。

示例

<NuxtImg src="/nuxt-icon.png" :nonce="nonce" /><script lang="ts" setup>
// useNonce不是由next /image提供的,但可能是
// 由另一个模块提供,例如nuxt-security
const nonce = useNonce()
</script>


Events

由<NuxtImg>和<NuxtPicture>组件包含的<img>元素发出的本地事件被重新发出,并且可以被监听。 
 
示例:监听来自<NuxtImg>的本机onLoad事件

<NuxtImgsrc="/images/colors.jpg"width="500"height="500"@load="doSomethingOnLoad"
/>


NuxtPicture

简介

使用和配置next Picture组件

<NuxtPicture>是本机<picture>标签的临时替代品。 


 
使用<NuxtPicture>几乎与<NuxtImg>相同,但也允许在可能的情况下提供像webp这样的现代格式。

 
 
在 MDN 上了解更多关于<picture>标签的信息。 


 
与原生的<picture>元素不同,<NuxtPicture>目前不支持使用多个图像源。参见 #309 了解更多信息。

使用类型可以参考 NuxtImg 相同


format

图片上的格式可以用来提供多种格式的图像。将自动生成遗留格式。因此在下面的示例中,将生成avif、webp和png。它们将以与添加到format属性相同的顺序添加。

示例

<NuxtPictureformat="avif,webp"src="/nuxt-icon.png"
/>

格式有webp、avif、jpeg、jpg、png和gif。如果没有指定格式,它将遵循默认的图像格式。


legacyFormat

用于回退的格式。Default是有条件的: 
 
1.如果原始格式支持透明(png, webp和gif),则使用png作为回退 


2.否则,jpeg用于回退


imgAttrs 


 
允许您在img元素上设置额外的html属性。 
 
例子:

<NuxtPicturesrc="/nuxt-icon.png":imgAttrs="{id: 'my-id',class: 'my-class',style: 'display: block','data-my-data': 'my-value'}"
/>


useImage()

一个可组合的Vue,它返回一个辅助函数来生成优化的图像url。 


有时,您可能需要直接使用生成的图像URL和应用的转换,而不是使用<NuxtImg>和<NuxtPicture>组件。这就是useImage()的用途(以及它返回的辅助函数,您经常会看到它被直接引用为$img或img)。

用法

const img = useImage()img(src, modifiers, options)

示例:为backgrounimage样式生成图像URL。

const img = useImage()const backgroundStyles = computed(() => {const imgUrl = img('https://github.com/nuxt.png', { width: 100 })return { backgroundImage: `url('${imgUrl}')` }
})


img.getSizes

const img = useImage()img.getSizes(src, { sizes, modifiers })

不稳定:getSizes API可能会改变或被移除。

参数

src: (字符串)源到原始图像的id


sizes:string)响应图像大小列表({breakpoint}:{size}{unit})


modifiers: (对象)传递给提供程序的用于调整大小和优化的修饰符


        width:调整到指定的宽度(以像素为单位)
        height: 调整到指定的高度(以像素为单位)
        quality: 改变图像质量(0到100)
        format: 修改图像格式
        (任何其他自定义提供程序修饰符)


options: (object)


        provider: string)非默认的提供商名称(参见providers)
        preset: 使用预设


示例:响应srcset与Vuetify v-img

<template><v-img:lazy-src="img(src, { width: 10, quality: 70 })":src="img(src, { height, quality: 70 })":srcset="_srcset.srcset":height="height":sizes="_srcset.sizes"/>
</template><script setup lang="ts">
const props = defineProps({height: {type: [Number, String],default: 500},src: {type: String,default: '/img/header-bg.jpg'}
})const img = useImage()const _srcset = computed(() => {return img.getSizes(props.src, {sizes: 'xs:100vw sm:100vw md:100vw lg:100vw xl:100vw',modifiers: {format: 'webp',quality: 70,height: props.height}})
})
</script>


自定义服务提供方程序 


如果不支持CDN提供商,您可以自己定义它。

供应商条目 

 
运行时将接收源、映像修改器及其提供程序选项。它负责为优化的图像生成URL,并且需要是同构的,因为它可能在服务器或客户端上被调用。

示例 providers/my-provider.ts

import { joinURL } from 'ufo'
import type { ProviderGetImage } from '@nuxt/image'
import { createOperationsGenerator } from '#image'const operationsGenerator = createOperationsGenerator()export const getImage: ProviderGetImage = (src,{ modifiers = {}, baseURL } = {}
) => {if (!baseURL) {// also support runtime config baseURL = useRuntimeConfig().public.siteUrl}const operations = operationsGenerator(modifiers)return {url: joinURL(baseURL, src + (operations ? '?' + operations : ''))}
}

参数

src: 图像的源路径。


modifiers: 在图像组件或预设中定义的图像修饰符列表。


ctx: (ImageCTX)图像模块运行时上下文 

        options: (CreateImageOptions)图像模块全局运行时选项
        $img:  $img 帮助

注意:ctx中的值可能会改变。请谨慎使用。

返回结果

url: 优化图像的绝对或相对url。


使用您的提供商 


 
注册供应商 


 
创建自己的提供程序之后,应该在next .config中注册它。为此,在image.provider中创建一个属性。

示例 nuxt.config.ts

export default defineNuxtConfig({image: {providers: {myProvider: {name: 'myProvider', // optional value to overrider provider nameprovider: '~/providers/my-provider.ts', // Path to custom provideroptions: {// ... provider optionsbaseURL: 'https://site.com'}}}}
})

通过从#image中导入,可以使用许多有用的实用程序来编写提供程序。更多信息请参见src/runtime/providers。

用法 

 
将属性提供者设置为您的自定义提供者名称。

示例 pages/index.vue

<NuxtImg provider="myProvider" src="/image.png" >
<!-- <img src="https://site.com/image.png"> -->


静态图像 


优化静态网站图片


如果您正在使用nuxt generate构建一个静态站点,那么当您的站点生成时,nuxt Image将优化并在本地保存您的图像,并将它们与生成的页面一起部署。 
 
如果禁用服务器端渲染(在next .config中设置ssr: false),那么next Image将无法在静态生成过程中优化您的图像。 
 
在这种情况下,你可以通过使用 nitro.prerender.routes 选项告诉next预渲染图像:

示例 nuxt.config.ts

export default defineNuxtConfig({ssr: false,nitro: {prerender: {routes: ['/_ipx/w_120/market.jpg','/_ipx/w_140/market.jpg',// etc.]}}
})


Providers

云服务商较多,且写法可参考上文github实例代码,可根据需要自行配置,云服务商配置​​​​​​​


@unocss/nuxt

在正式介绍@unocss/nuxt之前先来比较一下和 @nuxtjs/tailwindcss 组件库的区别,网上有很多相关的参考,主要有以下几点:

1.性能差异原因

2.性能数据差距

3.案例分析

简介

Tailwind CSS 是一款实用性优先的 CSS 框架,它允许开发者通过简单的实用程序类快速构建设计一致性的界面。Tailwind 提供了丰富的类名,可以用来调整颜色、间距、边框、背景等等,使开发者能够快速迭代设计。此外,Tailwind 还支持自定义配置,允许扩展框架的功能。

UnoCSS 是一个按需编译的 CSS 工具,它从源代码中提取 CSS 类,并生成最小化的 CSS 文件。UnoCSS 支持广泛的类名,并且可以集成到多种构建工具中,如 Vite、Rollup 等。UnoCSS 的核心理念是减少最终输出的 CSS 文件大小,从而提高加载速度。

1.性能差异原因

UnoCSS 和 Tailwind CSS 在性能上的差异主要体现在以下几点:

文件大小:UnoCSS 通过按需编译,只保留实际使用的样式类,这使得最终生成的 CSS 文件体积远小于 Tailwind CSS。Tailwind CSS 默认情况下会打包大量的未使用样式类,即使使用 PurgeCSS 进行优化,也可能无法完全消除这些未使用的类。

构建速度:UnoCSS 利用了 Vite 的热模块替换功能,在开发过程中能够更快地进行样式更新。而 Tailwind CSS 的构建过程可能因为需要处理大量的样式类而稍显缓慢,尤其是在大规模项目中。

加载时间:由于 UnoCSS 的 CSS 文件体积较小,因此在网络传输过程中加载时间也相对较短,特别是在移动设备或网络条件较差的情况下,这种优势更加明显。

2.性能数据差距​​​​​​​

为了量化 UnoCSS 与 Tailwind CSS 之间的性能差异,我们可以通过几个关键指标来进行比较:

CSS 文件大小

Tailwind CSS:默认情况下,Tailwind CSS 打包后的 CSS 文件可能达到几百 KB 的大小。即使使用 PurgeCSS 来移除未使用的类,也可能只能减少到 100KB 左右。

UnoCSS:通过按需编译,UnoCSS 可以将最终 CSS 文件的大小控制在几十 KB 内,甚至更低,具体取决于实际使用的类数量。

构建时间

Tailwind CSS:根据项目规模不同,Tailwind CSS 的构建时间可能会比 UnoCSS 多几秒到几十秒不等。这是因为 Tailwind CSS 需要处理更多的样式类。

UnoCSS:UnoCSS 通常构建速度更快,因为它只需要处理实际使用的类,减少了不必要的计算。

加载时间

由于 UnoCSS 的 CSS 文件体积较小,加载时间也较短。假设在一个典型的网页环境中,加载时间可以从几毫秒到几百毫秒不等,具体取决于用户的网络状况。

3.案例分析

假设在一个中等规模的应用中,使用 Tailwind CSS 默认打包后的 CSS 文件大小为 300KB,而 UnoCSS 通过按需编译后仅包含实际使用的 50KB 的 CSS 规则。这意味着在初次加载时,使用 UnoCSS 的应用可以减少大约 83% 的 CSS 下载量。

假设该应用每天有数千次访问,那么节省的带宽将是显著的。同时,更快的加载速度意味着更好的用户体验,尤其是在低带宽环境下。

4.总结

尽管 UnoCSS 在生成 CSS 文件的大小和构建时间上都优于 Tailwind CSS,但选择哪一个框架还应该综合考虑项目的具体需求、团队熟悉度以及长期维护成本等因素。UnoCSS 的高度可定制性和按需编译特性使其在性能优化方面具有明显优势,但对于初学者来说,Tailwind CSS 的易用性和丰富的文档可能更具吸引力。

总的来说,UnoCSS 和 Tailwind CSS 都是优秀的工具,选择哪一种取决于项目的具体需求以及团队的技术栈偏好。在性能敏感的应用场景下,UnoCSS 提供了一个轻量级且高效的解决方案,值得开发者们尝试和探索。

文章可参考 unocss和Tailwind对比​​​​​​​ 

unocss使用详解

unocss官方文档:

英文文档

中文文档


安装

pnpm add -D unocss @unocss/nuxt

在你的 Nuxt 配置文件中添加 @unocss/nuxt

// nuxt.config.ts
export default defineNuxtConfig({modules: ['@unocss/nuxt',],
})

配置和使用

创建一个 uno.config.ts 文件:

// uno.config.ts
import { defineConfig } from 'unocss'export default defineConfig({// ...UnoCSS 选项
})

uno.css 入口将由模块自动注入。

详细使用方法可参考文档


相关文章:

nuxt常用组件库html-validator、@nuxtjs/i18n、@nuxt/image、@unocss/nuxt使用解析

html-validator 主要用于自动验证nuxt服务器呈现的HTML(SSR和SSG)&#xff0c;以检测可能导致水合错误的HTML常见问题&#xff0c;有助于减少水合错误&#xff0c;检测常见的可访问性错误。 安装 npx nuxilatest module add html-validator配置 若自动更新nuxt.config.ts配置文…...

Leetcode-最大矩形(单调栈)

一、题目描述 给定一个仅包含 0 和 1 、大小为 rows x cols 的二维二进制矩阵&#xff0c;找出只包含 1 的最大矩形&#xff0c;并返回其面积。 输入&#xff1a;matrix [["1","0","1","0","0"],["1","0&…...

Vue核心知识:动态路由实现完整方案

在Vue中实现动态路由&#xff0c;并结合后端接口和数据库表设计&#xff0c;是一个复杂的项目&#xff0c;需要多个技术栈和步骤的配合。以下将详细描述整个实现过程&#xff0c;包括数据库设计、后端接口设计、前端路由配置以及如何实现动态路由的功能。 目录 一、需求分析二…...

【Docker】使用Docker搭建-MySQL数据库服务

零、更换Docker镜像源 因为国内现在封锁了Docker默认拉取镜像的站点&#xff08;DockerHub&#xff09;&#xff0c;而且国内大部分Docker镜像站已全部下线&#xff0c;导致现在很多朋友在拉取镜像的时候会出现无法拉取的现象&#xff0c;这时候就需要进行更换Docker镜像源。 可…...

DHCP配置和地址

DHCP&#xff1a;动态主机配置协议 DHCP系统组成 DHCP报文结构 DHCP报文类型 DHCP工作流程 DHCP租期更新 DHCP重绑定 自动保留IP 租期设置建议 IP地址释放 DHCP地址池 DHCP配置 DHCP接口地址池配置 DHCP全局地址池配置...

基于trl复现DeepSeek-R1的GRPO训练过程

1. 引入 huggingface开发了强化学习训练Transformer的库trl&#xff08;参考3&#xff09;&#xff0c;借助这个trl&#xff0c;可以用来做GRPO的强化学习训练。魔搭ModelScope社区的文章&#xff08;参考2&#xff09;给出了基于Qwen基座模型Qwen2.5-0.5B-Instruct&#xff0…...

常用的 pip 命令

pip 是 Python 的包管理工具&#xff0c;可用于安装、卸载、更新和管理 Python 包。以下是一些常用的 pip 命令&#xff1a; 1. 安装包 安装最新版本的包 pip install package_namepackage_name 是你要安装的 Python 包的名称&#xff0c;例如 pip install requests 可以安装…...

基于C#的CANoe CLR Adapter开发指南

一、引言 CANoe 是一款广泛应用于汽车电子开发和测试的工具&#xff0c;它支持多种编程接口&#xff0c;方便开发者进行自定义扩展。CANoe CLR Adapter 允许我们使用 C# 语言与 CANoe 进行交互&#xff0c;充分利用 C# 的强大功能和丰富的类库。本文将详细介绍如何基于 C# 进行…...

eMMC安全简介

1. 引言 术语“信息安全”涵盖多种不同的设计特性。一般而言&#xff0c; 信息安全是指通过实践防止信息遭受未经授权的访问、使用、披露、中断、篡改、检查、记录或销毁。 信息安全的三大核心目标为 机密性&#xff08;Confidentiality&#xff09;、完整性&#xff08;Integr…...

从零开始用react + tailwindcss + express + mongodb实现一个聊天程序(六) 导航栏 和 个人信息设置

1.导航栏&#xff08;navbar&#xff09; 在components下面 创建NavBar.jsx import { MessageSquare,Settings,User,LogOut} from "lucide-react" import {Link} from "react-router-dom" import { useAuthStore } from "../store/useAuthStore&qu…...

c#实现modbus rtu定时采集数据

以下是使用C#实现Modbus RTU定时采集数据的完整代码示例,包含定时任务、数据采集和异常处理: csharp 复制 using System; using System.IO.Ports; using System.Timers;public class ModbusRtuCollector : IDisposable {private readonly SerialPort _serialPort;private …...

【Python 语法】Python 数据结构

线性结构&#xff08;Linear Structures&#xff09;1. 顺序存储列表&#xff08;List&#xff09;元组&#xff08;Tuple&#xff09;字符串&#xff08;String&#xff09; 2. 线性存储栈&#xff08;Stack&#xff09;队列&#xff08;Queue&#xff09;双端队列&#xff08…...

数据库MySQL,在终端输入后,提示不是内部命令等

【解决问题】mysql提示不是内部或外部命令&#xff0c;也不是可运行的程序 一般这种问题是因为没有在系统变量里面添加MySQL的可执行路径 以下是添加可执行路径的方法&#xff1a; 第一步&#xff1a;winR输入services.msc 然后找到MySQL&#xff0c;右击属性并复制MySQL的可执…...

docker和containerd从TLS harbor拉取镜像

私有镜像仓库配置了自签名证书&#xff0c;https访问&#xff0c;好处是不需要处理免费证书和付费证书带来的证书文件变更&#xff0c;证书文件变更后需要重启服务&#xff0c;自签名证书需要将一套客户端证书存放在/etc/docker/cert.d目录下&#xff0c;或者/etc/containerd/c…...

《从0到1:用Python在鸿蒙系统开发安防图像分类AI功能》

在人工智能与移动应用深度融合的当下,类目标签AI功能成为众多行业提升效率和用户体验的关键技术。本文聚焦于HarmonyOS NEXT API 12及以上版本,以图像分类在智能家居安防领域的应用为例,为开发者详细阐述如何利用Python开发类目标签AI功能,助力鸿蒙技术在该领域的创新应用。…...

C语言生成二维码

1. 效果 2. 需要的代码&#xff08;QRCode&#xff09; qrcode.cqrcode.h 代码 3. 代码 #include <stdio.h> #include "qrcode.h"int main() {//拓展编码SetConsoleOutputCP(437);QRCode qrcode;uint8_t qrcodeBytes[qrcode_getBufferSize(3)];qrcode_initT…...

Spring Boot 消息队列(以RabbitMQ为例)

文章目录 RabbitMQ 简介与安装1. RabbitMQ 简介2. RabbitMQ 安装 Spring Boot 集成 RabbitMQ1. 创建 Spring Boot 项目2. 配置 RabbitMQ3. 定义消息队列和交换机4. 发送消息5. 接收消息6. 测试消息发送和接收 RabbitMQ 简介与安装 1. RabbitMQ 简介 RabbitMQ 是一个开源的消息…...

[Web 安全] PHP 反序列化漏洞 —— POP 链构造思路

关注这个专栏的其他相关笔记&#xff1a;[Web 安全] 反序列化漏洞 - 学习笔记-CSDN博客 0x01&#xff1a;什么是 POP 链&#xff1f; POP 链&#xff08;Payload On Purpose Chain&#xff09;是一种利用 PHP 中的魔法方法进行多次跳转以获取敏感数据的技术。它通常出现在 CTF…...

商城源码的框架

商城源码的框架通常是基于某种Web开发框架或者电子商务平台来构建的。以下是一些常见的商城源码框架&#xff1a; WooCommerce&#xff1a;基于WordPress的电子商务插件&#xff0c;适用于小型到中型的在线商店。 Magento&#xff1a;一个功能强大和灵活的开源电子商务平台&am…...

记录深度学习中有用的终端命令

1 查看 CUDA 版本 如果你安装了 CUDA 开发工具包&#xff0c;你可以使用 nvcc 命令来查看 CUDA 的版本。 打开终端&#xff08;或命令提示符&#xff09;&#xff0c;运行&#xff1a; nvcc --version 2. 监控 GPU 状态 使用 nvidia-smi 命令&#xff0c;nvidia-smi 是一个…...

深度探索推理新境界:DeepSeek-R1如何用“自学”让AI更聪明?

今天我们要聊从1月初火到现在的AI模型——DeepSeek-R1。它就像一个“自学成材的学霸”&#xff0c;不用老师手把手教&#xff0c;就能在数学、编程、逻辑推理等领域大显身手&#xff01;仔细阅读了深度求索发表的R1论文&#xff0c;发现它不仅揭秘了它的成长秘籍&#xff0c;还…...

2025春新生培训数据结构(树,图)

教学目标&#xff1a; 1&#xff0c;清楚什么是树和图&#xff0c;了解基本概念&#xff0c;并且理解其应用场景 2&#xff0c;掌握一种建图&#xff08;树&#xff09;方法 3&#xff0c;掌握图的dfs和树的前中后序遍历 例题与习题 2025NENU新生培训&#xff08;树&#…...

keil主题(vscode风格)

#修改global.prop文件&#xff0c;重新打开keil即可 # Keil uVision Global Properties File # This file is used to customize the appearance of the editor# Editor Font editor.font.nameConsolas editor.font.size10 editor.font.style0# Editor Colors editor.backgro…...

使用Hydra进行AI项目的动态配置管理

引言:机器学习中的超参数调优挑战 在机器学习领域,超参数调优是决定模型性能的关键环节。不同的模型架构,如神经网络中的层数、节点数,决策树中的最大深度、最小样本分割数等;以及各种训练相关的超参数,像学习率、优化器类型、批量大小等,其取值的选择对最终模型的效果…...

低代码与开发框架的一些整合[3]

1.基本说明 审批流程是企业内部运营的运行流程&#xff0c;与业务板块进行关联&#xff0c;在企业数智化过程中启动业务串联的作用&#xff0c;与AI业务模型及业务agent整合后&#xff0c;将大大提升企业的运行效率以及降低运营风险。 近期对开源的近40个携带流程平台的项目进…...

深入了解 K-Means 聚类算法:原理与应用

引言 在数据科学和机器学习的世界中&#xff0c;聚类是一项非常重要的技术&#xff0c;它帮助我们根据数据的相似性将数据划分为不同的组或簇。聚类算法在许多领域中得到了广泛的应用&#xff0c;如图像处理、市场细分、基因研究等。K-Means 聚类算法作为最常见的无监督学习算…...

AVFormatContext

1. AVFormatContext 的通用性 1.1 通用结构 AVFormatContext 是 FFmpeg 中的一个通用结构体&#xff0c;用于描述多媒体文件或流的上下文信息。它既可以用于输入文件/流&#xff0c;也可以用于输出文件/流。关键字段&#xff08;如 iformat 和 oformat&#xff09;决定了 AVF…...

永磁同步电机无速度算法--反电动势观测器

一、原理介绍 在众多无位置传感器控制方法中&#xff0c;低通滤波反电势观测器结构简单&#xff0c;参数整定容易&#xff0c;易于编程实现。但是该方法估计出的反电势会产生相位滞后&#xff0c;需要在估计永磁同步电机转子位置时进行了相位补偿。 二、仿真模型 在MATLAB/si…...

Spark基础篇 RDD、DataFrame与DataSet的关系、适用场景与演进趋势

一、核心概念与演进背景 1.1 RDD(弹性分布式数据集) 定义:RDD 是 Spark 最早的核心抽象(1.0版本引入),代表不可变、分区的分布式对象集合,支持函数式编程和容错机制。特点: 无结构化信息:仅存储对象本身,无法自动感知数据内部结构(如字段名、类型)。编译时类型安全…...

【Linux】命令行参数 | 环境变量(四)

目录 前言&#xff1a; 一、命令行参数&#xff1a; 1.main函数参数 2.为什么有它&#xff1f; 二、环境变量&#xff1a; 1.main函数第三个参数 2.查看shell本身环境变量 3.PATH环境变量 4.修改PATH环境变量配置文件 5.HOME环境变量 6.SHELL环境变量 7.PWD环境变…...