Road_roller/.claude/skills/uni-helper/references/util-unocss-preset.md

name, description

name	description
unocss-preset-uni	UnoCSS preset for uni-app with platform-specific utilities and rpx support

unocss-preset-uni

UnoCSS preset designed for uni-app development. Provides utilities for rpx units and platform-specific styling.

Installation

npm i -D @uni-helper/unocss-preset-uni

Setup

// uno.config.ts
import { defineConfig } from 'unocss'
import { presetUni } from '@uni-helper/unocss-preset-uni'

export default defineConfig({
  presets: [
    presetUni(),
  ],
})

Features

• rpx support: Automatic conversion to rpx units
• Platform variants: Style targeting specific platforms
• Safe area utilities: Handle notches and safe areas
• Compatible with: Mini programs, H5, and App

RPX Utilities

The preset automatically converts pixel values to rpx:

<!-- These generate rpx units -->
<view class="w-100"></view>    <!-- width: 100rpx -->
<view class="h-50"></view>     <!-- height: 50rpx -->
<view class="m-20"></view>     <!-- margin: 20rpx -->
<view class="p-16"></view>     <!-- padding: 16rpx -->
<view class="text-32"></view>  <!-- font-size: 32rpx -->

Platform Variants

Apply styles to specific platforms:

<!-- Only apply on H5 -->
<view class="h5:bg-red"></view>

<!-- Only apply on WeChat -->
<view class="mp-weixin:bg-blue"></view>

<!-- Only apply on App -->
<view class="app:bg-green"></view>

<!-- Combine with responsive -->
<view class="h5:p-20 mp-weixin:p-10"></view>

Safe Area Utilities

<!-- Safe area padding -->
<view class="pt-safe"></view>      <!-- padding-top: env(safe-area-inset-top) -->
<view class="pb-safe"></view>      <!-- padding-bottom: env(safe-area-inset-bottom) -->
<view class="px-safe"></view>      <!-- padding-x with safe area -->

<!-- Safe area margin -->
<view class="mt-safe"></view>
<view class="mb-safe"></view>

<!-- Full safe area -->
<view class="safe-area"></view>

Tab Bar Utilities

<!-- Padding for tab bar -->
<view class="pb-tabbar"></view>

<!-- Margin for tab bar -->
<view class="mb-tabbar"></view>

Status Bar Utilities

<!-- Status bar height -->
<view class="h-statusbar"></view>
<view class="pt-statusbar"></view>

Configuration

// uno.config.ts
import { defineConfig } from 'unocss'
import { presetUni } from '@uni-helper/unocss-preset-uni'

export default defineConfig({
  presets: [
    presetUni({
      // rpx base width (default: 750)
      baseWidth: 750,

      // Enable platform variants
      platform: true,

      // Enable safe area utilities
      safeArea: true,

      // Custom platforms
      platforms: ['mp-weixin', 'mp-alipay', 'h5', 'app'],
    }),
  ],
})

With Vite

// vite.config.ts
import Uni from '@dcloudio/vite-plugin-uni'
import UnoCSS from 'unocss/vite'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [
    UnoCSS(),
    Uni(),
  ],
})

Example

<template>
  <view class="page bg-gray-100">
    <!-- Status bar spacing -->
    <view class="h-statusbar"></view>

    <!-- Header with safe area -->
    <view class="px-32 pt-safe flex items-center justify-between">
      <text class="text-36 font-bold">Title</text>
    </view>

    <!-- Content -->
    <view class="p-32 flex flex-col gap-20">
      <!-- Platform-specific styling -->
      <view class="card h5:shadow-lg mp-weixin:border">
        <text class="text-28 text-gray-800">Content</text>
      </view>
    </view>

    <!-- Bottom safe area for devices with notches -->
    <view class="pb-safe"></view>
  </view>
</template>