feat: edit popup-windows article.md ru

Author: front42

3-frames-and-windows/01-popup-windows/article.md

@@ -15,7 +15,7 @@ window.open('https://javascript.info/')
 
 Однако, для некоторых задач попапы ещё используются, например для OAuth-авторизации (вход через Google/Facebook/...), так как:
 
-1. Попап - это отдельное окно со своим JavaScript-окружением. Так что открытие попапа со стороннего, не доверенного сайта вполне безопасно
+1. Попап - это отдельное окно со своим JavaScript-окружением. Так что открытие попапа со стороннего, не доверенного сайта относительно безопасно (учитывая, что сохраняются риски фишинга и другие угрозы).
 2. Открыть попап очень просто.
 3. Попап может производить навигацию (менять URL) и отсылать сообщения в основное окно.
 
@@ -46,7 +46,7 @@ url
 : URL для загрузки в новом окне.
 
 name
-: Имя нового окна. У каждого окна есть свойство `window.name`, в котором можно задавать, какое окно использовать для попапа. Таким образом, если уже существует окно с заданным именем – указанный в параметрах URL откроется в нем, в противном случае откроется новое окно.
+: Имя нового окна. У каждого окна есть свойство `window.name`, в котором можно задавать, какое окно использовать для попапа. Таким образом, если уже существует окно с заданным именем – указанный в параметрах URL откроется в нём, иначе откроется новое окно.
 
 params
 : Строка параметров для нового окна. Содержит настройки, разделённые запятыми. Важно помнить, что в данной строке не должно быть пробелов. Например `width=200,height=100`.
@@ -104,28 +104,28 @@ open('/', 'test', params);
 Например, здесь мы генерируем содержимое попапа из JavaScript:
 
 ```js
-let newWin = window.open("about:blank", "hello", "width=200,height=200");
+let myPopup = window.open("about:blank", "hello", "width=200,height=200");
 
-newWin.document.write("Hello, world!");
+myPopup.document.write("Hello, world!");
 ```
 
 А здесь содержимое окна модифицируется после загрузки:
 
 ```js run
-let newWindow = open('/', 'example', 'width=300,height=300')
-newWindow.focus();
+let myPopup = window.open('/', 'example', 'width=300,height=300')
+myPopup.focus();
 
-alert(newWindow.location.href); // (*) about:blank, загрузка ещё не началась
+alert(myPopup.location.href); // (*) about:blank, загрузка ещё не началась
 
-newWindow.onload = function() {
+myPopup.onload = function() {
   let html = `<div style="font-size:30px">Добро пожаловать!</div>`;
 *!*
-  newWindow.document.body.insertAdjacentHTML('afterbegin', html);
+  myPopup.document.body.insertAdjacentHTML('afterbegin', html);
 */!*
 };
 ```
 
-Обратите внимание: сразу после `window.open` новое окно ещё не загружено. Это демонстрируется в строке `(*)`. Так что нужно ждать `onload`, чтобы его изменить. Или же поставить обработчик `DOMContentLoaded` на `newWin.document`.
+Обратите внимание: сразу после `window.open` новое окно ещё не загружено. Это демонстрируется в строке `(*)`. Так что нужно ждать события `load`, чтобы его изменить. Или же поставить обработчик `DOMContentLoaded` на `myPopup.document`.
 
 ```warn header="Политика одного источника"
 Окна имеют свободный доступ к содержимому друг друга только если они с одного источника (у них совпадают домен, протокол и порт (protocol://domain:port).
@@ -140,9 +140,9 @@ newWindow.onload = function() {
 Если вы запустите код ниже, то он заменит содержимое открывшего (текущего) окна на "Тест":
 
 ```js run
-let newWin = window.open("about:blank", "hello", "width=200,height=200");
+let myPopup = window.open("about:blank", "hello", "width=200,height=200");
 
