richtext::markdown::add_editor (public)

 richtext::markdown::add_editor -text_id text_id -contents contents \
    [ -format format ] [ -format_field ] [ -repeat_template ] \
    [ -image_upload_url image_upload_url ]

Defined in packages/richtext-markdown/tcl/richtext-procs.tcl

Enhance a textarea with the Markdown editor and submit rendered HTML.

Switches:
-text_id (required)
the textarea ID
-contents (required)
the original textarea content before browser normalization
-format (optional, defaults to "text/html")
MIME type of the original content
-format_field (optional, boolean, defaults to "true")
whether the form has a companion MIME type field
-repeat_template (optional, boolean)
whether the textarea is a disabled repeat template
-image_upload_url (optional)
optional same-origin endpoint for pasted image blobs

Partial Call Graph (max 5 caller/called nodes):
richtext::markdown::initialize_widget richtext::markdown::initialize_widget (public) richtext::markdown::add_editor richtext::markdown::add_editor richtext::markdown::initialize_widget->richtext::markdown::add_editor _ _ (public) richtext::markdown::add_editor->_ ad_html_text_convert ad_html_text_convert (public) richtext::markdown::add_editor->ad_html_text_convert lang::message::lookup lang::message::lookup (public) richtext::markdown::add_editor->lang::message::lookup security::csrf::new security::csrf::new (public) richtext::markdown::add_editor->security::csrf::new template::head::add_javascript template::head::add_javascript (public) richtext::markdown::add_editor->template::head::add_javascript

Testcases:
No testcase defined.
Source code:
    set base /resources/richtext-markdown
    set ::acs_blank_master(markdown_toolbar) 1
    ::template::head::add_javascript -defer -order 10.1 -src urn:ad:js:marked
    ::template::head::add_javascript -defer -order 10.2 -src urn:ad:js:dompurify
    ::template::head::add_javascript -defer -order 10.4 -src $base/editor.js?v=6

    set original_html {}
    set legacy_html {}
    if {$format eq "text/html"} {
        set original_html $contents
        if {$original_html ne "" || $repeat_template_p} {
            ::template::head::add_javascript -defer -order 10.3 -src urn:ad:js:turndown
        }
    } elseif {$format ne "text/markdown"} {
        set legacy_html [ad_html_text_convert -from $format -to text/html -- $contents]
    }

    set image_options {}
    if {$image_upload_url ne ""} {
        set image_options [list $image_upload_url [::security::csrf::new]  [::lang::message::lookup "" richtext-markdown.Image_upload_pending "Uploading pasted image..." {} 0 0]  [::lang::message::lookup "" richtext-markdown.Image_upload_error "The image could not be uploaded." {} 0 0]  [::lang::message::lookup "" richtext-markdown.Pasted_image "Pasted image" {} 0 0]]
    }

    # Base64 keeps values out of the inline script syntax.
    set arguments {}
    foreach value [list $text_id $format  [_ richtext-markdown.Render_error] [_ richtext-markdown.Unavailable]  $legacy_html $original_html  [string is true -strict $format_field_p]  [string is true -strict $repeat_template_p]  {*}$image_options] {
        lappend arguments \"[binary encode base64 [encoding convertto utf-8 $value]]\"
    }
    ::template::head::add_javascript -script [format {
        (window.openacsMarkdownWidgets ||= []).push([%s]);
    } [join $arguments {, }]]
    return {}
XQL Not present:
Generic, PostgreSQL, Oracle
[ hide source ] | [ make this the default ]
Show another procedure: