uni-app 多端样式统一

核心知识点

1. 多端样式差异

uni-app 运行在多个平台上，不同平台的样式实现存在差异：

• 微信小程序：使用 WXSS，基本兼容 CSS 但有一些限制
• 支付宝小程序：使用 ACSS，与 CSS 有一定差异
• 百度小程序：使用 SWAN CSS，与 CSS 有一定差异
• App 端：使用 Web 标准的 CSS
• Web 端：使用 Web 标准的 CSS
• 其他平台：各有不同的样式实现

2. 样式重置与标准化

为了实现多端样式统一，需要进行样式重置和标准化：

• 样式重置：清除不同平台的默认样式差异
• 标准化：建立统一的样式标准，确保各平台表现一致
• CSS 变量：使用 CSS 变量管理样式，方便统一修改
• 工具类：建立统一的工具类，减少重复代码

3. 统一样式方案

有效的统一样式方案包括：

• 使用 SCSS/Less：使用 CSS 预处理器，提高样式代码的可维护性
• 样式变量：定义全局样式变量，统一管理颜色、字体、间距等
• 组件样式：为组件定义统一的样式，确保多端表现一致
• 平台特定样式：使用条件编译处理平台特定的样式
• 响应式设计：使用响应式设计，适配不同屏幕尺寸

4. 平台特定样式处理

处理平台特定样式的方法：

• 条件编译：使用 uni-app 的条件编译语法，为不同平台编写特定样式
• 平台判断：使用 JavaScript 判断当前平台，动态应用样式
• 样式覆盖：为特定平台编写覆盖样式

实用案例分析

案例：实现多端样式统一

1. 样式重置实现

样式重置文件 (static/css/reset.css)：

/* 样式重置 */
* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

body {
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
  font-size: 16px;
  line-height: 1.5;
  color: #333;
  background-color: #f5f5f5;
}

/* 清除列表样式 */
ul, ol {
  list-style: none;
}

/* 清除链接样式 */
a {
  color: inherit;
  text-decoration: none;
}

/* 清除图片默认样式 */
img {
  max-width: 100%;
  height: auto;
  vertical-align: middle;
}

/* 清除表单元素默认样式 */
input, button, select, textarea {
  font-family: inherit;
  font-size: inherit;
  line-height: inherit;
  color: inherit;
}

button {
  background: none;
  border: none;
  cursor: pointer;
}

/* 清除浮动 */
.clearfix::after {
  content: '';
  display: table;
  clear: both;
}

/* 解决 iOS 上的点击高亮问题 */
* {
  -webkit-tap-highlight-color: transparent;
}

/* 解决 Android 上的字体大小问题 */
body {
  -webkit-text-size-adjust: 100%;
}

在 App.vue 中引入样式重置：

<style>
/* 引入样式重置 */
@import "static/css/reset.css";

/* 全局样式 */
page {
  background-color: #f5f5f5;
}
</style>

2. 统一样式变量

使用 SCSS 变量 (static/css/variables.scss)：

// 颜色变量
$colors: (
  primary: #007AFF,
  secondary: #5856D6,
  success: #34C759,
  warning: #FF9500,
  danger: #FF3B30,
  info: #5AC8FA,
  light: #F2F2F7,
  dark: #1C1C1E,
  gray: #8E8E93,
  gray-light: #C7C7CC,
  white: #FFFFFF,
  black: #000000
);

// 字体大小
$font-sizes: (
  xs: 10px,
  sm: 12px,
  base: 14px,
  md: 16px,
  lg: 18px,
  xl: 20px,
  xxl: 24px
);

// 间距
$spacing: (
  xs: 4px,
  sm: 8px,
  md: 16px,
  lg: 24px,
  xl: 32px,
  xxl: 48px
);

// 圆角
$border-radius: (
  sm: 2px,
  md: 4px,
  lg: 8px,
  xl: 12px,
  round: 50%
);

// 阴影
$shadows: (
  sm: 0 1px 2px rgba(0, 0, 0, 0.05),
  md: 0 2px 4px rgba(0, 0, 0, 0.1),
  lg: 0 4px 8px rgba(0, 0, 0, 0.15),
  xl: 0 8px 16px rgba(0, 0, 0, 0.2)
);

// 字体权重
$font-weights: (
  normal: 400,
  medium: 500,
  semibold: 600,
  bold: 700
);

// 行高
$line-heights: (
  tight: 1.25,
  normal: 1.5,
  relaxed: 1.75
);

