# 基础介绍

# template结构体常识

root节点只能包含一个view标签

template-view

# css 的引用

如果我们创建自定义的样式文件,例如创建一个/static/scss/ruoyi.css,想要使其在全局引用。

1、在App.vue中全局引用,每个页面都可以使用该样式。

<style lang="scss">
  @import '@/static/scss/ruoyi.css';
</style>
1
2
3

2、在index.scss中导入,每个页面都可以使用该样式。

@import '@/static/scss/ruoyi.css';
1

推荐第二种方式,方便所有的样式文件在index.scss统一管理和维护。

# css 的变量

css 变量 描述
--status-bar-height 系统状态栏高度
--window-top 内容区域距离顶部的距离
--window-bottom 内容区域距离底部的距离

注意:

  • var(--status-bar-height)此变量在微信小程序环境为固定25px,在App里为手机实际状态栏高度。
  • 当设置"navigationStyle":"custom"取消原生导航栏后,由于窗体为沉浸式,占据了状态栏位置。此时可以使用一个高度为var(--status-bar-height)的 view 放在页面顶部,避免页面内容出现在状态栏。
  • 由于在 H5 端,不存在原生导航栏和 tabbar,也是前端 div 模拟。如果设置了一个固定位置的居底 view,在小程序和 App 端是在 tabbar 上方,但在 H5 端会与 tabbar 重叠。此时可使用--window-bottom,不管在哪个端,都是固定在 tabbar 上方。
  • 目前 nvue 在 App 端,还不支持--status-bar-height变量,替代方案是在页面 onLoad 时通过uni.getSystemInfoSync().statusBarHeight获取状态栏高度,然后通过 style 绑定方式给占位 view 设定高度。下方提供了示例代码

代码示例

<template>
  <page-meta>
    <navigation-bar />
  </page-meta>
  <view>
    <view class="status_bar">
      <!-- 这里是状态栏 -->
    </view>
    <view>状态栏下的文字</view>
  </view>
</template>
<style>
  .status_bar {
    height: var(--status-bar-height);
    width: 100%;
  }
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<template>
  <view>
    <view class="toTop">
      <!-- 这里可以放一个向上箭头,它距离底部tabbar上浮10px-->
    </view>
  </view>
</template>
<style>
  .toTop {
    bottom: calc(var(--window-bottom) + 10px);
  }
</style>
1
2
3
4
5
6
7
8
9
10
11
12

nvue 页面获取状态栏高度

<template>
  <view class="content">
    <view :style="{ height: iStatusBarHeight + 'px'}"></view>
  </view>
</template>

<script>
  export default {
    data() {
      return {
        iStatusBarHeight: 0,
      };
    },
    onLoad() {
      this.iStatusBarHeight = uni.getSystemInfoSync().statusBarHeight;
    },
  };
</script>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# js的引用

如创建/utils/ruoyi.js

export function hello() {
  alert('hello')
}
1
2
3

在其他页面使用hello方法

<script>
  import { hello } from  '@/utils/ruoyi.js'

  export default {
    onLoad: function() {
      hello()
    }
  };
</script>
1
2
3
4
5
6
7
8
9

# 内联样式

框架组件上支持使用styleclass属性来控制组件的样式。

  • style:静态的样式统一写到 class 中。style 接收动态的样式,在运行时会进行解析,请尽量避免将静态的样式写进 style 中,以免影响渲染速度。
<view :style="{color:color}" />
1
  • class:用于指定样式规则,其属性值是样式规则中类选择器名(样式类名)的集合,样式类名不需要带上.,样式类名之间用空格分隔。
<view class="normal_view" />
1

# 全局方法

全局方法在main.js定义,如/utils/permission.js,把checkPerm、checkRole方法注册到全局使用。

import { checkPermi, checkRole } from './utils/permission'

Vue.prototype.checkPermi = checkPermi
Vue.prototype.checkRole = checkRole
1
2
3
4

测试验证

<view v-if="checkRole(['admin'])">角色权限控制</view>
<view v-if="checkPermi(['system:user:list'])">按钮权限控制</view>
1
2

# 全局变量机制

全局变量机制globalData,支持全端通用。

以下是 App.vue 中定义globalData的相关配置:

<script>  
  export default {  
    globalData: {  
      text: 'text'  
    }
  }  
</script>  
1
2
3
4
5
6
7

其他页面获取方式

console.info(getApp().globalData.text);
1

修改globalData变量的方式如下:getApp().globalData.text = 'ruoyi'

注意

globalData是简单的全局变量,如果使用状态管理,请使用vuex(main.js中定义)

# 屏幕尺寸单位

uni-app支持的通用css单位包括pxrpx

  • px即屏幕像素
  • rpx即响应式px,一种根据屏幕宽度自适应的动态单位。以750宽的屏幕为基准,750rpx恰好为屏幕宽度。屏幕变宽,rpx实际显示效果会等比放大 。

vue页面支持下面这些普通H5单位,但在nvue里不支持

  • rem根字体大小可以通过page-meta配置
  • vh viewpoint height,视窗高度,1vh等于视窗高度的1%
  • vw viewpoint width,视窗宽度,1vw等于视窗宽度的1%

# 使用sass编写样式

style中 添加lang属性,这样就可以支持scss样式编译了

<template>
  <view class="content">
    <view class="item">
      <view class="title">若依移动端</view>
      <view class="count">520</view>
    </view>
  </view>
</template>

<style lang="scss">
  .item {
    .title {
      background-color: #0066CC;
    }

    .count {
      background: black;
      color: #FFF;
    }
  }
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21