blob: e296aa2c29bd9df92159f64050d2816ca6e3245f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
|
---
title: SVGStringList
slug: Web/API/SVGStringList
tags:
- API
- Reference
- SVG
- SVG DOM
translation_of: Web/API/SVGStringList
---
<div>{{APIRef("SVG")}}</div>
<h2 id="SVG_string_list_interface" name="SVG_string_list_interface">SVGStringList インターフェイス</h2>
<p><code>SVGStringList</code> は {{domxref("DOMString")}} オブジェクトのリストを定義します。</p>
<p><code>SVGStringList</code> オブジェクトは読み取り専用に設計できます。まりオブジェクトを編集しようとすると例外が投げられることになります。</p>
<h3 id="Interface_overview" name="Interface_overview">インターフェイスの概要</h3>
<table class="standard-table">
<tbody>
<tr>
<th scope="row">Also implement</th>
<td><em>なし</em></td>
</tr>
<tr>
<th scope="row">メソッド</th>
<td>
<ul>
<li><code>void clear()</code></li>
<li>{{domxref("DOMString")}} <code>initialize(in {{domxref("DOMString")}} <em>newItem</em>)</code></li>
<li>{{domxref("DOMString")}} <code>getItem(in unsigned long <em>index</em>)</code></li>
<li>{{domxref("DOMString")}} <code>insertItemBefore(in {{domxref("DOMString")}} <em>newItem</em>, in unsigned long <em>index</em>)</code></li>
<li>{{domxref("DOMString")}} <code>replaceItem(in {{domxref("DOMString")}} <em>newItem</em>, in unsigned long <em>index</em>)</code></li>
<li>{{domxref("DOMString")}} <code>removeItem(in unsigned long <em>index</em>)</code></li>
<li>{{domxref("DOMString")}} <code>appendItem(in {{domxref("DOMString")}} <em>newItem</em>)</code></li>
</ul>
</td>
</tr>
<tr>
<th scope="row">属性</th>
<td>
<ul>
<li>readonly unsigned long <code>numberOfItems</code></li>
<li>readonly unsigned long <code>length</code> {{non-standard_inline}}</li>
</ul>
</td>
</tr>
<tr>
<th scope="row">Normative document</th>
<td><a class="external" href="http://www.w3.org/TR/SVG11/types.html#InterfaceSVGStringList">SVG 1.1 (2nd Edition)</a></td>
</tr>
</tbody>
</table>
<h2 id="Properties" name="Properties">属性</h2>
<table class="standard-table">
<thead>
<tr>
<th>名前</th>
<th>型</th>
<th>説明</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>numberOfItems</code></td>
<td><code>unsigned long</code></td>
<td>リスト内の項目の数</td>
</tr>
<tr>
<td><code>length</code></td>
<td><code>unsigned long</code></td>
<td><code>numberOfItems</code> のミラー値で、他のインターフェイスの整合性用。{{non-standard_inline}}</td>
</tr>
</tbody>
</table>
<h2 id="Methods" name="Methods">メソッド</h2>
<table class="standard-table">
<thead>
<tr>
<th>名前と引数</th>
<th>戻り値</th>
<th>説明</th>
</tr>
</thead>
<tbody>
<tr>
<td><code><strong>clear</strong>()</code></td>
<td><em>void</em></td>
<td>
<p>リストから現在の既存アイテムをクリアーし、その結果空のリストになります。</p>
<p><strong>Exceptions:</strong></p>
<ul>
<li>a {{domxref("DOMException")}} with code <code>NO_MODIFICATION_ALLOWED_ERR</code> is raised when the list corresponds to a read only attribute or when the object itself is read only.</li>
</ul>
</td>
</tr>
<tr>
<td><code><strong>initialize</strong>(in {{domxref("DOMString")}} <em>newItem</em>)</code></td>
<td>{{domxref("DOMString")}}</td>
<td>
<p>リストから現在の既存アイテムをクリアーしてパラメーターで指定された単一項目を保持するように初期化します。挿入した項目が既にある場合は、直前のリストから削除された後に挿入されます。挿入した項目は項目自体であってコピーではありません。戻り値はリストに挿入された項目です。</p>
<p><strong>Exceptions:</strong></p>
<ul>
<li>a {{domxref("DOMException")}} with code <code>NO_MODIFICATION_ALLOWED_ERR</code> is raised when the list corresponds to a read only attribute or when the object itself is read only.</li>
</ul>
</td>
</tr>
<tr>
<td><code><strong>getItem</strong>(in unsigned long <em>index</em>)</code></td>
<td>{{domxref("DOMString")}}</td>
<td>
<p>リスト内の指定した項目を返します。戻り値は項目自体であってコピーではありません。戻り値はリストに挿入された項目です。項目になされた変更は即座にリストに反映されます。最初の項目は数字のゼロです。</p>
<p><strong>Exceptions:</strong></p>
<ul>
<li>a {{domxref("DOMException")}} with code <code>NO_MODIFICATION_ALLOWED_ERR</code> is raised when the list corresponds to a read only attribute or when the object itself is read only.</li>
</ul>
</td>
</tr>
<tr>
<td><code><strong>insertItemBefore</strong>(in {{domxref("DOMString")}} <em>newItem</em>, in unsigned long <em>index</em>)</code></td>
<td>{{domxref("DOMString")}}</td>
<td>
<p>リストの指定した位置に新しい項目を挿入します。最初の項目は数字の 0 です。<code>newItem</code> がリスト中にすでに存在する場合、リストに挿入される前に以前のリストから削除されます。挿入される項目は項目自身でコピーではありません。注意点としてその前に挿入するという index は項目を削除する前の時点です。<code>index</code> が 0 と等しい場合、新項目はリストの前に挿入されます。index が <code>numberOfItems</code> 以上の場合、新項目はリストの後に挿入されます。</p>
<p><strong>Exceptions:</strong></p>
<ul>
<li>a {{domxref("DOMException")}} with code <code>NO_MODIFICATION_ALLOWED_ERR</code> is raised when the list corresponds to a read only attribute or when the object itself is read only.</li>
</ul>
</td>
</tr>
<tr>
<td><code><strong>replaceItem</strong>(in {{domxref("DOMString")}} <em>newItem</em>, in unsigned long <em>index</em>)</code></td>
<td>{{domxref("DOMString")}}</td>
<td>
<p>リスト内の項目を新項目に置き換えます。<code>newItem</code> がリスト内にすでに存在する場合、リストに挿入される前に以前のリストから削除されます。挿入される項目は項目自身でコピーではありません。項目がリストにすでに存在する場合、注意点として置換する項目の index は項目を削除する前の時点です。</p>
<p><strong>Exceptions:</strong></p>
<ul>
<li>a {{domxref("DOMException")}} with code <code>NO_MODIFICATION_ALLOWED_ERR</code> is raised when the list corresponds to a read only attribute or when the object itself is read only.</li>
<li>a {{domxref("DOMException")}} with code <code>INDEX_SIZE_ERR</code> is raised if the index number is greater than or equal to <code>numberOfItems</code>.</li>
</ul>
</td>
</tr>
<tr>
<td><code><strong>removeItem</strong>(in unsigned long <em>index</em>)</code></td>
<td>{{domxref("DOMString")}}</td>
<td>
<p>リストから既存項目を削除します。</p>
<p><strong>Exceptions:</strong></p>
<ul>
<li>a {{domxref("DOMException")}} with code <code>NO_MODIFICATION_ALLOWED_ERR</code> is raised when the list corresponds to a read only attribute or when the object itself is read only.</li>
<li>a {{domxref("DOMException")}} with code <code>INDEX_SIZE_ERR</code> is raised if the index number is greater than or equal to <code>numberOfItems</code>.</li>
</ul>
</td>
</tr>
<tr>
<td><code><strong>appendItem</strong>(in {{domxref("DOMString")}} <em>newItem</em>)</code></td>
<td>{{domxref("DOMString")}}</td>
<td>
<p>リストの最後に新項目を挿入します。<code>newItem</code> がリスト内にすでに存在する場合、リストに挿入される前に以前のリストから削除されます。挿入される項目は項目自身でコピーではありません。</p>
<p><strong>Exceptions:</strong></p>
<ul>
<li>a {{domxref("DOMException")}} with code <code>NO_MODIFICATION_ALLOWED_ERR</code> is raised when the list corresponds to a read only attribute or when the object itself is read only.</li>
</ul>
</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザー実装状況</h2>
<div class="hidden">
<p>The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
</div>
<p>{{Compat("api.SVGStringList")}}</p>
<p> </p>
|
