…`包装器在任何以直接儿童为对象的香草集装箱内是必要的,例如: `.row`, (中文(简体) ), `.p-form--inline`, (中文(简体) ), `.p-equal-height-row`, (中文(简体) ), `.p-divider` 或者说 `.p-navigation__dropdown`,因为 `.ds` 放置在那里的根会失去其网格设置.
3. 交换内出部分:先是控制,再分组,再是容器,再是页壳. 改变一个容器,一旦没有香草留在里面, 并给一个区域 `ds` 一旦它清除出香草.
**根要素**
4. 从第一天开始,写 `` 在一个地点,或 `app comfortable light` 在应用程序中:一个上下文、一个密度和 `light`。没有迹象表明该页面是混合的,因为不需要。 普拉格玛的地盘是携带着 `ds`,以及 `elements.css` 将Pragma的元素风格局限于它们本身. 别放 `ds` 打开 `` 而香草在页面中, 因为这使得整个文件 是一个普拉克马岛和边界 然后恢复其中的每个香草规则.
5. 从一个框架到另一个框架没有任何翻转。 平板页和混合页带有相同的根类,只有样式表不同. 一个 pragma 页面加载 `@canonical/styles`,其元素层样式为整个文档。 混合页面加载此软件包。 香草去之前的最后一座州只是一页,里面没有香草课.
**光和暗模式**
6. 虽然两个框架都在页面上,但"香草"模式类决定了光或暗,其他都无所作为. 暗页是 ``,一个黑暗的部分是 `.p-strip--dark` 或者说 `.p-strip.is-dark`里面的一座浅岛是 `.is-light` 或者说 `.is-paper`。其中的Pragma组件通过桥继承了正确的模式,而你没有为它加分.
7. A 类 `.dark` 或者说 `.light` 在香草页内的平板根上进行分类没有效果,因为桥会赢得长久 `adapter.css` 已装入。 如果一个区域周围没有香草模式类,需要自己的模式,请声明 `color-scheme` 从你的 `app` 它坐落在包括桥在内的每层平面上.
8. 操作系统的暗模式在两个框架都在上面时没有到达页面. 此软件包一去不复返, 便会决定模式: 保存 `light` 或者说 `dark` 打开 `` 作为切换,或去掉接上系统的接针.
9. 离开 `color-scheme` 到桥上。 无阶地 `:root` 规则设置它比 每一个模式类和每一层.
**{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}什么是达不到的**
10. 这种安排不需要四样东西,每样东西都显示有别的东西是错误的. 一个 `!important` 以赢得一个争论,从而将决定从层取出。 这个软件包写了四个, 在一个叫做 `vanilla.escapes`,它们是显示规则的例外。 它们共同构成"第二个边界": 香草船有五条重要规则可以到达一岛内,而一个重要的宣言只能由从下层的另一条规则来回答,因此它们坐落在香草下方而不是上方. 每个名称都是单一财产,而不是 `all`,每个火只下放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出放出 手写对了香草, 当边界已经这样做了, 真正的问题在领土上。 包子或者让香草回到里面的小岛 `.ds`。一个建构步骤或一个变换使两个框架合用,这通常意味着有些东西在边界的错误一面.
**可渗透组件**
11. `ds-permeable` 只要缩小一个领土, 永远不扩大一个领土。 它阻止根的领地到达它的子孙;它不让香草进入 `.ds` 而且它也不能免除一个被窝住的平板块 成为其中之一。 用布局来安排香草内容, 而不是用孩子本该是花花公子的.
## 设计说明
地层,边界,模式桥和封闭的复制工作, 以及为什么选择者被写的方式 [设计](https://npmcn.com/package/%40canonical/styles-vanilla-adapter/DESIGN.md)。 。 。 .
## 浏览器支持
| 特性 | 它的束缚 | 颜色 | 萨法里 | 火花 | 用户 |
| --- | --- | --- | --- | --- | --- |
| `@layer` | 装入此软件包的每一页: 命令语句 | 99 (韩语) | 15.4 国家 | 97 (英语) | 96.6% |
| `revert` | 每个混合页:边界 | 84 (中文(简体) ) | 9.1 国家 | 67国道 | 97.0% |
| `:where()`, (中文(简体) ), `:is()` | 每个混合页:边界和桥 | 88国道 | 页:1 | 78国 | 97.3% 妇女 |
| `@scope` | 仅包含混合页 : `elements.css` | 118 (韩语) | 17.4 联合国 | 146 (中文(简体) ) | 88.6% |
最后一栏是支持该功能的履带全球浏览器使用份额,从2026年9月的Caniuse-lite 1.0.30001780. 运行 `bunx browserslist --coverage "supports css-cascade-scope"` 自己去检查他们中的任何一个.
下方的浏览器 `@scope` 地板将每个被限制的块整体降下,因此在边界仍然被保持的情况下,pragma的组件会用浏览器本身的默认来渲染出三个元素层. 仅限普拉克玛的页面不受影响,因为 `@canonical/styles` 写入否 `@scope`普拉格玛自己的楼层 `light-dark()`, (中文(简体) ), `mod()` 编辑 `cap` 单位,该软件包的README中记录并适用于两种页面.
## 食谱
### 一个萨斯站点
`static/sass/styles.scss`数字 :
```scss
/* 1. The order contract, inlined in place. Needs `node_modules` on the Sass
load path; see step 3. */
@use "@canonical/styles-vanilla-adapter/src/layers";
/* 2. Vanilla and everything built on it: one layer, one territory.
global-settings sets $font-base-family and $font-monospace to
pragma's stacks, and fonts declares the two faces (step 6). */
@import "global-settings";
@layer vanilla {
@import "vanilla-framework"; /* inside the block: Vanilla emits a rule at import time */
@import "cookie-policy"; /* inlined third-party CSS moves inside the layer */
@include vanilla;
@import "fonts"; /* the two @font-face rules from step 6 */
@include site-patterns; /* local patterns, as today */
/* … overrides, as today … */
}
```
`pragma.css`,第二个条目由您现有的导入解析器解决,并且从未清除:
```css
@import url("@canonical/styles-vanilla-adapter/adapter.css");
@import url("@canonical/react-ds-global-form/dist/esm/index.css");
```
写入 `` 和链接 `styles.css` 在此之前 `pragma.css`。 。 。 .
### 用捆绑器构建的应用程序
```css
@import url("@canonical/styles-vanilla-adapter/layers.css");
@import url("./fonts.css"); /* the two @font-face rules from step 6 */
@import url("./vanilla.css") layer(vanilla); /* Vanilla compiled to a file */
@import url("@canonical/styles-vanilla-adapter/adapter.css");
@import url("@canonical/react-ds-global-form/dist/esm/index.css");
@layer app { /* your pragma-era CSS */ }
```
写入 ``。 。 。 .
Bundlers 发射 CSS 按其模块图到达的顺序,而不是按您条目列出事物的顺序,所以在任何组件软件包之前,确保设计系统的 CSS 到达. 较早导入的组件模块可以将其软件包的样式表拖到命令语句之前.
### 没有构建步骤的页面
```html
```
香草的家族变量被编成 `vendor/vanilla.css` 已经,所以用 pragma 的堆栈建立文件,或者将两个家庭重复到 `style.css`。 。 。 .
## 保证
每行命名检查它的固定线, 在 `tests/`。将被限制的拷贝与 pragma 的样式表进行比较的版本,没有浏览器;其余的则渲染出两页并比较浏览器的计算结果,因此两个页面上的错误值会失败而不是通过.
- 封闭的复制件是 pragma 的元素层,规则规则和声明,在选择器映射到 [设计](https://npmcn.com/package/%40canonical/styles-vanilla-adapter/DESIGN.md). 两个规则和一个声明只在副本中存在,每个规则和声明在测试中分别命名其理由. (`tests/elements.test.ts`(中文(简体) )
- 没有香草规则在普拉克马的领地内 刻出一个元素 用于任何声明 `!important`。每个这样的属性要么是浏览器的默认值,要么是普拉克玛的(pragma`tests/territory.test.ts`超过完整的财产清单; `tests/vanilla-territory.test.ts` 明确检查 `--vf-color-text-default`,根线高和 `box-sizing`(中文(简体) )
- 5个香草 `!important` 可以在岛屿内达到的规则以实物形式得到回答,从香草下方的一层得到回答`tests/boundary.test.ts`(中文(简体) )
- 一种本身是岛屿根的元素,其风格仿佛只在一页上,无论它是什么元素。 (`tests/boundary.test.ts`,超过31个)
- 香草祖先不会将所继承的地产推入一个岛屿,但下文所述的一个故意例外`tests/boundary.test.ts`(中文(简体) )
- 凡尼拉页面中的普拉克玛元素会计算出与只用普拉克玛页面上的相同样式,每个属性的普拉克玛声明或离开浏览器. (Pracma)`tests/territory.test.ts`(中文(简体) )
- 香草不样式 `.ds` 根本身。 (`tests/territory.test.ts` 放在香草容器内, `tests/vanilla-territory.test.ts` 用于全长比较)
- 香草黑片内的平板根计算 `color-scheme: dark`,其标志驱动的颜色与普拉克玛的暗页相匹配. 在灯光或纸张区段内,它计算出光。 (`tests/theme.test.ts`,涵盖四个主题案例 `.is-paper`(中文(简体) )
- 安装此套件不会改变香草的地盘, 但以下一个例外: 外的每个元素 `.ds`,包括: `html` 财务报告和审定财务报表 `body`,匹配只使用香草的页面。 ()`tests/vanilla-territory.test.ts`,在1280和1700像素时)
- 何处 `adapter.css` 坐在你的垃圾箱里没关系 何处 `layers.css` 坐着吧`tests/order.test.ts`,则阴性病例在 `tests/boundary.test.ts`(中文(简体) )
- 删除后,页面会变成一页一页,每个根都跟着一页一页 `light` 财务报告和审定财务报表 `dark` 分类。 (`tests/theme.test.ts`(中文(简体) )
## 这个包没有修正
每一个都是在真实的一页上可以遇到的区别,或者可以走入的危险. 之所以列入清单,是因为它们是上来的,而不是因为它们很少跳过。 凡有为一而有为一而有为说.
**命令声明必须先进行,如果不是,没有什么会警告你的.** 一个级联层在浏览器第一次看到其名称时的顺序中取而代之,而后一个语句可以添加名称,但从不移动名称. 所以如果有任何样式表提到 `ds` 层到达浏览器前 `layers.css` ——一个组件包,或pragma自己的一个条目——然后 `ds` 放在顺序的下方,下面 `boundary`,而边界 `all: revert` 跑过普拉克马自己的规则 而不是香草。 每一个平面元件都变成赤色的标记 没有控制台警告,也没有局部的失败;这是全部或完全没有的。 有第二条路可以进去,有同样的原因 级联层的子层在它内部排序,而子层的位置在它的名字第一次出现时也是固定的. 因此样式表可以打开 NAMED 子层 `vanilla` 在宣读声明之前—— `@layer vanilla.mine { … }` - 将那个下层放在这个包的前面 `!important` 在它内部声明,然后跳过第二个边界。 测量:一个岛上的一张名单 拿走了香草 `max-width: 640px` 而不是浏览器 `none`。将同一规则直接写入 `@layer vanilla { … }`,这是安装步骤2所要求的,在任一顺序上都是安全的.
安装步骤3是整个防御, `adapter.css` 导入语句本身,以便单导入路径不会出错,步骤7就是您如何检查。 测量 `tests/boundary.test.ts`两种方式.
**7个普拉克马类名称不是前缀,它们匹配主机标记.** `tokens.css` 财务报告和审定财务报表 `layout.css` 是Pragma自己的条目,这个软件包装满了它们的全部,所以他们的规则适用于页面上的任何元素,不仅适用于一个岛屿内部. 他们的名字是 `grid`, (中文(简体) ), `subgrid`, (中文(简体) ), `responsive`, (中文(简体) ), `intrinsic` 财务报告和审定财务报表 `content-flow` 从布局预设,以及 `light` 财务报告和审定财务报表 `dark` 从主题修改符。 他们坐在那里 `ds.components.global` 财务报告和审定财务报表 `ds.modifiers`,以上两者 `vanilla`,所以当一个主机元素已经携带了其中一个名字时,pragma获胜. `grid` 这是值得检查的。 重新命名你的电话 丢弃条目不是此软件包提供的选项 : `adapter.css` 进口 `layout.css`,以及 `light` 财务报告和审定财务报表 `dark` 抵达 `tokens.css` 通过设计符号, 所以避免它们意味着手溶 `adapter.css` 而不是进口它。 碰撞是修复上游的道具,如果不运送第二份,这个包裹就不能限制碰撞.
**回答香草 `!important` 让你在四个公共设施里 拥有房产.** 一个重要的宣言只能由从下层另一个来回答,所以这个包所写的这四个计数器也是重要的. 无论谁点出火来 都比它高 __ 价值以及香草。 这是里面 `.u-text-max-width` 页:1 `max-width` 在列表中,内部 `.u-table-layout--fixed` 或者说 `--auto` 页:1 `table-layout` 在一张桌子上,里面 `.p-content-card__author-and-date` 页:1 `margin-bottom` 第1个孩子不是标题或段落,而是内部的 `.u-vertically-center` 页:1 `align-self` 在图像上。 每起火只放入香草类, 所以把岛屿从公用设施中移出, 或把地产放在一个内元素上,而不是岛根上, 就能把它带回来.
**一个香草工具完全无法回答.** `.u-table-layout--auto` 部队 `table-layout: auto`,这是浏览器本身的默认值。 计数器只能还原和还原在同一价值上的土地,所以该工具内部的平板电脑不能恢复 `table-layout: fixed` 它要求的。 测量: `auto` 还有柜台 `auto` 没有,反对 `fixed` 一页只计算出一页。 没有反面,因为任何改变都不会被理解为掩护。 将表格从工具列表中移出,或将布局设置在内部表格上.
**三种打字特性被停止给每个人,而不只是给香草.** 岛根宣布 `word-spacing`, (中文(简体) ), `text-shadow` 财务报告和审定财务报表 `text-underline-offset`因此,一个主机页面对他们本身的价值也没有到达该岛。 CSS中没有任何东西能从一个框架中分辨出一个主机的刻意选择,这三种是香草本身永远不会表现出区别的. 把他们放入岛上,如果你想要的.
**一个岛根不会继承一个表格单元格的文本对齐或它的大胆.** 浏览器居中a `
`,在一页纸上,一个小岛 _内部_ 一个继承它。 在这里,岛根宣布 `text-align: start` 财务报告和审定财务报表 `font-weight: normal`因为那些相同的属性是如何的香草 `u-align--*` 家庭及其标题类 否则会到达, CSS 中没有任何内容能从框架规则中分辨出浏览器默认值. 交易买断了更大的漏洞。 要么自己在岛上 要么自己去.
一个岛根 _实值_ (单位:千美元) ` | `页:1 `` 或一个 ` |