uniapp页面样式和布局和nvue教程详解

news/2024/11/22 19:20:12/

uniapp页面样式和布局和nvue教程

尺寸单位

uni-app 支持的通用 css 单位包括 px、rpx

  • px 即屏幕像素。
  • rpx 即响应式px，一种根据屏幕宽度自适应的动态单位。以750宽的屏幕为基准，750rpx恰好为屏幕宽度。屏幕变宽，rpx 实际显示效果会等比放大。但在 App 端和 H5 端屏幕宽度达到 960px 时，默认将按照 375px 的，屏幕宽度进行计算，具体配置参考：rpx计算配置

rpx 详细说明：

设计师在提供设计图时，一般只提供一个分辨率的图。严格按设计图标注的 px 做开发，在不同宽度的手机上界面很容易变形。而且主要是宽度变形。高度一般因为有滚动条，不容易出问题。由此，引发了较强的动态宽度单位需求。微信小程序设计了 rpx 解决这个问题。 uni-app 在 App 端、H5 端都支持了 rpx ，并且可以配置不同屏幕宽度的计算方式，具体参考：rpx计算配置。
rpx 是相对于基准宽度的单位，可以根据屏幕宽度进行自适应。uni-app 规定屏幕基准宽度 750rpx。
开发者可以通过设计稿基准宽度计算页面元素 rpx 值，设计稿 1px 与框架样式 1rpx 转换公式如： 设计稿 1px / 设计稿基准宽度 = 框架样式 1rpx / 750rpx。
换言之，页面元素宽度在 uni-app 中的宽度计算公式：750 * 元素在设计稿中的宽度 / 设计稿基准宽度
页面元素宽度在 uni-app 中的宽度计算举例说明：

  • 若设计稿宽度为 750px，元素 A 在设计稿上的宽度为 100px，那么元素 A 在 uni-app 里面的宽度应该设 为： 750 * 100 / 750 ，结果为：100rpx。
  • 若设计稿宽度为 640px，元素 A 在设计稿上的宽度为 100px，那么元素 A 在 uni-app 里面的宽度应该设 为： 750 * 100 / 640 ，结果为：117rpx。
  • 若设计稿宽度为 375px，元素 B 在设计稿上的宽度为 200px，那么元素 B 在 uni-app 里面的宽度应该设 为： 750 * 200 / 375 ，结果为：400rpx。

注意 ：
rpx 是和宽度相关的单位，屏幕越宽，该值实际像素越大。如不想根据屏幕宽度缩放，则应该使用 px 单位。如果开发者在字体或高度中也使用了 rpx ，那么需注意这样的写法意味着随着屏幕变宽，字体会变大、高度会变大。如果你需要固定高度，则应该使用px,rpx不支持动态横竖屏切换计算，使用rpx建议锁定屏幕方向。

全局样式与局部样式

定义在 App.vue 中的样式为全局样式，作用于每一个页面。在 pages 目录下 的 vue 文件中定义的样式为局部样式，只作用在对应的页面，并会覆盖 App.vue 中相同的选择器。
注意：
App.vue 中通过 @import语句可以导入外联样式文件，一样作用于每一个页面。

<style>/*每个页面公共css */@import url("../../common/css/common.css");
</style>

uniapp页面样式和布局和nvue教程
效果：
uniapp页面样式和布局和nvue教程详解
APP和小程序中子组件会使用父组件的样式，H5端不会使用父组件的样式。

CSS变量

uni-app 提供内置 CSS 变量

CSS 变量描述App小程序H5
–status-bar-height系统状态栏高度系统状态栏高度250
–window-top内容区域距离顶部的距离00NavigationBar 的高度
–window-bottom内容区域距离底部的距离00TabBar 的高度

注意：

  • 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><view><view class="status_bar"><!-- 这里是状态栏 --></view><view> 状态栏下的文字 </view></view>
</template>
<style>.status_bar {height: var(--status-bar-height);width: 100%;background: red;}
</style>

效果：
uniapp页面样式和布局和nvue教程详解

<template/> 和 <block/>

uni-app 支持在 template 模板中嵌套 <template/> 和 <block/> ，用来进行 列表渲染 和 条件渲染。
<template/> 和 <block/> 并不是一个组件，它们仅仅是一个包装元素，不会在页面中做任何渲染，只接受控制属性。
<block/> 在不同的平台表现存在一定差异，推荐统一使用 <template/> 。

<template><view><view class="box"><template v-if="test"><view>test为true,</view><view>test为true</view></template><template v-else><view>test为false,</view><view>test为false</view></template></view></view>
</template>
<script>export default {data() {return {test: false,}}}
</script><style>.box {display: flex;}
</style>

