HTML 양식 중첩 제한을 어떻게 극복합니까?


199

XHTML은 중첩 양식 태그를 지원하지 않으며이 주제와 관련하여 스택 오버플로에 대한 다른 답변을 이미 읽었지만 여전히 문제에 대한 우아한 해결책을 찾지 못했습니다.

어떤 사람들은 필요하지 않으며 시나리오가 필요하다고 생각할 수 없다고 말합니다. 개인적으로는 필자 필요 하지 않은 시나리오를 생각할 수 없습니다 .

매우 간단한 예를 보자.

블로그 앱을 작성 중이며 새 게시물을 작성하기위한 일부 필드와 "저장", "삭제", "취소"와 같은 "조치"가있는 도구 모음이있는 양식이 있습니다.

<form
 action="/post/dispatch/too_bad_the_action_url_is_in_the_form_tag_even_though_conceptually_every_submit_button_inside_it_may_need_to_post_to_a_diffent_distinct_url"
method="post">

    <input type="text" name="foo" /> <!-- several of those here -->
    <div id="toolbar">
        <input type="submit" name="save" value="Save" />
        <input type="submit" name="delete" value="Delete" />
        <a href="/home/index">Cancel</a>
    </div>
</form>

우리의 목표는 JavaScript를 요구하지 않는 방식으로 양식을 작성하는 것입니다. 일반 HTML 양식과 제출 버튼 만 있으면 됩니다.

조치 URL은 각 개별 제출 단추가 아닌 양식 태그에 정의되어 있으므로, 유일한 옵션은 일반 URL에 게시 한 다음 "if ... then ... else"를 시작하여 단추 이름을 판별하는 것입니다. 제출되었습니다. 우리는 JavaScript에 의존하고 싶지 않기 때문에 매우 우아하지는 않지만 우리의 유일한 선택입니다.

유일한 문제는 "삭제"를 누르면이 조치에 필요한 유일한 것은 post-id가있는 숨겨진 입력이지만 서버의 모든 양식 필드를 제출한다는 것입니다. 이 작은 예제에서는 그리 큰 문제는 아니지만 LOB 응용 프로그램에 수백 개의 필드와 탭이있는 양식 이 있습니다 (요구 사항으로 인해) 모든 것을 한 번에 제출해야하며 어쨌든 이것은 매우 비효율적입니다. 그리고 폐기물. 양식 중첩이 지원되면 최소한 "삭제"제출 버튼을 자체 양식 안에 post-id 필드만으로 줄 바꿈 할 수 있습니다.

"제출 대신 링크로"삭제 "를 구현하십시오"라고 말할 수 있습니다. 이것은 많은 수준에서 잘못 될 수 있지만 여기서 가장 중요한 것은 "삭제"와 같은 부작용이 GET 요청이 아니어야하기 때문입니다.

그래서 내 질문 (특히 폼 중첩이 필요하지 않다고 말하는 사람들)은 무엇을합니까? 내가 놓친 우아한 솔루션이 있습니까, 아니면 결론은 실제로 "JavaScript가 필요하거나 모든 것을 제출하십시오"입니까?


17
재밌지 만, XHTML은 흥미로운 참고 사항에 따라 간접 양식 중첩을 허용하며, aerwald.info/internet/nesting-form-tags-in-xhtml-(X ) HTML은 "form> form"과 같은 중첩 양식을 허용하지 않지만 "form> fieldset> form ", W3 유효성 검사기는 유효하지만 브라우저에는 이러한 중첩 관련 버그가 있습니다.
니시


@Nishi 님의 댓글 링크를위한 linkrot fix : web.archive.org/web/20170420110433/http://anderwald.info/…
albert

답변:


53

나는 당신이 묘사 한대로 이것을 정확하게 구현할 것입니다 : 모든 것을 서버에 제출하고 간단한 if / else를 수행하여 어떤 버튼이 클릭되었는지 확인하십시오.

그런 다음 양식을 제출하기 전에 확인하는 양식의 onsubmit 이벤트와 관련된 Javascript 호출을 구현하고 관련 데이터를 서버에 제출합니다 (아마도 페이지의 두 번째 양식을 통해 다음과 같이 처리합니다. 숨겨진 입력 또는 GET 요청으로 전달 해야하는 데이터로 페이지 위치를 새로 고치거나 서버에 Ajax 게시물을 수행하거나 ...).

