컬럼값 호출 구조
값을 읽고 쓸 때 getter, setter, selector가 작동하는 구조를 살펴봅니다.
컬럼의 value 값을 조회하거나 설정할 때 다양한 설정 방식을 활용하여 유연하게 구성할 수 있습니다.
컬럼값(value) 조회#
컬럼값 조회 시, 다음과 같은 우선순위에 따라 적합한 값을 선택합니다.
- getter : 값 조회 시 우선적으로 실행되는 사용자 정의 함수입니다.
- getFilter :
getter가 없을 경우, 값을 변환하기 위한 필터 함수입니다. - selector : DOM 요소에서 값을 가져옵니다.
- 내부값 : 컬럼에 저장된 내부
value값입니다. - 기본값(default) :
value나 다른 설정이 없을 경우 반환되는 기본값입니다.
조회 내부 구조#
graph BT
BB("getter():val") --> |1.getter 있을 경우|AA[let title = column.value]
CC{선택} --> AA
DD --> |값을 인자로 전달|EE("getFilter(selectorValue): val")
DOM -.-> DD
EE --> |2.getFilter 있을 경우|CC
DD[selector 조회] --> |3.selector 있을 경우|CC
FF[[inner value]] --> |4.설정 없는 경우|AA
style AA fill:navy,color:#fff
style DOM fill:orange,color:#fff
style BB fill:green,color:#fff
style DD fill:green,color:#fff
style EE fill:green,color:#fff
style FF fill:green,color:#fff
컬럼값 조회 단계#
getter확인getter함수가 설정되어 있으면, 이를 호출하여 반환된 값을 사용합니다.
getFilter확인getter가없을 경우,getFilter가설정되어 있으면 이를 통해 값을 변환합니다.- 만약
selector가 동시에 있으면selector로 값을 가져온 후getFilter를 거쳐 반환합니다.
selector확인getter와getFilter가 없고,selector가 설정되어 있으면selector의type에 따라 값을 가져옵니다.
- 내부값 확인
getter,getFilter,selector가 모두 없으면 컬럼에 저장된 내부 값을 반환합니다.getter,getFilter,selector에서 반환값이null, undefined이면 내부값을 반환합니다.
Note 값 조회 시에는 우선순위에 따라 적절한 값이 선택됩니다.
컬럼값(value) 설정#
컬럼값을 설정할 때, 아래 속성에 따라 병렬로 값을 저장하며, 각 단계는 독립적으로 실행됩니다.
즉, setter, setFilter, selector가 모두 설정되어 있으면 각각에 값을 저장합니다.
컬럼값 설정 시, 다음과 같은 순위에 따라 값을 설정합니다.
- setter : 값 설정 시 우선적으로 실행되는 사용자 정의 함수입니다.
- 내부값 : 컬럼에 저장된 내부 value 값에 저장합니다.
- setFilter : 값을 변환하여 설정하기 위한 필터 함수입니다.
- selector : DOM 요소에서 값을 설정합니다.
설정 내부 구조#
graph TD
A[title.value = 'title ...'] --> B("1.setter(val) : val?")
B --> |리턴 존재시|C[[2.inner value]]
A --> |setter 없는 경우| C
C --> |setFilter 있을 경우| D("3.setFilter(val) : val?")
D -->|return 값과 selector 있을 경우|E("4.selector 설정")
D -.-> |DOM Element 설정|DOM
C -->|selector 있는 경우|E
E -.->|type='none' 아닌 경우| DOM
style A fill:navy,color:#fff
style B fill:green,color:#fff
style C fill:green,color:#fff
style D fill:green,color:#fff
style E fill:green,color:#fff
style DOM fill:orange,color:#fff
컬럼값 설정 단계#
setter호출setter함수가 설정되어 있으면, 이를 호출하여 값을 처리합니다.setter함수가 값을 리턴하는 경우, 리턴값이 내부값으로 저장됩니다.
- 내부값 저장
- 설정된 값은 내부값으로 저장됩니다.
- 만약
setter가 값을 리턴하면, 리턴값이 내부값으로 저장됩니다.
setFilter호출setFilter가 설정되어 있으면, 설정된 함수가 호출되어 값이 변환됩니다.
selector설정selector가 설정되어 있으면,type에 따라 DOM 요소에 값을 설정합니다.setFilter함수가 값을 리턴하는 경우, 리턴값이selector에 값으로 저장됩니다.type이none이면 무시됩니다.
Note 값을 설정할 때는 정의된 순서에 따라 순차적으로 적용되며, 일부 항목은 병렬로 처리될 수 있습니다.
컬럼값 구성 빈도#
컬럼값은 다양한 환경과 요구에 따라 조회와 설정을 위한 속성이 다르게 구성됩니다. 아래는 컬럼값을 설정하거나 조회할 때 사용되는 속성의 빈도와 주요 사용 예를 설명합니다.
| 빈도 | setter | setFilter | selector | getFilter | getter | 설명 |
|---|---|---|---|---|---|---|
| 89% | 사용 |
- DOM 요소에 직접 연결 <br>- 단일 HTML 요소와 연동 <br>- 예시> 태그 p, input, select, css | ||||
| 3% | 사용 |
사용 |
- 외부 변수나 객체를 참조<br>- page_count 등 비 DOM 데이터 | |||
| 3% | 사용 |
사용 |
사용 |
- 외부 객체와 DOM을 동시 제어<br>- 예시> page_size <br>(HTML select 값과 연동) | ||
| 3% | 사용 |
사용 |
- 복합 DOM 요소를 제어 <br>- 예시> 라디오 버튼, 내부값과 화면값이 다른 경우 | |||
| 1% | 사용 |
사용 |
- HTML 표현값을 가공하는 경우<br>- 예시> 숫자를 통화 형식으로 표시 | |||
| 1% | 사용 |
- HTML 표현과 상관없이 내부적으로만 변환 <br>- 예시> 코드 값 변환, 선택값 표시 |
- 샘플 : 쇼핑몰, DB Table 36EA 기준
Note 값의 성격에 따라
setter,getter,setFilter,getFilter,selector를적절히 조합함으로써, 다양한 조건에 대응하는 컬럼 구성을 할 수 있습니다.
selector 를 사용한 경우#
selector는 DOM 요소와 직접 연결하여 값을 가져오거나 설정합니다.
<div id="idx"><p style="color:red;">10</p></div>
<input id="title" type="text" value="AA" />
<input id="chk_yn" type="checkbox" checked />
<a href="http://google.com">google.com</a>
var bm = new BindModel();
bm.addSelector('aa', { key:'#idx', type: 'html' });
bm.addSelector('bb', { key:'#idx', type: 'text' });
bm.addSelector('cc', { key:'title', type: 'value' });
bm.addSelector('dd', { key:'#chk_yn', type: 'prop.checked' });
bm.addSelector('ee', { key:'a', type: 'attr.href' });
bm.addSelector('ff', { key:'p', type: 'css.color' });
// bb.columns['aa'].value == '<p style="color:red;">10</p>'
// bb.columns['bb'].value == '10'
// bb.columns['cc'].value == 'AA'
// bb.columns['dd'].value == true
// bb.columns['ee'].value == 'http://google.com'
// bb.columns['ff'].value == 'red'
- 셀렉터에 문자열 키를 지정하면, 해당 DOM 요소를 검사하여
value,text,html중 적절한 타입이 자동으로 지정됩니다.
Tip
selector 지정한 값이 여러개 존재하면, 첫번째 값을 가져오거나, 설정합니다.
setter, getter 을 사용한 경우#
외부 변수와 컬럼을 연동할 때 사용합니다.
const bm = new BindModel();
let page_size = 10;
bm.addColumnValue('aa', {
getter: function() { return page_size },
setter: function(nVal) { page_size = nVal }
});
// bm.columns['aa'].value === 10
Tip
단방향으로 외부값을 읽기전용으로 사용할려면
getter함수만 정의합니다.
selector, setter, getter 를 조합한 경우#
HTML 요소와 외부 변수를 동시에 제어합니다.
<select id="page_size">
<option value="10">10EA</option>
<option value="20">20EA</option>
<option value="30">30EA</option>
</select>
const bm = new BindModel();
let page_size = 10;
bm.addColumnValue('aa', {
getter: function() { return page_size },
setter: function(nVal) { page_size = nVal },
selector: { key: '#page_size', type: 'value' }
});
// bm.columns['aa'].value === 10
// jQuery를 이용하여 DOM 값 변경
$("#page_size").val("20");
// bm.columns['aa'].value === 20
// 컬럼 value 값 변경
bm.columns['aa'].value = 30;
// bm.columns['aa'].value === 30
// page_size === 30
// $("#page_size").val() == '30'
- 값을 가져올 때는 우선순우가 높은
getter을 호출하여 값을 가져옵니다. - 값을 설정할 때는
setter와selector두곳에 값을 설정합니다.
setFilter, getFilter 을 사용한 경우#
컬럼 값이 여러 요소와 연관되어 있을 경우에는 setFilter와 getFilter를 사용하여 값을 변환하거나 가공할 수 있습니다.
<input type="radio" name="gender" value="woman" />
<input type="radio" name="gender" value="man" />
const bm = new BindModel();
bm.addColumnValue('aa', {
getFilter: function() {
return $('input[name=gender]:checked').val();
},
setFilter: function(nVal) {
$('input[name=gender][value='+ newVal + ']').prop('checked', true);
}
});
// bm.columns['aa'].value == ''
$('input[name=gender][value=man]').prop('checked', true); // radio choice
// bm.columns['aa'].value == 'man'
내부 값과 표시 값이 다를 경우, getFilter와 setFilter를 사용해 숫자를 통화 형식 등으로 변환할 수 있습니다.
<p id="sum"></p>
const bm = new BindModel();
bm.columns.addValue('price', {
setFilter: (val) => {
const formatted = Number(val).toLocaleString();
$("#sum").text(formatted);
},
getFilter: () => {
return parseInt($("#sum").text().replace(/,/g, ""));
}
});
// 값 설정 및 표시
bm.columns['price'].value = 10000;
// DOM 값 확인
console.log($("#sum").text()); // "10,000"
// 값 조회
console.log(bm.columns['price'].value); // 10000
- 내부적으로는
10000값으로 저장되고, 화면에는 콤마가 포함된10,000으로 표시됩니다.
selector 객체#
selector 객체는 컬럼값을 DOM 요소의 값을 참조하여 설정하거나 가져오는 데 사용됩니다. 이 객체를 사용하면 HTML 요소와 모델 간의 데이터를 동기화할 수 있습니다.
| type | 설명 | 비고 |
|---|---|---|
| 'value' | 'val' | DOM 요소의 value 값을 가르킵니다. | 'val' 은 축약어 |
| 'text' | 지정한 위치의 text 값을 가르킵니다. | 태그 제외 |
| 'html' | 지정한 위치의 html 태그값을 가르킵니다. | |
| 'attr.*' | HTML 속성명의 값을 가르킵니다. | 예> 'attr.value', 'attr.type' |
| 'prop.*' | DOM 객체의 속성명의 값을 가르킵니다. | 예> 'prop.checked' |
| 'css.*' | css 속성값을 가르킵니다 | jquery(셀렉터).css(속성명) 사용 |
| 'none' | 값을 사용하지 않습니다. | 유효성 검사 등에서 활용 |
value 타입#
DOM 요소의 value 값을 참조합니다. <input> 또는 <select> 요소에 주로 사용됩니다.
<input type="text" id="user_name" value="mike"/>
<select id="color_name">
<option value="red" selected>Red</option>
<option value="green">Blue</option>
<option value="blue">Green</option>
</select>
컬럼 등록시 설정할 경우#
bm.addSelector('aa', { key: '#user_name', type: 'value' });
bm.addSelector('bb', { key: '#color_name', type: 'value' });
// bm.columns['aa'].value = 'Mike'
// bm.columns['bb'].value = 'red'
기존 컬럼에 설정할 경우#
bm.addColumn('aa');
bm.addColumn('bb');
bm.columns['aa'].selector = { key: '#user_name', type: 'value' };
bm.columns['bb'].selector = { key: '#color_name', type: 'value' };
// bm.columns['aa'].value = 'Mike'
// bm.columns['bb'].value = 'red'
Tip jQuery(셀렉터).val()과 동일한 결과를 반환합니다.
text 타입#
태그를 제외한 순수 텍스트를 가져오거나 설정합니다.
<div id='area_name'>
<p id='user_name'>mike</p>
<p id='user_no'>1000</p>
</div>
컬럼 등록시 설정할 경우#
bm.addSelector('aa', { key: '#user_name', type: 'text' });
bm.addSelector('bb', { key: '#user_no', type: 'text' });
// bm.columns['aa'].value = 'mike'
// bm.columns['bb'].value = 'mike1000'
기존 컬럼에 설정할 경우#
bm.addColumn('aa');
bm.addColumn('bb');
bm.columns['aa'].selector = { key: '#user_name', type: 'text' };
bm.columns['bb'].selector = { key: '#user_no', type: 'text' };
// bm.columns['aa'].value = 'mike'
// bm.columns['bb'].value = 'mike1000'
Tip jQuery(셀렉터).text()와 동일한 결과를 반환합니다.
html 타입#
HTML 태그를 포함한 내용을 가져오거나 설정합니다.
<div id="content">
<p style="color:red;">Hello</p>
</div>
컬럼 등록시 설정할 경우#
bm.addSelector('aa', { key: '#content', type: 'html' });
// bm.columns['aa'].value === '<p style="color:red;">Hello</p>'
기존 컬럼에 설정할 경우#
bm.addColumn('aa');
bm.columns['aa'].selector = { key: '#content', type: 'html' };
// bm.columns['aa'].value === '<p style="color:red;">Hello</p>'
Tip jQuery(셀렉터).html()과 동일한 결과를 반환합니다.
attr 타입#
HTML 속성 값을 참조합니다.
<input id="user_name" type="text" flag="OK" />
bm.addSelector('aa', { key: '#user_name', type: 'attr.flag' });
// bm.columns['aa'].value === 'OK'
Tip jQuery(셀렉터).attr(속성명)과 동일한 결과를 반환합니다.
prop 타입#
DOM 객체의 속성 값을 참조합니다.
<input id='agree' type="checkbox" class="item" value="Y" />
bm.addSelector('aa', { key: '#agree', type: 'prop.checked' });
// bm.columns['aa'].value === false
$('#agree').prop('checked', true); // checkbox choice
// bm.columns['aa'].value === true
Tip jQuery(셀렉터).prop(속성명)과 동일한 결과를 반환합니다.
css 타입#
CSS 속성 값을 참조합니다.
<div id="title" style="color: black; padding: 10px;">Text Content</div>
bm.addSelector('aa', { key: '#title', type: 'css.color' });
bm.addSelector('bb', { key: '#title', type: 'css.padding' });
// bm.columns['aa'].value === 'black'
// bm.columns['bb'].value === '10px'
Tip
jQuery(셀렉터).css(속성명)을 사용한 결과와 동일합니다.
none 타입#
type을 'none'으로 설정하면 값을 사용하지 않습니다. 유효성 검사와 같은 검증 작업에 활용됩니다.
<input id="memo" type="text" value="Not Used" />
bm.addSelector('aa', { key: '#memo', type: 'none' });
// bm.columns['aa'].value === undefined
Tip
- 값 조작 및 검증
- none 타입은 UI 값이 아닌 상태만 검증하거나 이벤트 트리거에 활용할 수 있습니다.
- DOM 동기화
- value, text, html 타입은 데이터와 UI 동기화를 쉽게 관리할 수 있습니다.
- 속성 및 스타일 제어
- attr, prop, css 타입은 DOM 속성과 스타일을 효과적으로 제어합니다.