您的位置:首页>资讯列表>chrome插件开发教程>chrome插件窗口chrome.windows
chrome插件窗口chrome.windows原创
作者:绮晴 文章分类:chrome插件开发教程 阅读数:651 最后发布时间:2019-12-19

       [chrome插件视窗],由[绮晴]编写,chrome插件开发教程,是篇chrome插件Api[博客文章]介绍,主要介绍:视窗内容导航清单当前视窗范例API说明:chrome.windowsWindowonCreatedonFocu


窗口chrome.windows 

使用chrome.windows模块与浏览器窗口进行交互。 你可以使用这个模块在浏览器中创建、修改和重新排列窗口。


Two windows, each with one tab

清单

要使用窗口 API,你必须在声明"tabs"的权限 。(不,这不是一个错字 - 窗口和标签模块的互动如此密切,我们决定它们共享一个权限。)例如:

manifes_version:声明我们使用的版本
name:插件的名称
description:插件的描述
icons:插件显示的图标
"permissions": ["tabs"],

当前窗口

很多扩展系统的功能有一个可选的windowId参数,其默认值为当前窗口。

当前窗口是指包含当前正在执行的代码的窗口。重要的是要认识到,它可以跟最顶层或有焦点的窗口不一样。

例如,假设一个扩展从一个单一的HTML文件中创建了一些标签或窗口,而这个HTML文件包含一个的调用 。 当前窗口是指那个包含了发起调用的页面的窗口,不管它是不是最顶层窗口。

在这个例子中 ,当前窗口就是最后一个活动窗口。在某些情况下,背景页可能没有当前窗口。

范例

你可以在 目录下找到一些使用windows模块的简单范例。另外一个范例是在文件中的范例。 对于其他的例子和查看源代码的帮助,参见 。


API说明:chrome.windows


属性


WINDOW_ID_NONE

chrome.windows.WINDOW_ID_NONE

  • WINDOW_ID_NONE 整数 )

  • 这个windowId值表示没有Chrome浏览器窗口的情况。


方法


create

chrome.windows.create(object createDatafunction callback)

使用任何可选大小、位置或者默认提供的URL来创建(打开)一个新的浏览器。

