Dojo样式简介-创新互联
翻译自:https://github.com/dojo/framework/blob/master/docs/en/styling/introduction.md
成都创新互联公司坚持“要么做到,要么别承诺”的工作理念,服务领域包括:成都网站制作、成都网站设计、外贸营销网站建设、企业官网、英文网站、手机端网站、网站推广等服务,满足客户于互联网时代的汕尾网站设计、移动媒体设计的需求,帮助企业找到有效的互联网解决方案。努力成为您成熟可靠的网络建设合作伙伴!介绍
Dojo 是基于 HTML 的技术,使用 CSS 为框架中的元素和用它开发的应用程序设置样式。
Dojo 鼓励将结构样式封装在各部件中,以便大限度复用;同时将外观主题设置到应用程序所有部件上。用户为他们的应用程序设置样式和主题时,这种模式提供了固定的套路,即使混合使用 Dojo 的 @dojo/widgets
库中的部件、由第三方提供的部件或者为特定应用程序开发的内部使用的部件时也是如此。
功能 | 描述 |
---|---|
为单个部件设置样式 | CSS Modules 用于定义,在单个部件的作用域内有效的样式,避免潜在的交叉污染和样式冲突。通过类型化的 CSS 模块导入和 IDE 自动完成功能,部件可以精确的引用 CSS 类名。 |
强大的主题支持 | 可以轻松开发出支持主题的部件,这样的部件既能使用简化的、中心化的应用程序主题,也能调整或覆盖单个实例的目标样式(如果需要的话)。CLI 工具支持分发自定义主题。 |
响应式的主题变更 | 与 Dojo 应用程序中的其他响应式状态变更类似,当一个部件或者整个应用程序的主题发生变化时,只有受影响的部件才会重新渲染。 |
提取 CSS 属性 | 每个 CSS 模块可通过 CSS 自定义属性和 var() 引用集中定义的 :root 样式变量。 |
简化定义第三方部件的主题 | 应用程序可以轻松扩展主题以覆盖第三方部件,如 Dojo 内置部件库中的部件,Dojo 也提供了开箱即用的主题,应用程序可直接使用。CLI 工具极大简化了主题的创建和组合。 |
基本用法
注意: 以下示例是按顺序在前一个示例的基础上构建的。每个示例都尽量简短,只突出显示跟上一个示例相比发生变化的部分。
这些示例假定应用程序名为:
package.json
{
"name": "my-app"
}
应用程序名与部件主题的 key 有关。
为单个部件设置样式
- 为每个部件单独定义一个 CSS 模块
- 在部件的 TypeScript 代码中使用相应的类型化的样式类
src/styles/MyWidget.m.css
.root {
font-family: sans-serif;
}
src/widgets/MyWidget.tsx
import { create, tsx } from '@dojo/framework/core/vdom';
import * as css from '../styles/MyWidget.m.css';
const factory = create();
export default factory(function MyWidget() {
return My Widget;
});
让部件支持主题
- 注入
theme
中间件 - 使用
theme.classes
返回主题化的 css 类名,这样部件的默认样式就会被主题覆盖
src/widgets/MyWidget.tsx
import { create, tsx } from '@dojo/framework/core/vdom';
import theme from '@dojo/framework/core/middleware/theme';
import * as css from '../styles/MyWidget.m.css';
const factory = create({ theme });
export default factory(function MyWidget({ middleware: { theme } }) {
const { root } = theme.classes(css);
return My Widget;
});
创建主题
- 使用自定义的主题样式属性重写部件默认的 CSS 类
- 通过合适的部件主题 key 将一个或多个重写后的样式链接到主题结构中
src/themes/MyTheme/MyWidget.m.css
.root {
color: hotpink;
background-color: slategray;
}
src/themes/MyTheme/theme.ts
import * as myWidgetCss from './MyWidget.m.css';
export default {
'my-app/MyWidget': myWidgetCss
};
提取公共的主题属性
- 导入一个集中定义的常规 CSS 文件
variables.css
,其中定义了 CSS 自定义属性 - 通过
var()
引用自定义属性
src/themes/variables.css
:root {
--foreground: hotpink;
--background: slategray;
}
src/themes/MyTheme/MyWidget.m.css
@import '../variables.css';
.root {
color: var(--foreground);
background-color: var(--background);
}
指定默认的应用程序主题
theme
中间件可用于设置应用程序主题。要设置“默认的”或初始化主题,则使用 theme.set
函数,同时用 theme.get
函数确定是否需要设置主题。应该在应用程序的顶级部件中设置默认主题。
src/App.tsx
import { create, tsx } from '@dojo/framework/core/vdom';
import theme from '@dojo/framework/core/middleware/theme';
import myTheme from '../themes/MyTheme/theme';
const factory = create({ theme });
export default factory(function App({ middleware: { theme }}) {
// if the theme isn't set, set the default theme
if (!theme.get()) {
theme.set(myTheme);
}
return (
// the application's widgets
);
});
注意: 当同时使用基于函数的部件和基于类的部件时,应该使用应用程序注册器来注册主题。当使用基于类的部件时(如 @dojo/widgets
) 也是如此。详情参考[基于类部件的主题]()。
更改应用程序主题
- 使用
theme
中间件 在可用的主题间切换
src/widgets/ThemeSwitcher.tsx
import { create, tsx } from '@dojo/framework/core/vdom';
import theme from '@dojo/framework/core/middleware/theme';
import myTheme from '../themes/MyTheme/theme';
import alternativeTheme from '../themes/MyAlternativeTheme/theme';
const factory = create({ theme });
export default factory(function ThemeSwitcher({ middleware: { theme } }) {
return (
);
});
另外有需要云服务器可以了解下创新互联scvps.cn,海内外云服务器15元起步,三天无理由+7*72小时售后在线,公司持有idc许可证,提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案,具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势,专为企业上云打造定制,能够满足用户丰富、多元化的应用场景需求。
文章名称:Dojo样式简介-创新互联
链接URL:http://scyanting.com/article/cshgdo.html