이 방법으로 Javascript를 사용하지 않는 사람들은 양식을 잘 사용할 수 있지만 Javascript를 가진 사람들은 필요한 단일 데이터 만 제출하기 때문에 서버로드가 상쇄됩니다. 하나 또는 다른 것만 지원하는 데 집중하면 실제로 옵션이 불필요하게 제한됩니다.

또는 회사 방화벽 뒤에서 작업하거나 모든 사람이 Javascript를 사용하지 않도록 설정 한 경우 두 가지 형식을 수행하고 CSS 마법을 사용하여 삭제 단추가 첫 번째 형식의 일부인 것처럼 보일 수 있습니다.


15
OP 원본은 자바 스크립트를 언급하지 않았습니다
Jason

26
이 방법의 문제점은 비 RESTful이라는 것입니다. 저장 및 삭제는 "저장"-> POST / my_resource (새 자원 작성) "저장"-> PUT / my_resource (기존 자원 수정) "삭제"-> DELETE / my_resource (파기)의 다른 조치에 해당합니다. REST) ​​말하자면 문제는 POST가 새로운 리소스를 생성해야한다는 것입니다. 확실히 기존 리소스를 삭제해서는 안됩니다.
user132447

177

나는 이것이 오래된 질문이라는 것을 알고 있지만 HTML5는 몇 가지 새로운 옵션을 제공합니다.

첫 번째는 마크 업의 도구 모음에서 양식을 분리하고 삭제 조치를 위해 다른 양식을 추가 한 후 form속성을 사용하여 도구 모음의 단추를 해당 양식과 연관시키는 것입니다.

<form id="saveForm" action="/post/dispatch/save" method="post">
    <input type="text" name="foo" /> <!-- several of those here -->  
</form>
<form id="deleteForm" action="/post/dispatch/delete" method="post">
    <input type="hidden" value="some_id" />
</form>
<div id="toolbar">
    <input type="submit" name="save" value="Save" form="saveForm" />
    <input type="submit" name="delete" value="Delete" form="deleteForm" />
    <a href="/home/index">Cancel</a>
</div>

이 옵션은 매우 융통성이 있지만 원본 게시물에서는 단일 형식으로 다른 작업을 수행해야 할 수도 있다고 언급했습니다. HTML5가 다시 한 번 구출되었습니다. formaction제출 단추 에서 속성을 사용할 수 있으므로 동일한 양식의 다른 단추가 다른 URL로 제출할 수 있습니다. 이 예제는 양식 외부의 도구 모음에 복제 방법을 추가하지만 양식에 중첩 된 것과 동일하게 작동합니다.

<div id="toolbar">
    <input type="submit" name="clone" value="Clone" form="saveForm"
           formaction="/post/dispatch/clone" />
</div>

http://www.whatwg.org/specs/web-apps/current-work/#attributes-for-form-submission

이러한 새로운 기능의 장점은 JavaScript없이 이러한 모든 기능을 선언적으로 수행한다는 것입니다. 단점은 이전 브라우저에서 지원되지 않으므로 이전 브라우저에 대해 일부 폴리 필을 수행해야한다는 것입니다.


4
+ form=1- 브라우저 지원에 대해 아는 것이 좋을 것입니다 -CanIUse가 실제로 말하지 않습니다. caniuse.com/#feat=forms
AKX

1
맞습니다. 이것은 훌륭하지만, 현재까지 IE에서 지원하지 않는 기능은 여전히 ​​'제작'사용에 대한 자격을 박탈합니다
Jako

3
<input>버튼을 선언 하는 데 사용 하는 것은 좋지 않습니다 . 이 <button>요소는 15 년 전에이 목적으로 도입되었습니다. 정말 사람들.
Nicholas Shanks

27
귀하의 요점은 불필요하게 논쟁적이고 OP의 질문과 관련이 없습니다. OP는 JavaScript를 사용하지 않고 양식 중첩 제한에 대해 질문했으며 그에 대한 해결책을 제시했습니다. 버튼이 일반적으로 툴바에 더 적합하지만 사용 여부 <input>또는 <button>요소와 관계가 없습니다. 그건 그렇고, 버튼 요소는 15 년 동안 모든 브라우저에서 지원되지 않았습니다.
shovavnik