效果：
uniapp页面样式和布局和nvue教程详解

Flex 布局

为兼容多端跨平台运行，建议使用flex布局进行开发
阮一峰的flex教程：flex教程

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

flex-direction 决定主轴的方向（即项目的排列方向）
flex-wrap 默认情况下，项目都排在一条线（又称"轴线"）上。
flex-wrap属性定义，如果一条轴线排不下，如何换 行。
flex-flow是flex-direction属性和flex-wrap属性的简写形式，默认值为row nowrap。
justify-content 定义了项目在主轴上的对齐方式。
align-items 定义项目在交叉轴上如何对齐。
align-content 定义了多根轴线的对齐方式。如果项目只有一根轴线，该属性不起作用。

nvue 教程

        uni-app App 端内置了一个基于 weex 改进的原生渲染引擎，提供了原生渲染能力。在 App 端，如果使用 vue 页面，则使用 webview 渲染；如果使用 nvue 页面(native vue 的缩写)，则使用原生渲染。一个 App 中可以同时使用两种页面，比如首页使用 nvue，二级页使用 vue 页面，hello uni-app 示例就是如此。
        虽然 nvue 也可以多端编译，输出 H5 和小程序，但 nvue 的 css 写法受限，所以如果你不开发 App，那么不需要使用 nvue。
        以往的 weex ，有个很大的问题是它只是一个高性能的渲染器，没有足够的 API 能力（比如各种 push sdk 集成、蓝牙等能力调用），使得开发时非常依赖原生工程师协作，开发者本来想节约成本，结果需要前端、iOS、Android 3 拨人开发，适得其反。 nvue 解决了这个问题，让前端工程师可以直接开发完整 App，并提供丰富的插件生态和云打包。这些组合方案，帮助开发者切实的提高效率、降低成本。
        如果一个页面路由下同时有vue页面和nvue页面，即出现同名的vue和nvue文件。那么在App端，会仅使用nvue页面，同名的vue文件将不会被编译到App端。而在非App端，会优先使用vue页面。

nvue开发与vue开发的常见区别

基于原生引擎的渲染，虽然还是前端技术栈，但和web开发肯定是有区别的。

  1. nvue 页面控制显隐只可以使用 v-if 不可以使用 v-show
  2. nvue 页面只能使用 flex 布局，不支持其他布局方式。页面开发前，首先想清楚这个页面的纵向内容有什么，哪些是要滚动的，然后每个纵向内容的横轴排布有什么，按 flex 布局设计好界面。
  3. nvue 页面的布局排列方向默认为竖排（ column ），如需改变布局方向，可以在 manifest.json -> app-plus -> nvue -> flex-direction 节点下修改，仅在 uni-app 模式下生效。
  4. nvue页面编译为H5、小程序时，会做一件css默认值对齐的工作。因为weex渲染引擎只支持flex，并且默认flex方向是垂直。而H5和小程序端，使用web渲染，默认不是flex，并且设置 display:flex 后，它的flex方向默认是水平而不是垂直的。所以nvue编译为H5、小程序时，会自动把页面默认布局设为flex、方向为垂直。当然开发者手动设置后会覆盖默认设置。
  5. 文字内容，必须、只能在 <text> 组件下。不能在 <div> 、 <view> 的text区域里直接写文字。否则即使渲染了，也无法绑定js里的变量。
  6. 只有 text 标签可以设置字体大小，字体颜色。
  7. 布局不能使用百分比、没有媒体查询。
  8. nvue 切换横竖屏时可能导致样式出现问题，建议有 nvue 的页面锁定手机方向。
  9. 支持的css有限，不过并不影响布局出你需要的界面， flex 还是非常强大的。
  10. 不支持背景图。但可以使用 image 组件和层级来实现类似web中的背景效果。因为原生开发本身也没有web这种背景图概念
  11. css选择器支持的比较少，只能使用 class 选择器。
  12. nvue 的各组件在安卓端默认是透明的，如果不设置 background-color ，可能会导致出现重影的问题。
  13. class 进行绑定时只支持数组语法。
  14. Android端在一个页面内使用大量圆角边框会造成性能问题，尤其是多个角的样式还不一样的话更耗费性能。应避免这类使用。
  15. nvue页面没有 bounce 回弹效果，只有几个列表组件有 bounce 效果，包括 list 、 recycle-list 、waterfall 。
  16. 原生开发没有页面滚动的概念，页面内容高过屏幕高度并不会自动滚动，只有部分组件可滚动（ list 、waterfall 、 scroll-view/scroller ），要滚得内容需要套在可滚动组件下。这不符合前端开发的习惯，所以在 nvue 编译为 uni-app模式时，给页面外层自动套了一个 scroller ，页面内容过高会自动滚动。（组件不会套，页面有 recycle-list 时也不会套）。
  17. 在 App.vue 中定义的全局js变量不会在 nvue 页面生效。 globalData 和 vuex 是生效的。
  18. App.vue 中定义的全局css，对nvue和vue页面同时生效。如果全局css中有些css在nvue下不支持，编译时控制台会报警，建议把这些不支持的css包裹在条件编译里， APP-PLUS-NVUE
  19. 不能在 style 中引入字体文件，nvue 中字体图标的使用参考：加载自定义字体。如果是本地字体，可以用plus.io 的API转换路径。
  20. 目前不支持在 nvue 页面使用 typescript/ts 。
  21. nvue 页面关闭原生导航栏时，想要模拟状态栏，可以参考文章。但是，仍然强烈建议在nvue页面使用原生导航栏。nvue的渲染速度再快，也没有原生导航栏快。原生排版引擎解析 json 绘制原生导航栏耗时少，而解析nvue的js绘制整个页面的耗时要大的多，尤其在新页面进入动画期间，对于复杂页面，没有原生导航栏会在动画期间产生整个屏幕的白屏或闪屏。

