> For the complete documentation index, see [llms.txt](https://nzbin.gitbook.io/ng-matero/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nzbin.gitbook.io/ng-matero/zh-1/theming.md).

# 主题系统

Ng-Matero 的主题系统提供了两种常用布局（`侧边栏导航布局` 及 `顶部导航布局`）、菜单服务、页面标题组件（面包屑组件）、常用辅助样式类等。

> 建议在项目初始化的时候选择一个固定的布局类型，尽量不要在项目启动后通过 `options` 去设置布局，除非你有特殊的需求。

Ng-Matero 的主题样式是基于 Sass 编写，所以使用者必须了解 Sass 的基础知识。主题样式目录如下：

```
├── theme                               
│   ├── style                           
│   │   ├── core   
│   │   ├── functions   
│   │   ├── mixins
│   │   ├── widgets
│   │   ├── _colors.scss
│   │   ├── _core.scss
│   │   ├── _functions.scss
│   │   ├── _mixins.scss
│   │   ├── _variables.scss
│   │   ├── _widgets.scss
│   │   └── theming.scss
```

为了方便修改主题色系，`sidenav` 和 `topnav` 使用了 mixin。

```css
@mixin matero-admin-theme($theme) {
  @include matero-sidenav-theme($theme);
  @include matero-topnav-theme($theme);
}
```

![](/files/-LwvsvtGuCGIPiTfN4AH)