当前位置:首页 > uni-app

uniapp 官方样式

2026-03-05 08:04:34uni-app

Uniapp 官方样式规范

Uniapp 提供了一套默认的样式规范,旨在统一多端开发体验。这些样式基于微信小程序的 WXSS 规范,并扩展支持其他平台。

基础样式

Uniapp 内置的基础样式包括:

  • 默认字体:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue"
  • 默认字号:14px
  • 默认行高:1.4
  • 默认颜色:#333333

这些基础样式会自动应用到所有页面,开发者可以通过修改 app.vue 中的全局样式进行覆盖。

单位系统

Uniapp 使用 rpx 作为响应式单位:

  • 1rpx 等于屏幕宽度的 1/750
  • 设计稿通常按照 750rpx 宽度进行设计
  • 换算公式:px = rpx * (屏幕宽度 / 750)

对于需要固定尺寸的场景,可以使用 px 单位。

颜色系统

官方推荐的配色方案:

  • 主色:#007AFF(蓝色)
  • 成功色:#4CD964(绿色)
  • 警告色:#FF9500(橙色)
  • 错误色:#FF3B30(红色)
  • 文字色:#333333(主文字),#666666(常规文字),#999999(次要文字)
  • 背景色:#F7F7F7(页面背景),#FFFFFF(组件背景)

组件默认样式

常见组件的默认样式值:

  • 按钮:高度 92rpx,圆角 6rpx,默认内边距 0 32rpx
  • 输入框:高度 72rpx,默认边框 1rpx solid #e5e5e5
  • 列表项:高度 96rpx,左右边距 32rpx
  • 标签栏:高度 100rpx,图标尺寸 54rpx

全局样式变量

Uniapp 支持通过 CSS 变量定义全局样式:

:root {
  --primary-color: #007AFF;
  --success-color: #4CD964;
  --warning-color: #FF9500;
  --error-color: #FF3B30;
  --text-color: #333333;
  --border-color: #e5e5e5;
}

样式重置

Uniapp 会对部分 HTML 元素进行样式重置:

  • box-sizing: border-box 全局应用
  • body 元素默认边距清零
  • a 标签颜色继承父级
  • img 标签默认去除边框

多端适配建议

针对不同平台的样式适配:

  • H5 端可使用 postcss 进行自动转换
  • 小程序端注意 rpx 单位的兼容性
  • APP 端可使用条件编译处理平台差异样式

最佳实践

推荐的样式编写方式:

  • 使用 SCSS/LESS 预处理器管理样式
  • 遵循 BEM 命名规范
  • 提取公共样式到单独文件
  • 避免使用过于复杂的选择器
  • 合理使用 CSS 变量实现主题切换

以上规范可以帮助开发者保持应用样式的一致性和可维护性,同时确保在多端环境中获得良好的显示效果。

uniapp 官方样式

标签: 样式官方
分享给朋友:

相关文章

vue中样式的实现原理

vue中样式的实现原理

Vue 中样式的实现原理 Vue 的样式处理机制基于其核心的响应式系统和虚拟 DOM 技术,通过编译、作用域隔离和动态绑定实现高效的样式管理。 样式作用域隔离 Vue 的单文件组件(SFC)通过 s…

uniapp插槽样式

uniapp插槽样式

uniapp插槽样式的基本用法 在UniApp中使用插槽时,样式处理与普通组件类似,但需要注意作用域问题。父组件传递内容到子组件插槽时,样式默认受父组件作用域影响。 子组件中定义插槽: <…

vue实现禁用样式

vue实现禁用样式

Vue 中禁用样式的方法 在 Vue 项目中,可以通过多种方式实现禁用样式。以下是几种常见的方法: 动态绑定 class 或 style 通过 Vue 的 v-bind 动态绑定 class…

vue实现导航样式

vue实现导航样式

vue实现导航样式的方法 在Vue中实现导航样式可以通过多种方式完成,以下是一些常见的方法: 使用Vue Router和CSS样式 Vue Router是Vue.js官方的路由管理器,结合CSS可…

vue实现动态绑定样式

vue实现动态绑定样式

动态绑定样式的方法 在Vue中实现动态绑定样式主要通过v-bind:class和v-bind:style指令完成,支持对象语法、数组语法等多种灵活方式。 对象语法 通过对象可以动态切换class,…

vue实现点击添加样式

vue实现点击添加样式

实现点击添加样式的方法 在Vue中实现点击添加样式可以通过多种方式完成,以下是几种常见的方法: 使用v-bind:class动态绑定类名 通过v-bind:class可以动态切换CSS类名,结合点…