样式

  • nvue的css仅支持flex布局，是webview的css语法的子集。这是因为操作系统原生排版不支持非flex之外的web布局。当然flex足以排布出各种页面，只是写法需要适应。
  • 在选择器方面支持的较少，只支持简单的 class="classA" 。
  • class 进行绑定时只支持数组语法。
  • 不支持媒体查询。
  • 不支持复合样式，不支持简写。
  • 不能在 style 中引入字体文件。
  • 布局不能使用百分比，如 width：100%; 。
  • 有些web的css属性在nvue里无法支持，比如背景图。但可以使用image组件和层级来实现类似web中的背景效果。因为原生开发本身也没有web这种背景图概念。
  • nvue 的各组件在安卓端默认是透明的，如果不设置 background-color ，可能会导致出现重影的问题。
  • 文字内容，必须只能在 text 组件下， text 组件不能换行写内容，否则会出现无法去除的周边空白。
  • 只有 text 标签可以设置字体大小，字体颜色。

nvue 和 vue 相互通讯

uni.$emit(eventName,OBJECT)

触发全局的自定事件。附加参数都会传给监听器回调。
eventName类型String 事件名，OBJECT Object 触发事件携带的附加参数。

代码示例

uni.$emit('update',{msg:'页面更新'})
uni.$on(eventName,callback)

监听全局的自定义事件。事件可以由 uni.$emit 触发，回调函数会接收所有传入事件触发函数的额外参数。

示例：vue对nvue的传值通讯
uniapp页面样式和布局和nvue教程详解
index.vue页面代码