参数

  • createData optional object可选,对象 )


    • url optional string or array of string 可选,字符串或者字符串数组)

    • 一个或者一组在窗口作为标签打开的URL。完全合格的URL必须包括一个类型(即'http://www.google.com',不是'www.google.com')。相对URL将与扩展内的当前页相关。默认为新的标签页面。

  • tabId optional integer可选,整数 )

  • 你想要在新窗口选定的标签的id。

  • left optional integer 可选,整数 )

  • 新窗口相对于屏幕的左边缘的位置的像素值。如果没有指定,那么新的窗口从最后一个有焦点的窗口自然偏移。

  • top optional integer可选,整数 )

  • 新窗口相对于屏幕的上边缘的位置的像素值。如果没有指定,那么新的窗口从最后一个有焦点的窗口自然偏移。

  • width optional integer可选,整数 )

  • 新窗口的像素宽度。如果没有指定,默认为自然宽度。

  • height optional integer可选,整数 )

  • 新窗口的像素高度。如果没有指定,默认为自然高度。

  • incognito optional boolean可选,Boolean类型 )

  • 新窗口是否是隐身。

  • type optional enumerated string ["normal", "popup"]可选,枚举字符串["normal", "popup"] )

  • 指定新建浏览器窗口的类型。

  • callback optional function可选,函数 )

    回调函数

    如果指定了回调参数,它应该指定一个如下所示函数:

    function(Window window) {...};
    • window optional  可选,窗口 )

    • 包含新创建窗口的详细信息。


    get

    chrome.windows.get(integer windowIdfunction callback)

    获取有关窗口的详细信息。

    参数

    • windowId integer整数 )

    • callback function函数 )

      Callback function

      如果指定了回调参数,它应该指定一个如下所示函数:

      function(Window window) {...};
      • window  )


      getAll

      chrome.windows.getAll(object getInfofunction callback)

      获得所有的窗口。

      参数

      • getInfo optional object可选,对象 )


        • populate optional boolean 可选,Boolean类型)

        • 如果是true表示每个窗口对象都有一个包含该窗口所有标签的tabs属性。

      • callback function函数 )

        回调函数

        回调参数应该指定一个如下函数:

        function(array of Window windows) {...};
        • windows array of  )


        getCurrent

        chrome.windows.getCurrent(function callback)

        获得。

        参数

        • callback function 函数)

          回调函数

          如果指定了回调参数,它应该指定一个如下所示函数:

          function(Window window) {...};
          • window  )


          getLastFocused

          chrome.windows.getLastFocused(function callback)

          获取最近有焦点的窗口 — 一般是最顶层的窗口。

          参数

          • callback function 函数)

            回调函数

            如果指定了回调参数,它应该指定一个如下所示函数:

            function(Window window) {...};
            • window  )


            remove

            chrome.windows.remove(integer windowIdfunction callback)

            关闭一个窗口以及其包含的所有标签。

            参数

            • windowId integer整数 )

            • callback optional function 可选,函数 )

              回调函数

              如果指定了回调参数,它应该指定一个如下所示函数:

              function() {...};


                update

                chrome.windows.update(integer windowIdobject updateInfofunction callback)

                更新一个窗口的属性。只指定那些你希望修改的属性,未指定的属性将保持不变。

                参数

                • windowId integer整数 )

                • updateInfo object对象 )


                  • left optional integer 可选,整数 )

                  • 窗口相对屏幕左边界进行移动的像素偏移值。

                • top optional integer 可选,整数 )

                • 窗口相对屏幕上边界进行移动的像素偏移值。

                • width optional integer可选,整数 )

                • 窗口宽度调整的像素值。

                • height optional integer可选,整数 )

                • 窗口高度调整的像素值。

                • focused optional boolean可选,Boolean类型 )

                • 如果是true,将该窗口提至前面。否则,将z-order上下一窗口提至前面。

                • callback optional function 可选,函数)

                  回调函数

                  如果指定了回调参数,它应该指定一个如下所示函数:

                  function(Window window) {...};
                  • window  )


                  事件


                  onCreated

                  chrome.windows.onCreated.addListener(function(Window window{...});

                  当一个新窗口被创建时触发。

                  参数

                  • window  )

                  • 被创建窗体的详细信息。


                  onFocusChanged

                  chrome.windows.onFocusChanged.addListener(function(integer windowId{...});

                  当前获得焦点窗口改变时触发。

                  Parameters

                  • windowId integer )

                  • 新获取到焦点的窗口的ID。如果所有Chrome窗口都失去焦点,则为chrome.windows.WINDOW_ID_NONE。注意:在一些Linux的窗口管理器中,从一个Chrome窗口切换到另一个窗口的时候,WINDOW_ID_NONE总是会被先发送出去。


                  onRemoved

                  chrome.windows.onRemoved.addListener(function(integer windowId{...});

                  当一个窗口被关闭时触发。

                  参数

                  • windowId integer 整数)

                  • 被关闭窗口的ID。


                  类型


                  Window

                  • object窗口,对象 )


                    • id integer 整数)

                    • 窗口的ID。窗口ID在一个浏览器会话中是唯一的。

                  • focused boolean )

                  • 该窗口是否当前焦点窗口。

                  • top integer整数 )

                  • 窗体相对屏幕上边缘的偏移像素值。

                  • left integer整数 )

                  • 窗体相对屏幕左边缘的偏移像素值。

                  • width integer整数 )

                  • 窗体宽度像素值。

                  • height integer整数 )

                  • 窗体高度像素值。

                  • tabs optional array of 可选,数组 )

                  • 表征窗体所包含的数组。

                  • incognito boolean )

                  • 窗体是否隐藏。

                  • type enumerated string ["normal", "popup", "app"] )

                  • 浏览器窗口类型。


                  ———————————————————————

                  [本文标题和网址]

                  chrome插件窗口chrome.windows

                  https://www.zhaocrx.com/Article/ArtGroupDetail-3824.html

                  版权声明:本文为找软件网博主「 绮晴 」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。

                  文章评论
                  [chrome插件窗口chrome.windows]评论列表
                  查看更多