File twig-bundle/src/Extension/BootstrapExtension.php

public function bsButtonFilter(string $target=null, string $icon=null, $label=null, string $context=null, string $size=null, array $attrs=[], bool $trans=true): string

264:

{

265:

// gestion de l'option 'confirm'

266:

$confirm = false;

267:

if (\array_key_exists('confirm', $attrs)) {

268:

$confirm = $attrs['confirm'];

269:

unset($attrs['confirm']);

270:

if (\is_string($confirm) && \strlen($confirm)) $attrs['data-confirm'] = ($trans) ? $this->trans($confirm) : $confirm;

271:

}

272:

273:

// gestion de l'option 'modal'

274:

if (\array_key_exists('modal', $attrs)) {

275:

if (! isset($attrs['disabled']) || ! $attrs['disabled']) {

276:

$attrs['data-bs-toggle'] = "modal";

277:

$attrs['data-bs-target'] = "#" . $attrs['modal'];

278:

}

279:

unset($attrs['modal']);

280:

}

281:

282:

// différents types de boutons selon $target

283:

if (\preg_match('/^(submit|reset|button)?$/', $target)) {

284:

$tag = 'button';

285:

if ($target !== '') {

286:

$attrs['type'] = $target;

287:

if ($label === true ) { $label = 'btn.' . $target; $trans = true; }

288:

}

289:

}

290:

elseif (\preg_match('/^([#\.])(.*)$/', $target, $match)) {

291:

$tag = 'button';

292:

$attrs['type'] = 'button';

293:

if ($match[1] == '#') $attrs['id'] = $match[2];

294:

else $attrs['class'] = $match[2] . ' ' . $attrs['class'];

295:

if ($label === true) { $label = 'btn.' . $match[2]; $trans = true; }

296:

}

297:

elseif (isset($attrs['disabled']) && $attrs['disabled']) {

298:

// si disabled : <button> forcé avec href déporté dans 'data-href'

299:

// sans quoi un <a> avec la classe 'disabled' de bootstrap bloque tout event avec 'pointers-event:none', y compris le changement du cursor !

300:

$tag = 'button';

301:

$attrs['type'] = 'button';

302:

$attrs['data-href'] = $target;

303:

if ($label === true) { $label = $target; $trans = false; }

304:

}

305:

elseif ($confirm) {

306:

// si click à protéger par une demande de confirmation, href déporté dans 'data-href'

307:

// l'URL sera remise uniquement après confirmation positive (évite les risques de court-circuit notamment par un middle-clic)

308:

$tag = 'a';

309:

$attrs['role'] = 'button';

310:

$attrs['href'] = '#need_confirmation'; // alternative: 'javascript:null'

311:

$attrs['data-href'] = $target;

}

else {

$tag = 'a';

$attrs['role'] = 'button';

316:

$attrs['href'] = $target;

317:

if ($label === true) { $label = $target; $trans = false; }

318:

if (isset($attrs['disabled'])) unset($attrs['disabled']);

319:

}

320:

321:

// détermination des classes CSS

322:

if (! \strlen($context)) $context = ($target === 'submit') ? "primary" : "secondary";

323:

$class = "btn btn-" . $context;

324:

if (! empty($size) && ($size != 'md')) $class.= " btn-" . $size;

325:

if (! empty($confirm)) $class.= " btn-confirm";

326:

if (isset($attrs['disabled']) && $attrs['disabled']) $class.= " disabled";

327:

if (\array_key_exists('class', $attrs)) $class.= " " .$attrs['class'];

328:

329:

// génération du contenu du bouton (icone & texte)

330:

if ($label === null) $label = '';

331:

if ($trans) $label = $this->trans($label);

332:

if ($icon) {

333:

$content = $this->getIcon($icon);

334:

if (\strlen($label)) { $content.= " $label"; $class.= " icon-left"; }

} else {

$content = $label;

}

// envoi du tag du bouton

340:

$attrs['class'] = $class;

341:

return \sprintf('<%1$s %2$s>%3$s</%1$s>', $tag, $this->htmlAttr($attrs), $content);

}

/**

* Génération d'un bouton affichant uniquement un icone (avec libellé en title) avec les styles Bootstrap.

346:

*

347:

* @param string $target URL (pour tag A) ou TYPE (pour tag BUTTON avec 'submit'|'reset'|'button') ou #ID ou .CLASS (tag button)

348:

* @param string $icon Nom d'un icone (FontAwesome), par ex: 'ok', 'download', 'envelope', 'ban-circle', 'remove', 'edit', 'list'

349:

* @param string $title Texte à afficher uniquement au survol du bouton (utilisation de $href si true)

350:

* @param string $context Classe Bootstrap pour le style du bouton : 'default', 'primary' (défaut), 'info', 'success', 'warning', 'danger', 'link'

351:

* @param string $size Classe Bootstrap pour indiquer la taille du bouton : 'lg', 'md', 'sm' (défaut), 'xs'

352:

* @param array $attrs Liste d'attributs HTML supplémentaires (ex 'class', 'title', 'confirm', 'disabled')

353:

* @param bool $trans Si faux, désactivation de la traduction du libellé du bouton (et éventuel message de confirmation)

354:

* @return string Code HTML représentant un bouton Bootstrap

355:

*/

