B/S端界面控件DevExtreme中文使用指南——如何自定义图标
DevExtreme拥有高性能的HTML5 / JavaScript小部件集合,使您可以利用现代Web开发堆栈(包括React,Angular,ASP.NET Core,jQuery,Knockout等)构建交互式的Web应用程序,该套件附带功能齐全的数据网格、交互式图表小部件、数据编辑器等。
在本文中,我们将为大家介绍如何使用DevExtreme组件来自定义图标,欢迎下载最新版组件体验!
DevExtreme v22.2正式版下载(q技术交流:600715373)DevExtreme v22.2正式版下载
自定义图标
由于DevExtreme图标是作为图标字体发布的,因此可以使用与自定义文本内容相同的CSS属性对它们进行自定义:颜色、字体大小、字体粗细、文本对其等,这对于UI组件中使用的图标是正确的...
jQuery
HTML
<div id="saveButton"></div>
JavaSciprt
$(function() {
$("#saveButton").dxButton({
icon: "save",
text: "Save"
});
});
CSS
#saveButton .dx-icon {
font-size: 24px;
color: blue;
}
ASP.NET MVC Controls
... 以及用于任何其他HTML元素的图标:
HTML
<i class="dx-icon-email dx-icon-custom-style"></i>
CSS
.dx-icon-custom-style {
font-size: 24px;
color: blue;
}
dx-icon是一个CSS类,当DevExtreme UI组件将图标元素呈现到DOM中时添加到图标元素中。开发人员不能用另一个名字来称呼它,然而对于其他HTML元素中的图标则不是这样的,在本例中,可以为类使用任何名称,如前一个示例所示。
自定义图像作为图标
UI组件的icon属性接受URL,因此开发人员可以将图像的URL分配给它,但是最好用Base64类型来编码图像,以减少传输的数据量,可以在网上搜索一个图像到Base64的转换器。
虽然Base64代码可以直接分配给icon属性,但我们建议将它放在CSS中,因为它的长度。将以下CSS规则添加到样式表中:
CSS
.dx-icon-customicon { // in Angular apps, add ::ng-deep before
background-image: url(data:image/png;base64,... LONG BASE64 CODE IS HERE ...);
background-repeat: no-repeat;
background-position: 0px 0px;
}
customicon这里是图标的名称,应该分配给UI组件的icon属性。
此外,开发人员还可以为UI组件元素的不同状态提供特定的图标变体,在下面的代码中,为选定的选项卡提供了一个特殊的图标:
CSS
.dx-tab-selected .dx-icon-customicon {
background-image: url(data:image/png;base64,... LONG BASE64 CODE GOES HERE ...);
background-repeat: no-repeat;
background-position: 0px 0px;
}
从前面的示例中选择的类(如dx-tab-selected)没有记录,检查CSS规则,找出哪些类被添加到正在定制的UI组件元素中。
外部图标库
UI组件中的图标作为<i>元素插入到DOM中,当开发人员设置一个UI组件的icon属性时,它的值被用来形成<i>元素的class属性,例如,下面的代码…
icon: "home"
... 渲染到DOM,如下所示:
HTML
<i class="dx-icon dx-icon-home"></i>
这允许DevExtreme UI组件支持来自外部图标库的图标,前提是它们也应该在class属性中指定。
Font Awesome、Glyphicons和Ionicons就是这样的库的例子,按照你想要使用的库的安装教程,按如下方式设置图标属性:
jQuery
JavaScript
$(function() {
$("#homeButton").dxButton({
icon: "fas fa-home" // Font Awesome 5
icon: "fa fa-home" // Font Awesome 4
icon: "glyphicon glyphicon-home" // Glyphicons
icon: "icon ion-md-home" // Ionicons
});
});
ASP.NET MVC Controls
Razor C#
@(Html.DevExtreme().Button()
.Icon("fas fa-home") // Font Awesome 5
.Icon("fa fa-home") // Font Awesome 4
.Icon("glyphicon glyphicon-home") // Glyphicons
.Icon("icon ion-md-home") // Ionicons
)
SVG图标
除了字体图标外,DevExtreme还以SVG格式提供了相同的图标,开发人员可以再GitHub上的DevExtreme存储库中找到SVG图标。
下面的代码使用了Button UI组件中的SVG图标,同样的技术可以用于任何其他具有icon属性的UI组件。
1. 使用图标的URL:
JavaScript
new DevExpress.ui.dxButton(targetElement, {
icon: "https://path/to/the/icon.svg"
});
2. 插入SVG内容inline:
JavaScript
new DevExpress.ui.dxButton(targetElement, {
icon: "<svg>SVG_CONTENT</svg>"
});
3. 导入图标:
JavaScript
import * as myIcon from "./assets/icon.svg";
new DevExpress.ui.dxButton(targetElement, {
icon: myIcon
});
重要提示:SVG格式允许运行可能是恶意的可执行代码,我们强烈建议您只使用可信来源的SVG图标。