// 导出 CSS 变量
:root {
  @each $name, $value in $colors {
    --color-#{$name}: #{$value};
  }
  
  @each $name, $value in $font-sizes {
    --font-size-#{$name}: #{$value};
  }
  
  @each $name, $value in $spacing {
    --spacing-#{$name}: #{$value};
  }
  
  @each $name, $value in $border-radius {
    --border-radius-#{$name}: #{$value};
  }
  
  @each $name, $value in $shadows {
    --shadow-#{$name}: #{$value};
  }
  
  @each $name, $value in $font-weights {
    --font-weight-#{$name}: #{$value};
  }
  
  @each $name, $value in $line-heights {
    --line-height-#{$name}: #{$value};
  }
}

在组件中使用样式变量：

<style lang="scss">
@import "static/css/variables.scss";

.container {
  padding: var(--spacing-md);
  background-color: var(--color-white);
  border-radius: var(--border-radius-md);
  box-shadow: var(--shadow-md);
}

.title {
  font-size: var(--font-size-lg);
  font-weight: var(--font-weight-semibold);
  color: var(--color-dark);
  margin-bottom: var(--spacing-sm);
}

.button {
  padding: var(--spacing-sm) var(--spacing-lg);
  background-color: var(--color-primary);
  color: var(--color-white);
  border-radius: var(--border-radius-md);
  font-size: var(--font-size-base);
  font-weight: var(--font-weight-medium);
}
</style>

3. 平台特定样式处理

使用条件编译处理平台特定样式：

<style>
/* 通用样式 */
.button {
  padding: 12px 24px;
  border-radius: 8px;
  font-size: 16px;
}

/* #ifdef MP-WEIXIN */
/* 微信小程序特定样式 */
.button {
  font-weight: 500;
}
/* #endif */

/* #ifdef MP-ALIPAY */
/* 支付宝小程序特定样式 */
.button {
  font-weight: bold;
}
/* #endif */

/* #ifdef APP-PLUS */
/* App 端特定样式 */
.button {
  transition: background-color 0.3s ease;
}

.button:active {
  opacity: 0.8;
}
/* #endif */

/* #ifdef H5 */
/* Web 端特定样式 */
.button {
  cursor: pointer;
  transition: all 0.3s ease;
}

.button:hover {
  transform: translateY(-2px);
  box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
}

.button:active {
  transform: translateY(0);
  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
}
/* #endif */
</style>

4. 响应式样式设计

响应式样式实现：

<style>
/* 响应式容器 */
.container {
  width: 100%;
  padding: 0 16px;
  margin: 0 auto;
}

/* 响应式网格 */
.grid {
  display: flex;
  flex-wrap: wrap;
  margin: 0 -8px;
}

.grid-item {
  flex: 0 0 100%;
  padding: 0 8px;
  margin-bottom: 16px;
}

/* 平板 */
@media (min-width: 768px) {
  .container {
    max-width: 750px;
  }
  
  .grid-item {
    flex: 0 0 50%;
  }
}

/* 桌面 */
@media (min-width: 992px) {
  .container {
    max-width: 970px;
  }
  
  .grid-item {
    flex: 0 0 33.333%;
  }
}

/* 大屏桌面 */
@media (min-width: 1200px) {
  .container {
    max-width: 1170px;
  }
  
  .grid-item {
    flex: 0 0 25%;
  }
}
</style>

5. 组件样式统一

统一按钮组件 (components/unified-button.vue)：

<template>
  <view class="unified-button" :class="[type, size, { disabled }]">
    <slot></slot>
  </view>
</template>

<script>
export default {
  props: {
    type: {
      type: String,
      default: 'primary',
      validator: (value) => ['primary', 'secondary', 'success', 'warning', 'danger', 'info', 'light', 'dark'].includes(value)
    },
    size: {
      type: String,
      default: 'medium',
      validator: (value) => ['small', 'medium', 'large'].includes(value)
    },
    disabled: {
      type: Boolean,
      default: false
    }
  }
};
</script>

<style lang="scss">
@import "static/css/variables.scss";

