Функция submit_button() в WordPress

Функция submit_button() в WordPress используется для отображения кнопки отправки. Она принимает несколько параметров, чтобы вы могли настроить кнопку в соответствии с вашими нуждами.

Основные сведения

• Работает с: get_submit_button()
• Производительность:
  • 1 раз — 0.000053 сек (очень быстро)
  • 50000 раз — 1.39 сек (быстро)

Возвращаемое значение

• Возвращает: null (ничего).

Использование

Функция вызывается так:

submit_button( $text, $type, $name, $wrap, $other_attributes );

Параметры

• $text (строка) — текст кнопки.

  • По умолчанию: 'Сохранить изменения'

• $type (строка) — тип и CSS класс(ы) для кнопки.

  • Основные значения: primary, small, и large.
  • По умолчанию: 'primary'

• $name (строка) — HTML имя кнопки отправки. Если не указан атрибут id в параметре $other_attributes, то $name будет использовано как id кнопки.

  • По умолчанию: 'submit'

• $wrap (логический) — если true, то кнопка будет обернута в тег <p>, если false — нет.

  • По умолчанию: true

• $other_attributes (массив/строка) — другие атрибуты, которые нужно добавить к кнопке, например, array('id'=>'search-submit'). Атрибуты могут быть также указаны в виде строки, например, id="search-submit", хотя формат массива обычно предпочтительнее.

  • По умолчанию: пустая строка

Примеры использования

Пример 1: Основная кнопка

submit_button( 'Применить', 'action', '', false, [ 'id' => 'doaction2' ] );

Выводит:

Пример 2: Вторая кнопка

По умолчанию функция submit_button() создает основную кнопку. Чтобы создать вторичную кнопку, укажите $type = 'secondary'.

submit_button( __( 'Сбросить', 'textdomain' ), 'secondary' );

Пример 3: Кнопка удаления

В WordPress нет стилей для кнопки удаления по умолчанию. Лучше указать $type как 'delete', чтобы обозначить это.

submit_button( __( 'Удалить', 'textdomain' ), 'delete' );

Чтобы отобра��ить её как основную кнопку, используйте следующий код:

submit_button( __( 'Удалить', 'textdomain' ), 'delete button-primary' );

Пример 4: Использование параметра $name

Параметр $name можно использовать, если вы хотите задать имя HTML для кнопки. По умолчанию значение — submit.

submit_button( __( 'Сохранить настройки', 'textdomain' ), 'primary', 'wpdocs-save-settings' );

Пример 5: Использование параметра $wrap

Параметр $wrap определяет, будет ли кнопка обернута в тег <p>, по умолчанию это так. Чтобы отключить это, укажите false в качестве четвертого параметра.

submit_button( __( 'Отправить', 'textdomain' ), 'primary', 'submit-form', false );

Пример 6: Указание других HTML атрибутов

Вы можете добавить любые HTML-атрибуты для кнопки, используя параметр $other_attributes.

$other_attributes = [ 'tabindex' => '1' ];
submit_button( __( 'Далее!', 'textdomain' ), 'secondary', '', true, $other_attributes );

Заметки

• Функция submit_button() была добавлена в версии 3.1.0 WordPress.

Теперь вы знаете, как использовать функцию submit_button() для создания и настройки кнопок отправки в вашей теме или плагине WordPress!