用途:本 skill 是 openEuler Portal 项目通用前端开发工具的指南,覆盖 Vue Composables、SCSS Mixins 和工具函数三类资源,便于在项目开发中复用统一实现。
主要能力:Composables 位于 openEuler-portal/app/.vitepress/src-new/composables/,提供 useScreen(响应式屏幕适配)、useLocale(国际化切换)、useClipboard、useDebounceSearch、useCheckbox、useScrollBottom、useInViewDuration。SCSS Mixins 位于 assets/style/mixin/,含 screen.scss(响应式断点)、font.scss(响应式字体,如 h1-h4、text1-2、tip1-2、display1-3)、common.scss(暗色模式、文本截断、滚动条、悬停等)。Utils 位于 utils/,含 common.ts(URL 参数、Cookie、时间格式化、Git 平台检测)和 locale.ts(语言环境获取)。
使用方式:引入 composable 如 import { useScreen } from '~@/composables/useScreen',解构 isPhone、isPad 等;SCSS 中用 @use '~@/assets/style/mixin/font.scss' as * 后 @include h1,响应式用 @include respond-to('phone');工具函数如 getUrlParam、setCookie、changeTimeStamp、getCurrentLocale。新项目可配置 vite.config.ts 的 css.preprocessorOptions.scss.additionalData 全局注入 mixin。
适用场景:响应式页面布局、多语言切换、表单与搜索/剪贴板交互、标准字体与通用样式开发。
限制:路径别名项目用 ~@/,新项目常用 @/,需相应调整;SCSS mixin 文件不随 npm 包分发,需手动创建;全局注入后不应再手动 @use,否则报“cannot use module twice”;screen.scss 的 map 值必须用引号包裹,否则解析为 list 导致编译错误。费用、平台、效果等信息暂未提供。