Vaadin学习笔记——自定义vaadin组件的样式

简介:
在开始阅读本文之前,你需要先了解以下内容:
  • CSS相关知识(如选择器、如何编写CSS rule等)

  • HTML相关知识(元素、class属性、DOM层级结构等)

  • Vaadin相关知识(如怎样创建、运行Vaadin项目,怎样创建一个vaadin页面)

前言

习惯了SSH的小伙伴们遇到vaadin这样的技术时,肯定会一脸懵逼。我当初看到这个东西时眼前飘过的绝对不是6666666666,而是一大堆????????????。

有人说Vaadin就像swing,果真如此吗?No!形似而已。真要上手去用去写,你就会发现——这TM就是一坨屎。

好啦,不抱怨了。由于公司大部分产品都是基于Vaadin创建的,为了提高代码质量,再屎的东西也要硬着头皮去学。

在学习Vaadin的时候,有一个坎,那就是theming。Vaadin真不像Swing,再怎么说swing的LAF还没有跳脱Java的范畴,可以说他们还是在同一个体系中的。而Vaadin的style(或者说theming)则与你写的Java代码没有关系,哦,这样说并不确切。确切的说,绝大多数灵活的theming工作都要用到CSS(SCSS)。在Java代码中仅能对一些组件做最基础的尺寸等样式调整,至于什么margin、space、padding啥的,不能做(space仅有一个开关,代表“有space”和“没有space”)。如果你想对vaadin的组件进行更大尺度的样式化,请使用SCSS。

调整样式的大致步骤

1、用java语言编写页面,添加页面元素。

2、给页面元素指定一个特定的class name。

3、在SCSS中针对特定的class name编写样式规则。

4、编译,试运行,看结果。


实例:样式化一个Label组件

接下来我就以Label组件为例,详细讲述如何为vaadin组件修改样式。在例子中,我将创建一个Label用来显示某人的姓名和年龄。然后针对姓名和年龄两个部分分别样式化。如果创建Label部分不熟悉,你可以参考我的另一篇文章《Vaadin组件笔记——Label》。另:如何创建Vaadin项目,怎样编译运行,不在本文范畴之内,你可以参考其他相关资料。

第一步:用java语言编写页面,添加一个Label组件。

组件的Caption中填写“Mr. Wangbagaozi”,value中填写“1000 year-old”。

List-1

1
2
3
Label label =  new  Label();
label.setCaption( "Mr. Wangbagaozi" );
label.setValue( "1000 year-old" );

先让我们运行一下,看看界面上的效果。

wKioL1h022CTZS41AAAL3rNpZRQ373.png

这是Vaadin根据我们的Java代码自动生成的前端代码:

List-2

1
2
3
4
5
6
< div  class = "v-widget v-has-caption v-caption-on-top v-has-width"  style = "width: 100%;" >
     < div  class = "v-caption"  id = "gwt-uid-2"  for = "gwt-uid-3" >
         < span  class = "v-captiontext" >Mr. Wangbagaozi</ span >
     </ div >
     < div  class = "v-label v-widget v-has-width"  id = "gwt-uid-3"  aria-labelledby = "gwt-uid-2"  style = "width: 100%;" >1000 year-old</ div >
</ div >

第二步:给页面元素指定一个特定的class name。

现在,我希望caption中的内容字号24px并且加粗,value中的内容字号16px,灰色,斜体。之前说过,vaadin的组件样式是通过CSS来调整的,那么,作为CSS编写规则的最重要的选择器就那么几种,class、id、element name等。vaadin推荐使用class name。Okay,我们看一下生成的前端HTML代码,就清楚该怎样编写我们的CSS规则了。注:在CSS和SCSS中,有些需求可以使用多种方式来实现,本文介绍其中一种方式。方式无好坏,你觉得好用就好。

通过分析,我们看到,带有Caption的label被解析成了一个div包裹着两个同级div。提炼一下:

List-3

1
2
3
4
5
6
< div  class = "v-widget v-has-caption v-caption-on-top v-has-width" >
     < div  class = "v-caption" >
         < span  class = "v-captiontext" >Mr. Wangbagaozi</ span <!--这里是caption-->
     </ div >
     < div  class = "v-label v-widget v-has-width" >1000 year-old</ div <!--这里是value-->
</ div >

我们尝试写一下SCSS(vaadin中使用SCSS,你需要先编写SCSS,编译时vaadin会自动将SCSS编译为CSS)。

List-4

1
2
3
4
5
6
7
8
9
.v-captiontext {
     font-size 24px ;
     font-weight bold ;
}
.v-label {
     font-size 16px ;
     color gray ;
     font-style italic ;
}

运行一下看看结果:

wKioL1h0466z112HAAARCWLZrO0705.png

第三步:在SCSS中针对特定的class name编写样式规则。

样式改变了,貌似这样就可以了?等等!这样写有问题,让我再增加一个label组件到页面上,你们就知道问题在哪儿了。下面我增加一个label,用来显示这位Wangbagaozi先生的地址还有电话号码。

List-5

1
2
3
Label label2 =  new  Label();
label2.setCaption( "South China sea." );
label2.setValue( "13399988888." );

运行一下看看结果:

wKiom1h05PGBIQO2AAAe1YdoQZY392.png

Whaaat!! 这是什么鬼东西?没错,被放入label2的caption的内容也随之改变,而这并不是我们想要的结果。我们希望label2的caption和value都按照普通方式显示,不要加样式。

我们来看一下vaadin帮我们自动生成的前端代码,找一下有什么办法将两个Label进行区分。

List-6

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
< div  class = "v-slot" >
     <!--下面是label生成的代码-->
     < div  class = "v-widget v-has-caption v-caption-on-top v-has-width"  style = "width: 100%;" >
         < div  class = "v-caption"  id = "gwt-uid-2"  for = "gwt-uid-3" >
             < span  class = "v-captiontext" >Mr. Wangbagaozi</ span >
         </ div >
         < div  class = "v-label v-widget v-has-width"  id = "gwt-uid-3"  aria-labelledby = "gwt-uid-2"  style = "width: 100%;" >1000 year-old</ div >
     </ div >
</ div >
< div  class = "v-slot" >
     <!--下面是label2生成的代码-->
     < div  class = "v-widget v-has-caption v-caption-on-top v-has-width"  style = "width: 100%;" >
         < div  class = "v-caption"  id = "gwt-uid-4"  for = "gwt-uid-5" >
             < span  class = "v-captiontext" >South China sea.</ span >
         </ div >
         < div  class = "v-label v-widget v-has-width"  id = "gwt-uid-5"  aria-labelledby = "gwt-uid-4"  style = "width: 100%;" >13399988888.</ div >
     </ div >
</ div >

呃……label和label2生成的前端代码中用于区别的class name一模一样,除了进行恶心的相对定位选择就没有别的办法了吗?当然不是,Vaadin不会这么蠢!既然无法利用自动生成的class name,我们还可以利用我们自定义的class name来对这两个label进行区别。我们只需要针对第一个label进行样式化,其他的不用加载样式。Okay,稍加修改List-1的代码:

List-7

1
2
3
4
Label label =  new  Label();
label.setCaption( "Mr. Wangbagaozi" );
label.setValue( "1000 year-old" );
label.addStyleName( "special-label" );  <--- Look here!

方法addStyleName其实就是给指定的组件添加一个class name。现在让我们再看一下vaadin生成的前端代码有什么变化。

