dom.js

회원

정적 , 상수 $

다른 DOM 요소의 선택적 컨텍스트 내에서 선택자 와 일치하는 단일 DOM 요소를 찾습니다(기본값은 document ).

정적 , 상수 $$

다른 DOM 요소의 선택적 컨텍스트 내에서 선택자 와 일치하는 모든 DOM 요소를 찾습니다(기본값은 document ).

방법

정적 addClass (요소, classToAdd) → {요소}

요소에 클래스 이름을 추가합니다.

매개 변수 :
이름 유형 설명
요소 요소

클래스 이름을 추가할 요소입니다.

추가할 클래스

추가할 클래스 이름입니다.

반환:
요소 -

클래스 이름이 추가된 DOM 요소입니다.

정적 appendContent (el, 콘텐츠) → {Element}

콘텐츠를 정규화하고 요소에 추가합니다.

매개 변수 :
이름 유형 설명
엘자 요소

정규화된 콘텐츠를 추가할 요소입니다.

콘텐츠 모듈:dom~ContentDescriptor

콘텐츠 설명자 값입니다.

반환:
요소 -

정규화된 콘텐츠가 추가된 요소입니다.

정적 blockTextSelection ()

텍스트를 선택하는 기능을 차단하려고 시도합니다.

정적 createEl (tagName 선택 , 속성 선택 , 속성 선택 , 내용) → {요소}

요소를 생성하고 속성, 특성을 적용하고 콘텐츠를 삽입합니다.

매개 변수 :
이름 유형 속성 기본값 설명
태그 이름 <선택 과목>
'사업부'

생성할 태그의 이름입니다.

속성 물체 <선택 과목>
{}

적용할 요소 속성입니다.

속성 물체 <선택 과목>
{}

적용할 요소 속성입니다.

콘텐츠 모듈:dom~ContentDescriptor

콘텐츠 설명자 개체입니다.

반환:
요소 -

생성된 요소입니다.

정적 emptyEl (엘) → {요소}

요소의 내용을 비웁니다.

매개 변수 :
이름 유형 설명
엘자 요소

자식을 비울 요소

반환:
요소 -

자식이 없는 요소

static findPosition (el) → { module:dom~Position }

DOM에서 요소의 위치를 가져옵니다.

John Resig의 getBoundingClientRect 기술을 사용합니다.

매개 변수 :
이름 유형 설명
엘자 요소

오프셋을 가져올 요소입니다.

반환:
모듈:dom~Position -

전달된 요소의 위치입니다.

참조:

정적 getAttribute (el, 속성) → {string}

요소의 속성 값을 가져옵니다.

매개 변수 :
이름 유형 설명
엘자 요소

DOM 요소.

기인하다

값을 가져올 속성입니다.

반환:
문자열 -

속성의 값입니다.

정적 getAttributes (태그) → {객체}

HTML 태그에 정의된 대로 요소의 속성 값을 가져옵니다.

특성은 속성과 동일하지 않습니다. 태그 또는 setAttribute로 정의됩니다.

매개 변수 :
이름 유형 설명
꼬리표 요소

태그 속성을 가져올 요소입니다.

반환:
객체 -

요소의 모든 속성. 부울 속성은 true 또는 false 이고 다른 속성은 문자열입니다.

static getBoundingClientRect (el) → {객체|정의되지 않음}

기본 getBoundingClientRect 함수와 동일하지만 계속하기 전에 메서드가 전혀 지원되고(지원한다고 주장하는 모든 브라우저에 있음) 요소가 DOM에 있는지 확인합니다.

이 래퍼 기능은 일부 구형 브라우저(예: IE8)에서 제공하지 않는 속성도 shim합니다.

또한 일부 브라우저는 ClientRect / DOMRect 객체에 속성 추가를 지원하지 않습니다. 따라서 표준 속성(널리 지원되지 않는 xy 제외)을 사용하여 얕은 복사합니다. 이는 키를 열거할 수 없는 구현을 방지하는 데 도움이 됩니다.

매개 변수 :
이름 유형 설명
엘자 요소

ClientRect를 계산하려는 요소입니다.

