Skip to content

Commit

Permalink
Merge branch 'main' into remove/ru-conflicting-web-javascript-referen…
Browse files Browse the repository at this point in the history
…ce-errors-unexpected-token
  • Loading branch information
leon-win authored Jul 24, 2024
2 parents 30b94e9 + e973506 commit a4d5361
Show file tree
Hide file tree
Showing 22 changed files with 752 additions and 506 deletions.
6 changes: 3 additions & 3 deletions files/ja/web/api/event/preventdefault/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@ title: "Event: preventDefault() メソッド"
short-title: preventDefault()
slug: Web/API/Event/preventDefault
l10n:
sourceCommit: 32b07aa5b6ac4799a88e7b87a4d8333643ab6427
sourceCommit: 15f0b5552bc9c2ea1f32b0cd5ee840a7d43c887e
---

{{apiref("DOM")}}
{{APIRef("DOM")}}{{AvailableInWorkers}}

**`preventDefault()`** は {{domxref("Event")}} インターフェイスのメソッドで、{{Glossary("user agent", "ユーザーエージェント")}}に、このイベントが明示的に処理されない場合に、その既定のアクションを通常どおりに行うべきではないことを伝えます。

Expand Down Expand Up @@ -78,7 +78,7 @@ function checkboxClick(event) {

#### CSS

ユーザが無効なキーを押したときに描画する警告ボックスには、CSS を少し使用します。
ユーザーが無効なキーを押したときに描画する警告ボックスには、CSS を少し使用します。

```css
.warning {
Expand Down
611 changes: 323 additions & 288 deletions files/ja/web/api/eventtarget/addeventlistener/index.md

Large diffs are not rendered by default.

9 changes: 5 additions & 4 deletions files/ja/web/api/eventtarget/dispatchevent/index.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,20 @@
---
title: "EventTarget: dispatchEvent() メソッド"
short-title: dispatchEvent()
slug: Web/API/EventTarget/dispatchEvent
l10n:
sourceCommit: 339595951b78774e951b1a9d215a6db6b856f6b2
sourceCommit: 8ac73df2fbe2c88d8649fcb006dcde098616c723
---

{{APIRef("DOM")}}
{{APIRef("DOM")}}{{AvailableInWorkers}}

**`dispatchEvent()`** は {{domxref("EventTarget")}} のメソッドで、 {{domxref("Event")}} をそのオブジェクトへ送り、関連する[イベントリスナー](/ja/docs/Web/API/EventTarget/addEventListener)(同期的に)適切に起動させます。通常のイベント処理ルール(キャプチャとオプションのバブリングフェーズを含む)は `dispatchEvent()` で手動で配信されたイベントにも適用されます。
**`dispatchEvent()`** は {{domxref("EventTarget")}} のメソッドで、 {{domxref("Event")}} をそのオブジェクトへ送り、関連するイベントリスナーを(同期的に)適切に起動させます。通常のイベント処理ルール(キャプチャとオプションのバブリングフェーズを含む)は `dispatchEvent()` で手動で配信されたイベントにも適用されます。

`dispatchEvent()` の呼び出しは、イベントを発行させるための最後のステップです。イベントは既に {{domxref("Event/Event", "Event()")}} コンストラクターを使って作成され、初期化されているはずです。

> **メモ:** このメソッドを呼び出すとき、 {{domxref("Event.target")}} プロパティは現在の `EventTarget` に初期化されます。
「ネイティブ」イベントがブラウザーによって発生し、[イベントループ](/ja/docs/Web/JavaScript/Event_loop)を介して非同期にイベントハンドラーを呼び出すのとは異なり、 `dispatchEvent()` はイベントハンドラーを*同期的に*呼び出します。適用可能なすべてのイベントハンドラが呼び出され`dispatchEvent()` から戻る前に返されます。
「ネイティブ」イベントがブラウザーによって発生し、[イベントループ](/ja/docs/Web/JavaScript/Event_loop)を介して非同期にイベントハンドラーを呼び出すのとは異なり、 `dispatchEvent()` はイベントハンドラーを*同期的に*呼び出します。適用可能なすべてのイベントハンドラーが呼び出され`dispatchEvent()` から戻る前に返されます。

## 構文

Expand Down
63 changes: 49 additions & 14 deletions files/ja/web/api/eventtarget/eventtarget/index.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
---
title: "EventTarget: EventTarget() コンストラクター"
short-title: EventTarget()
slug: Web/API/EventTarget/EventTarget
l10n:
sourceCommit: 339595951b78774e951b1a9d215a6db6b856f6b2
sourceCommit: 15f0b5552bc9c2ea1f32b0cd5ee840a7d43c887e
---

{{APIRef("DOM")}}
{{APIRef("DOM")}}{{AvailableInWorkers}}

**`EventTarget()`** コンストラクターは、新しい {{domxref("EventTarget")}} オブジェクトのインスタンスを作成します。

Expand All @@ -27,29 +28,63 @@ new EventTarget()

##

### カウンターの実装

この例では、 `increment()` メソッドと `decrement()` メソッドを持つ `Counter` クラスを実装します。これらのメソッドが呼び出されると、カスタムイベント `"valuechange"` が発生します。

#### HTML

```html
<button id="dec" aria-label="Decrement">-</button>
<span id="currentValue">0</span>
<button id="inc" aria-label="Increment">+</button>
```

#### JavaScript

```js
class MyEventTarget extends EventTarget {
constructor(mySecret) {
class Counter extends EventTarget {
constructor(initialValue = 0) {
super();
this._secret = mySecret;
this.value = initialValue;
}

#emitChangeEvent() {
this.dispatchEvent(new CustomEvent("valuechange", { detail: this.value }));
}

get secret() {
return this._secret;
increment() {
this.value++;
this.#emitChangeEvent();
}

decrement() {
this.value--;
this.#emitChangeEvent();
}
}

let myEventTarget = new MyEventTarget(5);
let value = myEventTarget.secret; // === 5
myEventTarget.addEventListener("foo", (e) => {
myEventTarget._secret = e.detail;
const initialValue = 0;
const counter = new Counter(initialValue);
document.querySelector("#currentValue").innerText = initialValue;

counter.addEventListener("valuechange", (event) => {
document.querySelector("#currentValue").innerText = event.detail;
});

document.querySelector("#inc").addEventListener("click", () => {
counter.increment();
});

let event = new CustomEvent("foo", { detail: 7 });
myEventTarget.dispatchEvent(event);
let newValue = myEventTarget.secret; // === 7
document.querySelector("#dec").addEventListener("click", () => {
counter.decrement();
});
```

#### 結果

{{EmbedLiveSample("Implementing a counter")}}

## 仕様書

{{Specifications}}
Expand Down
6 changes: 3 additions & 3 deletions files/ja/web/api/eventtarget/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@
title: EventTarget
slug: Web/API/EventTarget
l10n:
sourceCommit: 049632675ccb83fe2e257c43071d366d3f80ee2b
sourceCommit: 15f0b5552bc9c2ea1f32b0cd5ee840a7d43c887e
---

{{ApiRef("DOM")}}
{{APIRef("DOM")}}{{AvailableInWorkers}}

**`EventTarget`** インターフェイスは、イベントを受け取ることや、リスナーを持つことができるオブジェクトが実装します。
言い換えると、イベントのターゲットはすべて、このインターフェイスに関する 3 つのメソッドを実装しています。

{{domxref("Element")}} とその子、{{domxref("Document")}}、{{domxref("Window")}} は、最も一般的なイベントターゲットですが、他のオブジェクトも、例えば {{domxref("XMLHttpRequest")}}、{{domxref("AudioNode")}}、{{domxref("AudioContext")}} などもイベントターゲットになります。
{{domxref("Element")}} とその子、{{domxref("Document")}}、{{domxref("Window")}} は、最も一般的なイベントターゲットですが、他のオブジェクト、例えば {{domxref("IDBRequest")}}、{{domxref("AudioNode")}}、{{domxref("AudioContext")}} などもイベントターゲットになります。

多くのイベントターゲット (要素、文書、ウィンドウを含む) は、[イベントハンドラー](/ja/docs/Web/Events/Event_handlers)を設定するのに `onイベント名` プロパティや属性を使用することもできます。

Expand Down
7 changes: 4 additions & 3 deletions files/ja/web/api/eventtarget/removeeventlistener/index.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
---
title: "EventTarget: removeEventListener() メソッド"
short-title: removeEventListener()
slug: Web/API/EventTarget/removeEventListener
l10n:
sourceCommit: 339595951b78774e951b1a9d215a6db6b856f6b2
sourceCommit: 15f0b5552bc9c2ea1f32b0cd5ee840a7d43c887e
---

{{APIRef("DOM")}}
{{APIRef("DOM")}}{{AvailableInWorkers}}

**`removeEventListener()`** は {{domxref("EventTarget")}} インターフェイスのメソッドで、以前に {{domxref("EventTarget.addEventListener()")}} で登録されたイベントリスナーを取り外します。
取り外されるイベントリスナーはイベントの型、イベントリスナー関数そのもの、照合プロセスに影響を与えるさまざまな任意のオプションを使用して識別します。
Expand Down Expand Up @@ -90,7 +91,7 @@ element.removeEventListener("mousedown", handleMouseDown, false); // 成功
element.removeEventListener("mousedown", handleMouseDown, true); // 失敗
```

この点については、いくつかのブラウザのリリースで一貫性がないことに注意してください。特に理由がない限り、`addEventListener()` の呼び出しで使用したのと同じ値を `removeEventListener()` の呼び出しでも使用することが賢明でしょう。
この点については、いくつかのブラウザーのリリースで一貫性がないことに注意してください。特に理由がない限り、`addEventListener()` の呼び出しで使用したのと同じ値を `removeEventListener()` の呼び出しでも使用することが賢明でしょう。

##

Expand Down
20 changes: 15 additions & 5 deletions files/ko/web/javascript/reference/global_objects/math/e/index.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,29 @@
---
title: Math.E
slug: Web/JavaScript/Reference/Global_Objects/Math/E
l10n:
sourceCommit: 761b9047d78876cbd153be811efb1aa77b419877
---

{{JSRef}}

**`Math.E`** 속성은 자연로그의 밑 값 e를 나타내며 약 2.718의 값을 가집니다.
**`Math.E`** 정적 데이터 속성은 오일러 수를 의미하며, 자연로그의 밑 값 e를 나타내며 약 2.718의 값을 가집니다.

<math display="block"><semantics><mrow><mstyle mathvariant="monospace"><mi>Math.E</mi></mstyle><mo>=</mo><mi>e</mi><mo>≈</mo><mn>2.718</mn></mrow><annotation encoding="TeX">\mathtt{\mi{Math.E}} = e \approx 2.718</annotation></semantics></math>
{{EmbedInteractiveExample("pages/js/math-e.html")}}

{{EmbedInteractiveExample("pages/js/math-e.html")}}{{js_property_attributes(0, 0, 0)}}
##

<!-- prettier-ignore-start -->
<math display="block">
<semantics><mrow><mi>𝙼𝚊𝚝𝚑.𝙴</mi><mo>=</mo><mi>e</mi><mo>≈</mo><mn>2.718</mn></mrow><annotation encoding="TeX">\mathtt{Math.E} = e \approx 2.718</annotation></semantics>
</math>
<!-- prettier-ignore-end -->

{{js_property_attributes(0, 0, 0)}}

## 설명

`E``Math`의 정적 속성이므로, 사용자가 생성한 `Math` 객체의 속성으로 접근할 수 없고 항상 `Math.E`를 사용해야 합니다. (`Math`는 생성자가 아닙니다)
`E``Math`의 정적 속성이므로, 생성한 `Math` 객체(`Math`는 생성자가 아닙니다)의 속성 대신 항상 `Math.E`를 사용해야 합니다.

## 예제

Expand All @@ -29,7 +39,7 @@ function getNapier() {
getNapier(); // 2.718281828459045
```

## 명세
## 명세서

{{Specifications}}

Expand Down
52 changes: 52 additions & 0 deletions files/ko/web/javascript/reference/global_objects/regexp/n/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
title: RegExp.$1, …, RegExp.$9
slug: Web/JavaScript/Reference/Global_Objects/RegExp/n
l10n:
sourceCommit: fb85334ffa4a2c88d209b1074909bee0e0abd57a
---

{{JSRef}} {{Deprecated_Header}}

> **참고:** 마지막 일치 상태를 전역적으로 노출하는 모든 `RegExp` 정적 속성은 더 이상 사용되지 않습니다. 자세한 내용은 [더 이상 사용되지 않는 RegExp 기능](/ko/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features#regexp)을 참고하세요.
**`RegExp.$1, …, RegExp.$9`** 정적 접근자 속성은 괄호 안의 하위 문자열 일치 항목을 반환합니다.

## 설명

`$1``$9`는 {{jsxref("RegExp")}}의 정적 속성이기 때문에, 생성한 `RegExp` 객체의 속성으로 사용하는 것보다는 항상`RegExp.$1`, `RegExp.$2` 등으로 사용해야 합니다.

`$1, …, $9`의 값은 `RegExp`(`RegExp` 하위 클래스 제외) 인스턴스가 일치에 성공할 때마다 갱신됩니다. 일치하는 항목이 없거나 마지막 일치가 대응되는 캡쳐 그룹이 없으면 각각의 속성은 빈 문자열입니다. 각각의 속성의 설정 접근자는 `undefined`이므로 이 속성을 직접 변경할 수 없습니다.

괄호로 묶을 수 있는 하위 문자열의 개수는 제한이 없지만 `RegExp` 객체는 처음 9개만 보유할 수 있습니다. 반환된 배열의 인덱스를 통해 괄호로 묶인 모든 하위 문자열에 접근할 수 있습니다.

`$1, …, $9`는 {{jsxref("String.prototype.replace()")}}의 대체 문자열에도 사용할 수 있지만, 이는 `RegExp.$n` 레거시 속성과는 관련이 없습니다.

## 예제

### RegExp.prototype.test()와 함께 $n 사용하기

아래 스크립트는 일반적인 문자열 내에서 숫자를 잡아내기 위해 {{jsxref("RegExp.prototype.test()")}} 메서드를 사용합니다.

```js
const str = "Test 24";
const number = /(\d+)/.test(str) ? RegExp.$1 : "0";
number; // "24"
```

`re.test(str)` 호출과 `RegExp.$n` 속성 사이에 다른 정규식을 사용하는 작업은 부작용이 있을 수 있습니다. 이러한 특수 속성 접근은 즉시 수행해야 하며, 그렇지 않으면 예상치 못한 결과가 발생할 수 있다는 점을 주의하시기 바랍니다.

## 명세서

{{Specifications}}

## 브라우저 호환성

{{Compat}}

## 같이 보기

- {{jsxref("RegExp/input", "RegExp.input ($_)")}}
- {{jsxref("RegExp/lastMatch", "RegExp.lastMatch ($&amp;)")}}
- {{jsxref("RegExp/lastParen", "RegExp.lastParen ($+)")}}
- {{jsxref("RegExp/leftContext", "RegExp.leftContext ($`)")}}
- {{jsxref("RegExp/rightContext", "RegExp.rightContext ($')")}}
2 changes: 0 additions & 2 deletions files/ru/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -755,10 +755,8 @@
/ru/docs/Web/JavaScript/Reference/Classes/Приватные_поля_класса /ru/docs/Web/JavaScript/Reference/Classes/Private_properties
/ru/docs/Web/JavaScript/Reference/Errors/Bad_return_or_yield /ru/docs/Web/JavaScript/Reference/Errors/Bad_return
/ru/docs/Web/JavaScript/Reference/Errors/Deprecated_octal /ru/docs/Web/JavaScript/Reference/Errors/Deprecated_octal_literal
/ru/docs/Web/JavaScript/Reference/Errors/Equal_as_assign /ru/docs/orphaned/Web/JavaScript/Reference/Errors/Equal_as_assign
/ru/docs/Web/JavaScript/Reference/Errors/Missing_semicolon_before_statement /ru/docs/Web/JavaScript/Reference/Errors/Unexpected_token
/ru/docs/Web/JavaScript/Reference/Errors/Not_a_codepoint /ru/docs/Web/JavaScript/Reference/Errors/Not_a_valid_code_point
/ru/docs/Web/JavaScript/Reference/Errors/Undefined_prop /ru/docs/orphaned/Web/JavaScript/Reference/Errors/Undefined_prop
/ru/docs/Web/JavaScript/Reference/Errors/Unterminated_string_literal /ru/docs/Web/JavaScript/Reference/Errors/String_literal_EOL
/ru/docs/Web/JavaScript/Reference/Functions/Определиние_методов /ru/docs/Web/JavaScript/Reference/Functions/Method_definitions
/ru/docs/Web/JavaScript/Reference/Global_Objects/Array/@@iterator /ru/docs/Web/JavaScript/Reference/Global_Objects/Array/Symbol.iterator
Expand Down
8 changes: 0 additions & 8 deletions files/ru/_wikihistory.json
Original file line number Diff line number Diff line change
Expand Up @@ -15961,13 +15961,5 @@
"conflicting/Web/SVG/Attribute": {
"modified": "2020-10-15T22:34:58.576Z",
"contributors": ["osipov_s"]
},
"orphaned/Web/JavaScript/Reference/Errors/Equal_as_assign": {
"modified": "2020-03-12T19:48:37.445Z",
"contributors": ["MakarovDs777"]
},
"orphaned/Web/JavaScript/Reference/Errors/Undefined_prop": {
"modified": "2020-03-12T19:47:58.221Z",
"contributors": ["KTatyana"]
}
}

This file was deleted.

Loading

0 comments on commit a4d5361

Please sign in to comment.