• 教程
• 文档

导读

CSS 逻辑属性（Logical Properties）让开发者不再依赖left、right、top、bottom这类物理方向，而是通过start、end、inline、block等逻辑方向来描述布局，从而让样式在不同书写模式（writing modes）与多语言环境下自动适配。本文以 30-seconds-of-code 仓库中 logical-physical-properties-map.md 一文为核心，系统整理逻辑属性与物理属性（LTR 场景）的完整映射关系，并结合仓库内真实样式代码，展示逻辑属性在工程实践中的落地方式。读完本文，你将掌握定位、外边距、内边距、边框、尺寸等常用属性的逻辑化写法，以及start/end等逻辑值的用法。

适用前提：本文所有映射关系均假设书写方向为从左到右（LTR）。若你的页面采用 RTL（从右到左）书写方向，物理属性会发生镜像反转，例如left与right互换、top与bottom互换，而逻辑属性始终指向逻辑方向，无需修改。

什么是 CSS 逻辑属性

逻辑属性是 CSS 中定义布局的一种新方式。传统物理属性直接指向屏幕上的物理方向（left、right、top、bottom），而逻辑属性使用与书写模式无关的逻辑方向：

• inline 轴：沿着文字书写方向延伸的轴，LTR 下对应水平方向；
• block 轴：垂直于文字书写方向的轴，LTR 下对应垂直方向；
• start / end：某一轴上的起点与终点，LTR 下inline-start为左侧、block-start为顶部。

使用逻辑属性的核心价值在于：同一套样式代码可以自动适配 LTR、RTL 以及竖排书写模式，无需为不同语言维护多套物理属性样式，这对国际化（i18n）项目尤为关键。

该文档在 30-seconds-of-code 中收录于 CSS Layout 集合，归类标签为layout，对应集合描述见 content/collections/css/layout.yaml。浏览器支持情况可通过文中嵌入的<baseline-support featureId="logical-properties">组件查询（即 Baseline 兼容性数据），本节目录结构可参考 content/languages/css.yaml 中针对inset-inline、margin-block、padding-inline、inline-size等属性维护的术语入口。

Position（定位）映射

定位属性用于控制定位元素（positioned elements）的偏移方向。LTR 场景下，逻辑定位属性与物理属性的对应关系如下：

其中inset-inline与inset-block为简写形式，分别同时设置同一轴上的两个方向。例如：

.box { position: absolute; inset-inline: 0; /* 等价于 left: 0; right: 0（LTR） */ inset-block: 0; /* 等价于 top: 0; bottom: 0 */ }

仓库中的姊妹篇 inset.md 也明确指出：虽然inset属性定义于 CSS Logical Properties and Values 规范中，但它本质上是物理属性，始终指向top、right、bottom、left，不会随书写模式变化；若需要逻辑化定位，应改用inset-inline-start、inset-block-end等逻辑属性。二者配合使用，可以在保留简洁简写的同时获得逻辑方向的能力。

Margin（外边距）映射

外边距方向的逻辑化写法与定位一致，只需将inset替换为margin：

典型场景：需要为文本块底部留出间距，用margin-block-end替代margin-bottom，即可在 LTR 与 RTL 下获得一致效果。

仓库样式 content/components/styles/code-tabs.scss 中正是使用margin-inline: 0（第 106 行）与margin-block-end: 0（第 124 行）来重置代码块与 summary 元素的默认外边距，说明逻辑属性在外边距重置场景下完全可替代物理属性。

Padding（内边距）映射

内边距同理：

应用示例：给行内元素左右留白，使用padding-inline；给容器顶部留白，使用padding-block-start。

仓库中的 content/components/styles/prism-code-highlights.scss 第 16 行使用padding-inline: var(--layout-bleed-width)为代码高亮区域设置水平内边距，而 code-tabs.scss 第 107 行使用padding-block-start: var(--spacing-12)控制顶部留白，均是逻辑属性在真实工程中的直接体现。

Border（边框）映射

边框是逻辑属性中维度最丰富的一组，除边框本身外，还包括颜色、样式、宽度以及圆角：

说明：原文档表格中border-inline-start-style、border-inline-start-width等行的物理对应项笔误为border-left-color，本文按标准规范修正为border-left-style、border-left-width，block 轴同理。圆角属性按“先轴后序”记忆：border-start-start-radius中第一个方向指 block 轴起点（顶），第二个方向指 inline 轴起点（左），即border-top-left-radius。

工程实践参考：仓库样式 code-tabs.scss 使用border-block-start（第 89 行、第 109 行）为标签页与代码块设置顶部边框，并在过渡动画中监听border-block-start-color的变化，实现选中态边框高亮——这正是用逻辑边框替代物理边框的真实案例。

Size（尺寸）映射

元素尺寸也有对应的逻辑属性，用于适配书写方向下的宽高语义：

在 LTR 下，inline-size对应宽度、block-size对应高度；在竖排书写模式（如writing-mode: vertical-rl）下，二者语义互换。对需要兼顾多语言排版的容器，使用inline-size/block-size可以让尺寸语义随书写模式自动调整。

Values（逻辑值）

除了逻辑属性，CSS 还提供可在多种属性中使用的逻辑值。它们常被用在text-align、float、clear、overflow等接受方向关键字的属性中：

示例：

.text { text-align: start; /* LTR 下等价于 left，RTL 下自动变为 right */ }

与逻辑属性一样，逻辑值同样具备书写模式感知能力，是国际化布局中让文本与浮动方向随语言自动切换的便捷手段。

实战建议与注意事项

1. 优先逻辑、按需物理：在面向多语言或可能切换书写方向的组件中，优先使用逻辑属性；仅在明确需要“物理”语义（如绝对定位的固定遮罩层）时使用物理属性。
2. 简写与单边结合：inset-inline、margin-block等简写属性可显著减少代码量，配合单边逻辑属性可实现精细控制。
3. 尺寸语义：用inline-size/block-size表达“主轴上尺寸/副轴上尺寸”，在竖排场景下避免宽高语义错乱。
4. Border 的逐层拆解：边框逻辑属性可按color、style、width逐层拆分，便于在主题系统中单独控制。
5. 验证兼容性：逻辑属性在现代浏览器中已具备良好支持，可通过文中 Baseline 组件或各属性的 MDN 数据确认当前项目的目标浏览器范围。

小结

CSS 逻辑属性将布局从“屏幕的物理方向”解放到“文字的书写方向”，是构建国际化、多书写模式界面的一等公民能力。通过本文的映射表，你可以快速将 LTR 场景下的物理属性改写为逻辑属性；而 30-seconds-of-code 仓库自身的样式系统（如 code-tabs.scss、prism-code-highlights.scss）也大量使用margin-inline、padding-inline、border-block-start等逻辑属性，印证了这套写法在实际工程中的可行性与可维护性。下一篇姊妹篇 inset.md 则从inset简写出发，帮助你进一步理解物理简写与逻辑属性之间的取舍。

• 教程
• 文档