电话 400-111-2626

# 自定义样式文档概述

此文档旨在针对七巧的CSS样式扩展功能做详细介绍,涵盖操作方式,使用路径等,同时汇总常用场景及其写法,为使用该功能的用户提供对应的案例,便于上手,减少开发的时间。

# 功能介绍

支持使用CSS代码,对PC运行端或者移动端的页面样式进行调整。下附CSS基础教程: https://www.w3school.com.cn/css/css_selectors.asp (opens new window)

# 功能涵盖范围

类型 入口位置 涉及范围
表单 表单设计中每个表单都可单独配置(不区分PC端和移动端入口) 该表单的字段组件全局样式
流程 流程设计中每个流程都可单独配置(不区分PC端和移动端入口) 该流程所有发起/详情页面的全局样式
应用页面 每个应用都可单独配置,分为PC端入口及移动端入口,分别在PC页面设计和移动端页面设计中 该应用的所有PC页面/移动端页面的全局样式
全局页面 整个平台的配置入口,可在基础设置-用户端样式设置中设置。分为PC端和移动端两个入口 所有PC页面/移动端页面的全局样式
外部单页面 每个外部单都可单独配置(不区分PC端和移动端入口) 该外部单整个页面的全局样式

# 表单设计

入口:表单设计>>表单属性

image.png

范围:每个表单都可设置单独的样式,所有打开该表单的页面都会生效,如:添加表单、编辑、详情、消息通知等。

针对该表单的字段组件样式生效(在:root路径下),具体范围如下图(粉色部分):

image.png

加载时机:在打开表单页面时加载

# 流程设计

入口:流程设计>>流程属性

image.png

范围:每个流程版本都可设置单独的样式,针对该版本的流程生效。包括流程发起页面、流程办理页面、流程详情页等。

(在:root路径下)页面上具体范围如下图(粉色部分):

image.png 加载时机:打开对应的流程页面时加载

# 应用页面

入口:PC页面设计/移动端页面设计(区分PC端和移动端)

说明:应用层级的CSS样式代码区分PC端和移动端

image.png

范围:每个应用都可设置单独的样式

image.png

加载时机:打开对应的应用时加载

# 全局页面

入口:管理平台>>基础设置

说明:全局层级的CSS样式代码区分PC端和移动端

image.png

范围:整个运行端都可设置单独的样式

加载时机:打开系统时加载

# 外部单页面

入口:表单设计>>表单属性>>外部表单>>页面CSS样式扩展

image.png

范围:整个外部单都可设置单独的样式

加载时机:打开外部单时加载

# 功能限制说明

# 范围说明

以上入口中写的代码,都是需要写在 :root 路径下,才会针对本范围生效。

例:在表单组件中写应用页面的CSS样式,不在:root中写,当打开表单时,会加载出对应的CSS样式,如下:

image.png

若在:root中写对应的样式,则仅针对本范围内生效,超出范围的部分不生效,效果如下:

image.png

# 代码优先级

若在多个入口同时配置了同一个类的样式,则会根据页面加载的顺序展示样式。

顺序如下:表单>流程>应用页面>全局>系统原生代码

(加载顺序:先加载系统原生代码->全局样式->应用页面->流程->表单)

因此若表单、流程、应用、全局都配置了代码,则发起流程时会显示【表单】中配置的样式

image.png

注:外部单的样式与其他入口是隔离的,即表单、流程等的CSS样式配置不会同步至外部单。

1 / 0