반환:
개체 | 정의되지 않은 -

항상 일반 객체를 반환하거나 반환할 수 없는 경우 정의되지 않음 .

static getPointerPosition (el, event) → { module:dom~Coordinates }

요소 내에서 포인터 위치를 가져옵니다.

좌표의 기준은 요소의 왼쪽 하단입니다.

매개 변수 :
이름 유형 설명
엘자 요소

포인터 위치를 가져올 요소입니다.

이벤트 EventTarget~이벤트

이벤트 객체.

반환:
module:dom~Coordinates -

마우스 위치에 해당하는 좌표 개체입니다.

정적 hasClass (요소, classToCheck) → {부울}

요소에 클래스 이름이 있는지 확인하십시오.

매개 변수 :
이름 유형 설명
요소 요소

확인할 요소

classToCheck

확인할 클래스 이름

던지기:

classToCheck 에 공백이 있으면 오류가 발생합니다.

유형
오류
반환:
부울 -

요소에 클래스가 있으면 true 이고 그렇지 않으면 false 입니다.

정적 insertContent (el, 내용) → {Element}

콘텐츠를 정규화하고 요소에 삽입합니다. 이것은 요소를 먼저 비운다는 점을 제외하고는 appendContent() 와 동일합니다.

매개 변수 :
이름 유형 설명
엘자 요소

정규화된 콘텐츠를 삽입할 요소입니다.

콘텐츠 모듈:dom~ContentDescriptor

콘텐츠 설명자 값입니다.

반환:
요소 -

정규화된 콘텐츠가 삽입된 요소입니다.

정적 isEl (값) → {부울}

덕 타이핑을 통해 값이 DOM 요소인지 여부를 결정합니다.

매개 변수 :
이름 유형 설명
혼합

확인할 값입니다.

반환:
부울 -

값이 DOM 요소이면 true 이고 그렇지 않으면 false 입니다.

정적 isInFrame () → {부울}

현재 DOM이 iframe에 포함되어 있는지 확인합니다.

반환:
부울 -

DOM이 iframe에 내장되어 있으면 true 이고 그렇지 않으면 false 입니다.

정적 isReal () → {부울}

현재 DOM 인터페이스가 실제처럼 보이는지 여부(즉, 시뮬레이션되지 않음).

반환:
부울 -

DOM이 실제처럼 보이면 이고 그렇지 않으면 거짓 입니다.

정적 isSingleLeftClick (이벤트) → {boolean}

이벤트가 단일 왼쪽 클릭인지 확인하십시오.

매개 변수 :
이름 유형 설명
이벤트 EventTarget~이벤트

이벤트 객체.

반환:
부울 -

단일 왼쪽 클릭이면 true 이고 그렇지 않으면 false 입니다.

정적 isTextNode (값) → {부울}

덕 타이핑을 통해 값이 텍스트 노드인지 여부를 결정합니다.

매개 변수 :
이름 유형 설명
혼합

이 값이 텍스트 노드인지 확인하십시오.

반환:
부울 -

값이 텍스트 노드이면 true 이고 그렇지 않으면 false 입니다.

정적 normalizeContent (콘텐츠) → {Array}

최종적으로 DOM에 삽입하기 위해 콘텐츠를 정규화합니다.

이를 통해 다양한 콘텐츠 정의 방법을 사용할 수 있지만 XSS 문제가 될 수 있는 innerHTML 에 단순히 쓰는 함정에 빠지지 않도록 보호할 수 있습니다.

요소의 내용은 여러 유형 및 조합으로 전달될 수 있으며 그 동작은 다음과 같습니다.

매개 변수 :
이름 유형 설명
콘텐츠 모듈:dom~ContentDescriptor

콘텐츠 설명자 값입니다.

반환:
어레이 -

전달된 모든 콘텐츠는 요소 또는 텍스트 노드의 배열로 정규화됩니다.

정적 prependTo (자식, 부모)

요소를 다른 요소의 첫 번째 자식 노드로 삽입

매개 변수 :
이름 유형 설명
어린이 요소

삽입할 요소

부모의 요소

자식을 삽입할 요소