356:

public function bsActionFilter(string $target=null, string $icon=null, string $title=null, string $context=null, string $size=null, array $attrs=[], bool $trans=true): string

357:

{

358:

if ($title !== null) $attrs['title'] = ($trans) ? $this->trans($title) : $title;

359:

if (empty($context)) $context = 'primary';

360:

if (empty($size)) $size = 'sm';

361:

return $this->bsButtonFilter($target, $icon, null, $context, $size, $attrs, $trans);

}

/**

* Affichage d'un texte dans une boite d'alerte Bootstrap.

366:

*

367:

* @param string $text Texte à afficher dans la boite d'alerte

368:

* @param string $state Classe Bootstrap : primary, secondary, info (défaut), success, warning, danger, dark, light

369:

* @param mixed $icon Nom d'un icone (ou true/null par défaut pour automatique à partir du $state)

370:

* @param bool $html Désactivation de l'échappement du texte s'il doit déjà contenir du HTML

371:

* @param bool $close Ajout d'un bouton permettant de fermer la boite d'alerte

372:

* @param bool $trans Recherche d'une traduction pour le token $text (si c'est une chaine)

373:

* @return string Code HTML représentant un message d'alerte Bootstrap

374:

*/

375:

public function bsAlertFilter($text, ?string $state = null, $icon = null, bool $html = false, bool $close = false, bool $trans = false): string

376:

{

377:

$class = 'alert-' . (empty($state) ? 'info' : $state);

378:

$head = $body = $foot = '';

379:

380:

if ($icon === null || $icon === true) $icon = $this->getStateIcon($state);

381:

if ($icon) {

382:

$class.= ' d-flex align-items-center';

383:

$head = $this->getIcon($icon) . '<div>';

$foot = '</div>';

}

if ($close) {

$class.= ' alert-dismissible fade show';

388:

$foot.= '<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>';

389:

}

390:

$body = ($trans) ? $this->trans($text) : $text;

391:

if (! $html) $body = \htmlspecialchars($body);

392:

return \sprintf('<div class="alert %s" role="alert">%s</div>', $class, $head, $body, $foot);

}

/**

* Formattage d'une liste de liens en barre de navigation Bootstrap (pour header de card).

398:

*

399:

* @param array $navs Liste de références pour les différents onglets/boutons de la barre

400:

* @param string $type Style des liens : 'tabs' (onglets), 'pills' (boutons) ou 'vtabs' (boutons verticaux)

401:

* @param string $label Préfixe des tokens de traductions pour les libellés des références (défaut 'tabs.group.')

402:

* @param array $extra Liste de contenus HTML (indexés par les références) à ajouter après le libellé

403:

* @return string Code HTML d'une liste de liens de navigation Bootstrap (onglets)

404:

*/

405:

public function cardTabsHeadFunction(array $navs, string $type = 'tabs', ?string $label = 'tabs.group.', array $extra = []): string

406:

{

407:

if (empty($navs)) return '';

408:

409:

if ($type == 'vtabs') {

410:

$container_tag = 'div';

411:

$container_mode = 'vertical';

412:

$container_class = 'nav nav-pills flex-column me-3';

413:

} else {

414:

$container_tag = 'ul';

415:

$container_mode = 'horizontal';

416:

$container_class = 'nav nav-' . $type . ' card-header-tabs';

417:

}

418:

419:

$line = '<button role="tab" data-bs-toggle="'.(($type=='tabs')?'tab':'pill').'" data-bs-target="#%1$s"';

420:

$line.= ' class="nav-link%4$s" aria-controls="%2$s" type="button">%2$s%3$s</button>';

421:

if ($container_tag == 'ul') $line = '<li role="presentation" class="nav-item">' . $line . '</li>' . "\n";

422:

423:

$html = \sprintf('<%s role="tablist" class="%s" aria-orientation="%s">', $container_tag, $container_class, $container_mode);

424:

$active = ' active';

425:

foreach ($navs as $nav) {

426:

if ($nav === '_') $nav = "misc";

427:

$ref = StringHelper::slugify($nav);

428:

$html.= \sprintf($line,

429:

\htmlspecialchars($ref . '_pane'),

430:

\htmlspecialchars(empty($label) ? $nav : $this->trans($label . $ref)),

431:

isset($extra[$ref]) ? $extra[$ref] : '',

$active

);

$active = "";

}

$html.= '</' . $container_tag . '>';

$html.= <<<END

if (typeof ticStarter == "object") ticStarter.add( function(){

441:

// activation de l'onglet correspondant si un hash est passé dans l'URL

442:

var hash = document.location.hash.replace('_tab', '_pane');

443:

if (hash) jQuery('.nav [data-bs-toggle][data-bs-target="' + hash + '"]').first().tab('show');

444:

445:

// mise à jour du hash dans l'URL sur changement d'onglet (ancre altérée pour éviter le déplacement)

446:

var res = jQuery('.nav [data-bs-toggle][data-bs-target]').on('shown.bs.tab', function(e){

447:

document.location.hash = e.target.data('bs-target').replace('_pane', '_tab');

});

});

</script>

END;

return $html;

}

}

Namespaces

Classes