balanceTags()
Виправляє неправильно введені XHTML (HTML) теги.
Функція спочатку перевіряє опцію use_balanceTags, якщо вона вимкнена, то функція нічого робити не буде. Для того, щоб функція працювала в будь-якому випадку, потрібно вказати другий параметр $force=true.
Автоматичне балансування XHTML тегів включається в опціях: Установки > Написання > WordPress повинен автоматично виправляти некоректний XHTML-код.
Працює на основі:
1 раз – 0.0001741 сек
(швидко) | 50000 разів – 0.37 сек
(дуже швидко) |
PHP 7.4.8, WP 5.8
1 раз – 0.0001741 сек
(швидко) | 50000 разів – 0.37 сек
(дуже швидко) |
PHP 7.4.8, WP 5.8
Хуків немає.
Повертає
Строку. Відформатований текст.
Використання
<?php balanceTags( $text, $force ); ?>
-
$text
(рядок) (обов’язковий) -
Рядок, в якому потрібно виправити XHTML (HTML) теги.
За замовчуванням: ” -
$force
(логічний) -
true — функція виправлятиме теги у будь-якому випадку. false — функція буде працювати лише якщо увімкнена опція в налаштуваннях.
Типово: false
Приклади
#1 Приклад того, як функція змінює місцями неправильно використані html теги і як закриває теги, які не були закриті:
$text = "<p><b>Це текст, в якому</p></b> html теги не збалансовані. <p>Тобто. є які відкриваються, але потім не закриваються, що може призвести до проблем. Використовуємо функцію <strong>balanceTags()."; echo htmlspecialchars( balanceTags($text, 1) );
Отримаємо:
<p><b>Це текст, в якому</b></p> html теги не збалансовані. <p>Тобто. є які відкриваються, але потім не закриваються, що може призвести до проблем. Використовуємо функцію <strong>balanceTags().</strong></p>
список змін
| З версії 0.71 | Введено. |
Код balanceTags() balanceTags WP 6.0.2
function balanceTags( $text, $force = false ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
if ( $force || (int) get_option( 'use_balanceTags' ) === 1 ) {
return force_balance_tags($text);
} else {
return $text;
}
}