全屏

Full Screen 插件在经典模式下使用时，可以在 TinyMCE 中启用全屏编辑。激活工具栏按钮后，可编辑区域将扩展至填满浏览器视口。该插件会添加一个 Fullscreen 工具栏按钮，并在 View 菜单下添加对应的菜单项。

可以通过以下键盘快捷键切换全屏模式：

• macOS：Command+Shift+F

• Windows 或 Linux：Ctrl+Shift+F

基本设置

tinymce.init({
  selector: 'textarea',  // 根据你的 HTML 修改此值
  plugins: 'fullscreen',
  toolbar: 'fullscreen'
});

有关如何使用模块打包工具将该插件打包的信息，请参阅 Bundling TinyMCE - Overview（打包 TinyMCE - 概述）。

此功能仅在 TinyMCE 以经典模式运行时支持。在 inline 模式下不受支持。有关编辑模式之间的差异详情，请参阅 Classic editing mode（经典编辑模式）。

选项

以下配置选项会影响 Full Screen 插件的行为。

fullscreen_native

fullscreen_native 选项允许编辑器使用浏览器的全屏模式，而不仅仅是在启用全屏模式时填满浏览器窗口。此功能与在线视频的全屏模式相同。

类型： Boolean

默认值： false

可能的值： true、false

该选项仅在 TinyMCE 处于经典模式时支持。在 inline 模式下不受支持。

示例：使用 fullscreen_native

要为 TinyMCE 编辑器使用浏览器原生的全屏模式，请将 fullscreen_native 设置为 true。例如：

tinymce.init({
  selector: 'textarea',  // 根据你的 HTML 修改此值
  plugins: 'fullscreen',
  toolbar: 'fullscreen',
  fullscreen_native: true
});

fullscreen_native 选项的限制

fullscreen_native 选项有以下限制。当启用 fullscreen_native 时：

• 按 Esc 键将退出全屏模式。Esc 键的默认编辑器行为会被浏览器覆盖，Esc 键将退出全屏模式，而不是关闭对话框、菜单，或将焦点从编辑器 UI 移到编辑器内容。这可能会导致可访问性问题。

• 对于 Firefox 用户，如果在两次开启之间不与编辑器进行交互，则无法使用全屏键盘快捷键（Command+Shift+F 或 Ctrl+Shift+F）反复切换浏览器原生的全屏模式开和关。如果用户在关闭和开启切换之间不与编辑器交互，插件将回退为填满浏览器窗口。

• 如果编辑器是在 iframe 元素内部初始化的，则在 Firefox 中全屏模式只会填满该 iframe。

工具栏按钮

Full Screen 插件提供以下工具栏按钮：

可以通过以下方式将这些工具栏按钮添加到编辑器中：

• 使用 toolbar 配置选项。

• 使用 quickbars_insert_toolbar 配置选项。

• 自定义上下文工具栏。

菜单项

Full Screen 插件提供以下菜单项：

可以通过以下方式将这些菜单项添加到编辑器中：

• 使用 menu 配置选项。

• 使用 contextmenu 配置选项。

• 自定义菜单工具栏按钮。

命令

Full Screen 插件提供以下 TinyMCE 命令。

tinymce.activeEditor.execCommand('mceFullScreen');