6
@AKX 이전 내용은 html5test.com/compare/feature/form-association-form.html 에서이 기능에 대한 지원을 볼 수 있습니다 . IE는 쓰기 기능이며 대부분의 다른 데스크탑 브라우저는 견딜 수 있습니다.
지방

16

페이지에 양식을 나란히 놓고 중첩 할 수는 없습니다. 그런 다음 CSS를 사용하여 모든 버튼을 예쁘게 정렬합니까?

<form method="post" action="delete_processing_page">
   <input type="hidden" name="id" value="foo" />
   <input type="submit" value="delete" class="css_makes_me_pretty" />
</form>

<form method="post" action="add_edit_processing_page">
   <input type="text" name="foo1"  />
   <input type="text" name="foo2"  />
   <input type="text" name="foo3"  />
   ...
   <input type="submit" value="post/edit" class="css_makes_me_pretty" />
</form>

5
그렇습니다. 또한 매우 큰 페이지 (여러 범위 레벨의 탭 및 하위 탭 및 중첩 제출 버튼 상상)에서 요소의 화면 위치를 문서의 위치와 완전히 분리하는 것은 거의 불가능합니다.
gCoder

3
글쎄, 항상 당신이하고 싶은 것과 할 수있는 일 사이의 균형입니다. 서버에서 처리되는 하나의 양식 또는 유지 관리하기 어려운 여러 양식 중 하나를 선택하십시오. 현명하게 선택하십시오. :)
Jason

3
예, 불행히도 html의 모든 제한 사항으로 지원되는 것을 고수하고 전체 양식을 서버에 보낸 다음 양식 제출을 차단하고 실제로 필요한 것만 보내도록 지원하는 클라이언트에 대해 자바 스크립트를 눈에 띄게 사용합니다. 가장 좋은 타협입니다.
gCoder

13

HTML5는 입력 요소에 대한 "form"속성 인 "form owner"에 대한 아이디어를 가지고 있습니다. 중첩 된 양식을 에뮬레이트하고 문제를 해결할 수 있습니다.


1
이 가치있는 연결에 대한 언급이 있습니까?
dakab

w3.org/TR/html5/forms.html#form-owner를 참조하십시오 . "양식 관련 요소는 기본적으로 가장 가까운 조상 양식 요소와 연관되어 있지만 다시 연결할 수있는 경우 대체하도록 지정된 양식 속성이있을 수 있습니다. 이."
Nishi

11

오래된 주제이지만, 이것은 누군가에게 유용 할 수 있습니다.

위에서 언급 한 바와 같이-더미 양식을 사용할 수 있습니다. 얼마 전에이 문제를 극복해야했습니다. 처음에는이 HTML 제한을 완전히 잊어 버렸고 중첩 된 양식을 추가했습니다. 결과는 흥미로웠다 – 나는 둥지에서 나의 첫번째 형태를 잃어 버렸다. 그런 다음 실제 중첩 양식 앞에 더미 양식 (브라우저에서 제거됨)을 추가하는 일종의 "트릭"으로 밝혀졌습니다.

제 경우에는 다음과 같습니다.

<form id="Main">
  <form></form> <!--this is the dummy one-->
  <input...><form id="Nested 1> ... </form>
  <input...><form id="Nested 1> ... </form>
  <input...><form id="Nested 1> ... </form>
  <input...><form id="Nested 1> ... </form>
  ......
</form>

Chrome, FireFox 및 Safari와 잘 작동합니다. IE는 최대 9 개 (10 개는 확실하지 않음)이며 Opera는 기본 형식의 매개 변수를 감지하지 않습니다. 입력에 관계없이 $ _REQUEST 전역이 비어 있습니다. 내부 형태는 모든 곳에서 잘 작동하는 것 같습니다.

여기에 설명 된 다른 제안을 테스트하지 않았습니다. 중첩 된 양식에 대한 필드 세트.

편집 : 프레임 셋이 작동하지 않았습니다! 나는 단순히 다른 폼 다음에 메인 폼을 추가하고 (더 이상 중첩 된 폼은 없음) jQuery의 "복제"를 사용하여 버튼 클릭시 폼의 입력을 복제했습니다. 복제 된 각 입력에 .hide ()를 추가하여 레이아웃을 변경하지 않고 이제는 매력처럼 작동합니다.


