본문 바로가기
← 패키지 목록

Active

인증된 제출자

watson/active

제출자 이우진
최신 v7.3.0라이센스 MIT배포 2026년 10월 23일

현재 라우트, 컨트롤러, 액션을 인식할 수 있게 해 주는 Laravel 헬퍼

Active for Laravel

Build Status Total Downloads Latest Stable Version Latest Unstable Version License Buy us a tree

Active는 현재 경로(path)나 라우트를 쉽게 판별할 수 있게 해 주는 Laravel용 헬퍼 패키지입니다. Bootstrap 프레임워크에서 쓰는 'active' 클래스를 메뉴에 붙이거나, 특정 라우트가 활성화된 경우에만 어떤 동작을 수행하고 싶을 때 유용합니다. 또한 현재 컨트롤러와 액션 이름을 가져오는 헬퍼도 함께 제공합니다.

설치

먼저 Composer로 패키지를 설치합니다.

composer require watson/active

Laravel 5.1을 사용 중인가요? 이 경우 사용할 수 있는 최신 버전은 2.0.4입니다.

다음으로 config/app.php 파일에 서비스 프로바이더를 추가합니다.

Watson\Active\ActiveServiceProvider::class

헬퍼 함수 대신 파사드(Facade)를 사용하려면 aliases 배열에 다음을 추가합니다.

'Active' => Watson\Active\Facades\Active::class

Active 사용하기

헬퍼 함수

Active는 파사드를 쓰거나 인스턴스를 직접 만들지 않고도 편하게 사용할 수 있도록 두 개의 헬퍼 함수를 제공합니다.

active() is_active()

active() 사용하기

현재 페이지인지 확인하고 싶은 라우트 또는 경로의 배열을 전달하면, 하나라도 일치할 때 Bootstrap용 문자열 active를 반환합니다. 두 번째 인자로 반환할 문자열을 직접 지정할 수도 있습니다.

active(['login', 'users/*', 'posts.*', 'pages.contact']); // 현재 경로 또는 라우트 이름이 하나라도 일치하면 'active'를 반환합니다. active(['login', 'logout'], 'active-class'); // 현재 라우트가 'login' 또는 'logout'이면 'active-class'를 반환합니다. active(['login', 'logout'], 'active-class', 'fallback-class'); // 현재 라우트가 'login' 또는 'logout'이 아니면 'fallback-class'를 반환합니다.

첫 번째 예제에서 이 함수는 현재 경로가 login이거나, users/로 시작하거나, 현재 라우트 이름이 posts.create일 때 active 문자열을 반환합니다.

전달할 수 있는 인자 형태가 여러 가지라는 점에 유의하세요. 경로 문자열, 와일드카드(*)를 사용한 경로 문자열, 그리고 이름이 지정된 라우트(named route)를 모두 사용할 수 있습니다.

링크에 이 함수를 사용하면 활성 상태 표시를 쉽게 줄 수 있습니다.

<a href="{{ route('posts.index') }}" class="{{ active('posts.index') }}">All posts</a>

판별 대상에서 제외할 경로나 라우트를 지정할 수도 있습니다.

active(['pages/*', 'not:pages/contact']) active(['pages.*', 'not:pages.contact'])

is_active() 사용하기

active()와 거의 같은 방식으로 경로와 라우트를 전달하지만, 문자열 대신 현재 페이지와 일치하는지를 나타내는 불리언 값을 반환합니다.

@if (is_active('posts/*')) You're looking at a blog post! @endif

추가 헬퍼

요청이 컨트롤러로 라우팅된 경우, 현재 컨트롤러와 액션 이름을 가져오는 함수 두 개가 더 제공됩니다. 이 함수들은 요청 메서드를 제외한 컨트롤러/액션 이름을 소문자로 반환합니다. 다음은 FooController@getBar로 라우팅된 요청의 예입니다.

$controller = controller_name(); // foo $action = action_name(); // bar

라이선스

Active for Laravel은 100% 무료 오픈소스이며 MIT 라이선스를 따릅니다. 원하는 대로 자유롭게 사용하세요.

이 패키지는 Treeware입니다. 프로덕션 환경에서 사용한다면, 저희의 작업에 대한 감사의 표시로 세상을 위해 나무 한 그루를 사 주세요. Treeware 숲에 기여하면 지역 가정에 일자리를 만들고 야생동물 서식지를 복원하는 데 도움이 됩니다.