CSS 可见性

Quasar 提供了下述这些常用的 CSS 工具类,您可以直接在 html 模版中使用。

Class 类名描述
disabled鼠标指针设置为’disable’的样式,并且降低 DOM 的透明度。
hidden设置 displaynone将元素从页面中删除,且不会再占用空间。
invisible设置 visibilityhidden将元素从页面中隐藏,但是任然会在页面中占据空间。
transparent将背景色设置为透明
dimmed在元素上添加深色透明遮罩层。但是在已经有了 :after 伪类的元素上不会生效。
light-dimmed在元素上添加白色透明遮罩层。但是在已经有了 :after 伪类的元素上不会生效。
ellipsis在空间不足的时候使用省略号将文字截断。
ellipsis-2-lines将超出 2 行的文字使用省略号截断。(只会在 Webkit 内核的浏览器中生效)。
ellipsis-3-lines将超出 3 行的文字使用省略号截断。(只会在 Webkit 内核的浏览器中生效)。
z-top将元素的z-index层级设置调高,使得它可以遮挡住其他的元素,但不会遮挡住 Popovers, Tooltips, Notifications。
z-max将元素的z-index层级置为页面最顶层,会挡住所有的其他的元素,包括 Drawer, Modals, Notifications, Layout header/footer, …。

屏幕断点相关(响应式)

我们先来看看,所有的屏幕尺寸断点定义:

Window 大小断点名称断点的像素大小
极小xs599px 以下 (一般是手机的屏幕)
sm600px 到 1023px (这个尺寸可能有手机和平板)
中等md1024px 到 1439px (这个尺寸可能有平板和电脑)
lg1440px 到 1919px (一般的电脑屏幕)
超大xl1920px 以上 (超大屏幕设备)

然后来看看跟断点相关的 css 类

CSS 类名描述
xs只会在极小尺寸的屏幕上展示
sm只会在小尺寸的屏幕上展示
md只会在中等尺寸的屏幕上展示
lg只会在大尺寸的屏幕上展示
xl只会在超大尺寸的屏幕上展示

也可指定在小于/大于某断点尺寸的屏幕上展示 DOM 元素或者组件,只需要使用lt-gt- 前缀。lt 表示小于是 lower than 的缩写,gt 表示大于是 greater than 的缩写。例如: lt-md,表示在只在小于 md(即 xs 和 sm)尺寸的屏幕上展示,lt-xl 表示在小于 xl 尺寸的屏幕上展示(即 xs, sm, md 和 lg),gt-md表示在大于 md 尺寸的屏幕上展示(即 lg 和 xl)。

TIP

您可以将上述可见性 css 类与inline结合起来使用将元素变成 inline-blocks 示例: <span class="gt-sm inline">...</span>

TIP

如果您想用 JavaScript 来控制元素的响应式显示和隐藏,您可以使用Screen Plugin.

平台相关

只在特定的平台上展示:

CSS 类名描述
desktop-only只在电脑上显示 Visible only on desktop
mobile-only只在手机上显示 Visible only on mobile
native-mobile-only只在 Cordova/Capacitor 平台下显示 Visible only on Cordova/Capacitor
cordova-only只在 Cordova 平台下显示 Visible only on Cordova wrapped Apps
capacitor-only只在 Capacitor 平台下显示 Visible only on Capacitor wrapped Apps
electron-only只在 Electron 平台下显示 Visible only on Electron wrapped Apps
touch-only只在 可触摸的平台下显示 Visible only on touch capable platforms
platform-ios-only只在 IOS 平台下显示 Visible only on an iOS platform
platform-android-only只在 Android 平台下显示 Visible only on an Android platform
within-iframe-only只在 iframe 标签中 显示 Visible only when entire website is under an IFRAME tag

Hide on:

CSS 类名描述
desktop-hide在电脑上隐藏 Hide on desktop
mobile-hide在手机上隐藏 Hide on mobile
native-mobile-hide在 Cordova/Capacitor 上隐藏 Hide on Cordova/Capacitor
cordova-hide在 Cordova 上隐藏 Hide on Cordova wrapped Apps
capacitor-hide在 Capacitor 上隐藏 Hide on Capacitor wrapped Apps
electron-hide在 Electron 上隐藏 Hide on Electron wrapped Apps
touch-hide在可触摸的屏幕上隐藏 Hide on touch capable platforms
platform-ios-hide在 iOS 上隐藏 Hide on iOS platform
platform-android-hide在 Android 上隐藏 Hide on Android platform
within-iframe-hide在 iframe 标签中隐藏 Hide only when entire website is under an IFRAME tag

TIP

如何使用 Javascript 来实现上述效果请看Platform Detection页面。这种方法更加高效,甚至不会渲染额外的 dom,在渲染过程很昂贵的时候很有用。

横屏竖屏相关

CSS 类名描述
orientation-portrait当竖屏时显示 Portrait
orientation-landscape当横屏时显示 Landscape

打印相关

CSS 类名描述
print-only只在打印时显示
print-hide在打印时隐藏