[WebIDL] 諸々の編集

Author: triple-underscore

WebIDL-ja.html

@@ -8892,15 +8892,14 @@ <h4 title="Overloading vs. union types">2.5.8.1. 多重定義 vs. 共用体~型<
 <h4 title="Iterable declarations">2.5.9. 可反復~宣言</h4>
 
 <p>
-~ifcは
+`~ifc$は、
 `可反復@
-（ `iterable^en ）になるように宣言できる。
-そのためには、
-`~ifc$の本体~内で
+（ `iterable^en ）になるよう宣言できる
+— その本体~内で
 `可反復~宣言@
 （ `iterable declaration^en ）
 （`Iterable$g に合致-）
-を利用すること。
+を利用することにより。
 ◎
 An interface can be declared to be iterable by using an iterable declaration (matching Iterable) in the body of the interface.
 </p>
@@ -8914,7 +8913,7 @@ <h4 title="Iterable declarations">2.5.9. 可反復~宣言</h4>
 
 <p>
 可反復として宣言された~ifcを実装している~objは、
-値の連列を得するために反復できるようになる。
+値たちが成す連列を得するよう反復することを~supportする。
 ◎
 Objects implementing an interface that is declared to be iterable support being iterated over to obtain a sequence of values.
 </p>
@@ -8929,64 +8928,53 @@ <h4 title="Iterable declarations">2.5.9. 可反復~宣言</h4>
 </p>
 
 <p>
-~parameterに与えられた型の個数が：
-◎
-↓</p>
-
-<ul>
-	<li>
-1 個ならば，~ifcは
+~parameterとして， 1 個の型が与えられた場合、
+当の~ifcは
 `値~反復子@
-（ `value iterator^en ）を有することになる
+（ `value iterator^en ）を有する
 — それは、
 所与の型の値たちを供する。
 ◎
 If a single type parameter is given, then the interface has a value iterator and provides values of the specified type.＼
-</li>
-	<li>
-2 個ならば，~ifcは
+</p>
+
+<p>
+~parameterとして， 2 個の型が与えられた場合、
+当の~ifcは
 `~pair反復子@
-（ `pair iterator^en ）を有することになる
-— それは、［
-所与の
-( ~key型, 値~型 )
-の値たちが成す`値~pair$
-］たちを供する。
+（ `pair iterator^en ）を有する
+— それは、
+`値~pair$たちを供する。
 ◎
 If two type parameters are given, then the interface has a pair iterator and provides value pairs with the given types.
-</li>
-</ul>
+</p>
 
 <p>
 各
 `値~pair@
 （ `value pair^en ）は、
-2 つの`~item$sct
+2 個の`~item$sct
 ( `~key$vP, `値$vP )
 からなる`構造体$である：
 ◎
 A value pair, given a key type and a value type, is a struct with two items:
 </p>
-<ol>
+<ul>
 	<li>
 `~key@vP
-は、
-~key型の~IDL値を値にとる，［
-`名前$sct ~EQ `key^l
-］なる`~item$sctである
+の`名前$sctは `key^l であり，
+1 個目の型の~IDL値を値にとる。
 ◎
 an item whose name is "key", which is referred to as the value pair’s key, and whose value is an IDL value of the key type;
 </li>
 	<li>
 `値@vP
-は、
-値~型の~IDL値を値にとる，［
-`名前$sct ~EQ `value^l
-］なる`~item$sctである
+の`名前$sctは `value^l であり，
+2 個目の型の~IDL値を値にとる。
 ◎
 an item whose name is "value", which is referred to as the value pair’s value, and whose value is an IDL value of the value type.
 </li>
-</ol>
+</ul>
 
 <p>
 `値~反復子$は、
@@ -9019,28 +9007,40 @@ <h4 title="Iterable declarations">2.5.9. 可反復~宣言</h4>
 
 <div class="note">
 <p>注記：
-`値~反復子$に対し生成される~JS `forEach^jp ~methodは、
-`Array.prototype.forEach^c が行うように，その~callbackを呼出す。
-`~pair反復子$用の `forEach^jp ~methodは、
-`Map.prototype.forEach^c が行うように，その~callbackを呼出す。
+［
+`値~反復子$／`~pair反復子$
+］用に生成される~JS `forEach^jp ~methodは、［
+`Array.prototype.forEach^c ／ `Map.prototype.forEach^c
+］が行う様に，その~callbackを呼出す。
 ◎
 The JavaScript forEach method that is generated for a value iterator invokes its callback like Array.prototype.forEach does, and the forEach method for a pair iterator invokes its callback like Map.prototype.forEach does.
 </p>
 
 <p>
-現在，`値~反復子$は`有index~propを~support$する~ifcに限り許容されているので、
-`forEach^jp ~methodを配列のように利用することもイミを成す。
 `値~反復子$は、
-次に該当する `forEach^jp ~methodにも必要になり得る
-⇒＃
-(a) `有index~propを~support$しない~ifc上のもの／
-(b) ~callbackを，代わりに `Set.prototype.forEach^c のように呼出すもの（ここでの~keyは、値と同じ）。
+現時点では，`有index~propを~support$する~ifcにしか許容されないので、
+`Array^jt`-like^en な `forEach^jp ~methodを利用することもイミを成す。
+次のような`値~反復子$も必要になり得る：
 ◎
-Since value iterators are currently allowed only on interfaces that support indexed properties, it makes sense to use an Array-like forEach method. There could be a need for value iterators (a) on interfaces that do not support indexed properties, or (b) with a forEach method that instead invokes its callback like Set.prototype.forEach (where the key is the same as the value).＼
+Since value iterators are currently allowed only on interfaces that support indexed properties, it makes sense to use an Array-like forEach method. There could be a need for value iterators＼
 </p>
+<ul>
+	<li>
+`有index~propを~support$しない~ifc上にあるもの
+◎
+(a) on interfaces that do not support indexed properties,＼
+</li>
+	<li>
+~callbackを代わりに `Set.prototype.forEach^c の様に呼出す `forEach^jp ~methodを伴うもの
+（そこでの~keyは、
+値と同じになる）
+◎
+or (b) with a forEach method that instead invokes its callback like Set.prototype.forEach (where the key is the same as the value).＼
+</li>
+</ul>
 
 <p>
-そのような `forEach^jp ~methodを必要とする~APIを再~作成している策定者は、
+そのような `forEach^jp ~methodが必要になる~APIを作成している策定者は、
 `Enhancement request for Iterables$fIされたし。
 ◎
 If you’re creating an API that needs such a forEach method, please file an issue.
@@ -9049,7 +9049,7 @@ <h4 title="Iterable declarations">2.5.9. 可反復~宣言</h4>
 
 <p class="note">注記：
 `配列~反復子~obj$は，このように働く。
-`有index~propを~support$する ~ifcに対しては、［
+`有index~propを~support$する ~ifc用には、［
 `entries^jp ／ `keys^jp ／ `values^jp ／ `Symbol.iterator$jI
 ］から返される反復子~objは，実際の`配列~反復子~obj$である。
 ◎