정적 removeAttribute (el, 속성)

요소의 속성을 제거합니다.

매개 변수 :
이름 유형 설명
엘자 요소

DOM 요소.

기인하다

제거할 속성입니다.

정적 removeClass (요소, classToRemove) → {요소}

요소에서 클래스 이름을 제거합니다.

매개 변수 :
이름 유형 설명
요소 요소

클래스 이름을 제거할 요소입니다.

제거할 클래스

제거할 클래스 이름

반환:
요소 -

클래스 이름이 제거된 DOM 요소입니다.

정적 setAttribute (el, 속성, 값)

요소의 속성 값을 설정합니다.

매개 변수 :
이름 유형 설명
엘자 요소

DOM 요소.

기인하다

설정할 속성입니다.

속성을 설정할 값입니다.

정적 setAttributes (el, 속성 옵션 )

HTML 요소에 속성을 적용합니다.

매개 변수 :
이름 유형 속성 설명
엘자 요소

속성을 추가할 요소입니다.

속성 물체 <선택 과목>

적용할 속성입니다.

정적 textContent (el, 텍스트) → {Element}

요소에 텍스트를 삽입하여 기존 내용을 완전히 바꿉니다.

매개 변수 :
이름 유형 설명
엘자 요소

텍스트 콘텐츠를 추가할 요소

텍스트

추가할 텍스트 콘텐츠입니다.

반환:
요소 -

텍스트 콘텐츠가 추가된 요소입니다.

정적 toggleClass (요소, classToToggle, 조건자 선택 ) → {Element}

선택적 조건 또는 클래스 이름의 유무에 따라 요소에 클래스 이름을 추가하거나 요소에서 제거합니다.

매개 변수 :
이름 유형 속성 설명
요소 요소

클래스 이름을 토글할 요소입니다.

클래스투토글

전환해야 하는 클래스입니다.

술부 부울 | 모듈:dom~PredicateCallback <선택 과목>

module:dom~PredicateCallback 의 반환 값을 참조하십시오.

반환:
요소 -

전환된 클래스가 있는 요소입니다.

정적 unblockTextSelection ()

텍스트 선택 차단을 끕니다.

유형 정의

콘텐츠 설명자 ()

어떤 메서드를 통해 DOM에 삽입할 콘텐츠를 설명하는 혼합 값입니다. 다음과 같은 유형일 수 있습니다.

유형 설명
값은 텍스트 노드로 정규화됩니다.
요소 값은 있는 그대로 수락됩니다.
텍스트노드 값은 있는 그대로 수락됩니다.
정렬 문자열, 요소, 텍스트 노드 또는 함수의 1차원 배열입니다. 이러한 함수는 문자열, 요소 또는 텍스트 노드를 반환해야 합니다(배열과 같은 다른 반환 값은 무시됨).
기능 문자열, 요소, 텍스트 노드 또는 배열(위에 설명된 다른 가능한 값)을 반환할 것으로 예상되는 함수입니다. 즉, 콘텐츠 설명자는 함수 배열을 반환하는 함수일 수 있지만 이러한 두 번째 수준 함수는 문자열, 요소 또는 텍스트 노드를 반환해야 합니다.

좌표

DOM 요소 또는 마우스 포인터의 x 및 y 좌표를 나타냅니다.

속성:
이름 유형 설명
엑스 숫자

x 좌표(픽셀 단위)

와이 숫자

y 좌표(픽셀 단위)

위치

페이지에서 DOM 요소의 위치를 나타냅니다.

속성:
이름 유형 설명
왼쪽 숫자

왼쪽 픽셀.

맨 위 숫자

위쪽에서 픽셀입니다.

PredicateCallback (요소, classToToggle) → {boolean|undefined}

toggleClass에 대한 콜백 정의입니다.

매개 변수 :
이름 유형 설명
요소 요소

구성 요소의 DOM 요소입니다.

클래스투토글

전환하려는 className

반환:
부울 | 정의되지 않은 -

true 가 반환되면 classToToggle요소 에 추가됩니다. false 인 경우 classToToggle요소 에서 제거됩니다. undefined 이면 콜백이 무시됩니다.