javascript - Google 文档的自定义键盘快捷键(更改颜色 - 背景颜色)

标签 javascript jquery google-apps-script google-docs

我想使用键盘快捷键更改 Google 文档中所选文本的 ForegroundColor

我可以制作“更改前景色”部分(将菜单项绑定(bind)到函数 setColor() ),但不能制作“键盘快捷键部分”。

我找到了这个 code但我在实现时遇到了麻烦:

$(document).keydown(function(e){
  //CTRL + Q keydown combo
  if(e.ctrlKey && e.keyCode == 81){
    $( '#output' ).html("I've been pressed!");
  }
})

我的困难:

1) 我不确定将这段代码放在我的脚本编辑器中的什么位置(我试图将它放在 onOpen() 函数中,如下所示,但也没有成功)。

2) 我不确定 $(document) 应该指的是什么。

3) 我不确定他们所说的“必须先单击/激活侧边栏才能发生”是什么意思。

function onOpen() {
  var ui = DocumentApp.getUi();
  ui.createMenu('My Menu')
      .addItem('Color', 'setColor')
      .addToUi();

  var document = DocumentApp.getActiveDocument() // should it be here?
  $(document).keydown(function(e){
    //CTRL + Q keydown combo
    if(e.ctrlKey && e.keyCode == 81){
      SpreadsheetApp.getUi().alert('Hello, world!');
    }
  })
}

function setColor1() {
    var selection = DocumentApp.getActiveDocument().getSelection();
    if (selection) {
    var elements = selection.getRangeElements();
    for (var i = 0; i < elements.length; i++) {
        var element = elements[i];

        // Only modify elements that can be edited as text; skip images and other non-text elements.
        if (element.getElement().editAsText) {
            var text = element.getElement().editAsText();

            // Edit the selected part of the element, or the full element if it's completely selected.
            if (element.isPartial()) {
                text.setForegroundColor(element.getStartOffset(), element.getEndOffsetInclusive(), "#00FFFF");
            } else {
                text.setForegroundColor("#00FFFF");
            }
        }
    }
    }
}

最佳答案

在这一行中,变量“document”是 Google Apps 脚本文档中定义的“Document”对象的一个​​实例。

var document = DocumentApp.getActiveDocument() 

它是对位于您的云端硬盘中的 Google 文档的抽象,允许您使用此处描述的一组方法修改您的云端硬盘文件 https://developers.google.com/apps-script/reference/document/document

下面一行是 jQuery 语法。

$(document).keydown(function(e){}

jQuery 是一个用于客户端开发的 JavaScript 库。它用于浏览网页的 HTML DOM 树。 $(document) 是 jQuery 对 DOM 的表示。更多关于 jQuery http://jquery.com/

由于 Google Apps 脚本在 Google 服务器上运行,而不是在您本地的计算机上运行,​​因此没有可供您导航的 DOM 树。您仅限于映射到 Google 服务器上的代码位的 GAS 函数。这两行代码彼此没有任何关系,也不是指同一个文档。

这同样适用于您可以收听的事件。虽然 GAS 确实具有一些事件处理功能,但事件列表非常短(请参阅“简单触发器”和可安装触发器)https://developers.google.com/apps-script/guides/triggers/

更新

您可以通过使用 HtmlService 构建您自己的自定义 UI 来实现这一点。需要注意的是,似乎无法将控制权从 Google Document 移交给 UI 元素,因此您必须在每次操作后手动将焦点设置在侧边栏上。

这是您项目中的 .gs 文件的示例。将其视为您的服务器应用程序。

//creates html output from the template
function onOpen(){ 


var ui = DocumentApp.getUi();
var htmlOutput = HtmlService.createTemplateFromFile('sidebar').evaluate();
ui.showSidebar(htmlOutput);

}

function setColor1(){

  //your code

}

下面是侧边栏模板的客户端代码。您可以通过单击文件 -> 新建 -> Html 文件在脚本编辑器中创建模板。 在上面的 .gs 文件中,将其命名为 sidebar 或您为 var htmlOutput 选择的任何名称。如果您按下“Ctrl + Q”,侧边栏将显示确认信息并调用您的 .gs 文件中的 setColor1() 函数。

更多关于从客户端调用服务器端 GAS 函数的信息 https://developers.google.com/apps-script/guides/html/reference/run

更多关于 HtmlService https://developers.google.com/apps-script/guides/html/

明显的缺点是侧边栏必须先获得焦点,所以你总是需要在选择后点击它。

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
  </head>
  <body>

    <p> Press Ctrl + Q to change the color of selected text </p>
    <p id="log"> </p>

    <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>
    <script>

    $(document).ready(function(){

      $(document).keydown(function(e){

      if(e.ctrlKey && e.keyCode == 81){

           $('#log').html('you pressed Ctrl + Q');

           google.script.run.setColor1();


      }

      });


    });

    </script>


  </body>
</html>

希望这对您有所帮助!

关于javascript - Google 文档的自定义键盘快捷键(更改颜色 - 背景颜色),我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/44342221/

相关文章:

jquery - 在文档加载事件的类上添加图像

javascript - 未捕获的类型错误 : Cannot read property 'getTime' of undefined in CanvasJS

javascript - Vue.js 访问父组件

javascript - Jquery ID 选择器不适用于变量

javascript - api未在ajax方法中加载,但在脚本标签中加载

javascript - 自动将 Google 表格中单元格内容大写的脚本?

google-app-engine - Google App 脚本/Gmail 附加组件 : How to display a window with text and buttons over Gmail?

javascript - 如何在 vscode 扩展中使用正则表达式保留返回战车?

javascript - 查找图像 ID 并替换为单击的按钮类

javascript - 专注于不使用 ID 的输入字段