이것은 나를 위해 완벽하게 작동했습니다. 나는 모든 것을 포함하는 asp.net 페이지에서 일하고있었습니다. jQuery Validation 플러그인 ( github.com/jzaefferer/jquery-validation ) 에 사용할 내부 중첩 양식이 있었고 FireFox 및 IE에서 완벽하게 작동했지만 Chrome에서 'TypeError :'method '를 호출 할 수 없습니다. 찾으시는 주소가 없습니다'. Chrome에서 jQuery.html ()을 사용하여 추가 한 html 블록에서 내부 양식을 찾을 수 없으므로 validate () 초기화 호출이 실패했습니다. 작은 더미 양식을 추가하면 Chrome에서 실제 양식을 남깁니다.
숫자 아님

더 이상 작동하지 않는 것 같습니다. Firefox는 두 번째 <form> 태그를 제거한 다음 첫 번째 </ form> 태그로 양식을 종료했습니다. 페이지 하단에 유효하지 않은 </ form> 태그가 있고 올바르게 제출되지 않은 양식이 남았습니다. :(
Tarquin

나에게 매우 유용합니다. 양식이 포함 된 웹 위젯을 asp.net 페이지에 추가하고 있습니다. WebForm은 항상 HTML 본문에 모든 것을 포함하는 양식을 생성한다는 사실에 놀랐습니다. 엔 클로징 양식은 웹 위젯의 두통이됩니다. 더미 형태는이 상황에서 빠르고 효과적인 해결책 인 것 같습니다. Chrome 및 Safari에서 완벽하게 작동하며 아직 Firefox를 테스트하지 않았습니다. 공유해 주셔서 감사합니다. 시간을 많이 절약했습니다!
JM Yang

4

제이슨 말이 맞아요 "삭제"조치가 최소한의 조치 인 경우, 그 자체로 양식을 작성하고 다른 단추와 정렬하여 인터페이스가 하나의 통합 된 양식처럼 보이도록하십시오.

또는 인터페이스를 다시 디자인하고 사람들이 완전히 다른 형식을 볼 필요가없는 다른 곳을 완전히 삭제하도록하십시오.


2

자바 스크립트 없이이 작업을 수행하는 한 가지 방법은 수행 할 작업을 정의하는 라디오 버튼 세트를 추가하는 것입니다.

  • 최신 정보
  • 지우다
  • 도대체 무엇이

그런 다음 조치 스크립트는 라디오 단추 세트의 값에 따라 다른 조치를 취합니다.

다른 방법은 제안한대로 페이지에 두 개의 양식을 배치하는 것입니다. 그래도 레이아웃을 제어하기 어려울 수 있습니다.

<form name = "editform"action = "the_action_url"method = "post">
   <input type = "hidden"name = "task"value = "update"/>
   <input type = "text"name = "foo"/>
   <input type = "submit"name = "save"value = "저장"/>
</ form>

<form name = "delform"action = "the_action_url"method = "post">
   <input type = "hidden"name = "task"value = "delete"/>
   <input type = "hidden"name = "post_id"value = "5"/>
   <input type = "submit"name = "delete"value = "삭제"/>
</ form>

처리 스크립트에서 숨겨진 "작업"필드를 사용하여 적절하게 분기합니다.


1

이 토론은 여전히 ​​나에게 관심이 있습니다. 원래 게시물 뒤에는 OP가 공유하는 것처럼 보이는 "요구 사항"즉, 이전 버전과의 호환성이있는 양식이 있습니다. 글을 쓰는 시점에서 IE6를 지원해야하는 사람 (그리고 앞으로 몇 년 동안)이 있기 때문에 나는 그것을 파헤칩니다.

프레임 워크를 추진하지 않으면 서 (모든 조직은 호환성 / 견고성에 대한 확신을 가지려고하며,이 논의를 프레임 워크에 대한 정당화로 사용하지 않습니다),이 문제에 대한 Drupal 솔루션은 흥미 롭습니다. 드루팔은 프레임 워크가 "자바 스크립트없이 작동해야한다"(예 : OP의 문제)라는 오랜 정책을 가지고 있었기 때문에 직접 관련이있다.

Drupal은 방대한 form.inc 함수를 사용하여 triggering_element (예, 코드 이름)를 찾습니다. 에 대한 API 페이지에 나열된 코드의 하단을 참조하십시오 form_builder을 (당신이 세부 사항을 발굴하려는 경우, 소스를 권장합니다 - 드루팔-X.XX / 포함 / form.inc을 ). 빌더는 자동 HTML 속성 생성을 사용하며이를 통해 어떤 버튼을 눌렀는지 감지하고 그에 따라 조치를 취할 수 있습니다 (이는 별도의 프로세스도 실행하도록 설정할 수 있음).

Drupal은 양식 작성기 외에도 데이터 '삭제'작업을 원래 게시물에 언급 된 이유로 별도의 URL / 양식으로 나눕니다. 여기 에는 예비 검색으로 일종의 검색 / 목록 단계 ( 다른 형식으로 신음 하지만 사용자에게 친숙 함)가 필요합니다. 그러나 이것은 "모든 것을 제출하십시오"문제를 제거하는 이점이 있습니다. 데이터가 포함 된 큰 형식은 의도 된 목적, 데이터 생성 / 업데이트 (또는 '병합'작업)에 사용됩니다.

즉, 문제를 해결하는 한 가지 방법은 양식을 두 가지로 나눈 다음 문제가 사라집니다 (HTML 메소드도 POST를 통해 수정할 수 있음).


0

iframe중첩 양식 에는 을 사용하십시오 . 필드를 공유해야하는 경우 ... 실제로 중첩되지 않습니다.


1
iframe을 사용하는 것은 좋은 생각입니다. 대부분의 경우 크기를 조정하기 위해 자바 스크립트가 필요하다는 것은 부끄러운 일입니다 (사용자의 텍스트 크기가 무엇인지 알 수 없으므로 버튼의 크기).
니콜라스 생크

@Nicholas, Javascript를 사용하여 크기를 조정할 수 있습니까? iframed HTML은 동일한 도메인에 있지 않으면 iframe과 대화 할 수 없으며 그 반대도 마찬가지입니다.
Dan Rosenstark

@Nicholas, 감사합니다. 그들은 단지 같은 도메인에 있어야합니다.
Dan Rosenstark

0

내 솔루션은 버튼이 JS 함수를 호출하여 기본 양식으로 양식을 작성한 다음 제출하는 것입니다.

<head>
<script>
function removeMe(A, B){
        document.write('<form name="removeForm" method="POST" action="Delete.php">');
        document.write('<input type="hidden" name="customerID" value="' + A + '">');
        document.write('<input type="hidden" name="productID" value="' + B + '">');
        document.write('</form>');
        document.removeForm.submit();
}
function insertMe(A, B){
        document.write('<form name="insertForm" method="POST" action="Insert.php">');
        document.write('<input type="hidden" name="customerID" value="' + A + '">');
        document.write('<input type="hidden" name="productID" value="' + B + '">');
        document.write('</form>');
        document.insertForm.submit();
}
</script>
</head>

<body>
<form method="POST" action="main_form_purpose_page.php">

<input type="button" name="remove" Value="Remove" onclick="removeMe('$customerID','$productID')">
<input type="button" name="insert" Value="Insert" onclick="insertMe('$customerID','$productID')">

<input type="submit" name="submit" value="Submit">
</form>
</body>

-1

Jason이 제안한 것처럼 여러 양식을 사용하지 않으려면 단추와 onclick 핸들러를 사용하십시오.

<form id='form' name='form' action='path/to/add/edit/blog' method='post'>
    <textarea name='message' id='message'>Blog message here</textarea>
    <input type='submit' id='save' value='Save'>
</form>
<button id='delete'>Delete</button>
<button id='cancel'>Cancel</button>

그런 다음 자바 스크립트에서 (jQuery를 사용하기 쉽게 사용함) (일부 클릭 핸들러를 추가하기에는 너무 과잉이지만)

$('#delete').click( function() {
   document.location = 'path/to/delete/post/id'; 
});
$('#cancel').click( function() {
   document.location = '/home/index';
});

또한 자바 스크립트가 없으면 페이지의 절반이 작동하지 않게됩니다.


1
내가 간과하지 않는 한 이것은 삭제 조치에 링크하는 것보다 낫지 않습니다. 최종 결과는 삭제 조치에 대한 GET 요청입니다 (나쁜). 사실 그것은 오래된 링크 태그로 할 수있는 것을 달성하기 위해 JavaScript가 필요하기 때문에 조금 더 거칠다.
Kyle Fox

-1

Yar가 자신의 답변에 대한 코멘트로 게시 한 질문에 대해 iframe의 크기를 조정하는 JavaScript를 제시합니다. 양식 버튼의 경우 iframe이 동일한 도메인에 있다고 가정하는 것이 안전합니다. 이것은 내가 사용하는 코드입니다. 자신의 사이트에 대한 수학 / 상수를 변경해야합니다.

function resizeIFrame(frame)
{
    try {
        innerDoc = ('contentDocument' in frame) ? frame.contentDocument : frame.contentWindow.document;
        if('style' in frame) {
            frame.style.width = Math.min(755, Math.ceil(innerDoc.body.scrollWidth)) + 'px';
            frame.style.height = Math.ceil(innerDoc.body.scrollHeight) + 'px';
        } else {
            frame.width = Math.ceil(innerDoc.body.scrollWidth);
            frame.height = Math.ceil(innerDoc.body.scrollHeight);
        }
    } catch(err) {
        window.status = err.message;
    }
}

그런 다음 다음과 같이 호출하십시오.

<iframe ... frameborder="0" onload="if(window.parent && window.parent.resizeIFrame){window.parent.resizeIFrame(this);}"></iframe>

-1

방금 jquery로 수행하는 좋은 방법을 생각해 냈습니다.

<form name="mainform">    
    <div id="placeholder">
    <div>
</form>

<form id="nested_form" style="position:absolute">
</form>

<script>
   $(document).ready(function(){
      pos = $('#placeholder').position();
      $('#nested_form')
         .css('left', pos.left.toFixed(0)+'px')
         .css('top', pos.top.toFixed(0)+'px');
   });
</script>

-1

글쎄, 당신이 양식을 제출하면, 브라우저는 또한 입력 제출 이름과 값을 보냅니다. 그래서 당신이 할 수있는 일은

<form   
 action="/post/dispatch/too_bad_the_action_url_is_in_the_form_tag_even_though_conceptually_every_submit_button_inside_it_may_need_to_post_to_a_diffent_distinct_url"  
method="post">  

    <input type="text" name="foo" /> <!-- several of those here -->  
    <div id="toolbar">
        <input type="submit" name="action:save" value="Save" />
        <input type="submit" name="action:delete" value="Delete" />
        <input type="submit" name="action:cancel" value="Cancel" />
    </div>
</form>

따라서 서버 측에서는 너비 문자열 "action :"을 시작하는 매개 변수를 찾고 나머지 부분은 수행 할 작업을 알려줍니다.

브라우저 저장 버튼을 클릭하면 foo = asd & action : save = 저장과 같은 메시지가 나타납니다.


-1

사람이 원하는 양식에 따라 확인란을 포함시켜 문제를 해결했습니다. 그런 다음 1 버튼을 사용하여 전체 양식을 제출하십시오.


2
스택 오버플로에 오신 것을 환영합니다 . 당신이 한 일을 말하는 것보다는 이것이 어떻게 문제를 해결하는지 설명하는 것이 좋습니다. 스택 오버플로에 대한 훌륭한 답변을 만드는 방법에 대한 팁은 답변 방법을 참조하십시오 . 감사합니다!
콴타스 94 헤비

-2

또는 actiob 양식을 즉시 할당 할 수 있습니다 ... 최상의 솔루션은 아니지만 서버 측 논리를 완화시킵니다 ...

<form name="frm" method="post">  
    <input type="submit" value="One" onclick="javascript:this.form.action='1.htm'" />  
    <input type="submit" value="Two" onclick="javascript:this.form.action='2.htm'" />  
</form>

왜? 어떤 버튼을 클릭했는지 쉽게 알 수 없기 때문에 진지하게 묻습니다 .jQuery의 click () 메소드와 같은 것을 사용하여 버튼의 onclick 핸들러를 설정해야한다고 말하고 있습니까? 또는 양식을 제출하기 전에 클릭 이벤트를 처리하는 것이 문제입니까?
잭 모리스
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.