指南大小写转换

大小写转换功能可让您快速更改所选内容的字母大小写。您可以使用它来格式化标题等文本的一部分,或将其更改为全大写并恢复。

此高级功能是 生产力包 的一部分。生产力包包含在我们的商业许可证中。如果您拥有有效的 CKEditor 5 许可证,请联系您的客户经理以查看您的资格。即使有些传统许可证是有效的,但也不符合独家生产力包的资格。 联系我们 了解更多详情。

您也可以注册 CKEditor 高级功能 30 天免费试用 来测试该功能。

# 演示

下面的演示可以让您测试大小写转换。将光标放在段落、标题或列表项等块内以影响整个块。您也可以选择要更改的文本片段。然后,使用 大小写转换 工具栏下拉菜单应用大小写格式。

您也可以使用 Shift+F3 键盘快捷键在大小写格式之间循环:大写 > 小写 > 标题大小写。使用 Ctrl/Cmd+Z 撤消更改。

关于正确处理标题的艺术

标题大小写(有时称为“标题大小写”)是英文写作中用于写作文学作品或艺术作品标题的大写方式。标题中的所有单词都会大写,除了某些次要单词(例如冠词、短介词和一些连接词),除非它们是标题的第一个或最后一个单词。

规则和标准

哪些单词是主要单词以及应该大写什么单词,有不同的规则。最受欢迎和最广泛的规则手册包括美联社风格手册芝加哥格式手册现代语言协会手册美国医学会风格手册大写规则

标题大小写与句子大小写相反,在句子大小写中,只有第一个单词和专有名词首字母大写。还有全大写,其中所有内容都大写。

此演示展示了一组有限的功能。访问 功能丰富的编辑器示例 以查看更多实际应用。

# 安装

⚠️ 新的导入路径

版本 42.0.0 开始,我们更改了导入路径的格式。本指南使用新的、更短的格式。如果您使用的是旧版本的 CKEditor 5,请参考 传统设置中的包 指南。

安装编辑器 后,将该功能添加到您的插件列表和工具栏配置中

import { ClassicEditor } from 'ckeditor5';
import { CaseChange } from 'ckeditor5-premium-features';

ClassicEditor
    .create( document.querySelector( '#editor' ), {
        plugins: [ CaseChange, /* ... */ ],
        toolbar: [ 'caseChange', /* ... */ ],

        // Title case configuration, see the section below.
        caseChange: {
            titleCase: {
                excludeWords: [ 'a', 'an', 'and', 'as', 'at', 'but', 'by', 'en', 'for', 'if', 'in',
                    'nor', 'of', 'on', 'or', 'per', 'the', 'to', 'vs', 'vs.', 'via' ]
            }
        },

        // Provide the licence key.
        licenseKey: '<YOUR_LICENSE_KEY>',
    } )
    .then( /* ... */ )
    .catch( /* ... */ );

阅读有关 安装插件工具栏配置 的更多信息。

# 激活功能

要使用此高级功能,您需要使用正确的凭据将其激活。有关详细信息,请参考 许可证密钥和激活 指南。

# 配置标题大小写模式

标题大小写更改的方法多种多样。这就是我们没有添加默认规则集的原因。您可以使用 config.caseChange.titleCase 配置来应用您的规则。该配置允许添加排除项 - 该功能不应大写的单词。它还提供了一个入口点,用于编写自定义句子结束检测机制,以处理句子中特殊位置的排除项。

以下是一些可以帮助您格式化内容的 CKEditor 5 功能

# 通用 API

The CaseChange 插件注册

  • 'caseChange' UI 下拉菜单组件。
  • 'changeCaseUpper', 'changeCaseLower''changeCaseTitle' 命令由 CaseChangeCommand 实现。

您可以使用 editor.execute() 方法执行命令

// Change the case of selected content to uppercase.
editor.execute( 'changeCaseUpper' );

// Change the case of selected content to lowercase.
editor.execute( 'changeCaseLower' );

// Change the case of selected content to title case.
editor.execute( 'changeCaseTitle' );

我们建议在开发和调试时使用官方的 CKEditor 5 检查器。它将为您提供大量关于编辑器状态的有用信息,例如内部数据结构、选择、命令等等。