List-8

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
< div  class = "v-slot v-slot-special-label" >
     <!--下面是为label生成的代码-->
     < div  class = "v-widget v-has-caption v-caption-on-top v-has-width"  style = "width: 100%;" >
         < div  class = "v-caption v-caption-special-label"  id = "gwt-uid-2"  for = "gwt-uid-3" >
             < span  class = "v-captiontext" >Mr. Wangbagaozi</ span >
         </ div >
         < div  class = "v-label v-widget special-label v-label-special-label v-has-width"  id = "gwt-uid-3"  aria-labelledby = "gwt-uid-2"  style = "width: 100%;" >1000 year-old</ div >
     </ div >
</ div >
< div  class = "v-slot" >
     <!--下面是为label2生成的代码-->
     < div  class = "v-widget v-has-caption v-caption-on-top v-has-width"  style = "width: 100%;" >
         < div  class = "v-caption"  id = "gwt-uid-4"  for = "gwt-uid-5" >
             < span  class = "v-captiontext" >South China sea.</ span >
         </ div >
         < div  class = "v-label v-widget v-has-width"  id = "gwt-uid-5"  aria-labelledby = "gwt-uid-4"  style = "width: 100%;" >13399988888.</ div >
     </ div >
</ div >

注意看List-8中的代码,相比较没有用addStyleName方法添加额外class name的label2生成的代码List-6,第4行的div元素class属性中多了“v-caption-special-label”,还有第7行的div元素中多了“special-label”和"v-label-special-label"。

有了这些不同,我们就好区别对待了。修改SCSS如下:

List-9

1
2
3
4
5
6
7
8
9
.v-caption-special-label .v-captiontext {
     font-size 24px ;
     font-weight bold ;
}
.v-label-special-label {
     font-size 16px ;
     color gray ;
     font-style italic ;
}

运行看看效果:

wKioL1h08s2iSFCTAAAbk96AwQE039.png

Bingo!就是我想要的效果。



本文转自 rickqin 51CTO博客,原文链接:http://blog.51cto.com/rickqin/1890908

相关文章
|
1天前
|
前端开发 JavaScript CDN
前端react 18.2整合ckeditor富文本编辑器——配置插件、自定义toolbar工具栏(一)
前端react 18.2整合ckeditor富文本编辑器——配置插件、自定义toolbar工具栏
11 0
|
1天前
|
前端开发 数据可视化 API
前端react 18.2整合ckeditor富文本编辑器——配置插件、自定义toolbar工具栏(二)
前端react 18.2整合ckeditor富文本编辑器——配置插件、自定义toolbar工具栏
10 0
前端react 18.2整合ckeditor富文本编辑器——配置插件、自定义toolbar工具栏(二)
|
1月前
|
JavaScript 前端开发
【vue2中引入阿里第三方图标库使用自定义的Ant Design Vue组件a-cascader级联选择后缀图标】
【vue2中引入阿里第三方图标库使用自定义的Ant Design Vue组件a-cascader级联选择后缀图标】
37 0
|
8月前
|
前端开发
ant design封装一个弹框组件
ant design封装一个弹框组件
73 0
|
3月前
|
小程序 API 索引
uniapp中uview组件库的DatetimePicker 选择器的用法
uniapp中uview组件库的DatetimePicker 选择器的用法
301 0
|
8月前
|
JavaScript
fastadmin框架中如何添加一个自定义按钮
使用fastadmin框架添加一个按钮并给按钮绑定相应的事件指向控制器中的方法,在fastadmin框架的二次开发中非常的常见,接下来本篇就来介绍一下创建按钮的具体流程。
640 0
|
8月前
|
索引
Ant Design:表格自定义渲染
Ant Design:表格自定义渲染
|
前端开发
前端项目实战183-ant design Cascader实现自定义字段
前端项目实战183-ant design Cascader实现自定义字段
64 0
|
前端开发
前端项目实战182-ant design Cascader实现自定义字段
前端项目实战182-ant design Cascader实现自定义字段
103 0
|
前端开发
前端项目实战170-ant design Popover扩展多余属性
前端项目实战170-ant design Popover扩展多余属性
81 0