From 6d93d47b221cd76e088180152e12d7e42b4bf852 Mon Sep 17 00:00:00 2001 From: Samuel Attard Date: Tue, 5 Oct 2021 02:02:31 -0700 Subject: [PATCH] =?UTF-8?q?feat:=20New=20Crowdin=20translations=20(auto-me?= =?UTF-8?q?rged=20=F0=9F=A4=96)=20(#2073)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/de-DE/docs/api/app.md | 2 +- content/es-ES/docs/api/browser-window.md | 2 +- content/es-ES/docs/api/dialog.md | 4 +- content/es-ES/docs/api/session.md | 46 +-- .../es-ES/docs/api/structures/hid-device.md | 14 +- content/es-ES/docs/api/web-contents.md | 6 +- content/fr-FR/docs/api/app.md | 2 +- content/pt-BR/docs/api/app.md | 2 +- content/ru-RU/docs/api/app.md | 2 +- content/zh-CN/docs/api/app.md | 2 +- content/zh-CN/docs/api/menu.md | 359 +++++------------- content/zh-CN/docs/api/session.md | 10 +- content/zh-CN/docs/api/webview-tag.md | 6 +- content/zh-CN/docs/tutorial/web-embeds.md | 14 +- 14 files changed, 146 insertions(+), 325 deletions(-) diff --git a/content/de-DE/docs/api/app.md b/content/de-DE/docs/api/app.md index 8354a58c69c44..3eb4401d67386 100644 --- a/content/de-DE/docs/api/app.md +++ b/content/de-DE/docs/api/app.md @@ -869,7 +869,7 @@ Imports the certificate in pkcs12 format into the platform certificate store. `c * `options` Objekt * `enableBuiltInResolver` Boolean (optional) - Whether the built-in host resolver is used in preference to getaddrinfo. When enabled, the built-in resolver will attempt to use the system's DNS settings to do DNS lookups itself. Enabled by default on macOS, disabled by default on Windows and Linux. - * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be peformed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". + * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be performed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". * `secureDnsServers` String[] (optional) - A list of DNS-over-HTTP server templates. See [RFC8484 § 3][] for details on the template format. Most servers support the POST method; the template for such servers is simply a URI. Note that for [some DNS providers][doh-providers], the resolver will automatically upgrade to DoH unless DoH is explicitly disabled, even if there are no DoH servers provided in this list. * `enableAdditionalDnsQueryTypes` Boolean (optional) - Controls whether additional DNS query types, e.g. HTTPS (DNS type 65) will be allowed besides the traditional A and AAAA queries when a request is being made via insecure DNS. Has no effect on Secure DNS which always allows additional types. Standard ist true. diff --git a/content/es-ES/docs/api/browser-window.md b/content/es-ES/docs/api/browser-window.md index 987fc86a79429..14b1c432ba23b 100644 --- a/content/es-ES/docs/api/browser-window.md +++ b/content/es-ES/docs/api/browser-window.md @@ -166,7 +166,7 @@ Crea una nueva `BrowserWindow` con propiedades nativas como las establecidas por * `roundedCorners` Boolean (opcional) - Si la ventana sin marco debería tener o no esquinas redondeadas macOS. Por defecto es `true`. * `fullscreenWindowTitle` Boolean (opcional) _Obsoleto_ - Muestra el título en la barra de título en el modo de pantalla completa en macOS para `hiddenInset` titleBarStyle. Por defecto es `false`. * `thickFrame` Boolean (opcional) - Utilice el estilo `WS_THICKFRAME` para ventanas sin marco en Windows, la cual agrega un marco de ventana estándar. Configurarlo en `false` eliminará la sombra de la ventana y las animaciones de la ventana. Por defecto es `true`. - * `vibrancy` Cadena (opcional) - Añade un tipo de efecto de vibración a la ventana. Funciona solamente en macOS. Puede ser `appearance-based`, `light`, `dark`, `titlebar`, `selection`, `menu`, `popover`, `sidebar`, `medium-light`, `ultra-dark`, `header`, `sheet`, `window`, `hud`, `fullscreen-ui`, `tooltip`, `content`, `under-window`, o `under-page`. Please note that `appearance-based`, `light`, `dark`, `medium-light`, and `ultra-dark` are deprecated and have been removed in macOS Catalina (10.15). + * `vibrancy` Cadena (opcional) - Añade un tipo de efecto de vibración a la ventana. Funciona solamente en macOS. Puede ser `appearance-based`, `light`, `dark`, `titlebar`, `selection`, `menu`, `popover`, `sidebar`, `medium-light`, `ultra-dark`, `header`, `sheet`, `window`, `hud`, `fullscreen-ui`, `tooltip`, `content`, `under-window`, o `under-page`. Por favor tenga en cuenta que `appearance-based`, `light`, `dark`, `medium-light`, and `ultra-dark` están obsoletas y han sido eliminadas en macOS Catalina (10.15). * `zoomToPageWidth` Boolean (optional) - Controls the behavior on macOS when option-clicking the green stoplight button on the toolbar or by clicking the Window > Zoom menu item. Si es `true`, la ventana crecerá al ancho recomendado de la página web cuando se haga zoom. `false` hará que haga zoom hasta el ancho de la pantalla. Esto también afectará el comportamiento cuando se llama directamente `maximize()`. Por defecto es `false`. * `tabbingIdentifier` String (opcional) - Crea una pestaña del nombre del grupo. Permite abrir la ventana como una pestaña nativa en macOC 10.12+. Las ventanas con el mismo identificador de pestaña se agruparán juntos. Esto también añade un nuevo botón de pestañas nativo a la barra de pestañas de la ventana y permite que la `app` y la ventana reciban el evento `new-window-for-tab`. * `webPreferences` Object (optional) - Settings of web page's features. diff --git a/content/es-ES/docs/api/dialog.md b/content/es-ES/docs/api/dialog.md index 17608a3bff9cc..a1498fa4c9248 100644 --- a/content/es-ES/docs/api/dialog.md +++ b/content/es-ES/docs/api/dialog.md @@ -187,7 +187,7 @@ Los `filtros` especifican un arreglo de los tipos de archivos can pueden ser mos * `title` Cadena (opcional) - Título del mensaje de la caja, algunas plataformas no se mostrarán. * `detail` Cadena (opcional) - Información extra del mensaje. * `icon` ([NativeImage](native-image.md) | String) (opcional) - * `textWidth` Integer (optional) _macOS_ - Custom width of the text in the message box. + * `textWidth` Integer (opcional) _macOS_ - Ancho personalizado del texto en el cuadro de mensaje. * `cancelId` Íntegro (opcional) - El índice el botón a ser usado a cancelar el diálogo, por vía la llave `Esc`. Por defecto, esto es asignado a el primer botón con "cancelar" o "no" como una etiqueta. Si no existen tales botones etiquetados y esta opción no esta configurada, `0` será usada como el valor de retorno. * `noLink` Boolean (opcional) - En Windows Electron se tratará de averiguar cuál de los `buttons` son botones comunes (como "Cancelar" o "Sí"), y muestra los otros como links de comandos en el diálogo. Esto puede hacer que el diálogo aparezca en el estilo de las aplicaciones modernas de Windows. Si no te gusta este comportamiento, puedes establecer `noLink` a `true`. * `normalizeAccessKeys` Boolean (opcional) - Normalizar el acceso al teclado a través de las plataformas. Por defecto es `false`. Permitir esto asume que `&` es usado en las etiquetas de los botones para el colocamiento de los atajos de acceso de las teclas del teclado y las etiquetas serán convertidas para que funcionen correctamente en cada plataforma, `&` personajes serán eliminados de macOS, convertidos a `_` en Linux, y dejado intacto en Windows. Por ejemplo, una etiqueta de botón de `Vie&w` será convertida a `Vie_w` en Linux y `View` en macOS y puede ser seleccionado vía `Alt-W` en Windows y Linux. @@ -212,7 +212,7 @@ El argumento de `browserWindow` permite el diálogo a adjuntarse a una ventana p * `checkboxLabel` String (opcional) - Si se proporciona, el cuadro de mensaje será incluido como un checkbox con la etiqueta dada. * `checkboxChecked` Boolean (opcional) - Estado inicial checked del checkbox. `false` por defecto. * `icon` [NativeImage](native-image.md) (opcional) - * `textWidth` Integer (optional) _macOS_ - Custom width of the text in the message box. + * `textWidth` Integer (opcional) _macOS_ - Ancho personalizado del texto en el cuadro de mensaje. * `cancelId` Íntegro (opcional) - El índice el botón a ser usado a cancelar el diálogo, por vía la llave `Esc`. Por defecto, esto es asignado a el primer botón con "cancelar" o "no" como una etiqueta. Si no existen tales botones etiquetados y esta opción no esta configurada, `0` será usada como el valor de retorno. * `noLink` Boolean (opcional) - En Windows Electron se tratará de averiguar cuál de los `buttons` son botones comunes (como "Cancelar" o "Sí"), y muestra los otros como links de comandos en el diálogo. Esto puede hacer que el diálogo aparezca en el estilo de las aplicaciones modernas de Windows. Si no te gusta este comportamiento, puedes establecer `noLink` a `true`. * `normalizeAccessKeys` Boolean (opcional) - Normalizar el acceso al teclado a través de las plataformas. Por defecto es `false`. Permitir esto asume que `&` es usado en las etiquetas de los botones para el colocamiento de los atajos de acceso de las teclas del teclado y las etiquetas serán convertidas para que funcionen correctamente en cada plataforma, `&` personajes serán eliminados de macOS, convertidos a `_` en Linux, y dejado intacto en Windows. Por ejemplo, una etiqueta de botón de `Vie&w` será convertida a `Vie_w` en Linux y `View` en macOS y puede ser seleccionado vía `Alt-W` en Windows y Linux. diff --git a/content/es-ES/docs/api/session.md b/content/es-ES/docs/api/session.md index f058502722fce..97c3418a85b02 100644 --- a/content/es-ES/docs/api/session.md +++ b/content/es-ES/docs/api/session.md @@ -169,9 +169,9 @@ Devuelve: * `deviceList` [HIDDevice[]](structures/hid-device.md) * `frame` [WebFrameMain](web-frame-main.md) * `callback` Función - * `deviceId` String | null (optional) + * `deviceId` String | null (opcional) -Emitted when a HID device needs to be selected when a call to `navigator.hid.requestDevice` is made. `callback` should be called with `deviceId` to be selected; passing no arguments to `callback` will cancel the request. Additionally, permissioning on `navigator.hid` can be further managed by using [ses.setPermissionCheckHandler(handler)](#sessetpermissioncheckhandlerhandler) and [ses.setDevicePermissionHandler(handler)`](#sessetdevicepermissionhandlerhandler). +Emitido cuando un dispositivo HID necesita ser seleccionado cuando se realizó una llamada a `navigator.hid.requestDevice`. `callback` debería ser llamada con el `deviceId` a ser seleccionado; al no pasar argumentos a `callback` se cancelará la solicitud. Adicionalmente, los permisos en `navigator.hid` pueden ser administrados aún más usando [ses.setPermissionCheckHandler(handler)](#sessetpermissioncheckhandlerhandler) y [ses.setDevicePermissionHandler(handler)`](#sessetdevicepermissionhandlerhandler). ```javascript const { app, BrowserWindow } = require('electron') @@ -183,23 +183,23 @@ app.whenReady().then(() => { win.webContents.session.setPermissionCheckHandler((webContents, permission, requestingOrigin, details) => { if (permission === 'hid') { - // Add logic here to determine if permission should be given to allow HID selection + // Agregue la lógica aquí para determinar si el permiso debería ser dado para permitir la selección HID return true } return false }) - // Optionally, retrieve previously persisted devices from a persistent store + // Opcionalmente, recupere los dispositivos persistentes anteriormente de un almacén persistente const grantedDevices = fetchGrantedDevices() win.webContents.session.setDevicePermissionHandler((details) => { if (new URL(details.origin).hostname === 'some-host' && details.deviceType === 'hid') { if (details.device.vendorId === 123 && details.device.productId === 345) { - // Always allow this type of device (this allows skipping the call to `navigator.hid.requestDevice` first) + // Siempre permite este tipo de dispositivo (esto permite saltar la primera llamada a `navigator.hid.requestDevice`) return true } - // Search through the list of devices that have previously been granted permission + // Busque a través de la lista de dispositivos a los que anteriormente se le han otorgado permiso return grantedDevices.some((grantedDevice) => { return grantedDevice.vendorId === details.device.vendorId && grantedDevice.productId === details.device.productId && @@ -219,7 +219,7 @@ app.whenReady().then(() => { }) ``` -#### Event: 'hid-device-added' +#### Evento: 'hid-device-added' Devuelve: @@ -228,11 +228,11 @@ Devuelve: * `device` [HIDDevice[]](structures/hid-device.md) * `frame` [WebFrameMain](web-frame-main.md) -Emitted when a new HID device becomes available. For example, when a new USB device is plugged in. +Emitido cuando un nuevo dispositivo HID está disponible. Por ejemplo, cuando un nuevo dispositivo USB se conecta. -This event will only be emitted after `navigator.hid.requestDevice` has been called and `select-hid-device` has fired. +Este evento sólo se emitirá después de que `navigator.hid.requestDevice` haya sido llamado y `select-hid-device` haya sido disparado. -#### Event: 'hid-device-removed' +#### Evento: 'hid-device-removed' Devuelve: @@ -241,9 +241,9 @@ Devuelve: * `device` [HIDDevice[]](structures/hid-device.md) * `frame` [WebFrameMain](web-frame-main.md) -Emitted when a HID device has been removed. For example, this event will fire when a USB device is unplugged. +Emitido cuando un dispositivo HID ha sido eliminado. For example, this event will fire when a USB device is unplugged. -This event will only be emitted after `navigator.hid.requestDevice` has been called and `select-hid-device` has fired. +Este evento sólo se emitirá después de que `navigator.hid.requestDevice` haya sido llamado y `select-hid-device` haya sido disparado. #### Evento: 'select-serial-port' @@ -531,8 +531,8 @@ session.fromPartition('some-partition').setPermissionRequestHandler((webContents #### `ses.setPermissionCheckHandler(handler)` * `handler` Función\ | null - * `webContents` ([WebContents](web-contents.md) | null) - WebContents verificando el permiso. Por favor, tenga en cuenta que si la solicitud viene de un subframe debe utilizar `requestUrl` para comprobar el origen de la solicitud. All cross origin sub frames making permission checks will pass a `null` webContents to this handler, while certain other permission checks such as `notifications` checks will always pass `null`. Debería usar `embeddingOrigin` y `requestingOrigin` para determinar que origen se encuentra en el marco propietario y en el marco solicitante respectivamente. - * `permission` String - Type of permission check. Valid values are `midiSysex`, `notifications`, `geolocation`, `media`,`mediaKeySystem`,`midi`, `pointerLock`, `fullscreen`, `openExternal`, `hid`, or `serial`. + * `webContents` ([WebContents](web-contents.md) | null) - WebContents verificando el permiso. Por favor, tenga en cuenta que si la solicitud viene de un subframe debe utilizar `requestUrl` para comprobar el origen de la solicitud. Todos los sub frames de origen cruzado que realizan comprobaciones de permisos pasarán un webContents `null` a este controlador, mientras que otras comprobaciones de permisos, como `notifications` siempre pasarán `null`. Debería usar `embeddingOrigin` y `requestingOrigin` para determinar que origen se encuentra en el marco propietario y en el marco solicitante respectivamente. + * `permission` String - Type of permission check. Los valores válidos son `midiSysex`, `notifications`, `geolocation`, `media`,`mediaKeySystem`,`midi`, `pointerLock`, `fullscreen`, `openExternal`, `hid`, o `serial`. * `requestingOrigin` String - La URL de origen para la comprobación de permisos * `details` Object - Some properties are only available on certain permission types. * `embeddingOrigin` String (opcional) - El origen del marco que incrusta el marco que hizo la verificación de permisos. Sólo se establece cross-origin submarcos haciendo comprobaciones de permisos. @@ -559,12 +559,12 @@ session.fromPartition('some-partition').setPermissionCheckHandler((webContents, * `handler` Función\ | null * `details` Object - * `deviceType` String - The type of device that permission is being requested on, can be `hid`. - * `origin` String - The origin URL of the device permission check. - * `device` [HIDDevice](structures/hid-device.md) - the device that permission is being requested for. - * `frame` [WebFrameMain](web-frame-main.md) - WebFrameMain checking the device permission. + * `deviceType` String - El tipo de dispositivo para el que se esta solicitando el permiso, puede ser `hid`. + * `origin` String - La URL de origen de verificación del permiso del dispositivo. + * `device` [HIDDevice](structures/hid-device.md) - El dispositivo para el que se está solicitando el permiso. + * `frame` [WebFrameMain](web-frame-main.md) - WebFrameMain comprobando el permiso del dispositivo. -Sets the handler which can be used to respond to device permission checks for the `session`. Returning `true` will allow the device to be permitted and `false` will reject it. To clear the handler, call `setDevicePermissionHandler(null)`. This handler can be used to provide default permissioning to devices without first calling for permission to devices (eg via `navigator.hid.requestDevice`). If this handler is not defined, the default device permissions as granted through device selection (eg via `navigator.hid.requestDevice`) will be used. Additionally, the default behavior of Electron is to store granted device permision through the lifetime of the corresponding WebContents. If longer term storage is needed, a developer can store granted device permissions (eg when handling the `select-hid-device` event) and then read from that storage with `setDevicePermissionHandler`. +Establece el manejador que puede ser usado para responder a las comprobaciones de permiso para la `session`. Devolver `true` permitirá que el dispositivo se permitido y `false` lo rechazará. Para borrar el manejador, llame a `setDevicePermissionHandler(null)`. Este manejador puede ser usado para proveer permisos por defecto a dispositivos sin solicitar primero el permiso a dispositivos (por ejemplo a través de `navigator.hid.requestDevice`). Si este manejador no esta difinido, los permisos por defecto para el dispositivos serán otorgados a través de la selección de dispositivo (por ejemplo a través de `navigator.hid.requestDevice`). Adicionalmente, el comportamiento por defecto de Electron es almacenar los permisos otorgados a dispositivos a través de toda la vida del correspondiente WebContents. Si se es necesario almacenarlo a más largo plazo, un desarrollador puede almacenar los permisos otorgados (por ejemplo, cuando se maneja el evento `select-hid-device`) y luego leerlo desde ese almacenamiento con `setDevicePermissionHandler`. ```javascript const { app, BrowserWindow } = require('electron') @@ -576,23 +576,23 @@ app.whenReady().then(() => { win.webContents.session.setPermissionCheckHandler((webContents, permission, requestingOrigin, details) => { if (permission === 'hid') { - // Add logic here to determine if permission should be given to allow HID selection + // Agregue la lógica aquí para determinar si el permiso debería ser dado para permitir la selección HID return true } return false }) - // Optionally, retrieve previously persisted devices from a persistent store + // Opcionalmente, recupere los dispositivos persistentes anteriormente de un almacén persistente const grantedDevices = fetchGrantedDevices() win.webContents.session.setDevicePermissionHandler((details) => { if (new URL(details.origin).hostname === 'some-host' && details.deviceType === 'hid') { if (details.device.vendorId === 123 && details.device.productId === 345) { - // Always allow this type of device (this allows skipping the call to `navigator.hid.requestDevice` first) + // Siempre permite este tipo de dispositivo (esto permite saltar la primera llamada a `navigator.hid.requestDevice`) return true } - // Search through the list of devices that have previously been granted permission + // Busque a través de la lista de dispositivos a los que anteriormente se le han otorgado permiso return grantedDevices.some((grantedDevice) => { return grantedDevice.vendorId === details.device.vendorId && grantedDevice.productId === details.device.productId && diff --git a/content/es-ES/docs/api/structures/hid-device.md b/content/es-ES/docs/api/structures/hid-device.md index fac2b6276a9df..71e6c3d54d3dd 100644 --- a/content/es-ES/docs/api/structures/hid-device.md +++ b/content/es-ES/docs/api/structures/hid-device.md @@ -1,8 +1,8 @@ -# HIDDevice Object +# Objecto HIDDevice -* `deviceId` String - Unique identifier for the device. -* `name` String - Name of the device. -* `vendorId` Integer - The USB vendor ID. -* `productId` Integer - The USB product ID. -* `serialNumber` String (optional) - The USB device serial number. -* `guid` String (optional) - Unique identifier for the HID interface. A device may have multiple HID interfaces. +* `deviceId` String - Identificador unico para el dispositivo. +* `name` String - Nombre del dispositivo. +* `vendorId` Integer - El ID del proveedor USB. +* `productId` Integer - El ID del producto USB. +* `serialNumber` String (opcional) - El número de serie del dispositivo USB. +* `guid` String (optional) - Identificador único para la interface del HID. Un dispositivo puede tener múltiples interfaces HID. diff --git a/content/es-ES/docs/api/web-contents.md b/content/es-ES/docs/api/web-contents.md index 598bf3f8ab1d1..fdd38cbd928ab 100644 --- a/content/es-ES/docs/api/web-contents.md +++ b/content/es-ES/docs/api/web-contents.md @@ -571,7 +571,7 @@ Devuelve: * `params` Object * `x` Integer - x coordinate. * `y` Integer - y coordinate. - * `frame` WebFrameMain - Frame from which the context menu was invoked. + * `frame` WebFrameMain - Frame desde el cual se invocó el menú contextual. * `linkURL` String - URL del enlace que incluye el nodo del menú contextual que fue invocado. * `linkText` String - Text associated with the link. May be an empty string if the contents of the link are an image. * `pageURL` String - URL de la parte superior del nivel de la página que se invocó en el menú del contexto. @@ -1610,8 +1610,8 @@ Finalizar suscripción para eventos de presentación de marcos. #### `contents.startDrag(item)` * Objeto `item` - * `file` String - The path to the file being dragged. - * `files` String[] (optional) - The paths to the files being dragged. (`files` will override `file` field) + * `file` String - La ruta al archivo que está siendo arrastrado. + * `files` String[] (opcional) - Las rutas a los archivos que están siendo arrastrados. (`files` anulará el campo `file`) * `icon` [NativeImage](native-image.md) | String - La imagen no debe estar vacía en on macOS. Configura el `item` como un elemento arrastrable para la operación drag-drop actual. El `file` es la ruta absoluta del archivo que se va a arrastrar, y `icon` es la imagen que se muestra debajo del cursor cuando se arrastra. diff --git a/content/fr-FR/docs/api/app.md b/content/fr-FR/docs/api/app.md index 702c0e76b2f4c..6b625697d38e4 100644 --- a/content/fr-FR/docs/api/app.md +++ b/content/fr-FR/docs/api/app.md @@ -866,7 +866,7 @@ Importe le certificat au format pkcs12 dans l'entrepôt de certificats de la pla * Objet `options` * `enableBuiltInResolver` Boolean (optional) - Whether the built-in host resolver is used in preference to getaddrinfo. When enabled, the built-in resolver will attempt to use the system's DNS settings to do DNS lookups itself. Enabled by default on macOS, disabled by default on Windows and Linux. - * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be peformed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". + * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be performed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". * `secureDnsServers` String[] (optional) - A list of DNS-over-HTTP server templates. See [RFC8484 § 3][] for details on the template format. Most servers support the POST method; the template for such servers is simply a URI. Note that for [some DNS providers][doh-providers], the resolver will automatically upgrade to DoH unless DoH is explicitly disabled, even if there are no DoH servers provided in this list. * `enableAdditionalDnsQueryTypes` Boolean (optional) - Controls whether additional DNS query types, e.g. HTTPS (DNS type 65) will be allowed besides the traditional A and AAAA queries when a request is being made via insecure DNS. Has no effect on Secure DNS which always allows additional types. Defaults to true. diff --git a/content/pt-BR/docs/api/app.md b/content/pt-BR/docs/api/app.md index 459dcda30bcfa..bb08d835b23eb 100644 --- a/content/pt-BR/docs/api/app.md +++ b/content/pt-BR/docs/api/app.md @@ -869,7 +869,7 @@ Importa o certificado em formato pkcs12 ao armazenamento de certificados da plat * `options` Object * `enableBuiltInResolver` Boolean (optional) - Whether the built-in host resolver is used in preference to getaddrinfo. When enabled, the built-in resolver will attempt to use the system's DNS settings to do DNS lookups itself. Enabled by default on macOS, disabled by default on Windows and Linux. - * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be peformed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". + * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be performed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". * `secureDnsServers` String[] (optional) - A list of DNS-over-HTTP server templates. See [RFC8484 § 3][] for details on the template format. Most servers support the POST method; the template for such servers is simply a URI. Note that for [some DNS providers][doh-providers], the resolver will automatically upgrade to DoH unless DoH is explicitly disabled, even if there are no DoH servers provided in this list. * `enableAdditionalDnsQueryTypes` Boolean (optional) - Controls whether additional DNS query types, e.g. HTTPS (DNS type 65) will be allowed besides the traditional A and AAAA queries when a request is being made via insecure DNS. Has no effect on Secure DNS which always allows additional types. Defaults to true. diff --git a/content/ru-RU/docs/api/app.md b/content/ru-RU/docs/api/app.md index db8686e809fc9..eb431f659ceca 100644 --- a/content/ru-RU/docs/api/app.md +++ b/content/ru-RU/docs/api/app.md @@ -869,7 +869,7 @@ Activation policy types: * `options` Object * `enableBuiltInResolver` Boolean (optional) - Whether the built-in host resolver is used in preference to getaddrinfo. When enabled, the built-in resolver will attempt to use the system's DNS settings to do DNS lookups itself. Enabled by default on macOS, disabled by default on Windows and Linux. - * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be peformed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". + * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be performed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". * `secureDnsServers` String[] (optional) - A list of DNS-over-HTTP server templates. See [RFC8484 § 3][] for details on the template format. Most servers support the POST method; the template for such servers is simply a URI. Note that for [some DNS providers][doh-providers], the resolver will automatically upgrade to DoH unless DoH is explicitly disabled, even if there are no DoH servers provided in this list. * `enableAdditionalDnsQueryTypes` Boolean (optional) - Controls whether additional DNS query types, e.g. HTTPS (DNS type 65) will be allowed besides the traditional A and AAAA queries when a request is being made via insecure DNS. Has no effect on Secure DNS which always allows additional types. Defaults to true. diff --git a/content/zh-CN/docs/api/app.md b/content/zh-CN/docs/api/app.md index 8f17e756c5b06..1b8319e11f631 100644 --- a/content/zh-CN/docs/api/app.md +++ b/content/zh-CN/docs/api/app.md @@ -869,7 +869,7 @@ if (!gotTheLock) { * `选项` 对象 * `enableBuiltInResolver` Boolean (optional) - Whether the built-in host resolver is used in preference to getaddrinfo. When enabled, the built-in resolver will attempt to use the system's DNS settings to do DNS lookups itself. Enabled by default on macOS, disabled by default on Windows and Linux. - * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be peformed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". + * `secureDnsMode` String (optional) - Can be "off", "automatic" or "secure". Configures the DNS-over-HTTP mode. When "off", no DoH lookups will be performed. When "automatic", DoH lookups will be performed first if DoH is available, and insecure DNS lookups will be performed as a fallback. When "secure", only DoH lookups will be performed. Defaults to "automatic". * `secureDnsServers` String[] (optional) - A list of DNS-over-HTTP server templates. See [RFC8484 § 3][] for details on the template format. Most servers support the POST method; the template for such servers is simply a URI. Note that for [some DNS providers][doh-providers], the resolver will automatically upgrade to DoH unless DoH is explicitly disabled, even if there are no DoH servers provided in this list. * `enableAdditionalDnsQueryTypes` Boolean (optional) - Controls whether additional DNS query types, e.g. HTTPS (DNS type 65) will be allowed besides the traditional A and AAAA queries when a request is being made via insecure DNS. Has no effect on Secure DNS which always allows additional types. 默认值为 true。 diff --git a/content/zh-CN/docs/api/menu.md b/content/zh-CN/docs/api/menu.md index 387f514e5a647..7c4c57f646512 100644 --- a/content/zh-CN/docs/api/menu.md +++ b/content/zh-CN/docs/api/menu.md @@ -65,164 +65,71 @@ * `positioningItem` Number (可选) _macOS_ - 在指定鼠标光标下定位的菜单项的索引。 默认值为 -1。 * `callback` Function (optional) - 会在菜单关闭后被调用. -将此菜单作为 browserWindow 中的上下文菜单弹出。

+弹出此菜单作为上下文菜单在 [`BrowserWindow`](browser-window.md)。 +#### `menu.closePopup([browserWindow])` +* `browserWindow` [BrowserWindow](browser-window.md) (可选) - 默认为选中窗口. -

- menu.closePopup([browserWindow]) -

+关闭 ` browserWindow ` 中的上下文菜单。 - +#### `menu.append(menuItem)` -

- 关闭 browserWindow 中的上下文菜单。 -

+* `menuItem` [菜单项](menu-item.md) +将 ` menuItem ` 追加到菜单。 +#### `menu.getMenuItemById(id)` -

- menu.append(menuItem) -

+* `id` String - +返回具有指定`id`项的`MenuItem | null` -

- 将 menuItem 追加到菜单。 -

+#### `menu.insert(pos, menuItem)` +* `pos` Integer +* `menuItem` [菜单项](menu-item.md) +将 ` menuItem ` 插入菜单的 ` pos ` 位置。 -

- menu.getMenuItemById(id) -

+### 实例事件 -
    -
  • - id String -
    • -
+使用 `new Menu` 创建对象或通过 `Menu.buildFromTemplate`返回对象均会触发下列事件： -

- 返回具有指定id项的MenuItem | null -

+** 注意: **某些事件仅在特定的操作系统上可用, 这些方法会被标记出来。 +#### 事件: 'menu-will-show' +返回: -

- menu.insert(pos, menuItem) -

+* `event` Event -
    -
  • - pos Integer -
    • -
  • - menuItem 菜单项 -
    • -
+调用`menu.popup()`事件时触发该事件。 -

- 将 menuItem 插入菜单的 pos 位置。 -

+#### 事件: 'menu-will-close' +返回: +* `event` Event -

- 实例事件 -

+手动关闭弹出，或使用 `menu.closePopup()`方法关闭弹出时，触发该事件。 -

- 使用 new Menu 创建对象或通过 Menu.buildFromTemplate返回对象均会触发下列事件： -

+### 实例属性 -

- 注意: 某些事件仅在特定的操作系统上可用, 这些方法会被标记出来。 -

+` menu ` 对象还具有以下属性: +#### `menu.items` +包含菜单项的 ` MenuItem [] ` 数组。 -

- 事件: 'menu-will-show' -

+每个 ` 菜单 ` 由多个 [` MenuItem `](menu-item.md) 组成, 每个 ` MenuItem `可以有子菜单。 -

- 返回: -

+## 示例 -
    -
  • - event Event -
    • -
+使用简单模板API创建 application menu 的示例代码： -

- 调用menu.popup()事件时触发该事件。 -

- - - -

- 事件: 'menu-will-close' -

- -

- 返回: -

- -
    -
  • - event Event -
    • -
- -

- 手动关闭弹出，或使用 menu.closePopup()方法关闭弹出时，触发该事件。 -

- - - -

- 实例属性 -

- -

- menu 对象还具有以下属性: -

- - - -

- menu.items -

- -

- 包含菜单项的 MenuItem [] 数组。 -

- -

- 每个 菜单 由多个 MenuItem 组成, 每个 MenuItem 可以有子菜单。 -

- - - -

- 示例 -

- -

- 使用简单模板API创建 application menu 的示例代码： -

- -
const { app, Menu } = require('electron')
+```javascript
+const { app, Menu } = require('electron')
 
 const isMac = process.platform === 'darwin'
 
@@ -314,7 +221,7 @@ const template = [
     submenu: [
       {
         label: 'Learn More',
-        click: async () => {
+        click: async () => {
           const { shell } = require('electron')
           await shell.openExternal('https://electronjs.org')
         }
@@ -325,38 +232,31 @@ const template = [
 
 const menu = Menu.buildFromTemplate(template)
 Menu.setApplicationMenu(menu)
-
+``` +### 渲染进程 +要创建由渲染器启动的菜单，请通过 IPC 发送所需的信息到主过程，并让主过程代替渲染器显示菜单。 -

- 渲染进程 -

+以下是用户右键单击页面时显示菜单的示例： -

- 要创建由渲染器启动的菜单，请通过 IPC 发送所需的信息到主过程，并让主过程代替渲染器显示菜单。 -

- -

- 以下是用户右键单击页面时显示菜单的示例： -

- -
// renderer
-window.addEventListener('contextmenu', (e) => {
+```js
+// renderer
+window.addEventListener('contextmenu', (e) => {
   e.preventDefault()
   ipcRenderer.send('show-context-menu')
 })
 
-ipcRenderer.on('context-menu-command', (e, command) => {
+ipcRenderer.on('context-menu-command', (e, command) => {
   // ...
 })
 
 // main
-ipcMain.on('show-context-menu', (event) => {
+ipcMain.on('show-context-menu', (event) => {
   const template = [
     {
       label: 'Menu Item 1',
-      click: () => { event.sender.send('context-menu-command', 'menu-item-1') }
+      click: () => { event.sender.send('context-menu-command', 'menu-item-1') }
     },
     { type: 'separator' },
     { label: 'Menu Item 2', type: 'checkbox', checked: true }
@@ -364,140 +264,69 @@ ipcMain.on('show-context-menu', (event) => {
   const menu = Menu.buildFromTemplate(template)
   menu.popup(BrowserWindow.fromWebContents(event.sender))
 })
-
- - - -

- MacOS中应用菜单注意事项 -

- -

- macOS 相比于 Windows 和 Linux 有着完全不同的应用程序菜单。 以下是一些有关使应用菜单更像原生应用菜单的注意事项。 -

- - - -

- 标准菜单 -

- -

- MacOS有一些系统预定义的菜单，像是Services and Windows。 让你的菜单更像MacOS标准菜单，只需设置菜单role值为如下示之一，Electron便会自动认出并设置成标准菜单，： -

+``` -
    -
  • - window -
    • -
  • - help -
    • -
  • - services -
    • -
+## MacOS中应用菜单注意事项 +macOS 相比于 Windows 和 Linux 有着完全不同的应用程序菜单。 以下是一些有关使应用菜单更像原生应用菜单的注意事项。 +### 标准菜单 -

- 标准菜单项操作 -

+MacOS有一些系统预定义的菜单，像是[`Services`](https://developer.apple.com/documentation/appkit/nsapplication/1428608-servicesmenu?language=objc) and `Windows`。 让你的菜单更像MacOS标准菜单，只需设置菜单`role`值为如下示之一，Electron便会自动认出并设置成标准菜单，： -

- macOS 已经为某些菜单项提供了标准操作, 如 about xxx 、 Hide xxx 和 Hide Others 。 若要将菜单项的操作设置为标准操作, 应设置菜单项的 role 属性。 -

+* `window` +* `help` +* `services` +### 标准菜单项操作 +macOS 已经为某些菜单项提供了标准操作, 如 ` about xxx `、` Hide xxx ` 和 ` Hide Others `。 若要将菜单项的操作设置为标准操作, 应设置菜单项的 ` role` 属性。 -

- 主菜单的名称 -

+### 主菜单的名称 -

- 在 macOS 中应用程序菜单的第一个项目的标签总是你的应用程序的名字, 无论你设置什么标签。 如要更改它, 请修改应用程序包的 Info. plist 文件。 详情参阅：About Information Property List Files -

+在 macOS 中应用程序菜单的第一个项目的标签总是你的应用程序的名字, 无论你设置什么标签。 如要更改它, 请修改应用程序包的 ` Info. plist ` 文件。 详情参阅：[About Information Property List Files][AboutInformationPropertyListFiles] +## 设置特定浏览器窗口的菜单 (* Linux * * Windows *) +浏览器窗口的 [ ` setMenu ` 方法 ][setMenu] 可以设置特定浏览器窗口的菜单。 -

- 设置特定浏览器窗口的菜单 ( Linux Windows ) -

+## 菜单项位置 -

- 浏览器窗口的 setMenu 方法 可以设置特定浏览器窗口的菜单。 -

+你可以使用 `before`, `after`, `beforeGroupContaining`, `afterGroupContaining` 和 `id` 来控制由 `Menu.buildFromTemplate` 生成的菜单项的位置. +* `before` - 在指定的标签之前插入菜单项。 如果引用值不存在，那么该菜单项会插在这个菜单的尾部。 这还意味着，菜单项应该被放置在与引用项相同的组中。 +* `after` - 在指定的标签之后插入菜单项。 如果引用值不存在，那么该菜单项会插在这个菜单的尾部。 这还意味着，菜单项应该被放置在与引用项相同的组中。 +* `beforeGroupContaining` - 为单个上下文菜单提供一种方法，用于在具有指定标签项的包含组之前声明其包含组的位置 +* `afterGroupContaining` - 为单个上下文菜单提供一种方法，用于在具有指定标签项的包含组之后声明其包含组的位置 +默认情况下，除非有位置相关的属性，所有的菜单项会按照模板中的顺序排放。 -

- 菜单项位置 -

+### 示例 -

- 你可以使用 before, after, beforeGroupContaining, afterGroupContaining 和 id 来控制由 Menu.buildFromTemplate 生成的菜单项的位置. -

+模板： -
    -
  • -

    - before - 在指定的标签之前插入菜单项。 如果引用值不存在，那么该菜单项会插在这个菜单的尾部。 这还意味着，菜单项应该被放置在与引用项相同的组中。 -

    -
    • -
  • -

    - after - 在指定的标签之后插入菜单项。 如果引用值不存在，那么该菜单项会插在这个菜单的尾部。 这还意味着，菜单项应该被放置在与引用项相同的组中。 -

    -
    • -
  • -

    - beforeGroupContaining - 为单个上下文菜单提供一种方法，用于在具有指定标签项的包含组之前声明其包含组的位置 -

    -
    • -
  • -

    - afterGroupContaining - 为单个上下文菜单提供一种方法，用于在具有指定标签项的包含组之后声明其包含组的位置 -

    -
    • -
- -

- 默认情况下，除非有位置相关的属性，所有的菜单项会按照模板中的顺序排放。 -

- - - -

- 示例 -

- -

- 模板： -

- -
[
+```javascript
+[
   { id: '1', label: 'one' },
   { id: '2', label: 'two' },
   { id: '3', label: 'three' },
   { id: '4', label: 'four' }
 ]
-
+``` -

- 菜单: -

+菜单: -
- 1
+```sh
+- 1
 - 2
 - 3
 - 4
-
+``` -

- 模板： -

+模板： -
[
+```javascript
+[
   { id: '1', label: 'one' },
   { type: 'separator' },
   { id: '3', label: 'three', beforeGroupContaining: ['1'] },
@@ -505,37 +334,37 @@ ipcMain.on('show-context-menu', (event) => {
   { type: 'separator' },
   { id: '2', label: 'two' }
 ]
-
+``` -

- 菜单: -

+菜单: -
- 3
+```sh
+- 3
 - 4
 - ---
 - 1
 - ---
 - 2
-
+``` -

- 模板： -

+模板： -
[
+```javascript
+[
   { id: '1', label: 'one', after: ['3'] },
   { id: '2', label: 'two', before: ['1'] },
   { id: '3', label: 'three' }
 ]
-
+``` -

- 菜单: -

+菜单: -
- ---
+```sh
+- ---
 - 3
 - 2
 - 1
-
+``` + +[AboutInformationPropertyListFiles]: https://developer.apple.com/library/ios/documentation/general/Reference/InfoPlistKeyReference/Articles/AboutInformationPropertyListFiles.html +[setMenu]: browser-window.md#winsetmenumenu-linux-windows diff --git a/content/zh-CN/docs/api/session.md b/content/zh-CN/docs/api/session.md index 0eb0c5f22d503..8a2aa1493547f 100644 --- a/content/zh-CN/docs/api/session.md +++ b/content/zh-CN/docs/api/session.md @@ -6,7 +6,7 @@ ` session ` 模块可用于创建新的 ` session ` 对象。 -你还可以使用[`WebContents`](web-contents.md)的`session`属性或` session`模块访问现有页的`session` +您还可以通过使用 `WebContents` 的 `session` 属性或从 `session` 模块访问现有页面的 <0>session。 ```javascript const { BrowserWindow } = require('electron') @@ -68,9 +68,9 @@ console.log(ses.getUserAgent()) * `item` [DownloadItem](download-item.md) * `webContents` [WebContents](web-contents.md) -当 Electron 刚要在`webContents`中下载`item<0>的时候触发。

+当 Electron 刚要在`webContents`中下载`item`的时候触发。 -

调用event.preventDefault()`方法，将会停止下载，并且在进程的next tick中，`item`将不再可用。 +调用`event.preventDefault()`方法，将会停止下载，并且在进程的next tick中，`item`将不再可用。 ```javascript const { session } = require('electron') @@ -820,9 +820,9 @@ A `String | null` indicating the absolute file system path where data for this s ### 实例属性 -以下属性在` Session 实例上可用：

+以下属性在` Session `实例上可用： -

ses.availableSpellCheckerLanguages` _只读_

+#### `ses.availableSpellCheckerLanguages` _只读_ A `String[]` array which consists of all the known available spell checker languages. Providing a language code to the `setSpellCheckerLanguages` API that isn't in this array will result in an error. diff --git a/content/zh-CN/docs/api/webview-tag.md b/content/zh-CN/docs/api/webview-tag.md index d3ba63211df26..9988fd58b80c1 100644 --- a/content/zh-CN/docs/api/webview-tag.md +++ b/content/zh-CN/docs/api/webview-tag.md @@ -2,7 +2,7 @@ ## 警告 -Electron的 `webview` 标签基于 [Chromium webview ][chrome-webview]，后者正在经历巨大的架构变化。 这将影响 `webview` 的稳定性，包括呈现、导航和事件路由。 我们目前建议不使用 `webview` 标签，并考虑其他替代方案，如 `iframe` ，[Electron的 `BrowserView`](browser-view.md) 或完全避免嵌入内容的架构。 +Electron的 `webview` 标签基于 [Chromium `webview` ][chrome-webview]，后者正在经历巨大的架构变化。 这将影响 `webview` 的稳定性，包括呈现、导航和事件路由。 我们目前建议不使用 `webview` 标签，并考虑其他替代方案，如 `iframe` ，[Electron的 `BrowserView`](browser-view.md) 或完全避免嵌入内容的架构。 ## 启用 @@ -20,7 +20,7 @@ Process: [Renderer](../glossary.md#renderer-process)
_This class is not ex ## 示例 -若要在应用程序中嵌入网页, 请将 ` webview ` 标签添加到应用程序的被嵌入页面中 (这是将显示外来内容的应用程序页)。 在最简单的例子中, ` webview ` 标签包括网页的 ` src ` 和控制 ` webview ` 容器外观的 css 样式: +若要在应用程序中嵌入网页, 请将 `webview` 标签添加到应用程序的被嵌入页面中 (这是将显示外来内容的应用程序页)。 在最简单的例子中, `webview` 标签包括网页的 `src` 和控制 `webview` 容器外观的 css 样式: ```html @@ -60,7 +60,7 @@ Process: [Renderer](../glossary.md#renderer-process)
_This class is not ex ## CSS 样式说明 -请注意，`webview` 标签的样式使用 `display:flex;` 来确保 ` iframe `在传统和 flex 布局一起使用的情况下填充其 `webview` 容器的全部高度和宽度。 除非指定内联布局的 `display:inline-flex;` ，否则请不要 覆盖默认 `display:flex;` CSS属性。 +请注意，`webview` 标签的样式使用 `display:flex;` 来确保 `iframe`在传统和 flex 布局一起使用的情况下填充其 `webview` 容器的全部高度和宽度。 除非指定内联布局的 `display:inline-flex;` ，否则请不要 覆盖默认 `display:flex;` CSS属性。 ## 标签属性 diff --git a/content/zh-CN/docs/tutorial/web-embeds.md b/content/zh-CN/docs/tutorial/web-embeds.md index 326afb45a5c02..b2d7a0e80d187 100644 --- a/content/zh-CN/docs/tutorial/web-embeds.md +++ b/content/zh-CN/docs/tutorial/web-embeds.md @@ -2,20 +2,14 @@ ## 概览 -有三种方式可以让你在Electron的BrowserWindow里集成（第三方）web内容，`