.unified-button {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  border-radius: var(--border-radius-md);
  font-weight: var(--font-weight-medium);
  text-align: center;
  white-space: nowrap;
  user-select: none;
  
  /* 大小变体 */
  &.small {
    padding: var(--spacing-xs) var(--spacing-md);
    font-size: var(--font-size-sm);
  }
  
  &.medium {
    padding: var(--spacing-sm) var(--spacing-lg);
    font-size: var(--font-size-base);
  }
  
  &.large {
    padding: var(--spacing-md) var(--spacing-xl);
    font-size: var(--font-size-md);
  }
  
  /* 类型变体 */
  &.primary {
    background-color: var(--color-primary);
    color: var(--color-white);
  }
  
  &.secondary {
    background-color: var(--color-secondary);
    color: var(--color-white);
  }
  
  &.success {
    background-color: var(--color-success);
    color: var(--color-white);
  }
  
  &.warning {
    background-color: var(--color-warning);
    color: var(--color-white);
  }
  
  &.danger {
    background-color: var(--color-danger);
    color: var(--color-white);
  }
  
  &.info {
    background-color: var(--color-info);
    color: var(--color-white);
  }
  
  &.light {
    background-color: var(--color-light);
    color: var(--color-dark);
  }
  
  &.dark {
    background-color: var(--color-dark);
    color: var(--color-white);
  }
  
  /* 禁用状态 */
  &.disabled {
    opacity: 0.6;
    pointer-events: none;
  }
  
  /* App 端和 Web 端的交互效果 */
  /* #ifdef APP-PLUS || H5 */
  &:not(.disabled) {
    transition: all 0.3s ease;
  }
  
  /* #ifdef H5 */
  &:not(.disabled):hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow-md);
  }
  
  &:not(.disabled):active {
    transform: translateY(0);
    box-shadow: var(--shadow-sm);
  }
  /* #endif */
  
  /* #ifdef APP-PLUS */
  &:not(.disabled):active {
    opacity: 0.8;
  }
  /* #endif */
  /* #endif */
}
</style>

使用统一按钮组件：

<template>
  <view class="button-container">
    <unified-button type="primary" size="medium">主要按钮</unified-button>
    <unified-button type="secondary" size="medium">次要按钮</unified-button>
    <unified-button type="success" size="medium">成功按钮</unified-button>
    <unified-button type="warning" size="medium">警告按钮</unified-button>
    <unified-button type="danger" size="medium">危险按钮</unified-button>
    <unified-button type="info" size="medium">信息按钮</unified-button>
    <unified-button type="light" size="medium">浅色按钮</unified-button>
    <unified-button type="dark" size="medium">深色按钮</unified-button>
    <unified-button type="primary" size="small">小按钮</unified-button>
    <unified-button type="primary" size="large">大按钮</unified-button>
    <unified-button type="primary" size="medium" disabled>禁用按钮</unified-button>
  </view>
</template>

<script>
import UnifiedButton from '@/components/unified-button.vue';

export default {
  components: {
    UnifiedButton
  }
};
</script>

<style>
.button-container {
  display: flex;
  flex-wrap: wrap;
  gap: 12px;
  padding: 20px;
  background-color: #f5f5f5;
  border-radius: 8px;
}
</style>

6. 样式工具类

统一工具类 (static/css/utilities.scss)：

// 布局工具类
.display-flex {
  display: flex;
}

.display-inline-flex {
  display: inline-flex;
}

.display-block {
  display: block;
}

.display-inline-block {
  display: inline-block;
}

.flex-row {
  flex-direction: row;
}

.flex-column {
  flex-direction: column;
}

.justify-start {
  justify-content: flex-start;
}

.justify-center {
  justify-content: center;
}

.justify-end {
  justify-content: flex-end;
}

.justify-between {
  justify-content: space-between;
}

.justify-around {
  justify-content: space-around;
}

.align-start {
  align-items: flex-start;
}

.align-center {
  align-items: center;
}

.align-end {
  align-items: flex-end;
}

.align-stretch {
  align-items: stretch;
}

.flex-1 {
  flex: 1;
}

.flex-shrink-0 {
  flex-shrink: 0;
}

// 间距工具类
.m-0 { margin: 0; }
.m-xs { margin: var(--spacing-xs); }
.m-sm { margin: var(--spacing-sm); }
.m-md { margin: var(--spacing-md); }
.m-lg { margin: var(--spacing-lg); }
.m-xl { margin: var(--spacing-xl); }

.mt-0 { margin-top: 0; }
.mt-xs { margin-top: var(--spacing-xs); }
.mt-sm { margin-top: var(--spacing-sm); }
.mt-md { margin-top: var(--spacing-md); }
.mt-lg { margin-top: var(--spacing-lg); }
.mt-xl { margin-top: var(--spacing-xl); }

