Как я могу добавить активный класс в Laravel для элементов заголовка при нажатии на них?
Я пытался получить активный класс для своих элементов заголовка, когда они нажимаются. У меня есть меню, и мои элементы li внутри меню ведут на определенные страницы на моем веб-сайте. Теперь я хочу добавить к ним активный класс, когда они нажимаются, это легко, когда веб-сайт состоит только из HTML и CSS, но как я могу сделать это в php, чтобы быть более конкретным в Laravel? Я включаю свой заголовок на все страницы.
Мой код header.php:
Может ли кто-нибудь помочь мне, я застрял и не знаю, что мне делать, я пробовал примеры отсюда, но ничего не работает, с наилучшими пожеланиями!
если ссылки перенаправляют на новую страницу, вы не сможете сделать их активными с помощью jquery/javascipt, я сделал активную часть с переменной, которую я установил в контроллере, а затем проверил в заголовке перед печатью
Ginger CSS Wizard
Может ли кто-нибудь сделать пример моего кода для этого? Я продолжаю пробовать что-то из темы, отправленной @GingerCSSWizard, но не могу добиться.
Laravel 9 blade как добавить класс active
- Open with Desktop
- View raw
- Copy raw contents Copy raw contents
Copy raw contents
Copy raw contents
Laravel 9 · Шаблонизатор Blade
Blade – это простой, но мощный движок шаблонов, входящий в состав Laravel. В отличие от некоторых шаблонизаторов PHP, Blade не ограничивает вас в использовании простого кода PHP в ваших шаблонах. На самом деле, все шаблоны Blade компилируются в простой код PHP и кешируются до тех пор, пока не будут изменены, что означает, что Blade добавляет фактически нулевую нагрузку вашему приложению. Файлы шаблонов Blade используют расширение файла .blade.php и обычно хранятся в каталоге resources/views .
Шаблоны Blade могут быть возвращены из маршрутов или контроллеров с помощью глобального помощника view . Конечно, как упоминалось в документации по HTML-шаблонам, данные могут быть переданы в шаблоны Blade, используя второй аргумент помощника view :
Хотите вывести использование шаблонов Blade на новый уровень и с легкостью создавать динамические интерфейсы? Ознакомьтесь с Laravel Livewire.
Вы можете отображать данные, которые передаются в шаблоны Blade, заключив переменную в фигурные скобки. Например, учитывая следующий маршрут:
Вы можете отобразить содержимое переменной name следующим образом:
Выражения вывода << >> Blade автоматически отправляются через функцию htmlspecialchars PHP для предотвращения XSS-атак.
Вы не ограничены отображением содержимого переменных, переданных в шаблон. Вы также можете вывести результаты любой функции PHP. Фактически, вы можете поместить любой PHP-код в выражение вывода Blade:
Преобразование в HTML-сущности
По умолчанию Blade (и глобальный помощник e Laravel) будет дважды кодировать объекты HTML. Если вы хотите отключить двойное кодирование, то вызовите метод Blade::withoutDoubleEncoding в методе boot поставщика App\Providers\AppServiceProvider :
Вывод неэкранированных данных
По умолчанию, выражения вывода << >> Blade автоматически отправляются через функцию htmlspecialchars PHP для предотвращения XSS-атак. Если вы не хотите, чтобы ваши данные были экранированы, вы можете использовать следующий синтаксис:
Будьте очень осторожны при выводе содержимого, полученного от пользователей вашего приложения. Обычно следует использовать экранированный синтаксис двойных фигурных скобок для предотвращения атак XSS при отображении данных, предоставленных пользователем.
Blade и JavaScript фреймворки
Поскольку во многих фреймворках JavaScript также используются «фигурные» скобки, чтобы указать, что данное выражение должно отобразиться в браузере, вы можете использовать символ @ , чтобы сообщить движку Blade, что выражение должно остаться нетронутым. Например:
В этом примере Blade удалит символ @ ; однако выражение << name >> останется нетронутым движком Blade, что позволит обработать его вашим фреймворком JavaScript.
Символ @ также используется для исключения из обработки директив Blade:
Вы можете передать массив в ваш шаблон с намерением отобразить его как JSON для инициализации переменной JavaScript. Например:
Однако вместо ручного вызова json_encode вы можете использовать метод Illuminate\Support\Js::from . Метод from принимает те же аргументы, что и функция json_encode PHP; однако это гарантирует, что полученный JSON будет правильно экранирован кавычками HTML. Метод from вернет строковое выражение JSON.parse JavaScript, которое преобразует переданный объект или массив в допустимый объект JavaScript:
Последние версии приложения Laravel включают фасад Js , который обеспечивает удобный доступ к этому функционалу в ваших шаблонах Blade:
Вы должны использовать метод Js::from только для отображения существующих переменных как JSON. Шаблонизатор Blade основан на регулярных выражениях, и попытки передать сложное выражение в метод могут вызвать неожиданные сбои.
Если вы отображаете переменные JavaScript в крупной части своего шаблона, вы можете заключить HTML в директиву @verbatim , чтобы вам не приходилось добавлять префикс @ к каждому выражению вывода Blade:
Помимо наследования шаблонов и отображения данных, Blade также содержит удобные псевдонимы для общих структур управления PHP, таких как условные операторы и циклы. Эти директивы обеспечивают очень чистый и лаконичный способ работы со структурами управления PHP, но при этом остаются схожими со своими аналогами PHP.
Вы можете создавать операторы if , используя директивы @if , @elseif , @else и @endif . Эти директивы работают так же, как и их аналоги в PHP:
Для удобства Blade также содержит директиву @unless :
В дополнение к уже обсужденным условным директивам, директивы @isset и @empty могут использоваться в качестве удобных ярлыков для соответствующих функций PHP:
Директивы @auth и @guest могут использоваться для быстрого определения, является ли текущий пользователь аутентифицированным или считается гостем:
При необходимости вы можете указать охранника аутентификации для проверки при использовании директив @auth и @guest :
Вы можете проверить, запущено ли приложение в эксплуатационном окружении, с помощью директивы @production :
Или вы можете определить, работает ли приложение в конкретной среде, с помощью директивы @env :
Вы можете определить, есть ли в секции наследуемого шаблона содержимое, используя директиву @hasSection :
Вы можете использовать директиву sectionMissing , чтобы определить, что в секции нет содержимого:
Операторы Switch могут быть созданы с использованием директив @switch , @case , @break , @default и @endswitch :
В дополнение к условным операторам, Blade содержит простые директивы для работы со структурами циклов PHP. Опять же, каждая из этих директив работает так же, как и их аналоги в PHP:
При итерации с помощью foreach вы можете использовать переменную Loop, чтобы получить информацию о цикле, например, находитесь ли вы в первой или последней итерации цикла.
Вы также можете пропустить текущую итерацию или завершить цикл, используя директивы @continue и @break :
Вы также можете включить в объявление директивы условие продолжения или прерывания:
При итерации с помощью foreach внутри цикла доступна переменная $loop . Она обеспечивает доступ к некоторой полезной информации, например, индекс текущего цикла, первая это или последняя итерация цикла:
При нахождении во вложенном цикле, вы можете получить доступ к переменной $loop родительского цикла через свойство parent :
Переменная $loop также содержит множество других полезных свойств:
| Свойство | Описание |
|---|---|
| $loop->index | Индекс текущей итерации цикла (начинается с 0). |
| $loop->iteration | Текущая итерация цикла (начинается с 1). |
| $loop->remaining | Итерации, оставшиеся в цикле. |
| $loop->count | Общее количество элементов в итерируемом массиве. |
| $loop->first | Первая ли это итерация цикла. |
| $loop->last | Последняя ли это итерация цикла. |
| $loop->even | Четная ли это итерация цикла. |
| $loop->odd | Нечетная ли это итерация цикла. |
| $loop->depth | Уровень вложенности текущего цикла. |
| $loop->parent | Переменная родительского цикла во вложенном цикле. |
Директива @class условно компилирует строку класса CSS. Директива принимает массив классов, где ключ массива содержит класс или классы, которые вы хотите добавить, а значение является логическим выражением. Если элемент массива имеет числовой ключ, он всегда будет включен в отображаемый список классов:
Отмеченные / Выделенные / Отключенные элементы интерфейса
Для удобства вы можете использовать директиву @checked , чтобы указать, должен ли быть «отмечен» HTML-флажок. Эта директива выведет checked , если переданное условие является истинным:
Аналогично, директива @selected может использоваться для указания, следует ли «выбрать» указанный элемент выпадающего списка:
Аналогично, директива @disabled может использоваться для указания, следует ли «заблокировать» указанный элемент:
Подключение дочерних шаблонов
Хотя вы можете использовать директиву @include , компоненты Blade содержат аналогичный функционал и предлагают несколько преимуществ по сравнению с директивой @include , например привязку данных и атрибутов.
Директива @include Blade позволяет вам включать шаблоны из другого шаблона. Все переменные, доступные для родительского шаблона, будут доступны для включенного шаблона:
Включенный шаблон унаследует все данные, доступные в родительском шаблоне, но вы также можете передать массив дополнительных данных, которые должны быть доступны для включенного шаблона:
Если вы попытаетесь включить несуществующий шаблон, Laravel выдаст ошибку. Если вы хотите включить шаблон, который может присутствовать или отсутствовать, вам следует использовать директиву @includeIf :
Если вы хотите включить шаблон в зависимости от результата логического выражения, возвращающего либо true , либо false , то используйте директивы @includeWhen и @includeUnless :
Чтобы включить первый существующий шаблон из переданного массива шаблонов, вы можете использовать директиву includeFirst :
Вам следует избегать использования в ваших шаблонах Blade констант __DIR__ и __FILE__ , поскольку они будут ссылаться на расположение кешированного, скомпилированного шаблона.
Отрисовка шаблонов с коллекциями
Вы можете cкомбинировать циклы и подключение шаблона в одну строку с помощью директивы Blade @each :
Первый аргумент директивы @each – это шаблон, отображаемый для каждого элемента в массиве или коллекции. Второй аргумент – это массив или коллекция, которую вы хотите перебрать, а третий аргумент – это имя переменной, которая будет присвоена текущей итерации в шаблоне. Так, например, если вы выполняете итерацию по массиву jobs , обычно вам нужно обращаться к каждому элементу как к переменной job в шаблоне. Ключ массива для текущей итерации будет доступен как переменная key в шаблоне.
Вы можете передать четвертый аргумент директиве @each . Этот аргумент определяет шаблон, который будет отображаться, если переданный массив пуст.
Шаблоны, отображаемые с помощью @each , не наследуют переменные родительского шаблона. Если дочернему шаблону требуются эти переменные, вам следует использовать вместо них директивы @foreach и @include .
Директива @once позволяет вам определить часть шаблона, которая будет проанализирована только один раз за цикл визуализации. Это может быть полезно для вставки переданного фрагмента JavaScript в подвал страницы с помощью стеков. Например, если вы отображаете переданный компонент в цикле, то бывает необходимо разместить JavaScript в подвале при визуализации компонента только единожды:
Поскольку как директива @once часто используется в сочетании с директивами @push или @prepend , то для удобства доступны директивы @pushOnce и @prependOnce :
В крайних ситуациях можно встроить PHP-код в ваши шаблоны. Вы можете использовать директиву @php Blade для размещения блока простого PHP в вашем шаблоне:
Blade также позволяет вам определять комментарии в ваших шаблонах. Однако, в отличие от комментариев HTML, комментарии Blade не будут включены в результирующий HTML, возвращаемый вашим приложением:
Компоненты и слоты предоставляют те же преимущества, что и секции, макеты и включение шаблона из другого шаблона; однако, некоторым может быть легче понять мысленную модель компонентов и слотов. Есть два подхода к написанию компонентов: компоненты на основе классов и анонимные компоненты.
Чтобы создать компонент на основе класса, вы можете использовать команду make:component Artisan. Чтобы проиллюстрировать, как использовать компоненты, мы создадим простой компонент Alert . Команда make:component поместит компонент в каталог app/View/Components :
Команда make: component также создаст шаблон для компонента. Шаблон будет помещен в каталог resources/views/components . При написании компонентов для вашего собственного приложения компоненты автоматически обнаруживаются в каталогах app/View/Components и resources/views/components , поэтому дополнительная регистрация компонентов обычно не требуется.
Вы также можете создавать компоненты в подкаталогах:
Приведенная выше команда создаст компонент Input в каталоге App\View\Components\Forms , а шаблон будет помещен в каталог resources/views/components/forms .
Если вы хотите создать анонимный компонент (компонент только с шаблоном Blade и без класса), то вы можете использовать флаг —view при вызове команды make:component :
Приведенная выше команда создаст файл Blade в resources/views/components/forms/input.blade.php , который можно использовать как компонент: <x-forms.input /> .
Самостоятельная регистрация компонентов пакета
При написании компонентов для вашего собственного приложения компоненты автоматически обнаруживаются в каталогах app/View/Components и resources/views/components .
Однако, если вы создаете пакет, который использует компоненты Blade, вам необходимо вручную зарегистрировать класс компонента и его псевдоним HTML-тега. Вы должны зарегистрировать свои компоненты в методе boot поставщика служб вашего пакета:
После того, как ваш компонент был зарегистрирован, он может быть отображен с использованием псевдонима тега:
Как вариант, вы можете использовать метод componentNamespace для автоматической загрузки классов компонентов по соглашению. Например, пакет Nightshade может иметь компоненты Calendar и ColorPicker , которые находятся в пространстве имен Package\Views\Components :
Это позволит использовать компоненты пакета в пространстве имен их поставщиков, используя синтаксис x-package-name:: :
Blade автоматически обнаружит класс, связанный с этим компонентом, используя «верблюжий регистр» имени компонента. Подкаталоги также поддерживаются с использованием «точечной» нотации.
Для отображения компонента вы можете использовать тег компонента Blade в одном из ваших шаблонов Blade. Теги компонентов Blade начинаются со строки x- , за которой следует имя в «шашлычном регистре» класса компонента:
Если класс компонента имеет вложенность в каталоге app/View/Components , то вы можете использовать символ . для обозначения вложенности каталогов. Например, если мы предполагаем, что компонент находится в App\View\Components\Inputs\Button.php , то мы можем отобразить его так:
Передача данных компонентам
Вы можете передавать данные в компоненты Blade, используя атрибуты HTML. Жестко запрограммированные примитивные значения могут быть переданы компоненту с помощью простых строк атрибутов HTML. Выражения и переменные PHP следует передавать компоненту через атрибуты, которые используют символ : в качестве префикса:
Вы должны определить необходимые данные компонента в его конструкторе класса. Все общедоступные свойства компонента будут автоматически доступны в шаблоне компонента. Нет необходимости передавать данные в шаблон из метода render компонента:
Когда ваш компонент визуализируется, вы можете отображать содержимое общедоступных переменных вашего компонента, выводя переменные по имени:
Аргументы конструктора компонентов следует указывать с помощью camelCase , а при обращении к именам аргументов в ваших атрибутах HTML следует использовать kebab-case . Например, учитывая следующий конструктор компонента:
Аргумент $alertType может быть передан компоненту следующим образом:
Экранирование атрибутов от синтаксического анализа
Поскольку некоторые фреймворки JavaScript, такие как Alpine.js, также используют атрибуты с префиксом двоеточия, вы можете использовать префикс с двойным двоеточием ( :: ), чтобы сообщить Blade, что атрибут не является выражением PHP. Например, учитывая следующий компонент:
Blade отобразит следующий HTML-код:
В дополнение к общедоступным переменным, доступным для вашего шаблона компонента, могут быть вызваны любые общедоступные методы компонента. Например, представьте компонент, у которого есть метод isSelected :
Вы можете выполнить этот метод из своего шаблона компонента, вызвав переменную, соответствующую имени метода:
Доступ к атрибутам и слотам в классах компонентов
Компоненты Blade также позволяют получить доступ к имени компонента, атрибутам и слоту внутри метода render класса. Однако, чтобы получить доступ к этим данным, вы должны вернуть замыкание из метода render вашего компонента. Замыкание получит массив $data в качестве единственного аргумента. Этот массив будет содержать несколько элементов, предоставляющих информацию о компоненте:
componentName эквивалентно имени, используемому в HTML-теге после префикса x- . Таким образом, componentName компонента <x-alert /> будет alert . Элемент attributes будет содержать все атрибуты, которые присутствовали в HTML-теге. Элемент slot – это экземпляр Illuminate\Support\HtmlString с содержимым слота компонента.
Замыкание должно возвращать строку. Если возвращенная строка соответствует существующему шаблону, то этот шаблон будет отрисован; в противном случае возвращенная строка будет оцениваться как встроенный шаблон Blade.
Если вашему компоненту требуются зависимости из контейнера служб Laravel, то вы можете указать их перед любыми атрибутами данных компонента, и они будут автоматически внедрены контейнером:
Скрытие атрибутов / методов
Если вы хотите, чтобы некоторые публичные методы или свойства не использовались как переменные в шаблоне компонента, вы можете добавить их в свойство массива $except в вашем компоненте:
Мы уже рассмотрели, как передавать атрибуты данных в компонент; иногда требуется указать дополнительные атрибуты HTML, такие как class , которые не являются частью данных, необходимых для функционирования компонента. Как правило, вы хотите передать эти дополнительные атрибуты корневому элементу шаблона компонента. Например, представьте, что мы хотим отобразить компонент alert следующим образом:
Все атрибуты, которые не являются частью конструктора компонента, будут автоматически добавлены в «коллекцию атрибутов» компонента. Эта коллекция атрибутов автоматически становится доступной для компонента через переменную $attributes . Все атрибуты могут отображаться в компоненте путем вывода этой переменной:
Использование таких директив, как @env в тегах компонентов в настоящее время не поддерживается. Например, <x-alert :live=»@env(‘production’)»/> не будет компилироваться.
Атрибуты по умолчанию и слияние атрибутов
Иногда требуется указать значения по умолчанию для атрибутов или добавить дополнительные значения в некоторые атрибуты компонента. Для этого вы можете использовать метод merge коллекции атрибутов. Этот метод особенно полезен для определения набора CSS-классов по умолчанию, которые всегда должны применяться к компоненту:
Окончательный обработанный HTML-код компонента будет выглядеть следующим образом:
Условное слияние классов
По желанию можно объединить классы, если указанное условие истинно. Вы можете сделать это с помощью метода class , который принимает массив классов, где ключ массива содержит класс или классы, которые вы хотите добавить, а значение является логическим выражением. Если элемент массива имеет числовой ключ, то он всегда будет добавлен в конечный список классов:
Если вам нужно объединить другие атрибуты в свой компонент, вы можете связать метод merge с методом class :
Если вам нужно условно скомпилировать классы для других элементов HTML, которые не должны получать объединенные атрибуты, вы можете использовать директиву @class .
Слияние неклассовых атрибутов
При слиянии атрибутов, которые не являются атрибутами класса, значения, предоставленные методу merge , будут считаться значениями атрибута по умолчанию. Однако, в отличие от атрибута class , эти атрибуты не будут объединены с указанными значениями атрибутов. Вместо этого они будут перезаписаны. Например, реализация компонента button может выглядеть следующим образом:
Чтобы отобразить компонент кнопки с настраиваемым type , его можно указать при использовании компонента. Если тип не указан, будет использоваться тип button , определенный по умолчанию:
Обработанный HTML-код компонента button в этом примере будет:
Если вы хотите, чтобы атрибут, отличный от class , имел значение по умолчанию и указанное значение, объединенные вместе, вы можете использовать метод prepends . В этом примере атрибут data-controller всегда будет начинаться с profile-controller , а любые дополнительные указанные значения data-controller будут помещены после этого значения по умолчанию:
Получение и фильтрация атрибутов
Вы можете фильтровать атрибуты, используя метод filter . Этот метод принимает замыкание, которое должно возвращать true , если вы хотите сохранить атрибут в коллекции атрибутов:
Для удобства вы можете использовать метод whereStartsWith для получения всех атрибутов, ключи которых начинаются с указанной строки:
И наоборот, метод whereDoesntStartWith может использоваться для исключения всех атрибутов, ключи которых начинаются с указанной строки:
Используя метод first , вы можете отобразить первый атрибут в указанной коллекции атрибутов:
Если вы хотите проверить, присутствует ли атрибут в компоненте, вы можете использовать метод has . Этот метод принимает имя атрибута в качестве единственного аргумента и возвращает логическое значение, указывающее, присутствует ли атрибут:
Вы можете получить значение конкретного атрибута, используя метод get :
Зарезервированные ключевые слова
По умолчанию некоторые ключевые слова зарезервированы для внутреннего использования Blade при визуализации компонентов. Следующие ключевые слова не могут быть определены как публичные свойства или имена методов в ваших компонентах:
- data
- render
- resolveView
- shouldRender
- view
- withAttributes
- withName
Вам часто потребуется передавать дополнительный контент вашему компоненту через «слоты». Слоты компонентов отображаются путем вывода переменной $slot . Чтобы изучить эту концепцию, представим, что компонент alert имеет следующую разметку:
Мы можем передавать контент в slot , вставив контент в компонент:
Иногда внутри компонента требуется отрисовать несколько разных слотов в разных местах. Давайте модифицируем наш компонент оповещения, чтобы учесть вставку слота title :
Вы можете определить содержимое именованнго слота с помощью тега x-slot . Любой контент, не указанный в явном теге x-slot , будет передан компоненту в переменной $slot :
Слоты с ограниченной областью видимости
Если вы использовали фреймворк JavaScript, такой как Vue, то вы, возможно, знакомы со «слотами с ограниченной областью видимости», которые позволяют получать доступ к данным или методам из компонента в вашем слоте. Вы можете добиться аналогичного поведения в Laravel, определив общедоступные методы или свойства в вашем компоненте и получив доступ к компоненту в вашем слоте через переменную $component . В этом примере мы предположим, что компонент x-alert имеет общедоступный метод formatAlert , определенный в его классе компонента:
Подобно компонентам Blade, вы можете назначить дополнительные атрибуты для слотов, такие как имена CSS-классов:
Для взаимодействия с атрибутами слота вы можете получить доступ к свойству attributes переменной слота. Для получения дополнительной информации о том, как взаимодействовать с атрибутами, обратитесь к документации по атрибутам компонента:
Встроенные шаблоны компонентов
Для очень маленьких компонентов может показаться обременительным управлять как классом компонента, так и шаблоном компонента. По этой причине вы можете вернуть разметку компонента прямо из метода render :
Генерация компонентов со встроенными шаблонами
Чтобы создать компонент, который использует встроенный шаблон, вы можете использовать параметр —inline при выполнении команды make:component :
Иногда требуется визуализировать компонент, но вы не знаете, какой компонент следует визуализировать до времени выполнения. В этой ситуации вы можете использовать встроенный в Laravel компонент dynamic-component для отображения компонента на основе значения или переменной, полученной во время выполнения запроса:
Самостоятельная регистрация компонентов
Следующая документация по самостоятельной регистрации компонентов в первую очередь полезна тем, кто пишет пакеты Laravel, которые включают компоненты. Если вы не пишете пакет, эта часть документации компонента может быть вам не нужна.
При написании компонентов для вашего собственного приложения компоненты автоматически обнаруживаются в каталогах app/View/Components и resources/views/components .
Однако, если вы создаете пакет, который использует компоненты Blade или размещаете компоненты в других каталогах, вам необходимо самостоятельно зарегистрировать класс компонента и его псевдоним HTML-тега, чтобы Laravel знал, где найти компонент. Вы должны зарегистрировать свои компоненты в методе boot поставщика служб вашего пакета:
После того, как ваш компонент был зарегистрирован, он может быть отображен с использованием псевдонима тега:
Автозагрузка компонентов пакета
Как вариант, вы можете использовать метод componentNamespace для автоматической загрузки классов компонентов по соглашению. Например, пакет Nightshade может иметь компоненты Calendar и ColorPicker , которые находятся в пространстве имен Package\Views\Components :
Это позволит использовать компоненты пакета в пространстве имен их поставщиков, используя синтаксис x-package-name:: :
Blade автоматически обнаружит класс, связанный с этим компонентом, используя «регистр паскаля» имени компонента. Также поддерживаются подкаталоги с использованием «точечной» нотации.
Подобно встроенным компонентам, анонимные компоненты предоставляют механизм для управления компонентом через один файл. Однако анонимные компоненты используют один файл шаблона, но не имеют связанного с компонентом класса. Чтобы определить анонимный компонент, вам нужно только разместить шаблон Blade в вашем каталоге resources/views/components . Например, если вы определили компонент в resources/views/components/alert.blade.php , вы можете просто отобразить его так:
Вы можете использовать символ . , чтобы указать, вложен ли компонент в каталоге components . Например, если компонент определен в resources/views/components/inputs/button.blade.php , вы можете отобразить его так:
Анонимные составные компоненты
Если компонент состоит из множества шаблонов Blade, то вы можете сгруппировать шаблоны данного компонента в одном каталоге. Например, представьте себе компонент «аккордеон» со следующей структурой каталогов:
Эта структура каталогов позволяет отображать компонент аккордеона и его элементы следующим образом:
Однако для того, чтобы отобразить данный компонент через x-accordion , мы были вынуждены поместить «индексный» шаблон компонента в каталог resources/views/components вместо того, чтобы вкладывать его вместе с другими связанными шаблонами в каталог accordion .
К счастью, Blade позволяет вам разместить файл index.blade.php в каталоге шаблонов компонента. Когда для компонента существует шаблон index.blade.php , он будет отображаться как «корневой» узел компонента. Итак, мы можем продолжать использовать тот же синтаксис Blade, что и в примере выше, но мы изменим структуру каталогов следующим образом:
Свойства / атрибуты данных
Поскольку анонимные компоненты не имеют ассоциированного класса, вы можете задаться вопросом, как можно различить, какие данные должны быть переданы компоненту как переменные, а какие атрибуты должны быть помещены в коллекцию атрибутов компонента.
Вы можете указать, какие атрибуты следует рассматривать как переменные данных, используя директиву @props в верхней части шаблона Blade вашего компонента. Все остальные атрибуты компонента будут доступны через коллекцию атрибутов компонента. Если вы хотите присвоить переменной данных значение по умолчанию, вы можете указать имя переменной в качестве ключа массива и значение по умолчанию в качестве значения массива:
Учитывая приведенное выше определение компонента, мы можем отобразить компонент следующим образом:
Доступ к данным родительского компонента
Иногда внутри дочернего компонента требуется доступ к данным родительского компонента. В этих случаях вы можете использовать директиву @aware . Например, представьте, что мы создаем сложный компонент меню, состоящий из родительского <x-menu> и дочернего <x-menu.item> :
Компонент <x-menu> может иметь следующую реализацию:
Поскольку свойство color было передано только родительскому элементу <x-menu> , оно не будет доступно внутри <x-menu.item> . Однако, если мы воспользуемся директивой @aware , то мы можем сделать свойство доступным и внутри <x-menu.item> :
Директива @aware не может получить доступ к родительским данным, если они не переданы родительскому компоненту явным образом через атрибуты HTML. Значения по умолчанию @props , которые не переданы явно родительскому компоненту, не могут быть доступны директиве @aware .
Анонимные пространства имен компонентов
Как обсуждалось ранее, анонимные компоненты обычно определяются путем размещения шаблона Blade в вашем каталоге resources/views/components . Однако иногда требуется зарегистрировать другие пути анонимных компонентов в Laravel в дополнение к пути по умолчанию.
Например, при создании приложения для бронирования отеля вы можете поместить анонимные компоненты, связанные с бронированием авиабилета, в каталог resources/views/flights/bookings/components . Чтобы сообщить Laravel о расположении этого анонимного компонента, вы можете использовать метод anonymousComponentNamespace фасада Blade.
Метод anonymousComponentNamespace принимает «путь» к местоположению анонимного компонента в качестве первого аргумента и «пространство имен», в котором должны быть размещены компоненты, в качестве второго аргумента. Как вы увидите в приведенном ниже примере, «пространство имен» будет добавлено к имени компонента при отрисовки компонента. Как правило, вызов этого метода осуществляется в методе boot одного из поставщиков служб вашего приложения:
Учитывая приведенный выше пример, вы можете использовать компонент panel , который существует в только что зарегистрированном каталоге компонентов, следующим образом:
Макеты с использованием компонентов
Большинство веб-приложений поддерживают одинаковый общий макет на разных страницах. Было бы невероятно громоздко и сложно поддерживать наше приложение, если бы нам приходилось повторять весь HTML-макет в каждом создаваемом экране. К счастью, этот макет удобно определить как один компонент Blade, а затем использовать его во всем приложении.
Определение компонента макета
Например, представьте, что мы создаем приложение со списком задач. Мы могли бы определить компонент layout , который выглядит следующим образом:
Использование компонента макета
Как только компонент layout определен, мы можем создать шаблон Blade, который будет использовать этот компонент. В этом примере мы определим простой шаблон, который отображает наш список задач:
Помните, что содержимое, внедренное в компонент, по умолчанию будет передано переменной $slot компонента layout . Как вы могли заметить, наш layout также учитывает слот $title , если он предусмотрен; в противном случае отображается заголовок по умолчанию. Мы можем добавить другой заголовок из нашего шаблона списка задач, используя стандартный синтаксис слотов, описанный в документации по компонентам:
Теперь, когда мы определили наш макет и шаблоны списка задач, нам просто нужно вернуть представление task из маршрута:
Макеты с использованием наследования шаблонов
Макеты также могут быть созданы с помощью «наследования шаблонов». Это был основной способ создания приложений до появления компонентов.
Для начала рассмотрим простой пример. Сначала мы изучим макет страницы. Поскольку большинство веб-приложений поддерживают одинаковый общий макет на разных страницах, удобно определить этот макет как единый шаблон Blade:
Как видите, этот файл содержит типичную разметку HTML. Однако, обратите внимание на директивы @section и @yield . Директива @ section , как следует из названия, определяет секцию содержимого, тогда как директива @yield используется для отображения содержимого секции, предоставленного дочерним шаблоном.
Теперь, когда мы определили макет для нашего приложения, давайте определим дочернюю страницу, которая наследует макет.
При определении дочернего шаблона используйте директиву Blade @extends , чтобы указать, какой макет дочерний шаблон должен «наследовать». Шаблоны, расширяющие макет Blade, могут добавлять содержимое в секции макета с помощью директив @section . Помните, как видно из приведенного выше примера, содержимое этих секций будет отображаться в макете с помощью @yield :
В этом примере секция sidebar использует директиву @@parent для добавления (а не перезаписи) содержимого к боковой панели макета. Директива @@parent будет заменена содержимым макета при визуализации представления.
В отличие от предыдущего примера, нынешняя секция sidebar заканчивается @endsection вместо @show . Директива @endsection будет только определять секцию, в то время как @show будет определять и немедленно дополнять секцию.
Директива @yield также принимает значение по умолчанию в качестве второго параметра. Это значение будет отображено, если дополняемый раздел не определен:
Каждый раз, когда вы определяете HTML-форму в своем приложении, вы должны включать в форму скрытое поле токена CSRF, чтобы посредник защиты от CSRF мог провалидировать запрос. Вы можете использовать директиву @csrf Blade для генерации поля токена:
Поскольку HTML-формы не могут выполнять запросы PUT , PATCH или DELETE , вам нужно будет добавить скрытое поле _method , чтобы подменить эти HTTP-методы. Директива @method Blade поможет создать для вас такое поле:
Директива @error используется для быстрой проверки наличия сообщений об ошибках валидации для конкретного атрибута. В директиве @error вы можете вывести содержимое переменной $message для отображения сообщения об ошибке:
Поскольку директива @error компилируется в конструкцию if , то вы можете использовать директиву @else для отображения содержимого в случае отсутствия ошибки валидации атрибута:
Вы можете передать имя конкретной коллекции ошибок в качестве второго параметра директивы @error для получения сообщений об ошибках валидации на страницах, содержащих несколько форм:
Blade позволяет вам добавлять содержимое к именованным стекам, которые можно отобразить где-нибудь еще в другом шаблоне или макете. Это может быть особенно полезно для указания любых библиотек JavaScript, необходимых для ваших дочерних шаблонов:
Вы можете помещать в стек сколько угодно раз. Чтобы отобразить полное содержимое стека, передайте имя стека в директиву @stack :
Если вы хотите добавить содержимое в начало стека, вы должны использовать директиву @prepend :
Директива @inject используется для извлечения службы из контейнера служб Laravel. Первый аргумент, переданный в @inject , – это имя переменной, в которую будет помещена служба, а второй аргумент – это имя класса или интерфейса службы, которую вы хотите извлечь:
Отрисовка встроенных шаблонов Blade
Иногда требуется преобразовать строку шаблона Blade в HTML. Вы можете сделать это, используя метод render фасада Blade . Метод render принимает строку шаблона Blade и необязательный массив данных для шаблона:
Laravel отображает встроенные шаблоны Blade, записывая их в каталог storage/framework/views . Если вы хотите, чтобы Laravel удалял эти временные файлы после отрисовки шаблона Blade, то вы можете передать методу именованный аргумент deleteCachedView :
Blade позволяет вам определять ваши собственные пользовательские директивы с помощью метода directive . Когда компилятор Blade встречает вашу директиву, он вызывает указанное замыкание с выражением, содержащимся в директиве.
В следующем примере создается директива @datetime($var) , которая форматирует переданный $var , который должен быть экземпляром DateTime :
Как видите, мы привяжем метод format к любому выражению, переданному в директиву. Итак, в этом примере окончательный PHP, сгенерированный этой директивой, будет:
После обновления логики директивы Blade вам нужно будет удалить все кешированные шаблоны Blade. Кешированные шаблоны Blade могут быть удалены с помощью команды view:clear Artisan.
Пользовательские обработчики вывода
Если вы попытаетесь «отобразить» объект с помощью Blade, будет вызван метод объекта __toString . Метод __toString является одним из встроенных в PHP «магических методов». Однако иногда у вас может не быть контроля над методом __toString передаваемого класса, например, когда класс, с которым вы взаимодействуете, принадлежит сторонней библиотеке.
В этих случаях Blade позволяет вам зарегистрировать собственный обработчик вывода для конкретного типа объекта. Для этого вы должны вызвать метод stringable Blade. Метод stringable принимает замыкание. Это замыкание должно получит тип объекта, за отрисовку которого оно отвечает. Как правило, вызов метода stringable осуществляется в методе boot поставщика App\Providers\AppServiceProvider :
После того, как ваш обработчик был определен, вы можете просто вывести объект в своем шаблоне Blade:
Пользовательские операторы If
Программирование пользовательской директивы иногда бывает более сложным, чем необходимо при определении простых пользовательских условных операторов. По этой причине Blade содержит метод Blade::if , который позволяет быстро определять пользовательские условные директивы с помощью замыканий. Например, давайте определим условие, которое проверяет сконфигурированный по умолчанию «диск» приложения. Мы можем сделать это в методе boot поставщика App\Providers\AppServiceProvider :
После того, как пользовательское условие было определено, вы можете использовать его в своих шаблонах:
Laravel: How to Make Menu Item Active by URL/Route
Povilas Korop
Founder of QuickAdminPanel
Probably one of the most common operation on every website is to assign “active” CSS class to the menu item which is currently opened. There are quite a few ways to detect that status, let’s review them.
We assume that the code will be based on Bootstrap and active menu item will have this:
Now, the part that we’re interested in is class=”active”. In real Blade, it should be this:
So, how to define that $some_condition_if_active?
Approach 1. Exact URL
Probably, the most simple one – you just check the exact URL and see if it matches:
We use helper function $request->is().
Approach 2. Starting with the URL
This one is similar, but more flexible – will also match any other URL starting with the one we want, like /admin/cities/create or /admin/cities/1/edit.
We use asterisk (*) symbol for it.
Approach 3. Matching URL Segment
Another useful helper is to get URL segments by number.
So, this one will match any URL like /admin/cities, /user/cities/edit etc.
Approach 4. Matching Route by Name
The one that I personally recommend. Route names is a really powerful weapon in case your URLs change for some reason. Let’s say we attached route names with this line in routes/web.php:
So we should match any route name like admin.cities.index or admin.cities.create for menu item to be active.
In this case, all URLs assigned to our resourceful controller will be matched, like /admin/cities, /admin/cities/create, /admin/cities/1/edit etc.