<template><view><button @click="sendMessage">点击修改数据</button></view>
</template><script>export default {data() {return {message: 'Hello from nVue'};},methods: {sendMessage() {uni.navigateTo({url: '../test/test',success: () => {// 确保目标页面已经加载uni.$emit('ceshi', {title: '测试标题',content: '测试内容'});}});}}};
</script>

test.nvue页面代码

<template><view><text>Test Page</text></view>
</template><script>
export default {onLoad() {// 注册事件监听器uni.$on('ceshi', (data) => {console.log('标题：' + data.title);console.log('内容：' + data.content);});},onUnload() {// 页面卸载时移除事件监听器uni.$off('ceshi');},methods: {}
};
</script><style scoped>
/* 可以在这里添加样式 */
</style>

效果：
uniapp页面样式和布局和nvue教程详解

uni.$once(eventName,callback)

监听全局的自定义事件。事件可以由uni.$emit触发，但是只触发一次，在第一次触发之后移除监听器。

属性类型描述
eventNameString事件名
callbackFunction事件回调函数
示例代码：
onLoad() {uni.$once('update',function(data){console.log('监听到事件来自 update ，携带参数 msg 为：' + data.msg);})
}

示例：

<template><view><text>Test Page</text></view>
</template><script>export default {onLoad() {uni.$once('ceshi', function(data) {console.log('监听到事件来自 update ，携带参数 msg 为：' + data);})},onUnload() {// 页面卸载时移除事件监听器uni.$off('ceshi');},methods: {}};
</script><style scoped>/* 可以在这里添加样式 */
</style>

效果:
uniapp页面样式和布局和nvue教程详解

uni.$off([eventName, callback])

移除全局自定义事件监听器。

属性类型描述
eventNameArray[String]事件名
callbackFunction事件回调函数
示例代码
onUnload() {
// 移除 update 监听器
uni.$off('update')
}

上面中已经用到了uni.$off的使用，在每次onUnload页面卸载的时候移除事件监听。

Tips
  • 如果没有提供参数，则移除所有的事件监听器；
  • 如果只提供了事件，则移除该事件所有的监听器；
  • 如果同时提供了事件与回调，则只移除这个回调的监听器；
  • 提供的回调必须跟$on的回调为同一个才能移除这个回调的监听器；

阶段完结~


http://www.ppmy.cn/news/1549109.html

相关文章

Linux - 弯路系列4：安装Torque、PBS作业系统及遇到的问题

Linux - 弯路系列4：安装Torque、PBS作业系统及遇到的问题

系统&#xff1a;Anolis8&#xff08;离线&#xff09;&#xff0c;所有命令在root账户下进行 目录 1、安装步骤2、问题汇总&#xff08;1&#xff09;socket_connect_unix failed: 15137 / could not connect to trqauthd&#xff08;2&#xff09;cannot connect to server …
阅读更多...
2.13 转换矩阵

2.13 转换矩阵

转换矩阵引用了库nalgebra&#xff0c;使用时研究具体实现。 use std::ops;use nalgebra::Perspective3;use crate::Scalar;use super::{Aabb, LineSegment, Point, Triangle, Vector};/// An affine transform #[repr(C)] #[derive(Debug, Clone, Copy, Default)] pub struct…
阅读更多...
【Ubuntu下离线安装docker】

【Ubuntu下离线安装docker】

一、前言 国内无法安装docker&#xff0c;因为无法连接docker官网&#xff0c;所以写下此教程二、环境 1、虚拟机下的Ubuntu22.04 2、科学上网工具,用于下载docker离线包三、下载docker离线包 1、查看Ubuntu22.04环境 rootapq-virtual-machine:/home/apq# lsb_release -a No…
阅读更多...
【MyBatisPlus·最新教程】包含多个改造案例，常用注解、条件构造器、代码生成、静态工具、类型处理器、分页插件、自动填充字段

【MyBatisPlus·最新教程】包含多个改造案例，常用注解、条件构造器、代码生成、静态工具、类型处理器、分页插件、自动填充字段

文章目录 一、MyBatis-Plus简介二、快速入门1、环境准备2、将mybatis项目改造成mybatis-plus项目&#xff08;1&#xff09;引入MybatisPlus依赖&#xff0c;代替MyBatis依赖&#xff08;2&#xff09;配置Mapper包扫描路径&#xff08;3&#xff09;定义Mapper接口并继承BaseM…
阅读更多...
【01】Selenium+Python 入门案例

【01】Selenium+Python 入门案例

Selenium介绍 ‌ Selenium是一款web应用的自动化测试工具&#xff0c;主要用于UI测试&#xff1b;它支持多语言、多平台和多浏览器的测试。Selenium的核心功能是通过模拟用户在浏览器中的操作&#xff0c;如点击、输入等&#xff0c;来测试Web应用的响应。Selenium的工作原理主…
阅读更多...
Docker Registry（镜像仓库）详解

Docker Registry（镜像仓库）详解

Docker Registry&#xff08;镜像仓库&#xff09;详解 Docker Registry&#xff0c;即Docker镜像仓库&#xff0c;是Docker生态系统中一个至关重要的组件。它负责存储、管理和分发Docker镜像&#xff0c;为Docker容器提供镜像资源。本文将深入探讨Docker Registry的功能、结构…
阅读更多...
经验笔记：Git 中的远程仓库链接及上下游关系管理

经验笔记：Git 中的远程仓库链接及上下游关系管理

Git 中的远程仓库链接及上下游关系管理 1. 远程仓库的链接信息 当你克隆一个远程仓库时&#xff0c;Git 会在本地仓库中记录远程仓库的信息。这些信息包括远程仓库的 URL、默认的远程名称&#xff08;通常是 origin&#xff09;&#xff0c;以及远程仓库中的所有分支和标签。…
阅读更多...
Android 开发构建问题

Android 开发构建问题

1.Android studio gradle 同步慢 在Android Studio中打开新的项目 同步新项目可能会出现 gradle zip包下载慢的问题&#xff0c;我们可以尝试替换源 可以把 services.gradle.org/distributions 可能需要半小时以上替换为 mirrors.cloud.tencent.com/gradle/ 这样下载速度明…
阅读更多...
最新文章

Copyright @ 2022~2023