context=(value)
[permalink][rdoc][edit]-
要素の「コンテキスト」を Hash で設定します。
コンテキストとは、 text node (REXML::Text) での特別な文字、特に空白についての取り扱いについての設定です。以下の Symbol をハッシュのキーとして使います。
- :respect_whitespace
-
空白を考慮して欲しい要素の名前の集合を文字列の配列で指定します。また、すべての要素で空白を考慮して欲しい場合には :all を指定します。デフォルト値は :all です。 REXML::Element#whitespace も参照してください。
- :compress_whitespace
-
空白を無視して欲しい要素の名前の集合を文字列の配列で指定します。この指定は :respect_whitespace での指定を上書きします。すべての要素で空白を無視して欲しい場合には :all を指定します。 REXML::Element#whitespace も参照してください。
- :ignore_whitespace_nodes
-
空白のみからなるノードを無視して欲しい要素の名前の集合を文字列の配列で指定します。すべての要素で無視して欲しい場合は :all を指定します。これが設定された場合、空白のみからなる text node は追加されません。 REXML::Element#ignore_whitespace_nodes も参照してください。
- :raw
-
raw mode で取り扱いをして欲しい要素の名前の集合を文字列の配列で指定します。すべてのノードを raw mode で取り扱って欲しい場合は :all を指定します。 raw mode においては、text 中の特殊文字は一切変換されません。 REXML::Element#raw も参照してください。
nil を渡すことでデフォルト値を使うよう指示できます。
- [PARAM] value:
- 設定値
[SEE_ALSO] REXML::Element.new, REXML::Element#context