mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-03 01:09:39 +01:00
d1948f623a
- properly labels all the code editor areas (Theme/Plugin, Custom HTML widget, Additional CSS), whether CodeMirror is enabled or disabled - adds `role="textbox"` and `aria-multiline="true"` to the CodeMirror editing area to allow assistive technologies properly identify it as a textarea - standardizes the "keyboard trap" help text across the admin and keeps it as a list for better readability - use the Help text elements as target for `aria-describedby`, to make screen readers read out the help text when focusing the editors - fixes the `aria-expanded` attribute usage in the Customizer "Additional CSS" help toggle - moves focus to the CodeMirror editing area when clicking on the associated label - in the Plugin editor screen: changes a `<big>` element to `<h2>` for better semantics and consistency with the Theme editor screen - also, removes a few textdomain leftovers, see `better-code-editing` and `default` Props westonruter, melchoyce, afercia. Fixes #41872. Built from https://develop.svn.wordpress.org/trunk@41586 git-svn-id: http://core.svn.wordpress.org/trunk@41419 1a063a9b-81f0-0310-95a4-ce76da25c4cd
110 lines
2.3 KiB
PHP
110 lines
2.3 KiB
PHP
<?php
|
|
/**
|
|
* Customize API: WP_Customize_Code_Editor_Control class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Customize
|
|
* @since 4.9.0
|
|
*/
|
|
|
|
/**
|
|
* Customize Code Editor Control class.
|
|
*
|
|
* @since 4.9.0
|
|
*
|
|
* @see WP_Customize_Control
|
|
*/
|
|
class WP_Customize_Code_Editor_Control extends WP_Customize_Control {
|
|
|
|
/**
|
|
* Customize control type.
|
|
*
|
|
* @since 4.9.0
|
|
* @var string
|
|
*/
|
|
public $type = 'code_editor';
|
|
|
|
/**
|
|
* Type of code that is being edited.
|
|
*
|
|
* @since 4.9.0
|
|
* @var string
|
|
*/
|
|
public $code_type = '';
|
|
|
|
/**
|
|
* Code editor settings.
|
|
*
|
|
* @see wp_enqueue_code_editor()
|
|
* @since 4.9.0
|
|
* @var array|false
|
|
*/
|
|
public $editor_settings = array();
|
|
|
|
/**
|
|
* Enqueue control related scripts/styles.
|
|
*
|
|
* @since 4.9.0
|
|
*/
|
|
public function enqueue() {
|
|
$this->editor_settings = wp_enqueue_code_editor( array_merge(
|
|
array(
|
|
'type' => $this->code_type,
|
|
'codemirror' => array(
|
|
'indentUnit' => 2,
|
|
'tabSize' => 2,
|
|
),
|
|
),
|
|
$this->editor_settings
|
|
) );
|
|
}
|
|
|
|
/**
|
|
* Refresh the parameters passed to the JavaScript via JSON.
|
|
*
|
|
* @since 4.9.0
|
|
* @see WP_Customize_Control::json()
|
|
*
|
|
* @return array Array of parameters passed to the JavaScript.
|
|
*/
|
|
public function json() {
|
|
$json = parent::json();
|
|
$json['code_type'] = $this->code_type;
|
|
$json['editor_settings'] = $this->editor_settings;
|
|
$json['input_attrs'] = $this->input_attrs;
|
|
return $json;
|
|
}
|
|
|
|
/**
|
|
* Don't render the control content from PHP, as it's rendered via JS on load.
|
|
*
|
|
* @since 4.9.0
|
|
*/
|
|
public function render_content() {}
|
|
|
|
/**
|
|
* Render a JS template for control display.
|
|
*
|
|
* @since 4.9.0
|
|
*/
|
|
public function content_template() {
|
|
?>
|
|
<# var elementIdPrefix = 'el' + String( Math.random() ); #>
|
|
<# if ( data.label ) { #>
|
|
<label for="{{ elementIdPrefix }}_editor">
|
|
<span class="customize-control-title">{{ data.label }}</span>
|
|
</label>
|
|
<# } #>
|
|
<# if ( data.description ) { #>
|
|
<span class="description customize-control-description">{{{ data.description }}}</span>
|
|
<# } #>
|
|
<div class="customize-control-notifications-container"></div>
|
|
<textarea id="{{ elementIdPrefix }}_editor"
|
|
<# _.each( _.extend( { 'class': 'code' }, data.input_attrs ), function( value, key ) { #>
|
|
{{{ key }}}="{{ value }}"
|
|
<# }); #>
|
|
></textarea>
|
|
<?php
|
|
}
|
|
}
|