Statamic CMS 控制面板的RTL语言支持问题解析

问题背景

Statamic CMS 是一款基于Laravel的内容管理系统，其控制面板(Control Panel)在支持从右向左(RTL)书写语言时存在显示问题。当用户将站点选择器切换为希伯来语等RTL语言时，HTML文档的direction属性仍保持左向右(LTR)设置，导致文本方向显示异常。

技术分析

方向属性设置机制

Statamic通过cpDirection()函数设置文档方向属性，该函数调用cpLocale()获取当前语言环境。问题根源在于cpLocale()始终返回配置中的默认语言(英语)，而非当前选中的站点语言。

public static function cpLocale(): string
{
    return config('app.locale'); // 始终返回'en'
}

解决方案探索

临时解决方案是修改cpLocale()函数，使其返回当前选中的站点语言：

public static function cpLocale(): string
{
    return session('statamic.cp.selected-site') ?? config('app.locale');
}

CodeMirror编辑器问题

即使修正了HTML方向属性，CodeMirror编辑器仍存在显示问题。这是因为Statamic的CodeMirror CSS中强制设置了LTR方向：

.CodeMirror-rtl pre { direction: ltr; }

而官方CodeMirror的CSS中实际应为：

.CodeMirror-rtl pre { direction: rtl; }

深层原因

Statamic设计上基于用户偏好语言而非编辑站点语言来确定RTL方向。用户需在"偏好设置"中选择RTL语言(如波斯语)，控制面板才会相应调整。超级用户可将此设置设为所有用户的默认值。

技术建议

1. 方向属性策略：明确区分用户界面语言方向和编辑内容方向
2. CodeMirror修复：更新CSS以匹配官方CodeMirror的RTL支持
3. 多语言支持：考虑为不同语言环境提供更细粒度的方向控制

总结

Statamic CMS的RTL支持需要从用户偏好和内容编辑两个维度进行设计。当前实现更关注用户界面语言的RTL支持，而非编辑内容的文本方向。开发者可根据实际需求选择通过用户偏好设置或直接修改核心代码来实现所需的RTL支持效果。