.mb-0 { margin-bottom: 0; }
.mb-xs { margin-bottom: var(--spacing-xs); }
.mb-sm { margin-bottom: var(--spacing-sm); }
.mb-md { margin-bottom: var(--spacing-md); }
.mb-lg { margin-bottom: var(--spacing-lg); }
.mb-xl { margin-bottom: var(--spacing-xl); }

.ml-0 { margin-left: 0; }
.ml-xs { margin-left: var(--spacing-xs); }
.ml-sm { margin-left: var(--spacing-sm); }
.ml-md { margin-left: var(--spacing-md); }
.ml-lg { margin-left: var(--spacing-lg); }
.ml-xl { margin-left: var(--spacing-xl); }

.mr-0 { margin-right: 0; }
.mr-xs { margin-right: var(--spacing-xs); }
.mr-sm { margin-right: var(--spacing-sm); }
.mr-md { margin-right: var(--spacing-md); }
.mr-lg { margin-right: var(--spacing-lg); }
.mr-xl { margin-right: var(--spacing-xl); }

.p-0 { padding: 0; }
.p-xs { padding: var(--spacing-xs); }
.p-sm { padding: var(--spacing-sm); }
.p-md { padding: var(--spacing-md); }
.p-lg { padding: var(--spacing-lg); }
.p-xl { padding: var(--spacing-xl); }

.pt-0 { padding-top: 0; }
.pt-xs { padding-top: var(--spacing-xs); }
.pt-sm { padding-top: var(--spacing-sm); }
.pt-md { padding-top: var(--spacing-md); }
.pt-lg { padding-top: var(--spacing-lg); }
.pt-xl { padding-top: var(--spacing-xl); }

.pb-0 { padding-bottom: 0; }
.pb-xs { padding-bottom: var(--spacing-xs); }
.pb-sm { padding-bottom: var(--spacing-sm); }
.pb-md { padding-bottom: var(--spacing-md); }
.pb-lg { padding-bottom: var(--spacing-lg); }
.pb-xl { padding-bottom: var(--spacing-xl); }

.pl-0 { padding-left: 0; }
.pl-xs { padding-left: var(--spacing-xs); }
.pl-sm { padding-left: var(--spacing-sm); }
.pl-md { padding-left: var(--spacing-md); }
.pl-lg { padding-left: var(--spacing-lg); }
.pl-xl { padding-left: var(--spacing-xl); }

.pr-0 { padding-right: 0; }
.pr-xs { padding-right: var(--spacing-xs); }
.pr-sm { padding-right: var(--spacing-sm); }
.pr-md { padding-right: var(--spacing-md); }
.pr-lg { padding-right: var(--spacing-lg); }
.pr-xl { padding-right: var(--spacing-xl); }

// 文本工具类
.text-xs { font-size: var(--font-size-xs); }
.text-sm { font-size: var(--font-size-sm); }
.text-base { font-size: var(--font-size-base); }
.text-md { font-size: var(--font-size-md); }
.text-lg { font-size: var(--font-size-lg); }
.text-xl { font-size: var(--font-size-xl); }
.text-xxl { font-size: var(--font-size-xxl); }

.font-normal { font-weight: var(--font-weight-normal); }
.font-medium { font-weight: var(--font-weight-medium); }
.font-semibold { font-weight: var(--font-weight-semibold); }
.font-bold { font-weight: var(--font-weight-bold); }

.text-left { text-align: left; }
.text-center { text-align: center; }
.text-right { text-align: right; }

.text-primary { color: var(--color-primary); }
.text-secondary { color: var(--color-secondary); }
.text-success { color: var(--color-success); }
.text-warning { color: var(--color-warning); }
.text-danger { color: var(--color-danger); }
.text-info { color: var(--color-info); }
.text-light { color: var(--color-light); }
.text-dark { color: var(--color-dark); }
.text-gray { color: var(--color-gray); }
.text-white { color: var(--color-white); }
.text-black { color: var(--color-black); }

// 背景工具类
.bg-primary { background-color: var(--color-primary); }
.bg-secondary { background-color: var(--color-secondary); }
.bg-success { background-color: var(--color-success); }
.bg-warning { background-color: var(--color-warning); }
.bg-danger { background-color: var(--color-danger); }
.bg-info { background-color: var(--color-info); }
.bg-light { background-color: var(--color-light); }
.bg-dark { background-color: var(--color-dark); }
.bg-gray { background-color: var(--color-gray); }
.bg-white { background-color: var(--color-white); }
.bg-black { background-color: var(--color-black); }

