GitHub에서 보기

테이블 쿠키

Bootstrap Table의 쿠키 확장 기능으로, 테이블 상태를 저장하고 복원합니다.

이 페이지에서

쿠키 확장 기능은 테이블의 상태 정보(예: 페이지 위치, 정렬 상태, 페이지당 표시 항목 수 등)를 쿠키에 저장하여 사용자가 페이지를 다시 방문할 때 이전 설정을 자동으로 복원합니다.

사용법

<script src="extensions/cookie/bootstrap-table-cookie.js"></script>

예제

Cookie

옵션

  • 속성: data-cookie

  • 유형: Boolean

  • 세부 정보:

    쿠키 저장 기능을 활성화할지 여부를 지정합니다. true로 설정하면 테이블의 페이지 상태, 정렬 상태, 검색 조건 등의 정보가 쿠키에 저장됩니다.

  • 기본값: false

cookieCustomStorageDelete

  • 속성: data-cookie-custom-storage-delete

  • 유형: function

  • 매개변수

    • cookieName: 값의 이름(예: 검색 키워드)
  • 세부 정보:

    사용자 정의 함수를 사용하여 저장된 값을 삭제합니다. cookieStorage 옵션이 customStorage로 설정된 경우에만 이 함수를 구현해야 합니다.

  • 기본값: undefined

cookieCustomStorageGet

  • 속성: data-cookie-custom-storage-get

  • 유형: function

  • 매개변수

    • cookieName: 값의 이름(예: 검색 키워드)
  • 세부 정보:

    사용자 정의 함수를 사용하여 저장된 값을 가져옵니다. cookieStorage 옵션이 customStorage로 설정된 경우에만 이 함수를 구현해야 합니다.

  • 기본값: undefined

cookieCustomStorageSet

  • 속성: data-cookie-custom-storage-set

  • 유형: function

  • 매개변수

    • cookieName: 값의 이름(예: 검색 키워드)
    • value: 저장할 값
  • 세부 정보:

    사용자 정의 함수를 사용하여 값을 저장소에 저장합니다. cookieStorage 옵션이 customStorage로 설정된 경우에만 이 함수를 구현해야 합니다.

  • 기본값: undefined

cookieDomain

  • 속성: data-cookie-domain

  • 유형: String

  • 세부 정보:

    쿠키의 도메인을 설정합니다. 일반적으로 www. 접두사를 제거해야 합니다(예: example.com).

  • 기본값: null

cookieExpire

  • 속성: data-cookie-expire

  • 유형: String

  • 세부 정보:

    쿠키의 만료 시간을 설정합니다. 형식은 '숫자+단위'입니다(예: '2h'는 2시간을 의미). 지원되는 시간 단위: 's'(초), 'mi'(분), 'h'(시간), 'd'(일), 'm'(월), 'y'(년).

  • 기본값: 2h

cookieIdTable

  • 속성: data-cookie-id-table

  • 유형: String

  • 세부 정보:

    테이블의 고유 식별자를 설정합니다. 페이지에 여러 테이블이 있는 경우 각 테이블은 고유 ID를 설정해야 쿠키 데이터를 구분할 수 있습니다.

  • 기본값: ''

cookiePath

  • 속성: data-cookie-path

  • 유형: String

  • 세부 정보:

    쿠키의 경로를 설정합니다. 기본값은 현재 페이지 경로이며, 전체 사이트나 특정 디렉토리에서 쿠키가 유효하도록 지정할 수 있습니다.

  • 기본값: null

cookieSecure

  • 속성: data-cookie-secure

  • 유형: Boolean

  • 세부 정보:

    보안 모드를 활성화할지 여부를 지정합니다. true로 설정하면 쿠키는 HTTPS 연결에서만 전송되어 데이터 보안성이 향상됩니다.

  • 기본값: null

cookieSameSite

  • 속성: data-cookie-same-site

  • 유형: string

  • 세부 정보:

    SameSite 쿠키 속성 값을 설정합니다. 자세한 내용은 SameSite 문서를 참조하세요.

  • 기본값: Lax

cookieStorage

  • 속성: data-cookie-storage

  • 유형: String

  • 세부 정보:

    확장 기능이 사용할 저장 방식을 설정합니다. 가능한 값: cookieStorage, localStorage, sessionStorage 또는 customStorage.

    customStorage를 사용하는 경우 cookieCustomStorageGet, cookieCustomStorageSetcookieCustomStorageDelete를 함께 구현해야 합니다.

  • 기본값: cookieStorage

cookiesEnabled

  • 속성: data-cookies-enabled

  • 유형: Array

  • 세부 정보:

    저장할 테이블 속성 배열을 설정합니다. 예: sortOrder, sortName, sortPriority, pageNumber, pageList, hiddenColumns, searchText, filterControl 등.

  • 기본값: ['bs.table.sortOrder', 'bs.table.sortName', 'bs.table.sortPriority', 'bs.table.pageNumber', 'bs.table.pageList', 'bs.table.hiddenColumns', 'bs.table.searchText', 'bs.table.filterControl', 'bs.table.cardView', 'bs.table.customView']

메서드

deleteCookie

  • 매개변수: cookieName

  • 세부 정보:

    이름으로 저장된 쿠키를 삭제합니다.

getCookies

  • 매개변수: undefined

  • 세부 정보: