diff --git a/content/de-DE/docs/api/dialog.md b/content/de-DE/docs/api/dialog.md index dfd2f7cc36308..c647d5266c2ea 100644 --- a/content/de-DE/docs/api/dialog.md +++ b/content/de-DE/docs/api/dialog.md @@ -23,7 +23,7 @@ Das `dialog` module hat die folgenden Methoden: * `defaultPath` String (optional) * `buttonLabel` String (optional) - Custom label für den Bestätigen-Button. Wenn leer gelassen, dann wird das default label verwendet. * `filters` [FileFilter[]](structures/file-filter.md) (optional) - * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: + * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: * `openFile` - Erlaubt die Auswahl von Dateien. * `openDirectory` - Erlaubt die Auswahl von Verzeichnissen. * `multiSelections` - Erlaubt die Auswahl mehrerer Pfade. @@ -71,7 +71,7 @@ dialog.showOpenDialogSync(mainWindow, { * `defaultPath` String (optional) * `buttonLabel` String (optional) - Custom label für den Bestätigen-Button. Wenn leer gelassen, dann wird das default label verwendet. * `filters` [FileFilter[]](structures/file-filter.md) (optional) - * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: + * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: * `openFile` - Erlaubt die Auswahl von Dateien. * `openDirectory` - Erlaubt die Auswahl von Verzeichnissen. * `multiSelections` - Erlaubt die Auswahl mehrerer Pfade. @@ -88,7 +88,7 @@ Returns `Promise` - Resolve with an object containing the following: * `canceled` Boolean - whether or not the dialog was canceled. * `filePaths` String[] - An array of file paths chosen by the user. If the dialog is cancelled this will be an empty array. -* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. `securityScopedBookmarks` must be enabled for this to be populated. (For return values, see [table here](#bookmarks-array).) +* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. `securityScopedBookmarks` must be enabled for this to be populated. (For return values, see [table here](#bookmarks-array).) The `browserWindow` argument allows the dialog to attach itself to a parent window, making it modal. @@ -131,7 +131,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (optional) _macOS_ - Message to display above text fields. * `nameFieldLabel` String (optional) _macOS_ - Custom label for the text displayed in front of the filename text field. * `showsTagField` Boolean (optional) _macOS_ - Show the tags input box, defaults to `true`. - * `properties` String[] (optional) + * `properties` String[] (optional) * `showHiddenFiles` - Zeige versteckte Dateien im Dialog. * `createDirectory` _macOS_ - Erlaube das Erstellen neuer Verzeichnisse im Dialog. * `treatPackageAsDirectory` _macOS_ - Treat packages, such as `.app` folders, as a directory instead of a file. @@ -156,7 +156,7 @@ The `filters` specifies an array of file types that can be displayed, see `dialo * `message` String (optional) _macOS_ - Message to display above text fields. * `nameFieldLabel` String (optional) _macOS_ - Custom label for the text displayed in front of the filename text field. * `showsTagField` Boolean (optional) _macOS_ - Show the tags input box, defaults to `true`. - * `properties` String[] (optional) + * `properties` String[] (optional) * `showHiddenFiles` - Zeige versteckte Dateien im Dialog. * `createDirectory` _macOS_ - Erlaube das Erstellen neuer Verzeichnisse im Dialog. * `treatPackageAsDirectory` _macOS_ - Treat packages, such as `.app` folders, as a directory instead of a file. @@ -182,7 +182,7 @@ The `filters` specifies an array of file types that can be displayed, see `dialo * `options` Object * `message` String - Content of the message box. * `type` String (optional) - Can be `"none"`, `"info"`, `"error"`, `"question"` or `"warning"`. On Windows, `"question"` displays the same icon as `"info"`, unless you set an icon using the `"icon"` option. On macOS, both `"warning"` and `"error"` display the same warning icon. - * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". + * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". * `defaultId` Integer (optional) - Index of the button in the buttons array which will be selected by default when the message box opens. * `title` String (optional) - Title of the message box, some platforms will not show it. * `detail` String (optional) - Extra information of the message. @@ -205,7 +205,7 @@ The `browserWindow` argument allows the dialog to attach itself to a parent wind * `options` Object * `message` String - Content of the message box. * `type` String (optional) - Can be `"none"`, `"info"`, `"error"`, `"question"` or `"warning"`. On Windows, `"question"` displays the same icon as `"info"`, unless you set an icon using the `"icon"` option. On macOS, both `"warning"` and `"error"` display the same warning icon. - * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". + * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". * `defaultId` Integer (optional) - Index of the button in the buttons array which will be selected by default when the message box opens. * `title` String (optional) - Title of the message box, some platforms will not show it. * `detail` String (optional) - Extra information of the message. diff --git a/content/de-DE/docs/tutorial/security.md b/content/de-DE/docs/tutorial/security.md index f8e747925d27a..198404ba8e414 100644 --- a/content/de-DE/docs/tutorial/security.md +++ b/content/de-DE/docs/tutorial/security.md @@ -78,8 +78,13 @@ browserWindow.loadURL('http://example.com') browserWindow.loadURL('https://example.com') ``` -```html - +```html + + + + + + ``` @@ -120,7 +125,12 @@ const mainWindow = new BrowserWindow({ mainWindow.loadURL('https://example.com') ``` -```html +```html + + + + + ``` Wenn Sie die Node.js-Integration deaktivieren, können Sie trotzdem APIs Ihrer Website aussetzen, die Node.js Module oder Funktionen verbrauchen. Skripte vor dem Laden haben weiterhin Zugriff auf auf `erfordern` und andere Knoten. s Features, die es Entwicklern erlauben, eine benutzerdefinierte API für aus der Ferne geladene Inhalte freizugeben. @@ -209,7 +219,12 @@ const mainWindow = new BrowserWindow({ const mainWindow = new BrowserWindow() ``` -```html +```html + + + + + ``` ## 6) Definieren Sie eine Inhaltssicherheitsrichtlinie @@ -349,7 +364,12 @@ If you do not need popups, you are better off not allowing the creation of new [ ### Wie? -```html +```html + + + + + ``` ## 11) WebView-Optionen vor der Erstellung überprüfen diff --git a/content/es-ES/docs/api/dialog.md b/content/es-ES/docs/api/dialog.md index 9ae61131e9ffc..cb0ecbde8c288 100644 --- a/content/es-ES/docs/api/dialog.md +++ b/content/es-ES/docs/api/dialog.md @@ -23,7 +23,7 @@ El módulo `dialogo` tiene los siguientes métodos: * `defaultPath` Cadena (optional) * `buttonLabel` cadena (optional) - Etiqueta predeterminada para el botón de confirmación, cuando esta se deja vacía la etiqueta predeterminada será usada. * `filters` [FileFilter[]](structures/file-filter.md) (optional) - * `properties` String[] (opcional) - Contiene cuales características del dialog que debe usar. Los siguientes valores son soportados: + * `properties` String[] (optional) - Contains which features the dialog should use. Los siguientes valores son soportados: * `openFile` - Le permite a los archivos ser seleccionados. * `openDirectory` - Le permite a los directorios ser seleccionados. * `multiSelections` - Permite que varios caminos sean seleccionados. @@ -71,7 +71,7 @@ dialog.showOpenDialogSync(mainWindow, { * `defaultPath` Cadena (optional) * `buttonLabel` cadena (optional) - Etiqueta predeterminada para el botón de confirmación, cuando esta se deja vacía la etiqueta predeterminada será usada. * `filters` [FileFilter[]](structures/file-filter.md) (optional) - * `properties` String[] (opcional) - Contiene cuales características del dialog que debe usar. Los siguientes valores son soportados: + * `properties` String[] (optional) - Contains which features the dialog should use. Los siguientes valores son soportados: * `openFile` - Le permite a los archivos ser seleccionados. * `openDirectory` - Le permite a los directorios ser seleccionados. * `multiSelections` - Permite que varios caminos sean seleccionados. @@ -88,7 +88,7 @@ Devuelve `Promise` - Resuelve con un objeto conteniendo lo siguiente: * `canceled` Boolean - si el diálogo fue o no cancelado. * `filePaths` Cadena[] - Un arreglo del camino de archivos elegido por el usuario. Si es dialog es cancelado esto será un array vacío. -* `bookmarks` String[] (opcional) _macOS_ _mas_ - Un array que coincide con el array `filePaths` de cadenas codificadas en base64 que contiene datos de seguridad del marcador de ambito. `securityScopedBookmarks` debe estar activado para ser poblado. (Para devolver valores, vea [tabla aquí](#bookmarks-array).) +* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. `securityScopedBookmarks` debe estar activado para ser poblado. (Para devolver valores, vea [tabla aquí](#bookmarks-array).) El argumento de `browserWindow` permite el diálogo a adjuntarse a una ventana parental, haciéndola una modalidad. @@ -131,7 +131,7 @@ dialog.showOpenDialog(mainWindow, { * `message` Cadena (opcional) _macOS_ - Mensaje a mostrar por encima de los campos de texto. * `nameFieldLabel` Cadena (opcional) _macOS_ - Etiqueta personalizada para el texto mostrado en frente al nombre del archivo del campo de texto. * `showsTagField` Boolean (opcional) _macOS_ - Muestra las etiquetas de las cajas de entrada, por defecto a `true`. - * `properties` String[] (opcional) + * `properties` String[] (optional) * `showHiddenFiles` - Muestra archivos ocultos en diálogo. * `createDirectory` _macOS_- Permite crear nuevos directorios a partir del diálogo. * `treatPackageAsDirectory` _macOS_ - Trata paquetes como carpetas `.app`, como un directorio en vez de como un fichero. @@ -156,7 +156,7 @@ Los `filtros` especifican un arreglo de los tipos de archivos can pueden ser mos * `message` Cadena (opcional) _macOS_ - Mensaje a mostrar por encima de los campos de texto. * `nameFieldLabel` Cadena (opcional) _macOS_ - Etiqueta personalizada para el texto mostrado en frente al nombre del archivo del campo de texto. * `showsTagField` Boolean (opcional) _macOS_ - Muestra las etiquetas input box, por defecto `true`. - * `properties` String[] (opcional) + * `properties` String[] (optional) * `showHiddenFiles` - Muestra archivos ocultos en diálogo. * `createDirectory` _macOS_- Permite crear nuevos directorios a partir del diálogo. * `treatPackageAsDirectory` _macOS_ - Trata paquetes como carpetas `.app`, como un directorio en vez de como un fichero. @@ -182,7 +182,7 @@ Los `filtros` especifican un arreglo de los tipos de archivos can pueden ser mos * `options` Object * `message` Cadena - Contenido de la caja de mensaje. * `type` Cadena (opcional) - Puede ser `"none"`, `"info"`, `"error"`, `"question"` o `"warning"`. En Windows, `"question"` muestra el mismo icono que `"info"`, a menos que tu dispongas un icono usando la opción `"icon"`. En macOS, tanto `"warning"` como `"error"` muestran el mismo icono de peligro. - * `buttons` String[] (opcional) - Array de textos para los botones. En Windows, un array vacío resultará en un botón con al etiqueta "OK". + * `buttons` String[] (optional) - Array of texts for buttons. En Windows, un array vacío resultará en un botón con al etiqueta "OK". * `defaultId` Íntegro (opcional) - El índice del botón en el arreglo de los botones, el cual será selecto por defecto cuando el mensaje de la caja se abra. * `title` Cadena (opcional) - Título del mensaje de la caja, algunas plataformas no se mostrarán. * `detail` Cadena (opcional) - Información extra del mensaje. @@ -205,7 +205,7 @@ El argumento de `browserWindow` permite el diálogo a adjuntarse a una ventana p * `options` Object * `message` Cadena - Contenido de la caja de mensaje. * `type` Cadena (opcional) - Puede ser `"none"`, `"info"`, `"error"`, `"question"` o `"warning"`. En Windows, `"question"` muestra el mismo icono que `"info"`, a menos que tu dispongas un icono usando la opción `"icon"`. En macOS, tanto `"warning"` como `"error"` muestran el mismo icono de peligro. - * `buttons` String[] (opcional) - Array de textos para los botones. En Windows, un array vacío resultará en un botón con al etiqueta "OK". + * `buttons` String[] (optional) - Array of texts for buttons. En Windows, un array vacío resultará en un botón con al etiqueta "OK". * `defaultId` Íntegro (opcional) - El índice del botón en el arreglo de los botones, el cual será selecto por defecto cuando el mensaje de la caja se abra. * `title` Cadena (opcional) - Título del mensaje de la caja, algunas plataformas no se mostrarán. * `detail` Cadena (opcional) - Información extra del mensaje. diff --git a/content/es-ES/docs/tutorial/security.md b/content/es-ES/docs/tutorial/security.md index b6f98017c5534..90267bba15325 100644 --- a/content/es-ES/docs/tutorial/security.md +++ b/content/es-ES/docs/tutorial/security.md @@ -125,7 +125,12 @@ const mainWindow = new BrowserWindow({ mainWindow.loadURL('https://example.com') ``` -```html +```html + + + + + ``` Cuando desactivas la integración Node.js, todavía puedes exponer APIs a tu página web que consume módulos Node.js o características. Guiones precargados continúan teniendo acceso a `require` y otras características de Node.js, permitiendo que los desarrolladores expongan un API personalizado para cargar contenido de manera remota. diff --git a/content/fr-FR/docs/api/dialog.md b/content/fr-FR/docs/api/dialog.md index ba89c903a4369..04965d070f13b 100644 --- a/content/fr-FR/docs/api/dialog.md +++ b/content/fr-FR/docs/api/dialog.md @@ -23,7 +23,7 @@ Le module `dialog` dispose des méthodes suivantes : * `defaultPath` String (facultatif) * `buttonLabel` String (facultatif) - Étiquette personnalisé pour le bouton de confirmation. Si laissé vide, l'étiquette par défaut sera utilisé. * `filters` [FileFilter[]](structures/file-filter.md) (facultatif) - * `propriétés` String[] (facultatif) - Contient les fonctionnalités que la boîte de dialogue utilise. Les valeurs suivantes sont prises en charge : + * `properties` String[] (optional) - Contains which features the dialog should use. Les valeurs suivantes sont prises en charge : * `openFile` - Permet la sélection de fichiers. * `openDirectory` - Permet la sélection de dossiers. * `multiSelections` - Permet la sélection de multiples chemins. @@ -71,7 +71,7 @@ dialog.showOpenDialogSync(mainWindow, { * `defaultPath` String (facultatif) * `buttonLabel` String (facultatif) - Étiquette personnalisé pour le bouton de confirmation. Si laissé vide, l'étiquette par défaut sera utilisé. * `filters` [FileFilter[]](structures/file-filter.md) (facultatif) - * `propriétés` String[] (facultatif) - Contient les fonctionnalités que la boîte de dialogue utilise. Les valeurs suivantes sont prises en charge : + * `properties` String[] (optional) - Contains which features the dialog should use. Les valeurs suivantes sont prises en charge : * `openFile` - Permet la sélection de fichiers. * `openDirectory` - Permet la sélection de dossiers. * `multiSelections` - Permet la sélection de multiples chemins. @@ -88,7 +88,7 @@ Retourne `Promise` - Résoudre avec un objet contenant les éléments su * `annulé` Booléen - que la boîte de dialogue ait été annulée ou non. * `filePaths` String[] - Un tableau de chemins d'accès choisi par l'utilisateur. If the dialog is cancelled this will be an empty array. -* `signets` String[] (facultatif) _macOS_ _mas_ - Un tableau correspondant au tableau `filePaths` de chaînes encodées en base64 qui contient des données de marque-pages à portée de sécurité. `securityScopedBookmarks` doit être activé pour que ceci soit rempli. (Pour les valeurs de retour, voir la [table ici](#bookmarks-array).) +* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. `securityScopedBookmarks` doit être activé pour que ceci soit rempli. (Pour les valeurs de retour, voir la [table ici](#bookmarks-array).) L'argument `browserWindow` permet à la boîte de dialogue de s'attacher elle-même à la fenêtre parent, la rendant modale. @@ -131,7 +131,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (facultatif) _macOS_ - Message à afficher au-dessus des champs de texte. * `nameFieldLabel` String (facultatif) _macOS_ - Étiquette personnalisé pour le texte affiché dans la zone de texte du nom de fichier. * `showsTagField` Boolean (facultatif) _macOS_ - Affiche le champ de texte. `true` par défaut. - * `properties` String[] (optionnelle) + * `properties` String[] (optional) * `showHiddenFiles` - Affiche les fichiers cachés dans la boîte de dialogue. * `createDirectory` _macOS_ - Permet la création de nouveaux dossiers depuis la boîte de dialogue. * `treatPackageAsDirectory` _macOS_ - Considérer les paquets, tels que les dossiers `.app`, comme des dossiers plutôt que des fichiers. @@ -156,7 +156,7 @@ Les `filters` spécifie un tableau de types de fichiers qui peuvent être affich * `message` String (facultatif) _macOS_ - Message à afficher au-dessus des champs de texte. * `nameFieldLabel` String (facultatif) _macOS_ - Étiquette personnalisé pour le texte affiché dans la zone de texte du nom de fichier. * `showsTagField` Boolean (facultatif) _macOS_ - Affiche le champ de texte, par défaut à `true`. - * `properties` String[] (optionnelle) + * `properties` String[] (optional) * `showHiddenFiles` - Affiche les fichiers cachés dans la boîte de dialogue. * `createDirectory` _macOS_ - Permet la création de nouveaux dossiers depuis la boîte de dialogue. * `treatPackageAsDirectory` _macOS_ - Considérer les paquets, tels que les dossiers `.app`, comme des dossiers plutôt que des fichiers. @@ -182,7 +182,7 @@ Les `filters` spécifie un tableau de types de fichiers qui peuvent être affich * Objet `options` * `message` Chaîne - Contenu de la boîte de message. * `type` String (facultatif) - Peut être `"none"`, `"info"`, `"error"`, `"question"` ou `"warning"`. Sur Windows, `"question"` affiche la même icône que `"info"`, sauf si vous définissez une icône en utilisant l'option `"icône"`. Sur macOS, `"avertissement"` et `"erreur"` affichent la même icône d'avertissement. - * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". + * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". * `defaultId` Integer (facultatif) - Index du bouton dans le tableau des boutons qui seront sélectionnés par défaut lorsque la boîte de message s'ouvrira. * `title` String (facultatif) - Titre de la boîte de message, certaines plateformes ne l'afficheront pas. * `detail` String (facultatif) - Informations supplémentaires du message. @@ -205,7 +205,7 @@ L'argument `browserWindow` permet à la boîte de dialogue de s'attacher elle-m * Objet `options` * `message` Chaîne - Contenu de la boîte de message. * `type` String (facultatif) - Peut être `"none"`, `"info"`, `"error"`, `"question"` ou `"warning"`. Sur Windows, `"question"` affiche la même icône que `"info"`, sauf si vous définissez une icône en utilisant l'option `"icône"`. Sur macOS, `"avertissement"` et `"erreur"` affichent la même icône d'avertissement. - * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". + * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". * `defaultId` Integer (facultatif) - Index du bouton dans le tableau des boutons qui seront sélectionnés par défaut lorsque la boîte de message s'ouvrira. * `title` String (facultatif) - Titre de la boîte de message, certaines plateformes ne l'afficheront pas. * `detail` String (facultatif) - Informations supplémentaires du message. diff --git a/content/fr-FR/docs/tutorial/quick-start.md b/content/fr-FR/docs/tutorial/quick-start.md index 8e6f1df309f86..6b1d6c322f4de 100644 --- a/content/fr-FR/docs/tutorial/quick-start.md +++ b/content/fr-FR/docs/tutorial/quick-start.md @@ -1,6 +1,6 @@ # Démarrage Rapide -Ce guide vous guidera dans le processus de création d'une application Hello World dans Electron, similaire à [`electron/electron-quick-start`][quick-start]. +Ce tutoriel vous guidera dans le processus de création d'une application Hello World dans Electron, similaire à [`electron/electron-quick-start`][quick-start]. À la fin de ce tutoriel, votre application ouvrira une fenêtre de navigateur qui affichera une page web avec des informations sur quelles versions de Chromium, de Node.js et d'Electron sont en cours d'exécution. @@ -346,7 +346,10 @@ window.addEventListener('DOMContentLoaded', () => {

Hello World!

Nous utilisons Node.js , Chromium , - et Electron . + et Electron . + + + ``` diff --git a/content/fr-FR/docs/tutorial/repl.md b/content/fr-FR/docs/tutorial/repl.md index 0d114de644ac2..e380503f34bf4 100644 --- a/content/fr-FR/docs/tutorial/repl.md +++ b/content/fr-FR/docs/tutorial/repl.md @@ -2,7 +2,7 @@ [Read-Eval-Print-Loop](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop) (REPL) is a simple, interactive computer programming environment that takes single user inputs (i.e. single expressions), evaluates them, and returns the result to the user. -## Main process +## Processus principal Electron exposes the [Node.js `repl` module](https://nodejs.org/dist/latest/docs/api/repl.html) through the `--interactive` CLI flag. Assuming you have `electron` installed as a local project dependency, you should be able to access the REPL with the following command: diff --git a/content/fr-FR/docs/tutorial/security.md b/content/fr-FR/docs/tutorial/security.md index 635353c2150ef..d7f55e9428264 100644 --- a/content/fr-FR/docs/tutorial/security.md +++ b/content/fr-FR/docs/tutorial/security.md @@ -78,8 +78,13 @@ browserWindow.loadURL('http://example.com') browserWindow.loadURL('https://example.com') ``` -```html - +```html + + + + + + ``` @@ -120,7 +125,12 @@ const mainWindow = new BrowserWindow({ mainWindow.loadURL('https://example.com') ``` -```html +```html + + + + + ``` Lors de la désactivation de l'intégration de Node.js, vous pouvez toujours exposer des API à votre site web qui consomment des modules ou des fonctionnalités de Node.js. Les scripts de préchargement continuent d'avoir accès à `require` et aux autres fonctionnalités de Node.js, permettant aux développeurs d'exposer une API personnalisée au contenu chargé à distance. @@ -209,7 +219,12 @@ const mainWindow = new BrowserWindow({ const mainWindow = new BrowserWindow() ``` -```html +```html + + + + + ``` ## 6) Définir une politique de sécurité de contenu @@ -349,7 +364,12 @@ Si vous n'avez pas besoin de popups, il vaut mieux ne pas autoriser la création ### Comment ? -```html +```html + + + + + ``` ## 11) Vérifiez les options de WebView avant la création diff --git a/content/ja-JP/docs/api/dialog.md b/content/ja-JP/docs/api/dialog.md index 04755735f6bde..e7b752faf9233 100644 --- a/content/ja-JP/docs/api/dialog.md +++ b/content/ja-JP/docs/api/dialog.md @@ -23,7 +23,7 @@ console.log(dialog.showOpenDialog({ properties: ['openFile', 'multiSelections'] * `defaultPath` String (任意) * `buttonLabel` String (任意) - 確認ボタンのカスタムラベル。空のままにすると、既定のラベルが使用されます。 * `filters` [FileFilter[]](structures/file-filter.md) (任意) - * `properties` String[] (任意) - ダイアログが使うべきでない機能を含む。 以下の値がサポートされています: + * `properties` String[] (任意) - ダイアログが使うべきでない機能が入ります。 以下の値がサポートされています: * `openFile` - ファイルを選択するのを許可します。 * `openDirectory` - ディレクトリを選択するのを許可します。 * `multiSelections` - 複数のパスを選択するのを許可します。 @@ -71,7 +71,7 @@ dialog.showOpenDialogSync(mainWindow, { * `defaultPath` String (任意) * `buttonLabel` String (任意) - 確認ボタンのカスタムラベル。空のままにすると、既定のラベルが使用されます。 * `filters` [FileFilter[]](structures/file-filter.md) (任意) - * `properties` String[] (任意) - ダイアログが使うべきでない機能を含む。 以下の値がサポートされています: + * `properties` String[] (任意) - ダイアログが使うべきでない機能が入ります。 以下の値がサポートされています: * `openFile` - ファイルを選択するのを許可します。 * `openDirectory` - ディレクトリを選択するのを許可します。 * `multiSelections` - 複数のパスを選択するのを許可します。 @@ -88,7 +88,7 @@ dialog.showOpenDialogSync(mainWindow, { * `canceled` Boolean - dialog がキャンセルされたかそうでないか。 * `filePaths` String[] - ユーザーによって選択されたファイルパスの配列. ダイアログがキャンセルされた場合、これは空の配列になります。 -* `bookmarks` String[] (任意)_macOS_ _mas_ - セキュリティスコープ付きブックマークを含む base64 エンコードされた `filePaths` 配列にマッチする配列。 データを取り込むために `securityScopedBookmarks` を有効にする必要があります。 (戻り値については、[この表](#bookmarks-array) を参照してください。) +* `bookmarks` String[] (任意)_macOS_ _mas_ - セキュリティスコープ付きブックマークを含む base64 エンコードされた `filePaths` 配列にマッチする配列。 データを取り込むために `securityScopedBookmarks` を有効にする必要があります。 (戻り値については、[この表](#bookmarks-array) を参照してください。) `browserWindow` の引数で、ダイアログは親ウインドウにアタッチされ、モーダル表示になります。 @@ -131,7 +131,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (任意) _macOS_ - テキストフィールドの上に表示するメッセージ。 * `nameFieldLabel` String (任意) _macOS_ - ファイル名のテキストフィールドの前に表示されるテキストのカスタムラベル。 * `showsTagField` Boolean (任意) _macOS_ - タグの入力ボックスを表示します。省略値は、`true` です。 - * `properties` String[] (任意) + * `properties` String[] (任意) * `showHiddenFiles` - ダイアログで隠しファイルを表示します。 * `createDirectory` _macOS_ - ダイアログでディレクトリを作成するのを許可します。 * `treatPackageAsDirectory` _macOS_ - `.app` フォルダのようなパッケージを、ファイルの代わりにディレクトリとして扱います。 @@ -156,7 +156,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (任意) _macOS_ - テキストフィールドの上に表示するメッセージ。 * `nameFieldLabel` String (任意) _macOS_ - ファイル名のテキストフィールドの前に表示されるテキストのカスタムラベル。 * `showsTagField` Boolean (任意) _macOS_ - タグの入力ボックスを表示します。省略値は、`true` です。 - * `properties` String[] (任意) + * `properties` String[] (任意) * `showHiddenFiles` - ダイアログで隠しファイルを表示します。 * `createDirectory` _macOS_ - ダイアログでディレクトリを作成するのを許可します。 * `treatPackageAsDirectory` _macOS_ - `.app` フォルダのようなパッケージを、ファイルの代わりにディレクトリとして扱います。 @@ -182,7 +182,7 @@ dialog.showOpenDialog(mainWindow, { * `options` Object * `message` String - メッセージボックスの内容。 * `type` String (任意) - `"none"`、`"info"`、`"error"`、`"question"`、`"warning"` にすることができます。 Windowsでは、`"icon"` のオプションを使用してアイコンを設定しない場合、`"question"` は、`"info"` と同じアイコンを表示します。 macOSでは、`"warning"` と `"error"` の両方で同じ警告アイコンを表示します。 - * `buttons` String[] (任意) - ボタン用テキストの配列。 Windows では、空の配列は 1 つの "OK" ボタンになります。 + * `buttons` String[] (任意) - ボタン用テキストの配列。 Windows では、空の配列は 1 つの "OK" ボタンになります。 * `defaultId` Integer (任意) - メッセージボックスを開いたとき、既定で選択されるボタンの配列の中のボタンのインデックス。 * `title` String (任意) - メッセージボックスのタイトル。いくつかのプラットフォームでは表示されません。 * `detail` String (任意) - メッセージの追加情報。 @@ -205,7 +205,7 @@ dialog.showOpenDialog(mainWindow, { * `options` Object * `message` String - メッセージボックスの内容。 * `type` String (任意) - `"none"`、`"info"`、`"error"`、`"question"`、`"warning"` にすることができます。 Windowsでは、`"icon"` のオプションを使用してアイコンを設定しない場合、`"question"` は、`"info"` と同じアイコンを表示します。 macOSでは、`"warning"` と `"error"` の両方で同じ警告アイコンを表示します。 - * `buttons` String[] (任意) - ボタン用テキストの配列。 Windows では、空の配列は 1 つの "OK" ボタンになります。 + * `buttons` String[] (任意) - ボタン用テキストの配列。 Windows では、空の配列は 1 つの "OK" ボタンになります。 * `defaultId` Integer (任意) - メッセージボックスを開いたとき、既定で選択されるボタンの配列の中のボタンのインデックス。 * `title` String (任意) - メッセージボックスのタイトル。いくつかのプラットフォームでは表示されません。 * `detail` String (任意) - メッセージの追加情報。 diff --git a/content/ja-JP/docs/tutorial/quick-start.md b/content/ja-JP/docs/tutorial/quick-start.md index 4ed4d9f15f8c8..5a7c7ea7347b9 100644 --- a/content/ja-JP/docs/tutorial/quick-start.md +++ b/content/ja-JP/docs/tutorial/quick-start.md @@ -347,7 +347,10 @@ window.addEventListener('DOMContentLoaded', () => {

Hello World!

We are using Node.js , Chromium , - and Electron . + and Electron . + + + ``` diff --git a/content/ja-JP/docs/tutorial/security.md b/content/ja-JP/docs/tutorial/security.md index a790484158489..66b9968d3989b 100644 --- a/content/ja-JP/docs/tutorial/security.md +++ b/content/ja-JP/docs/tutorial/security.md @@ -78,8 +78,13 @@ browserWindow.loadURL('http://example.com') browserWindow.loadURL('https://example.com') ``` -```html - +```html + + + + + + ``` @@ -120,7 +125,12 @@ const mainWindow = new BrowserWindow({ mainWindow.loadURL('https://example.com') ``` -```html +```html + + + + + ``` Node.js integration を無効にすると、ウェブサイトへ Node.js モジュールまたは機能を使用する API を確認することができます。 プリロードスクリプトは引き続き `require` と他の Node.js の機能にアクセスできるため、開発者はコンテンツをリモートにロードするカスタム API を確認します。 @@ -209,7 +219,12 @@ const mainWindow = new BrowserWindow({ const mainWindow = new BrowserWindow() ``` -```html +```html + + + + + ``` ## 6) Content-Security-Policy を定義する @@ -349,7 +364,12 @@ _Electron のデフォルトを推奨しています_ ### どうすればいいの？ -```html +```html + + + + + ``` ## 11) 作成前に WebView のオプションを確認する diff --git a/content/pt-BR/docs/api/dialog.md b/content/pt-BR/docs/api/dialog.md index c0105d58a7925..75b6523638387 100644 --- a/content/pt-BR/docs/api/dialog.md +++ b/content/pt-BR/docs/api/dialog.md @@ -23,7 +23,7 @@ O módulo `dialog` possúi os seguintes métodos: * `defaultPath` String (opcional) * `buttonLabel` String (opcional) - Rótulo personalizado para o botão de confirmação, quando deixado em branco o label padrão será usado. * `filters` [FileFilter[]](structures/file-filter.md) (opcional) - * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: + * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: * `openFile` - Permite selecionar arquivos. * `openDirectory` - Permite selecionar diretórios. * `multiSelections` - Permite selecionar múltiplos caminhos. @@ -63,7 +63,7 @@ dialog.showOpenDialogSync(mainWindow, { }) ``` -### `dialog.showOpenDialog([browserWindow, ]options)` +### `dialog.showOpenDialog([browserWindow, ]options[, callback)` * `browserWindow` [BrowserWindow](browser-window.md)) * `options` Object @@ -71,7 +71,7 @@ dialog.showOpenDialogSync(mainWindow, { * `defaultPath` String (opcional) * `buttonLabel` String (opcional) - Rótulo personalizado para o botão de confirmação, quando deixado em branco o label padrão será usado. * `filters` [FileFilter[]](structures/file-filter.md) (opcional) - * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: + * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: * `openFile` - Permite selecionar arquivos. * `openDirectory` - Permite selecionar diretórios. * `multiSelections` - Permite selecionar múltiplos caminhos. @@ -88,7 +88,7 @@ Returns `Promise` - Resolve with an object containing the following: * `canceled` Boolean - whether or not the dialog was canceled. * `filePaths` String[] - Um array de caminhos de arquivos selecionados pelo usuário. If the dialog is cancelled this will be an empty array. -* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. `securityScopedBookmarks` must be enabled for this to be populated. (For return values, see [table here](#bookmarks-array).) +* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. `securityScopedBookmarks` must be enabled for this to be populated. (For return values, see [table here](#bookmarks-array).) O argumento `browserWindow` permite que o diálogo seja acoplado a janela parent, tornando-a modal. @@ -120,7 +120,7 @@ dialog.showOpenDialog(mainWindow, { }) ``` -### `dialog.showSaveDialogSync([browserWindow, ]options)` +### `dialog.showSaveDialogSync([browserWindow, ]options[, callback)` * `browserWindow` [BrowserWindow](browser-window.md)) * `options` Object @@ -131,7 +131,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (opcional) _macOS_ - Mensagem a ser exibida acima de campos de texto. * `nameFieldLabel` String (opcional) _macOS_ - Rótulo personalizado do texto a ser exibido em frente ao campo do nome do arquivo. * `showsTagField` Boolean (opcional) _macOS_ - apresenta a tag do campo de entrada, por padrão `true`. - * `properties` String[] (Opcional) + * `properties` String[] (optional) * `showHiddenFiles` - Mostra arquivos escondidos no dialog. * `createDirectory` _macOS_ - Allow creating new directories from dialog. * `treatPackageAsDirectory` _macOS_ - Treat packages, such as `.app` folders, as a directory instead of a file. @@ -145,7 +145,7 @@ O argumento `browserWindow` permite que o diálogo seja acoplado a janela parent Os `filters` especificam um array de tipos de arquivo que podem ser exibidos, veja `dialog.ShowOpenDialog` para exemplos. -### `dialog.showSaveDialog([browserWindow, ]options)` +### `dialog.showSaveDialog([browserWindow, ]options[, callback)` * `browserWindow` [BrowserWindow](browser-window.md)) * `options` Object @@ -156,7 +156,7 @@ Os `filters` especificam um array de tipos de arquivo que podem ser exibidos, ve * `message` String (opcional) _macOS_ - Mensagem a ser exibida acima de campos de texto. * `nameFieldLabel` String (opcional) _macOS_ - Rótulo personalizado do texto a ser exibido em frente ao campo do nome do arquivo. * `showsTagField` Boolean (optional) _macOS_ - Show the tags input box, defaults to `true`. - * `properties` String[] (Opcional) + * `properties` String[] (optional) * `showHiddenFiles` - Mostra arquivos escondidos no dialog. * `createDirectory` _macOS_ - Allow creating new directories from dialog. * `treatPackageAsDirectory` _macOS_ - Treat packages, such as `.app` folders, as a directory instead of a file. @@ -176,13 +176,13 @@ Os `filters` especificam um array de tipos de arquivo que podem ser exibidos, ve **Note:** On macOS, using the asynchronous version is recommended to avoid issues when expanding and collapsing the dialog. -### `dialog.showMessageBoxSync([browserWindow, ]options)` +### `dialog.showMessageBoxSync([browserWindow, ]options[, callback)` * `browserWindow` [BrowserWindow](browser-window.md)) * `options` Object * `message` String - Conteúdo da caixa de mensagem. * `type` String (opcional) - Pode ser `"none"`, `"info"`, `"error"`, `"question"` ou `"warning"`. No Windows, `"question"` exibe o mesmo ícone que `"info"`, a menos que você especifique um ícone usando a opção `"icon"`. No macOS, tanto `"warning"` como `"error"` exibirão o mesmo ícone de alerta. - * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". + * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". * `defaultId` Integer (opcional) - Indicador do botão na array de botões que será selecionado como padrão quando a caixa de mensagem abrir. * `title` String (opcional) - Título da caixa de mensagem, algumas plataformas não o exibirão. * `detail` String (opcional) - Informações adicionais da mensagem. @@ -199,13 +199,13 @@ Shows a message box, it will block the process until the message box is closed. O argumento `browserWindow` permite que o diálogo seja acoplado a janela parent, tornando-a modal. If `browserWindow` is not shown dialog will not be attached to it. In such case it will be displayed as an independent window. -### `dialog.showMessageBox([browserWindow, ]options)` +### `dialog.showMessageBox([browserWindow, ]options[, callback)` * `browserWindow` [BrowserWindow](browser-window.md)) * `options` Object * `message` String - Conteúdo da caixa de mensagem. * `type` String (opcional) - Pode ser `"none"`, `"info"`, `"error"`, `"question"` ou `"warning"`. No Windows, `"question"` exibe o mesmo ícone que `"info"`, a menos que você especifique um ícone usando a opção `"icon"`. No macOS, tanto `"warning"` como `"error"` exibirão o mesmo ícone de alerta. - * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". + * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". * `defaultId` Integer (opcional) - Indicador do botão na array de botões que será selecionado como padrão quando a caixa de mensagem abrir. * `title` String (opcional) - Título da caixa de mensagem, algumas plataformas não o exibirão. * `detail` String (opcional) - Informações adicionais da mensagem. diff --git a/content/pt-BR/docs/tutorial/notifications.md b/content/pt-BR/docs/tutorial/notifications.md index 0d6b0b70a83c6..3c1ef170447c0 100644 --- a/content/pt-BR/docs/tutorial/notifications.md +++ b/content/pt-BR/docs/tutorial/notifications.md @@ -21,19 +21,19 @@ Starting with a working application from the [Quick Start Guide](quick-start.md) ...and add the `renderer.js` file: ```javascript fiddle='docs/fiddles/features/notifications/renderer' -const NOTIFICATION_TITLE = 'Title' -const NOTIFICATION_BODY = 'Notification from the Renderer process. Click to log to console.' -const CLICK_MESSAGE = 'Notification clicked' +const NOTIFICACAO_TITULO = 'Title' +const NOTIFICACAO_CORPO = 'Notification from the Renderer process. Click to log to console.' +const CLICK_MENSAGEM = 'Notificação clicada!' -new Notification(NOTIFICATION_TITLE, { body: NOTIFICATION_BODY }) - .onclick = () => console.log(CLICK_MESSAGE) +new Notification(NOTIFICACAO_TITULO, { body: NOTIFICACAO_CORPO }) + .onclick = () => console.log(CLICK_MENSAGEM) ``` Após iniciar o aplicativo Electron, você verá a notificação: ![Notificação no processo de renderização](../images/notification-renderer.png) -Additionally, if you click on the notification, the DOM will update to show "Notification clicked!". +Além disso, se você clicar na notificação, o DOM atualizará para exibir 'Notificação clicada!". ### Mostrar notificações no processo principal @@ -52,7 +52,7 @@ function showNotification () { app.whenReady().then(createWindow).then(showNotification) ``` -After launching the Electron application, you should see the system notification: +Após executar a aplicação em Electron, você deve ver a notificação do sistema: ![Notification in the Main process](../images/notification-main.png) diff --git a/content/pt-BR/docs/tutorial/quick-start.md b/content/pt-BR/docs/tutorial/quick-start.md index 44a75bbcb021e..324a33a9b4839 100644 --- a/content/pt-BR/docs/tutorial/quick-start.md +++ b/content/pt-BR/docs/tutorial/quick-start.md @@ -78,19 +78,19 @@ npm start ### Execute o processo principal -The entry point of any Electron application is its `main` script. This script controls the **main process**, which runs in a full Node.js environment and is responsible for controlling your app's lifecycle, displaying native interfaces, performing privileged operations, and managing renderer processes (more on that later). +O ponto de entrada de qualquer aplicação Electron é o script `main`. Este script controla o **processo principal**, que é executado em um ambiente Node.js completo e é responsável por controlar o ciclo de vida de seu aplicativo, exibindo interfaces nativas, realizando todas as operações necessárias e gerenciando os processos de renderização (mais sobre isso mais tarde). During execution, Electron will look for this script in the [`main`][package-json-main] field of the app's `package.json` config, which you should have configured during the [app scaffolding](#scaffold-the-project) step. -To initialize the `main` script, create an empty file named `main.js` in the root folder of your project. +Para inicializar o script `main`, crie um arquivo vazio com o nome `main.js` na pasta raíz do seu projeto. -> Note: If you run the `start` script again at this point, your app will no longer throw any errors! However, it won't do anything yet because we haven't added any code into `main.js`. +> Nota: Se você executar o script `start` novamente neste ponto, sua aplicação não irá lançar qualquer erro! Entretanto, ela não fará nada, visto que não adicionamos nenhum código no arquivo `main.js`. ### Crie uma página web -Before we can create a window for our application, we need to create the content that will be loaded into it. In Electron, each window displays web contents that can be loaded from either from a local HTML file or a remote URL. +Antes de criarmos uma janela para a nossa aplicação, precisamos criar o conteúdo que será carregado dentro dela. No Electron, cada janela exibe um conteúdo web, que pode ser carregado de um arquivo HTML local ou de um URL remoto. -For this tutorial, you will be doing the former. Create an `index.html` file in the root folder of your project: +Para este tutorial, você fará a página html primeiro. Crie um arquivo `index.html` na pasta raíz do seu projeto: ```html @@ -104,29 +104,29 @@ For this tutorial, you will be doing the former. Create an `index.html` file in

Hello World!

- We are using Node.js , + Estamos utilizando Node.js , Chromium , - and Electron . + e Electron . ``` -> Note: Looking at this HTML document, you can observe that the version numbers are missing from the body text. We'll manually insert them later using JavaScript. +> Nota: Olhando para este documento HTML, você pode observar que os números das versões estão faltando dentro do texto. Nós vamos inserir manualmente mais tarde, utilizando JavaScript. -### Opening your web page in a browser window +### Abrindo sua página web em uma janela do navegador -Now that you have a web page, load it into an application window. To do so, you'll need two Electron modules: +Agora que você já tem uma página web, carregue-a na janela do aplicativo. Para fazer isso, você precisa de dois módulos do Electron: -* The [`app`][app] module, which controls your application's event lifecycle. -* The [`BrowserWindow`][browser-window] module, which creates and manages application windows. +* O módulo [`app`][app], que controla os eventos do ciclo de vida de sua aplicação. +* O módulo [`BrowserWindow`][browser-window], que cria e gerencia as janelas da sua aplicação. -Because the main process runs Node.js, you can import these as [CommonJS][commonjs] modules at the top of your file: +Pelo fato do processo principal ser executado em Node.js, você pode importá-los como módulos [CommonJS][commonjs] no topo de seu arquivo: ```js const { app, BrowserWindow } = require('electron') ``` -Then, add a `createWindow()` function that loads `index.html` into a new `BrowserWindow` instance. +Então, adicione a função `createWindow()` que carregará o arquivo `index.html` em uma nova instância do `BrowserWindow`. ```js function createWindow () { @@ -139,9 +139,9 @@ function createWindow () { } ``` -Next, call this `createWindow()` function to open your window. +O próximo passo é chamar a função `createWindow()` que abrirá a janela. -In Electron, browser windows can only be created after the `app` module's [`ready`][app-ready] event is fired. You can wait for this event by using the [`app.whenReady()`][app-when-ready] API. Call `createWindow()` after `whenReady()` resolves its Promise. +No Electron, janelas do navegador só podem ser criadas após o módulo `app` disparar o evento [`ready`][app-ready]. Você pode esperar por este evento utilizando a API [`app.whenReady()`][app-when-ready]. Chame a função `createWindow()` após `whenReady()` resolver a Promise. ```js app.whenReady().then(() => { @@ -149,19 +149,19 @@ app.whenReady().then(() => { }) ``` -> Note: At this point, your Electron application should successfully open a window that displays your web page! +> Nota: Neste ponto do tutorial, sua aplicação Electron deve abrir uma janela que mostra o conteúdo de sua página web! -### Manage your window's lifecycle +### Gerencie o ciclo de vida de sua janela Although you can now open a browser window, you'll need some additional boilerplate code to make it feel more native to each platform. Application windows behave differently on each OS, and Electron puts the responsibility on developers to implement these conventions in their app. In general, you can use the `process` global's [`platform`][node-platform] attribute to run code specifically for certain operating systems. -#### Quit the app when all windows are closed (Windows & Linux) +#### Encerrar a aplicação quando todas as janelas estiverem fechadas (Windows e Linux) -On Windows and Linux, exiting all windows generally quits an application entirely. +No Windows e no Linux, fechar todas as janelas geralmente encerra totalmente a aplicação. -To implement this, listen for the `app` module's [`'window-all-closed'`][window-all-closed] event, and call [`app.quit()`][app-quit] if the user is not on macOS (`darwin`). +Para implementar isso, "ouça" o módulo [`window-all-closed`][window-all-closed] do `app` e chame [`app.quit()`][app-quit] se o usuário não estiver utilizando macOS (`darwin`). ```js app.on('window-all-closed', function () { diff --git a/content/pt-BR/docs/tutorial/security.md b/content/pt-BR/docs/tutorial/security.md index e25428b133162..7370b53ba3eae 100644 --- a/content/pt-BR/docs/tutorial/security.md +++ b/content/pt-BR/docs/tutorial/security.md @@ -78,8 +78,13 @@ browserWindow.loadURL('http://example.com') browserWindow.loadURL('https://example.com') ``` -```html - +```html + + + + + + ``` @@ -120,7 +125,12 @@ const mainWindow = new BrowserWindow({ mainWindow.loadURL('https://example.com') ``` -```html +```html + + + + + ``` Ao desativar a integração do Node.js, você ainda pode expor APIs ao seu site que consome módulos ou recursos do Node.js. Pré-carregar scripts continuam a ter acesso para `exigir` e outro nó. s recursos, permitindo que os desenvolvedores exponham uma API personalizada para um conteúdo carregado remotamente. @@ -209,7 +219,12 @@ const mainWindow = new BrowserWindow({ const mainWindow = new BrowserWindow() ``` -```html +```html + + + + + ``` ## 6) Defina uma política de segurança de conteúdo @@ -349,7 +364,12 @@ If you do not need popups, you are better off not allowing the creation of new [ ### Como? -```html +```html + + + + + ``` ## 11) Verifique as opções do WebView antes da criação diff --git a/content/ru-RU/docs/api/dialog.md b/content/ru-RU/docs/api/dialog.md index 069fac66bf09d..629fced1f1153 100644 --- a/content/ru-RU/docs/api/dialog.md +++ b/content/ru-RU/docs/api/dialog.md @@ -23,7 +23,7 @@ console.log(dialog.showOpenDialog({ properties: ['openFile', 'multiSelections'] * `defaultPath` String (опционально) * `buttonLabel` String(опционально) - Пользовательский текст кнопки подтверждения. Если оставить пустым будет использован стандартный текст. * `filters` [FileFilter[]](structures/file-filter.md) (опционально) - * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: + * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: * `openFile` - Позволяет выбирать файлы. * `openDirectory` - Позволяет выбирать папки. * `multiSelections` - Позволяет выбрать несколько объектов. @@ -71,7 +71,7 @@ dialog.showOpenDialogSync(mainWindow, { * `defaultPath` String (опционально) * `buttonLabel` String(опционально) - Пользовательский текст кнопки подтверждения. Если оставить пустым будет использован стандартный текст. * `filters` [FileFilter[]](structures/file-filter.md) (опционально) - * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: + * `properties` String[] (optional) - Contains which features the dialog should use. The following values are supported: * `openFile` - Позволяет выбирать файлы. * `openDirectory` - Позволяет выбирать папки. * `multiSelections` - Позволяет выбрать несколько объектов. @@ -88,7 +88,7 @@ dialog.showOpenDialogSync(mainWindow, { * `canceled` Boolean - независимо от того, был ли диалог отменен. * `filePaths` String[] - Массив файлов, которые выбрал пользователь. If the dialog is cancelled this will be an empty array. -* `bookmarks` String[] (необязательно) _macOS_ _mas_ - Массив строк, соответствующих массиву `filePaths`, в кодировке base64, который содержит закладки с областью безопасности. Для его использования, `securityScopedBookmarks` должны быть активированы. (For return values, see [table here](#bookmarks-array).) +* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. Для его использования, `securityScopedBookmarks` должны быть активированы. (For return values, see [table here](#bookmarks-array).) Аргумент `browserWindow` позволяет диалоговому окну прикрепляться к родительскому, что делает его модальным. @@ -131,7 +131,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (необязательно) _macOS_ - Сообщение, которое будет показано над полями ввода. * `nameFieldLabel` String (необязательно) _macOS_ - Специальная метка для текста, отображаемая перед текстовым полем с именем файла. * `showsTagField` Boolean (необязательно) _macOS_ - Показать поле ввода тегов, по умолчанию `true`. - * `properties` String[] (опционально) + * `properties` String[] (optional) * `showHiddenFiles` - Отображает в диалоге скрытые файлы. * `createDirectory` _macOS_ - Позволяет создавать новые директории из диалога. * `treatPackageAsDirectory` _macOS_ - Считает пакеты, такие как папки `.app`, за папки, а не файлы. @@ -156,7 +156,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (необязательно) _macOS_ - Сообщение, которое будет показано над полями ввода. * `nameFieldLabel` String (необязательно) _macOS_ - Специальная метка для текста, отображаемая перед текстовым полем с именем файла. * `showsTagField` Boolean (optional) _macOS_ - Show the tags input box, defaults to `true`. - * `properties` String[] (опционально) + * `properties` String[] (optional) * `showHiddenFiles` - Отображает в диалоге скрытые файлы. * `createDirectory` _macOS_ - Позволяет создавать новые директории из диалога. * `treatPackageAsDirectory` _macOS_ - Считает пакеты, такие как папки `.app`, за папки, а не файлы. @@ -182,7 +182,7 @@ dialog.showOpenDialog(mainWindow, { * `options` Object * `message` String - содержимое сообщения. * `type` String (опционально) - Может быть `"none"`, `"info"`, `"error"`, `"question"` или `"warning"`. В Windows, `"question"` отображает ту же иконку, что и `"info"`, если вы не установили иконку, используя опцию `"icon"`. На macOS и `"warning"` и `"error"` отображают ту же иконку предупреждения (warning). - * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". + * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". * `defaultId` Integer (опционально) - Индекс кнопки в массиве кнопок, который будет выбран по умолчанию при открытии окна сообщения. * `title` String (необязательно) - Заголовок окна сообщения, некоторые платформы не смогут его отобразить. * `detail` String (опционально) - Дополнительные сведения о сообщении. @@ -205,7 +205,7 @@ dialog.showOpenDialog(mainWindow, { * `options` Object * `message` String - содержимое сообщения. * `type` String (опционально) - Может быть `"none"`, `"info"`, `"error"`, `"question"` или `"warning"`. В Windows, `"question"` отображает ту же иконку, что и `"info"`, если вы не установили иконку, используя опцию `"icon"`. На macOS и `"warning"` и `"error"` отображают ту же иконку предупреждения (warning). - * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". + * `buttons` String[] (optional) - Array of texts for buttons. On Windows, an empty array will result in one button labeled "OK". * `defaultId` Integer (опционально) - Индекс кнопки в массиве кнопок, который будет выбран по умолчанию при открытии окна сообщения. * `title` String (необязательно) - Заголовок окна сообщения, некоторые платформы не смогут его отобразить. * `detail` String (опционально) - Дополнительные сведения о сообщении. diff --git a/content/ru-RU/docs/tutorial/quick-start.md b/content/ru-RU/docs/tutorial/quick-start.md index 3eaf2bd1b6332..b3a0f5c950a41 100644 --- a/content/ru-RU/docs/tutorial/quick-start.md +++ b/content/ru-RU/docs/tutorial/quick-start.md @@ -25,7 +25,7 @@ npm -v ### Сборка приложения -Electron apps follow the same general structure as other Node.js projects. Start by creating a folder and initializing an npm package. +Приложения Electron имеют ту же общую структуру, что и другие проекты Node.js. Начните с создания папки и инициализации пакета npm. ```sh npm2yarn mkdir my-electron-app && cd my-electron-app diff --git a/content/ru-RU/docs/tutorial/security.md b/content/ru-RU/docs/tutorial/security.md index 3f6e0a081cbb6..f106e943faa39 100644 --- a/content/ru-RU/docs/tutorial/security.md +++ b/content/ru-RU/docs/tutorial/security.md @@ -78,8 +78,13 @@ browserWindow.loadURL('http://example.com') browserWindow.loadURL('https://example.com') ``` -```html - +```html + + + + + + ``` diff --git a/content/zh-CN/docs/api/dialog.md b/content/zh-CN/docs/api/dialog.md index 94b7f9f74b02a..f42ab7083c4eb 100644 --- a/content/zh-CN/docs/api/dialog.md +++ b/content/zh-CN/docs/api/dialog.md @@ -23,7 +23,7 @@ console.log(dialog.showOpenDialog({ properties: ['openFile', 'multiSelections'] * `defaultPath` String (可选) - 对话框的默认展示路径 * ` buttonLabel ` String (可选) - 「确认」按钮的自定义标签, 当为空时, 将使用默认标签。 * `filters` [FileFilter[]](structures/file-filter.md) (可选) - * `properties` String[](可选)-包括对话框应当使用的特性。 支持以下属性值: + * `properties` String[] (optional) - Contains which features the dialog should use. 支持以下属性值: * `openFile` - 允许选择文件 * `openDirectory` - 允许选择文件夹 * ` multiSelections `-允许多选。 @@ -71,7 +71,7 @@ dialog.showOpenDialogSync(mainWindow, { * `defaultPath` String (可选) - 对话框的默认展示路径 * ` buttonLabel ` String (可选) - 「确认」按钮的自定义标签, 当为空时, 将使用默认标签。 * `filters` [FileFilter[]](structures/file-filter.md) (可选) - * `properties` String[](可选)-包括对话框应当使用的特性。 支持以下属性值: + * `properties` String[] (optional) - Contains which features the dialog should use. 支持以下属性值: * `openFile` - 允许选择文件 * `openDirectory` - 允许选择文件夹 * ` multiSelections `-允许多选。 @@ -88,7 +88,7 @@ dialog.showOpenDialogSync(mainWindow, { * `canceled` Boolean - 对话框是否被取消。 * ` filePaths ` String[] - 用户选择的文件路径的数组. 如果对话框被取消，这将是一个空的数组。 -* `bookmarks` String[] (optional) _macOS_ _mas_ - 一个 `filePaths` 数组符合 base64 编码的安全作用域的书签数据。 `securityScopedBookmarks` 必须启用才能捕获数据。 (返回值见 [这里的表格](#bookmarks-array)。) +* `bookmarks` String[] (optional) _macOS_ _mas_ - An array matching the `filePaths` array of base64 encoded strings which contains security scoped bookmark data. `securityScopedBookmarks` 必须启用才能捕获数据。 (返回值见 [这里的表格](#bookmarks-array)。) ` browserWindow ` 参数允许该对话框将自身附加到父窗口, 作为父窗口的模态框。 @@ -131,7 +131,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (可选) _ macOS _-显示在对话框上的消息。 * ` nameFieldLabel ` String (可选) _ macOS _ - 文件名输入框对应的自定义标签名。 * ` showsTagField ` Boolean (可选) _ macOS _-显示标记输入框, 默认为 ` true `。 - * `properties` String[] (可选) + * `properties` String[] (optional) * ` showHiddenFiles `-显示对话框中的隐藏文件。 * `createDirectory` _macOS_ -允许你通过对话框的形式创建新的目录。 * ` treatPackageAsDirectory `_ macOS _-将包 (如 `.app ` 文件夹) 视为目录而不是文件。 @@ -156,7 +156,7 @@ dialog.showOpenDialog(mainWindow, { * `message` String (可选) _ macOS _-显示在对话框上的消息。 * ` nameFieldLabel ` String (可选) _ macOS _ - 文件名输入框对应的自定义标签名。 * `showsTagField` Boolean (可选) _macOS_ - 显示标签输入框，默认为 `true`。 - * `properties` String[] (可选) + * `properties` String[] (optional) * ` showHiddenFiles `-显示对话框中的隐藏文件。 * `createDirectory` _macOS_ -允许你通过对话框的形式创建新的目录。 * ` treatPackageAsDirectory `_ macOS _-将包 (如 `.app ` 文件夹) 视为目录而不是文件。 @@ -182,7 +182,7 @@ dialog.showOpenDialog(mainWindow, { * `选项` 对象 * `message` String - message box 的内容. * `type` String (可选) - 可以为 `"none"`, `"info"`, `"error"`, `"question"` 或者 `"warning"`. 在 Windows 上, `"question"` 与`"info"`显示相同的图标, 除非你使用了 `"icon"` 选项设置图标。 在 macOS 上, `"warning"` 和 `"error"` 显示相同的警告图标 - * `buttons` String[] (可选) - 按钮文本数组。 在 Windows上，一个空数组将导致按钮被标为“OK”。 + * `buttons` String[] (optional) - Array of texts for buttons. 在 Windows上，一个空数组将导致按钮被标为“OK”。 * `defaultId` Integer (可选) - 在 message box 对话框打开的时候，设置默认选中的按钮，值为在 buttons 数组中的索引. * `title` String (可选) - message box 的标题，一些平台不显示. * `detail` String (可选) - 额外信息. @@ -205,7 +205,7 @@ dialog.showOpenDialog(mainWindow, { * `选项` 对象 * `message` String - message box 的内容. * `type` String (可选) - 可以为 `"none"`, `"info"`, `"error"`, `"question"` 或者 `"warning"`. 在 Windows 上, `"question"` 与`"info"`显示相同的图标, 除非你使用了 `"icon"` 选项设置图标。 在 macOS 上, `"warning"` 和 `"error"` 显示相同的警告图标 - * `buttons` String[] (可选) - 按钮文本数组。 在 Windows上，一个空数组将导致按钮被标为“OK”。 + * `buttons` String[] (optional) - Array of texts for buttons. 在 Windows上，一个空数组将导致按钮被标为“OK”。 * `defaultId` Integer (可选) - 在 message box 对话框打开的时候，设置默认选中的按钮，值为在 buttons 数组中的索引. * `title` String (可选) - message box 的标题，一些平台不显示. * `detail` String (可选) - 额外信息. diff --git a/content/zh-CN/docs/tutorial/security.md b/content/zh-CN/docs/tutorial/security.md index 35200e9df5a02..8dba4b1996ac4 100644 --- a/content/zh-CN/docs/tutorial/security.md +++ b/content/zh-CN/docs/tutorial/security.md @@ -77,8 +77,13 @@ browserWindow.loadURL ('http://example.com') browserWindow.loadURL ('https://example.com') ``` -```html - +```html + + + + + + ``` @@ -119,7 +124,12 @@ const mainWindow = new BrowserWindow({ mainWindow.loadURL('https://example.com') ``` -```html +```html + + + + + ``` 当禁用Node.js集成时，你依然可以暴露API给你的站点以使用Node.js的模块功能或特性。 预加载脚本依然可以使用`require`等Node.js特性， 以使开发者可以暴露自定义API给远程加载内容。 @@ -208,7 +218,12 @@ const mainWindow = new BrowserWindow({ const mainWindow = new BrowserWindow() ``` -```html +```html + + + + + ``` ## 6) 定义一个内容安全策略 @@ -348,7 +363,12 @@ _Electron的默认值即是建议值。_ ### 怎么做？ -```html +```html + + + + + ``` ## 11) 创建WebView前确认其选项