.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.
.. include:: ../../../Includes.txt
.. _styling-drop-down-behavior:
Behavior of the text styling drop-down list
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Only one of the classes is pre-selected in the Text Style selectlist
and therefore shown in the collapsed selectlist. At all times, only
classes allowed by the configuration settings are presented in the
selectlist.
.. _styling-legend:
Legend:
"""""""
highlighted (selected) string:This is the string inside the textarea
the user has selected using the mouse or keyboard.
\|= cursor position inside the textarea.
.. _styling-case-1-no-string-is-highlighted-and-the-cursor-is-outside-any-inline-element:
Case 1: No string is highlighted and the cursor is outside any inline element:
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
a) the option shown in the collapsed selectlist is 'No text style';
b) the selectlist is disabled.
.. _styling-case-2-no-string-is-highlighted-and-the-cursor-is-inside-an-inline-element:
Case 2: No string is highlighted and the cursor is inside an inline element:
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
Example:wor\|d
a) the option shown in the collapsed selectlist is the current value
of the element's class attribute, or 'No text style' when the inline
element bears no class attribute;
b) the selectlist is enabled and contains the classes allowed for the
type of inline element;
c) if the author chooses a different class, the class attribute gets
updated; the position of the cursor is unchanged;
d) if the author chooses 'No text style', the current class is
removed; if the element has no more class, the class attribute gets
removed; if the element is a span element and it has no more
attribute, the span element is removed;the position of the cursor is
unchanged.
.. _styling-case-3-a-string-is-highlighted-and-crosses-multiple-elements:
Case 3: A string is highlighted and crosses multiple elements:
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
a) the option shown in the collapsed selectlist is 'No text style';
b) if the string crosses multiple block elements:
- the selectlist is disabled;
c) if the string crosses multiple inline elements:
- the selectlist is enabled and contains the classes allowed for the
'span' element;
- if the author chooses a class, the highlighted string is wrapped with
a 'span' element with the chosen class as value of its class
attribute;
- the resulting marked up string is not highlighted;
- the cursor is positioned at the end of the string.
.. _styling-case-4-the-highlighted-string-is-not-contained-in-any-inline-element:
Case 4: The highlighted string is not contained in any inline element:
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
a) the option shown in the collapsed selectlist is 'No text style';
b) if the author chooses a class, the highlighted string is wrapped
with a 'span' element with the chosen class as value of its class
attribute;
c) the resulting marked up string is not highlighted;
d) the cursor is positioned at the end of the highlighted string.
.. _styling-case-5-the-highlighted-string-is-contained-in-an-inline-element:
Case 5: The highlighted string is contained in an inline element:
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
a) the option shown in the collapsed selectlist is 'No text style';
b) if the author chooses a class, the highlighted string is wrapped
with a 'span' element with the chosen class as value of its class
attribute;
c) the resulting marked up string is not highlighted;
d) the cursor is positioned at the end of the highlighted string.
.. _styling-case-6-the-hightlighted-string-contains-exactly-the-complete-inline-element:
Case 6: The hightlighted string contains exactly the complete inline element:
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
Example of hightlighted string:word
a) the option shown in the collapsed selectlist is the current value
of the element's class attribute, or 'No style' when the inline
element bears no class attribute;
b) the selectlist is enabled and contains the classes allowed for the
type of inline element;
c) if the author chooses a different class, the class attribute gets
updated; the cursor is moved at the end of the highlighted string
which gets de-highlighted;
d)if the author chooses 'No style', the current class is removed; if
the element has no more class, the class attribute gets removed;if the
element is a span element and it has no more attribute, the span
element is removed; the cursor is moved at the end of the highlighted
string which gets de-highlighted.