NAME

Krang::ElementClass::PoorTextList - a multi field WYSIWYG element

SYNOPSIS

   $class = pkg('ElementClass::PoorTextList')->new( 
        name     => "poortext",
        type     => 'textarea',
        commands => 'all',
   );

DESCRIPTION

This element combines the WYSIWYG capability of Krang::ElementClass::PoorText with the list management controls of Krang::ElementClass::TextInputList. Where the latter comes with HTML text input fields, this class comes with PoorText fields.

This class is based on Krang::ElementClass::_PoorTextBase.

INTERFACE

All the normal Krang::ElementClass attributes are available, plus:

• type
  
May be 'text' or 'textarea' to mimic the two flavors of legacy text input and textarea fields.
• width
  
The width of the edit area. Defaults to 400px.
• height
  
The height of the edit area. For type 'textarea' defaults to 120px. For type 'text' this option takes no effect.
• commands
  
This can be either a string denoting a pre-cooked set of WYSIWYG commands or an array or command names. The pre-cooked sets are:

   basic                    => [ qw(bold     italic      underline
                                    cut      copy        paste
                                    add_html delete_html add_story_link
                                    redo     undo
                                    help     toggle_selectall)
                               ],
   basic_with_special_chars => [ qw(bold         italic      underline
                                    cut          copy        paste
                                    add_html     delete_html add_story_link
                                    redo         undo
                                    specialchars help        toggle_selectall)
                               ],
   all                      => [ qw(bold          italic       underline
                                    strikethrough subscript    superscript
                                    cut           copy         paste
                                    add_html      delete_html  add_story_link
                                    redo          undo
                                    specialchars  help         toggle_selectall) ],

Most of these commands should be self-evident. Some, however, are not:

• add_html
  
This command opens a popup allowing to wrap the selected text with a A, ABBR or ACRONYM tag.
• delete_html
  
Deletes an A, ABBR or ACRONYM around the current selection.
• add_story_link
  
This command hooks Krang's StoryLink selection into PoorText fields. The hard find feature known from Krang::ElementClass::StoryLink is also supported.
• specialchars
  
This command displays a second toolbar allowing to insert double and single curly quotes as well as the ndash.
• toggle_selectall
  
This command is only accessible via the keyboard using the default shortcut Ctrl-a. PoorText implements this command as a toggle. When deselecting, the original position of the cursor or the original selection is restituted.

• command_button_bar
  
This boolean determines whether a button bar with the configured commands will be displayed when the edit area receives focus. (You might want to just use the shortcuts. Which ones? Press Ctrl-h). The default is true.
• special_char_bar
  
If true, the specialchar button bar will be displayed when the edit area receives focus. In this case, even if the command button bar is configured to contain the specialchars command (the omega sign), this command will not be present. Defaults to false.
• shortcut_for
  
This hashref maps commands and specialchars to shortcuts. The default is:

    bold              => 'ctrl_b',
    italic            => 'ctrl_i',
    underline         => 'ctrl_u',
    subscript         => 'ctrl_d',
    superscript       => 'ctrl_s',
    strikethrough     => 'ctrl_t',
    toggle_selectall  => 'ctrl_a',
    add_html          => 'ctrl_l',
    delete_html       => 'ctrl_shift_l',
    add_story_link    => 'ctrt_shift_s',
    redo              => 'ctrl_y',
    undo              => 'ctrl_z',
    help              => 'ctrl_h',
    cut               => 'ctrl_x',
    copy              => 'ctrl_c',
    paste             => 'ctrl_v',
    specialchars      => 'ctrl_6',
    lsquo             => 'ctrl_4',
    rsquo             => 'ctrl_5',
    ldquo             => 'ctrl_2',
    rdquo             => 'ctrl_3',
    ndash             => 'ctrl_0',

(See htdocs/poortext/src/poortext_core.js for more information)

• defaults
  
Either a number specifying the number of input fields to be created when creating the element, or an arrayref of strings that will prepopulate the list of input fields. Defaults to 1.
• find
  
The find parameter works the way known from Krang::ElementClass::StoryLink.

Integrating PoorTextList with Xinha-based bulk editing

This elementclass may be used to represent (un)ordered HTML lists. Legal values for the option bulk_edit_tag are therefore limited to

  ul, ol

For

  p, h1, h2, h3, h4, h5, h6, address, pre

see Krang::ElementClass::PoorText.

SEE ALSO

The base class Krang::ElementClass::_PoorTextBase and the PoorText source in htdocs/poortext/src/.