87. searchReplaceElement

87. searchReplaceElement
	Chapter 6. Commands written in the Java™ programming language

Parameter syntax:

[ search|searchBackwards|replace|replaceBackwards|
  findAgain|findAgainBackwards|
  replaceAgain|replaceAgainBackwards|
  find search_spec|findBackwards search_spec]?

Displays a (non-modal) dialog box which lets the user search and replace elements in the document being edited.

The parameter defaults to search.

search: Displays the dialog box ready to be used to search elements from explicitly or implicitly selected node to the end of the document.
searchBackwards: Displays the dialog box ready to be used to search elements from explicitly or implicitly selected node to the beginning of the document (backwards).
replace: Displays the dialog box ready to be used to search and replace elements from explicitly or implicitly selected node to the end of the document.
replaceBackwards: Displays the dialog box ready to be used to search and replace elements from explicitly or implicitly selected node to the beginning of the document (backwards).
findAgain: The dialog box is not displayed. Repeats last specified search operation starting at explicitly or implicitly selected node and ending at the end of the document.
findAgainBackwards: The dialog box is not displayed. Repeats last specified search operation starting at explicitly or implicitly selected node and ending at the beginning of the document (backwards).
replaceAgain: The dialog box is not displayed. Repeats last specified search and replace operation starting at explicitly or implicitly selected node and ending at the end of the document.
replaceAgainBackwards: The dialog box is not displayed. Repeat last specified search and replace operation starting at explicitly or implicitly selected node and ending at the beginning of the document (backwards).
findsearch_spec: The dialog box is not displayed. Performs specified search operation starting at explicitly or implicitly selected node and ending at the end of the document.
findBackwardssearch_spec: The dialog box is not displayed. Performs specified search operation starting at explicitly or implicitly selected node and ending at the beginning of the document (backwards).

search_spec, the argument of find and findBackwards, contains up to 7 fields separated with whitespace. An empty field is specified as character minus (-) without a quote of any kind. A field containing whitespace must be quoted (e.g. "1 2 3" or 'a b c'). Character minus (-) when used as an actual field value must be quoted (that is, "-" or '-').

These 7 fields are:

Searched element name. This field may contain one or more qualified XML names (e.g. para, {http://www.w3.org/1999/xhtml}li) or wildcards (e.g. *, {http://www.w3.org/2000/svg}*).
Note that namespace prefixes are not supported here. A qualified name must be specified using notation {namespace_URI}local_name, the so-called James Clark's notation.
Searched attribute name. This field may contain one or more qualified XML names (e.g. href, xml:lang) or wildcards (e.g. *, {http://www.w3.org/1999/xlink}*).
Note that namespace prefixes are not supported here. A qualified name must be specified using notation {namespace_URI}local_name, the so-called James Clark's notation.
Operation used to compare found attribute value with searched attribute value: = (Equals), *= (Contains), ~= (Contains item), =~ (Matches Regular Expression).
Searched attribute value.
#text is searched element must contain text, - otherwise.
Operation used to compare found text with searched text: = (Equals), *= (Contains), =~ (Matches Regular Expression).
Searched text.

Examples:

{http://www.w3.org/1999/xhtml}caption - - - - - -

- xml:id - - - - -

"{http://www.w3.org/1999/xhtml}a {http://www.w3.org/1999/xhtml}area" {}href =~ ^http(s)?:// - - -


86. searchReplace		88. selectAt