RuoYi

# 基础介绍

# 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

# 内联样式

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

  • 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单位包括px、rpx

  • 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

← 生命周期 →