drupal/core/modules/field_ui/field_ui.js

543 lines
17 KiB
JavaScript

/**
* @file
* Attaches the behaviors for the Field UI module.
*/
(function ($, Drupal, drupalSettings, debounce) {
/**
* @type {Drupal~behavior}
*
* @prop {Drupal~behaviorAttach} attach
* Adds behaviors to the field storage add form.
*/
Drupal.behaviors.fieldUIFieldStorageAddForm = {
attach(context) {
const form = once(
'field_ui_add',
'[data-drupal-selector="field-ui-field-storage-add-form"]',
context,
);
if (form.length) {
const $form = $(form);
// Add a few 'js-form-required' and 'form-required' css classes here.
// We can not use the Form API '#required' property because both label
// elements for "add new" and "re-use existing" can never be filled and
// submitted at the same time. The actual validation will happen
// server-side.
$form
.find(
'.js-form-item-label label,' +
'.js-form-item-field-name label,' +
'.js-form-item-existing-storage-label label',
)
.addClass('js-form-required form-required');
const $newFieldType = $form.find('select[name="new_storage_type"]');
const $existingStorageName = $form.find(
'select[name="existing_storage_name"]',
);
const $existingStorageLabel = $form.find(
'input[name="existing_storage_label"]',
);
// When the user selects a new field type, clear the "existing field"
// selection.
$newFieldType.on('change', function () {
if (this.value !== '') {
// Reset the "existing storage name" selection.
if ($existingStorageName.length) {
$existingStorageName[0].value = '';
$existingStorageName.trigger('change');
}
}
});
// When the user selects an existing storage name, clear the "new field
// type" selection and populate the 'existing_storage_label' element.
$existingStorageName.on('change', function () {
const { value } = this;
if (value !== '') {
if ($newFieldType.length) {
// Reset the "new field type" selection.
$newFieldType[0].value = '';
$newFieldType.trigger('change');
}
// Pre-populate the "existing storage label" element.
if (
typeof drupalSettings.existingFieldLabels[value] !== 'undefined'
) {
$existingStorageLabel[0].value =
drupalSettings.existingFieldLabels[value];
}
}
});
}
},
};
/**
* Attaches the fieldUIOverview behavior.
*
* @type {Drupal~behavior}
*
* @prop {Drupal~behaviorAttach} attach
* Attaches the fieldUIOverview behavior.
*
* @see Drupal.fieldUIOverview.attach
*/
Drupal.behaviors.fieldUIDisplayOverview = {
attach(context, settings) {
once(
'field-display-overview',
'table#field-display-overview',
context,
).forEach((overview) => {
Drupal.fieldUIOverview.attach(
overview,
settings.fieldUIRowsData,
Drupal.fieldUIDisplayOverview,
);
});
},
};
/**
* Namespace for the field UI overview.
*
* @namespace
*/
Drupal.fieldUIOverview = {
/**
* Attaches the fieldUIOverview behavior.
*
* @param {HTMLTableElement} table
* The table element for the overview.
* @param {object} rowsData
* The data of the rows in the table.
* @param {object} rowHandlers
* Handlers to be added to the rows.
*/
attach(table, rowsData, rowHandlers) {
const tableDrag = Drupal.tableDrag[table.id];
// Add custom tabledrag callbacks.
tableDrag.onDrop = this.onDrop;
tableDrag.row.prototype.onSwap = this.onSwap;
// Create row handlers.
$(table)
.find('tr.draggable')
.each(function () {
// Extract server-side data for the row.
const row = this;
if (row.id in rowsData) {
const data = rowsData[row.id];
data.tableDrag = tableDrag;
// Create the row handler, make it accessible from the DOM row
// element.
const rowHandler = new rowHandlers[data.rowHandler](row, data);
$(row).data('fieldUIRowHandler', rowHandler);
}
});
},
/**
* Event handler to be attached to form inputs triggering a region change.
*/
onChange() {
const $trigger = $(this);
const $row = $trigger.closest('tr');
// Do not fire change listeners for items within forms that have their
// own AJAX callbacks to process a change.
if ($trigger.closest('.ajax-new-content').length !== 0) {
return;
}
const rowHandler = $row.data('fieldUIRowHandler');
const refreshRows = {};
refreshRows[rowHandler.name] = $trigger.get(0);
// Handle region change.
const region = rowHandler.getRegion();
if (region !== rowHandler.region) {
const $fieldParent = $row.find('select.js-field-parent');
if ($fieldParent.length) {
// Remove parenting.
$fieldParent[0].value = '';
}
// Let the row handler deal with the region change.
$.extend(refreshRows, rowHandler.regionChange(region));
// Update the row region.
rowHandler.region = region;
}
// Fields inside `.tabledrag-hide` are typically hidden. They can be
// visible when "Show row weights" are enabled. If their value is changed
// while visible, the row should be marked as changed, but they should not
// be processed via AJAXRefreshRows as they are intended to be fields AJAX
// updates the value of.
if ($trigger.closest('.tabledrag-hide').length) {
const thisTableDrag = Drupal.tableDrag['field-display-overview'];
// eslint-disable-next-line new-cap
const rowObject = new thisTableDrag.row(
$row[0],
'',
thisTableDrag.indentEnabled,
thisTableDrag.maxDepth,
true,
);
rowObject.markChanged();
rowObject.addChangedWarning();
} else {
// Ajax-update the rows.
Drupal.fieldUIOverview.AJAXRefreshRows(refreshRows);
}
},
/**
* Lets row handlers react when a row is dropped into a new region.
*/
onDrop() {
const dragObject = this;
const row = dragObject.rowObject.element;
const $row = $(row);
const rowHandler = $row.data('fieldUIRowHandler');
if (typeof rowHandler !== 'undefined') {
const regionRow = $row.prevAll('tr.region-message').get(0);
const region = regionRow.className.replace(
/([^ ]+[ ]+)*region-([^ ]+)-message([ ]+[^ ]+)*/,
'$2',
);
if (region !== rowHandler.region) {
// Let the row handler deal with the region change.
const refreshRows = rowHandler.regionChange(region);
// Update the row region.
rowHandler.region = region;
// Ajax-update the rows.
Drupal.fieldUIOverview.AJAXRefreshRows(refreshRows);
}
}
},
/**
* Refreshes placeholder rows in empty regions while a row is being dragged.
*
* Copied from block.js.
*
* @param {HTMLElement} draggedRow
* The tableDrag rowObject for the row being dragged.
*/
onSwap(draggedRow) {
const rowObject = this;
$(rowObject.table)
.find('tr.region-message')
.each(function () {
const $this = $(this);
// If the dragged row is in this region, but above the message row, swap
// it down one space.
if (
$this.prev('tr').get(0) ===
rowObject.group[rowObject.group.length - 1]
) {
// Prevent a recursion problem when using the keyboard to move rows
// up.
if (
rowObject.method !== 'keyboard' ||
rowObject.direction === 'down'
) {
rowObject.swap('after', this);
}
}
// This region has become empty.
if (
$this.next('tr').length === 0 ||
!$this.next('tr')[0].matches('.draggable')
) {
$this.removeClass('region-populated').addClass('region-empty');
}
// This region has become populated.
else if (this.matches('.region-empty')) {
$this.removeClass('region-empty').addClass('region-populated');
}
});
},
/**
* Triggers Ajax refresh of selected rows.
*
* The 'format type' selects can trigger a series of changes in child rows.
* The #ajax behavior is therefore not attached directly to the selects, but
* triggered manually through a hidden #ajax 'Refresh' button.
*
* @param {object} rows
* A hash object, whose keys are the names of the rows to refresh (they
* will receive the 'ajax-new-content' effect on the server side), and
* whose values are the DOM element in the row that should get an Ajax
* throbber.
*/
AJAXRefreshRows(rows) {
// Separate keys and values.
const rowNames = [];
const ajaxElements = [];
Object.keys(rows || {}).forEach((rowName) => {
rowNames.push(rowName);
ajaxElements.push(rows[rowName]);
});
if (rowNames.length) {
// Add a throbber next each of the ajaxElements.
$(ajaxElements).after(Drupal.theme.ajaxProgressThrobber());
const $refreshRows = $('input[name=refresh_rows]');
if ($refreshRows.length) {
// Fire the Ajax update.
$refreshRows[0].value = rowNames.join(' ');
}
once(
'edit-refresh',
'input[data-drupal-selector="edit-refresh"]',
).forEach((input) => {
// Keep track of the element that was focused prior to triggering the
// mousedown event on the hidden submit button.
let returnFocus = {
drupalSelector: null,
scrollY: null,
};
// Use jQuery on to listen as the mousedown event is propagated by
// jQuery trigger().
$(input).on('mousedown', () => {
returnFocus = {
drupalSelector: document.activeElement.hasAttribute(
'data-drupal-selector',
)
? document.activeElement.getAttribute('data-drupal-selector')
: false,
scrollY: window.scrollY,
};
});
input.addEventListener('focus', () => {
if (returnFocus.drupalSelector) {
// Refocus the element that lost focus due to this hidden submit
// button being triggered by a mousedown event.
document
.querySelector(
`[data-drupal-selector="${returnFocus.drupalSelector}"]`,
)
.focus();
}
// Ensure the scroll position is the same as when the input was
// initially changed.
window.scrollTo({
top: returnFocus.scrollY,
});
returnFocus = {};
});
});
$('input[data-drupal-selector="edit-refresh"]').trigger('mousedown');
// Disabled elements do not appear in POST ajax data, so we mark the
// elements disabled only after firing the request.
$(ajaxElements).prop('disabled', true);
}
},
};
/**
* Row handlers for the 'Manage display' screen.
*
* @namespace
*/
Drupal.fieldUIDisplayOverview = {};
/**
* Constructor for a 'field' row handler.
*
* This handler is used for both fields and 'extra fields' rows.
*
* @constructor
*
* @param {HTMLTableRowElement} row
* The row DOM element.
* @param {object} data
* Additional data to be populated in the constructed object.
*
* @return {Drupal.fieldUIDisplayOverview.field}
* The field row handler constructed.
*/
Drupal.fieldUIDisplayOverview.field = function (row, data) {
this.row = row;
this.name = data.name;
this.region = data.region;
this.tableDrag = data.tableDrag;
this.defaultPlugin = data.defaultPlugin;
this.$pluginSelect = $(row).find('.field-plugin-type');
this.$regionSelect = $(row).find('select.field-region');
// Attach change listeners to select and input elements in the row.
$(row).find('select, input').on('change', Drupal.fieldUIOverview.onChange);
return this;
};
Drupal.fieldUIDisplayOverview.field.prototype = {
/**
* Returns the region corresponding to the current form values of the row.
*
* @return {string}
* Either 'hidden' or 'content'.
*/
getRegion() {
if (this.$regionSelect.length) {
return this.$regionSelect[0].value;
}
},
/**
* Reacts to a row being changed regions.
*
* This function is called when the row is moved to a different region, as
* a
* result of either :
* - a drag-and-drop action (the row's form elements then probably need to
* be updated accordingly)
* - user input in one of the form elements watched by the
* {@link Drupal.fieldUIOverview.onChange} change listener.
*
* @param {string} region
* The name of the new region for the row.
*
* @return {object}
* A hash object indicating which rows should be Ajax-updated as a result
* of the change, in the format expected by
* {@link Drupal.fieldUIOverview.AJAXRefreshRows}.
*/
regionChange(region) {
// Replace dashes with underscores.
region = region.replace(/-/g, '_');
if (this.$regionSelect.length) {
// Set the region of the select list.
this.$regionSelect[0].value = region;
}
// Restore the formatter back to the default formatter only if it was
// disabled previously. Pseudo-fields do not have default formatters,
// we just return to 'visible' for those.
if (this.region === 'hidden') {
const pluginSelect =
typeof this.$pluginSelect.find('option')[0] !== 'undefined'
? this.$pluginSelect.find('option')[0].value
: undefined;
const value =
typeof this.defaultPlugin !== 'undefined'
? this.defaultPlugin
: pluginSelect;
if (typeof value !== 'undefined') {
if (this.$pluginSelect.length) {
this.$pluginSelect[0].value = value;
}
}
}
const refreshRows = {};
refreshRows[this.name] = this.$pluginSelect.get(0);
return refreshRows;
},
};
/**
* Filters the existing fields table by the field name or field type.
*
* @type {Drupal~behavior}
*/
Drupal.behaviors.tableFilterByText = {
attach() {
const [input] = once('table-filter-text', '.js-table-filter-text');
if (!input) {
return;
}
const $table = $(input.getAttribute('data-table'));
let $rows;
let searching = false;
function filterRows(e) {
const query = e.target.value;
function showRow(index, row) {
const sources = row.querySelectorAll('.form-item');
let sourcesConcat = '';
// Concatenate the textContent of the elements in the row, with a
// space in between.
sources.forEach((item) => {
sourcesConcat += ` ${item.textContent}`;
});
// Make it case-insensitive.
const textMatch = sourcesConcat
.toLowerCase()
.includes(query.toLowerCase());
$(row).closest('tr').toggle(textMatch);
}
// Filter if the length of the query is at least 1 character.
if (query.length > 0) {
searching = true;
$rows.each(showRow);
} else if (searching) {
searching = false;
$rows.show();
}
}
function preventEnterKey(event) {
if (event.key === 'Enter') {
event.preventDefault();
event.stopPropagation();
}
}
if ($table.length) {
$rows = $table.find('tbody tr');
$(input).on({
keyup: debounce(filterRows, 200),
keydown: preventEnterKey,
});
}
},
};
/**
* Allows users to select an element which checks a radio button.
*
* @type {Drupal~behavior}
*
* @prop {Drupal~behaviorAttach} attach
* Attaches behavior for selecting field.
*/
Drupal.behaviors.clickToSelect = {
attach(context) {
$(once('field-click-to-select', '.js-click-to-select', context)).on(
'click',
(event) => {
const clickToSelect = event.target.closest('.js-click-to-select');
const input = clickToSelect.querySelector('input');
input.checked = true;
// Ensure focus is added at the end of the process so wrap in
// a timeout.
setTimeout(() => {
// Remove the disabled attribute added by Drupal ajax so the
// element is focusable. This is safe as clicking the element
// multiple times causes no problems.
input.removeAttribute('disabled');
input.focus();
}, 0);
$(input).trigger('updateOptions');
},
);
},
};
})(jQuery, Drupal, drupalSettings, Drupal.debounce);