CSS Rules

Editing

@property

자바스크립트를 실행할 필요없이 스타일 시트에서 직접 사용자 지정 속성 등록을 나타낸다. 유효한 @property 규칙은 자바스크립트의 registerProperty()가 동등한 매개변수로 호출된 것처럼 사용자 정의 속성을 등록한다.

설명

@property 규칙은 syntaxinherits 설명자가 반드시 정의되어야 한다. initial-value 설명자는 syntax가 범용인 경우에 한해서 선택사항이다. 생락하면 초기값은 보장된 유효하지 않은 값이 된다.

선언

<@property>

DEVDIC-Specified Data Types

@property 앳룰(at-rules)의 구문 형식을 나타낸다.

사용자 정의 속성을 등록한다.

  • CSS Properties and Values API Level 1
    @property <custom-property-name> { <declaration-list>
    }
    Example

포함된 타입

아래 유형에서 지원하는 모든 키워드와 단위를 사용하지 않을 수도 있다.

  • <custom-property-name>

    사용자 정의 속성명을 나타낸다.

    • CSS Custom Properties for Cascading Variables Module Level 1
      <dashed-ident>

      두 개의 대시 문자로 시작하는 <custom-ident> 값이다.

    Details

    포함된 타입

    • <dashed-ident>

      <custom-ident> 의 하위 타입이며 암시하는 모든 대소문자 구분과 두 개의 대시(U+002D HYPHEN-MINUS)로 시작해야 한다는 추가 제한이 있다.

  • <declaration-list>

    선언 목록을 나타낸다. 문법에서 블록의 유일한 값으로만 사용할 수 있으며 선언 목록 처리 알고리즘을 사용하여 블록의 내용을 구문 분석해야 함을 나타낸다.

사용 가능한 디스크립터 및 특성

[사용 가능한 값]은 설정 가능한 모든 값을 나열하지 않을 수도 있다. 자세한 사항은 각 항목의 추가 정보를 확인하라.

inherits 

@property 규칙으로 표시되는 사용자 지정 속성 등록의 상속 플래그를 지정하여 속성이 기본적으로 상속되는지 여부를 제어한다. @property 규칙이 유효하려면 inherits 디스크립터가 작성되어야 한다.

true이면 선언후 재정의가 가능하며 false인 경우는 재정의가 불가하다.

사용 가능한 값

true

선언후 재정의가 가능하다.

false

선언후 재정의가 불가하다.

사용되는 타입

<boolean>

논리값(true, false)을 나타낸다.

  • true | false

initial-value 

@property 규칙으로 지정된 사용자 지정 속성 등록의 초기 값을 지정하여 속성의 초기 값을 제어한다. 선택사항이며 생략하면 속성의 초기 값은 보장된 무효값이다.

사용되는 타입

<declaration-value> 타입은 시퀀스에 허용되지 않는 토큰이 포함되지 않는 한 하나 이상의 토큰 시퀀스와 일치한다. 유효한 선언이 값으로 가질 수 있는 전체를 나타낸다.

  • CSS Custom Properties for Cascading Variables Module Level 1
    <declaration-value>?

syntax 

@property 규칙으로 표현되는 사용자 지정 속성 등록의 구문을 지정하여 계산된 값 시점에 속성 값이 구문 분석되는 방식을 제어한다.

사용 가능한 값

"<length>"

단위가 있는 값을 정의한다.

"<number>"

숫자 유형으로 선언한다.

"<percentage>"

퍼센트 유형으로 선언한다.

"<length-percentage>"

퍼센트를 포함한 단위가 있는 값으로 선언한다.

"<color>"

색상값으로 선언한다.

"<image>"

이미지 리소스 유형으로 선언한다.

"<url>"

url() 함수의 값을 사용한다.

"<integer>"

정수 유형의 선언한다.

"<angle>"

각도를 나타내는 유형으로 선언한다.

"<time>"

시간를 나타내는 유형으로 선언한다.

"<resolution>"

해상도를 나타내는 유형으로 선언한다.

"<transform-function>"

변형 함수의 값을 나타내는 유형으로 선언한다.

"<custom-ident>"

임의의 사용자 정의 문자열로 선언한다.

"<transform-list>"

유효한 변환 함수 값의 목록 유형으로 선언한다.

사용되는 타입

따옴표로 감싸진 데이터 유형을 표현한다.

  • "this is a 'string'."

동일한 타입을 사용하는 관련 속성

  • font-family

    글꼴을 지정한다.

  • content

    가상 요소로 생성할 콘텐츠를 설정한다.

  • quotes

    인용 부호의 유형을 설정한다.

버전 명세

Modules
Module NameStatusSummary
CSS Properties and Values API Level 1초안 작업

Last review date: 2023-4-14

지원 웹브라우저