# 内置样式
# 说明
zxUI组件功能的实现,并不依赖全局样式,内置的一些类名,只是提供一些基础且常用的样式,仅此而已。
注意:请根据快速上手中的说明,引入zxUI提供的scss文件。
温馨提示
由于zxUI的内置样式均是写在scss文件中的,您在使用的时候,请确保要给页面的style
标签加上lang="scss"
属性,否则可能会报错。
# 文字省略
zx-line-1
,zx-line-2
,zx-line-3
,zx-line-4
,zx-line-5
五个类名在文字超出内容盒子时,分别只显示一行、两行、三行、四行、五行+省略号。
<text class="zx-line-1">是日也,天朗气清,惠风和畅,仰观宇宙之大,俯察品类之盛</text>
# 重置按钮样式
我们知道,uni-app和微信小程序的button
按钮是自带样式的,比如边框,内边距,行高等。在某些特殊场景,我们可能会需要清除这些样式,仅仅只留下按钮文本,就像
单纯的view
元素一样,不带预置样式,场景:
在微信小程序中,我们知道button
设置open-type
参数为getUserInfo
(或者分享场景),点击按钮可以弹出让用户授权的系统弹窗,有时候我们可能需要按钮形式展现,但也有时候我们仅仅需要
"点击登录/授权/分享"几个字,同时具备获取相应的功能,就需要清除按钮的样式了,只需要给button
加上zx-reset-button
类名即可。
<button class="zx-reset-button">点击登录</button>
提示:
- 此种场景,不建议使用zxUI的
zx-button
组件,使用原生的button
即可 - 有时候,我们可能弹出询问用户是否想授权,可以用
zx-modal
组件,此组件有一个confirm-button
的slot
用于替换确定
按钮,用户点击确定,即可授权。
/* 请在微信开发工具中运行此代码 */
<template>
<view>
<zx-modal v-model="show" content="点击确定进行授权">
<button open-type="getUserInfo" class="zx-reset-button" slot="confirm-button" @getuserinfo="getuserinfo">确定</button>
</zx-modal>
<zx-button @click="show = true">打开modal</zx-button>
</view>
</template>
<script>
export default {
data() {
return {
show: true
}
},
methods: {
getuserinfo(res) {
console.log(res);
}
}
}
</script>
# 边框
uni-app,iOS和少数设备使用1rpx
是能够得到类似0.5px
的半像素宽度的,但是某些情况下是不兼容的,
故zxUI提供了一套兼容的css类名,方便用户使用。
zx-border
表示给元素添加四周的边框,zx-border-top
为上边框,zx-border-right
为右边框,
zx-border-bottom
为下边框,zx-border-left
为左边框。
说明:如果想调整边框与内容的距离,修改元素的内边距即可。
<view class="zx-border-bottom">
夫人之相与,俯仰一世,或取诸怀抱,悟言一室之内;或因寄所托,放浪形骸之外
</view>
# 文字颜色
zxUI提供了四个关于文字的颜色,具体详见文档的Color 色彩部分,分别是:
main-color
主要颜色,可以用于标题等需要重颜色的场景content-color
内容颜色,可以用于一般性内容的场景tips-color
提示颜色,可以用于浅颜色的提示语的场景light-color
为比tips-color
更浅的颜色,可以和tips-color
搭配使用
举个例子:
我们平时看到的APP的新闻列表,标题颜色可以用$zx-main-color
,简介部分颜色可以用$zx-content-color
,底部的发布时间文字等可以用$zx-tips-color
。
zxUI提供了四个关于文字颜色的scss变量名,具体详见文档的Color 色彩部分,分别是:
$zx-main-color
$zx-content-color
$zx-tips-color
$zx-light-color
<!-- 请确保在style标签声明了"lang="scss"" -->
<style lang="scss" scoped>
.box {
color: $zx-main-color;
}
.count {
border-color: $zx-light-color;
}
</style>
# 主题色
zxUI提供五个关于主题的scss颜色变量,如有需要,可合理使用。具体详见文档的Color 色彩部分,分别是:
$zx-primary
为蓝色,zxUI的主色彩,代表热情,友好,积极,向上之意。$zx-warning
为黄色,代表警告之意。$zx-success
为绿色,代表成功之意。$zx-error
为红色,代表错误之意。$zx-info
为灰色,代表一般信息之意。
<style lang="scss" scoped>
.item {
color: $zx-primary;
}
</style>