-newWin.document.write(
+myPopup.document.write(
   "<script>window.opener.document.body.innerHTML = 'Тест'<\/script>"
 );
 ```
@@ -151,9 +151,9 @@ newWin.document.write(
 
 ## Закрытие попапа
 
-Чтобы закрыть окно: `win.close()`
+Чтобы закрыть окно: `myPopup.close()`
 
-Для проверки, закрыто ли окно: `win.closed`.
+Для проверки, закрыто ли окно: `myPopup.closed`.
 
 Технически метод `close()` доступен для любого окна, но `window.close()` будет игнорироваться большинством браузеров, если `window` не было создано с помощью `window.open()`. Так что он сработает только для попапов.
 
@@ -162,28 +162,28 @@ newWin.document.write(
 Этот код откроет и затем закроет окно:
 
 ```js run
-let newWindow = open('/', 'example', 'width=300,height=300');
+let myPopup = open('/', 'example', 'width=300,height=300');
 
-newWindow.onload = function() {
-  newWindow.close();
-  alert(newWindow.closed); // true
+myPopup.onload = function() {
+  myPopup.close();
+  alert(myPopup.closed); // true
 };
 ```
 
-## Прокрутка и изменение размеров
+## Перемещение и изменение размеров попапа
 
-Методы для передвижения и изменения размеров окна:
+Методы для перемещения и изменения размеров окна:
 
-`win.moveBy(x,y)`
+`myPopup.moveBy(x,y)`
 : Переместить окно относительно текущей позиции на `x` пикселей вправо и `y` пикселей вниз. Допустимы отрицательные значения (для перемещения окна влево и вверх).
 
-`win.moveTo(x,y)`
+`myPopup.moveTo(x,y)`
 : Переместить окно на координаты экрана `(x,y)`.
 
-`win.resizeBy(width,height)`
+`myPopup.resizeBy(width,height)`
 : Изменить размер окна на указанные значения `width/height` относительно текущего размера. Допустимы отрицательные значения.
 
-`win.resizeTo(width,height)`
+`myPopup.resizeTo(width,height)`
 : Изменить размер окна до указанных значений.
 
 Также существует событие `window.onresize`.
@@ -198,18 +198,18 @@ newWindow.onload = function() {
 Методы перемещения и изменения размера окна не работают для свернутых и развёрнутых на весь экран окон.
 ```
 
-## Прокрутка окна
+## Прокрутка попапа
 
 Мы уже говорили о прокрутке окна в главе <info:size-and-scroll-window>.
 
-`win.scrollBy(x,y)`
+`myPopup.scrollBy(x,y)`
 : Прокрутить окно на `x` пикселей вправо и `y` пикселей вниз относительно текущей прокрутки. Допустимы отрицательные значения.
 
-`win.scrollTo(x,y)`
+`myPopup.scrollTo(x,y)`
 : Прокрутить окно до заданных координат `(x,y)`.
 
 `elem.scrollIntoView(top = true)`
-: Прокрутить окно так, чтобы `elem` для `elem.scrollIntoView(false)` появился вверху (по умолчанию) или внизу.
+: Прокрутить окно так, чтобы `elem` появился вверху (по умолчанию) или внизу при `elem.scrollIntoView(false)`.
 
 Также существует событие `window.onscroll`.
 
@@ -231,7 +231,7 @@ window.onblur = () => window.focus();
 
 Но всё-таки иногда методы фокусировки бывают полезны. Например:
 
-- Когда мы открываем попап, может быть хорошей идеей запустить для него `newWindow.focus()`. Для некоторых комбинаций браузера и операционной системы это устранит неоднозначность – заметит ли пользователь это новое окно.
+- Когда мы открываем попап, может быть хорошей идеей запустить для него `myPopup.focus()`. Для некоторых комбинаций браузера и операционной системы это устранит неоднозначность – заметит ли пользователь это новое окно.
 - Если нужно отследить, когда посетитель использует веб-приложение, можно отслеживать `window.onfocus/onblur`. Это позволит ставить на паузу и продолжать выполнение анимаций и других интерактивных действий на странице. При этом важно помнить, что `blur` означает, что окно больше не в фокусе, но пользователь может по-прежнему видеть его.
 
 ## Итого