// 圆角工具类
.rounded-none { border-radius: 0; }
.rounded-sm { border-radius: var(--border-radius-sm); }
.rounded-md { border-radius: var(--border-radius-md); }
.rounded-lg { border-radius: var(--border-radius-lg); }
.rounded-xl { border-radius: var(--border-radius-xl); }
.rounded-full { border-radius: var(--border-radius-round); }

// 阴影工具类
.shadow-none { box-shadow: none; }
.shadow-sm { box-shadow: var(--shadow-sm); }
.shadow-md { box-shadow: var(--shadow-md); }
.shadow-lg { box-shadow: var(--shadow-lg); }
.shadow-xl { box-shadow: var(--shadow-xl); }

// 定位工具类
.relative { position: relative; }
.absolute { position: absolute; }
.fixed { position: fixed; }
.sticky { position: sticky; }

.top-0 { top: 0; }
.right-0 { right: 0; }
.bottom-0 { bottom: 0; }
.left-0 { left: 0; }

.inset-0 { top: 0; right: 0; bottom: 0; left: 0; }

// 显示/隐藏工具类
.hidden { display: none; }
.visible { display: block; }
.invisible { visibility: hidden; }

// 溢出工具类
.overflow-hidden { overflow: hidden; }
.overflow-auto { overflow: auto; }
.overflow-scroll { overflow: scroll; }
.overflow-x-auto { overflow-x: auto; }
.overflow-y-auto { overflow-y: auto; }

// 文本截断工具类
.truncate {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.truncate-2 {
  display: -webkit-box;
  -webkit-line-clamp: 2;
  -webkit-box-orient: vertical;
  overflow: hidden;
}

.truncate-3 {
  display: -webkit-box;
  -webkit-line-clamp: 3;
  -webkit-box-orient: vertical;
  overflow: hidden;
}

在组件中使用工具类：

<template>
  <view class="card bg-white rounded-md shadow-md p-md">
    <view class="card-header mb-md">
      <text class="text-lg font-semibold text-dark">卡片标题</text>
    </view>
    <view class="card-body mb-md">
      <text class="text-base text-gray mb-sm">这是一张示例卡片，用于展示如何使用样式工具类实现多端样式统一。</text>
    </view>
    <view class="card-footer flex justify-between items-center">
      <unified-button type="primary" size="small">操作按钮</unified-button>
      <text class="text-sm text-gray">2023-01-01</text>
    </view>
  </view>
</template>

<script>
import UnifiedButton from '@/components/unified-button.vue';

export default {
  components: {
    UnifiedButton
  }
};
</script>

<style>
@import "static/css/utilities.scss";

/* 组件特定样式 */
.card {
  transition: transform 0.3s ease, box-shadow 0.3s ease;
}

/* #ifdef H5 */
.card:hover {
  transform: translateY(-4px);
  box-shadow: var(--shadow-lg);
}
/* #endif */
</style>

学习目标

通过本章节的学习，你应该能够：

1. 理解多端样式差异：掌握不同平台的样式实现差异
2. 掌握样式重置与标准化：能够实现样式重置和标准化，消除平台差异
3. 实现统一样式方案：能够使用 CSS 变量、预处理器等工具实现统一样式
4. 处理平台特定样式：能够使用条件编译处理平台特定的样式
5. 设计响应式样式：能够设计适配不同屏幕尺寸的响应式样式
6. 构建统一组件库：能够构建多端表现一致的组件库

总结

uni-app 多端样式统一是一个需要综合考虑的问题，需要开发者了解不同平台的样式差异，并采用有效的策略来消除这些差异。通过样式重置、使用 CSS 变量、条件编译等方法，可以实现多端样式的统一，提供一致的用户体验。

在实际项目中，我们需要注意以下几点：

1. 建立样式规范：制定统一的样式规范，包括颜色、字体、间距等
2. 使用工具链：使用 SCSS/Less 等预处理器，提高样式代码的可维护性
3. 组件化开发：将样式封装到组件中，确保组件在不同平台的表现一致
4. 测试验证：在不同平台上测试样式表现，确保多端一致
5. 持续优化：根据实际使用情况，持续优化样式方案

通过本章节的学习和实践，你应该能够熟练掌握 uni-app 多端样式统一的方法和技巧，为用户提供一致、优质的多端体验。