diff --git a/docs-vitepress/.vitepress/config.ts b/docs-vitepress/.vitepress/config.ts index 149573d16a..5ebd92f102 100644 --- a/docs-vitepress/.vitepress/config.ts +++ b/docs-vitepress/.vitepress/config.ts @@ -117,6 +117,7 @@ const sidebar: ExtendedSidebar = { { text: '跨端样式', link: '/guide/rn/style' }, { text: '应用能力', link: '/guide/rn/application-api' }, { text: '混合编写 RN', link: '/guide/rn/hybrid-with-react-native' }, + { text: '使用原子类', link: '/guide/rn/rn-unocss' } ], }, { diff --git a/docs-vitepress/api/compile.md b/docs-vitepress/api/compile.md index 85a5b5a617..3a5ed245f9 100644 --- a/docs-vitepress/api/compile.md +++ b/docs-vitepress/api/compile.md @@ -1756,7 +1756,7 @@ module.exports = defineConfig({ ## MpxUnocssBase -Mpx 内置的 unocss preset,继承自 `@unocss/preset-uno`,并额外提供小程序原子类的预设样式,安装示例如下: +Mpx 内置的 unocss preset,继承自 `@unocss/preset-wind3`,并额外提供小程序原子类的预设样式,安装示例如下: ```bash npm install -D @mpxjs/unocss-base diff --git a/docs-vitepress/guide/rn/rn-unocss.md b/docs-vitepress/guide/rn/rn-unocss.md new file mode 100644 index 0000000000..008d3cea08 --- /dev/null +++ b/docs-vitepress/guide/rn/rn-unocss.md @@ -0,0 +1,410 @@ +# 在Mpx RN 环境中使用原子类 + +Mpx 使用 unocss 作为原子类引擎,使得在使用 mpx 开发跨端项目也可以使用原子类。如果要在你的项目当中集成原子类的能力,具体操作请参照接入文档。 + +受限于 RN 平台的样式规则能力限制,绝大部分的 unocss 提供的原子类并不能在跨 RN 项目当中使用,以下是目前所支持的原子类: + +> 对于不支持的原子类,在项目编译构建阶段会将不支持的原子类以 error 形式提示,且最终的编译产物当中不会产出对应的原子类结果 + + +#### [Typography](https://windicss.org/utilities/general/typography.html#typography) + +| 规则 | 是否支持 | 备注 | +| :------------------------ | :------: | :---------------------------------------------------: | +| Font family | 是 | | +| Font size | 是 | | +| Font style | 是 | | +| Font weight | 是 | | +| Font Variant Numberic | 否 | | +| Hyphens | 否 | | +| Letter spacing | 是 | | +| Line height | 是 | | +| Tab size | 否 | | +| Text alignment | 是 | | +| Text color | 是 | | +| Text decoration | 是 | | +| Text decoration style | 是 | ios 支持 安卓不支持 | +| Text decoration thickness | 否 | | +| Text underline offset | 否 | | +| Text decoration opacity | 是 | | +| Text indent | 否 | | +| Text opacity | 是 | | +| Text shadow | 是 | | +| Text stroke | 否 | | +| Text stroke color | 否 | | +| Text transform | 是 | | +| Vertical alignment | 是 | 安卓支持,ios 不支持,且只支持 auto/top/bottom/center | +| White space | 否 | | +| Word break | 否 | | +| Write mode | 否 | | +| Writing orientation | 否 | | + +#### Svg + +不支持 + +#### [Variants](https://windicss.org/utilities/general/variants.html) + +* Screen Variants + +Mobile First + +| Varaint | 规则 | 备注 | +| :------------- | :------: | :---: | +| sm | @media (min-width: 640px) | | +| md | @media (min-width: 768px) | | +| lg | @media (min-width: 1024px) | | +| xl | @media (min-width: 1280px) | | +| 2xl | @media (min-width: 1536px) | | + +Desktop First + +| Varaint | 规则 | 备注 | +| :------------- | :------: | :---: | +|